How to Upgrade the Terminal Server Agent

How to Upgrade the Terminal Server Agent

• These steps are applicable if you are currently running any of the following versions or older
  
  • 9.0.6-101 or older
  • 9.1.5-108 or older
  • 10.0.7-104 or older
  • 10.1.2-104 or older
  • 10.2.4-107 or older
  • 11.0.1-104 or older

High-level steps

• [REQUIRED] Back up the Terminal Server Agent configuration.
• Install the Terminal Server Agent.
• Restore custom certificates from the backup.
• Start the Terminal Server Agent.
• Note on silent installation.

1. Back up the Terminal Server Agent configuration.

• 1. On your Windows server, navigate to “C:\Program Files\Palo Alto Networks\Terminal Server Agent”.
  2. Create a compressed archive of the contents of this folder and save the archive to a different location.

2. Download the Terminal Server Agent installation file from the Customer Support Portal.

3. Click the “Exit” button to close the Terminal Server Agent application.

• 1. Open the Services application on your Windows server.
  2. Locate the service named “PAN Terminal Server Agent”. Right-click the service and select “Stop” as shown in the screenshot below.

4. Install the Terminal Server Agent.

   1. Open the Windows Start menu, right-click the Command Prompt program, and select “Run as Administrator”.
   2. From the command line, run the file you downloaded. For example, if you saved the file to the Desktop, enter the following:

• • • C:\Users\administrator.acme>cd Desktop 
    • C:\Users\administrator.acme\Desktop>TaInstall<version>.msi

1. 3. Follow the setup prompts to install the agent using the default settings. The setup installs the agent in “C:\Program Files\Palo Alto Networks\Terminal Server Agent”.
   4. During installation you will see the pop-up window shown in the screenshot, which reminds you to perform the backup at step 1 above. Click “Yes”.
   5. When the installation completes, click “Close”.

5. Restore custom certificates from the backup.

   1. From the backup you took at step 1, extract any custom certificate files you had configured through the “Server Certificates” option in the UI. Skip this step if you do not have custom certificates configured. 

6. Start the Terminal Server Agent.

• 1. Open the Services application, right-click the service named “PAN Terminal Server Agent” and select “Restart”.
  2. From the Windows Start menu, open the Terminal Server Agent application.
  3. Confirm that the PAN Terminal Server Agent service is running

Note on silent Installation.

1. For Terminal Server Agent version 11.0.4 and higher, you can perform silent installation using the "/qn" command line option. Example below:

• • C:\Users\administrator.acme\Desktop>TaInstall<version>.msi /qn