Donovan Brown

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.