Thursday, July 19, 2018

Auto start build agent in interactive mode

Copyright from: donovanbrown.com

Problem:
I need my build agent to auto login and start in interactive mode.
Solution:
Enable Windows auto login and add a shortcut to the startup folder.
Explanation:
I run Coded UI and Selenium UI test using my build agent. To do so the agent must be run in interactive mode. However, if you configure your agent to run interactive, it will not restart automatically after a reboot. If your system is configured to automatically install updates, your server may get rebooted without you knowing and prevent your agent from starting.
To solve this you can configure Windows to automatically log in a user and start the agent in interactive mode for you. To begin we need to enable automatic log in.
  1. Press Windows Key + R to open the Run dialog
  2. Type in the following and press enter: 
    control userpasswords2
  3. Uncheck the box for User must enter a user name and password to use this computer.
  4. Click the Apply button 
    You will be prompted by an Automatically sign in dialog
  5. Enter the password for the user
  6. Click OK
  7. Click OK on the Users Accounts dialog
Now every time your machine is rebooted the configured user will automatically login to the machine.
Now we need to make sure that once the user is logged in that our agent starts in interactive mode. To do this we are going to create a shortcut that will start our agent then simply place that shortcut in the startup folder for Windows.
  1. Right-click the desktop
  2. Select New / Shortcut
  3. Enter cmd
  4. Click Next
  5. Change the name to Start Agent
  6. Click Finish
  7. Right-click on the new shortcut
  8. Select Properties
  9. Append /c {pathToVsoagent.exe} to the target 
    If you installed your agent to C:\Agent, your target should look like this: C:\Windows\System32\cmd.exe /c c:\agent\agent\vsoagent.exe
  10. Click OK
If you double click the shortcut, your agent will start in interactive mode. Now we need to copy this shortcut into the startup folder for Windows. This will ensure that each time we login the agent is started.
  1. Press Windows Key + R to open the Run dialog
  2. Type in the following 
    shell:startup
  3. Click OK This will open the Startup folder in Windows Explorer.
  4. Drag and drop the shortcut to this folder
Now whenever your machine is restarted your agents will start up in interactive mode.

No comments: