Download/Install Latest Agent from PerformanceGuard

You can download the latest released PerformanceGuard agent directly from the PerformanceGuard web interface, or generate a PowerShell command that downloads and installs it.

To open the page, select Administration → Agent Configuration → Download/Install Agent.

At the top of the page, select the tab for the operating system: Windows - 64bit or Windows - 32bit.

Option 1: Download the agent in your browser

Select the PerformanceGuard Agent button. It shows the version and operating system of the agent it downloads. The browser saves the installer in your Downloads folder.

Option 2: Download and install the agent with PowerShell

Caution

PowerShell is required

The page has a form that generates a command. When you run the command in PowerShell, it downloads AND installs the agent with the settings you specify.

Caution

The command downloads the installer to the current folder. Make sure to cd into the correct folder before you run it.

Check boxes

1. Silent Installation: The installation runs silently.
2. Log Installation: The installation writes a log file, agentInstall.log, in the same folder as the downloaded agent installer (.msi).

Caution

If you select Silent Installation, you can’t change any of the options during the installation.

Fields

• Frontend Server URL: The public DNS name of your frontend server. If you leave it blank, the agent uses performanceguard.
• Frontend Server Port: The public TCP port of your frontend server. If you leave it blank, the agent uses 4001.
• Configuration Group: The agent configuration group the agent joins when it first connects. If you leave it blank, the agent uses Default.
• Service Start Delay: The number of seconds the agent waits before it attaches to the network.
• Encryption Settings: See the following.

For more information about these settings, see Installation parameters.

Encryption settings

• 0: Don’t use encryption
• -1: Use encryption if the Frontend server supports encryption
• 1: Force use of encryption (that is: don’t communicate with Frontend servers that don’t support encryption)
• -2: Use custom defined encryption if the Frontend server supports encryption
• 2: Force use of custom defined encryption

Caution

A custom AES key is required if you choose -2 or 2 in the encryption settings. The AES Key is set (or generated) when you install PerformanceGuard.

If PerformanceGuard was installed without setting an AES Key, -2 and 2 aren’t available:

The generated PowerShell command

With AES key (encryption 2 chosen):

If -2 or 2 is chosen in the encryption settings, the downloaded agent is configured with your installation’s AES key automatically.

Without AES key (encryption -1 chosen):

Select Copy to clipboard to copy the generated command.