Removing and reinstalling agents as Windows™ services

If you installed an agent as a Windows™ service, you can remove and reinstall the service.

Old or non-compact agents

Before you begin, make sure that the agent is installed as a Windows service. See Installing agents from the command line for detailed instructions.

  1. Open a command prompt as an administrator.
  2. Go to the C:\agent_install\bin\service folder, where agent_install is the installed agent location.
  3. Remove the service by running the following command: 
    _agent.cmd remove service_name
    Use the name of the service for service_name. The default service name is DevOps Deploy Agent.
  4. Reinstall the service by running the following command: 
    _agent.cmd install service_name
    Note: While re-installing an agent, the latest PATH variable values are used.

Compact agents

Before you begin, make sure that the agent is installed as a Windows service. See Installing agents from the command line for detailed instructions.

  1. Open a command prompt as an administrator.
  2. Go to the C:\agent_install\bin\ folder, where agent_install is the installed agent location.
  3. Remove the service by running the following command: 
    agent.exe uninstall-service
  4. Reinstall the service by running the following command: 
    agent.exe install-service

    For additional commands, see Agent executable command-line commands.