Manually Installing the Agent

Manually Downloading Install Packages from the Manage Packages Page

The Manage Packages page provides three types of links for downloading agent install packages:

  • Click the link underneath the Name of an install package to display a download link you can copy to your clipboard or into an email message. Anyone who receives an email with that link can click it to install the agent package.
  • Click the Download Package link for an install package to immediately download that package to your local machine.
  • Select an install package and click the Download Page to display a download link you can use to download the package to your local machine.

Any of these methods downloads the same KcsSetup file used to install the agent.

Installing an Agent Using the Download Page (on premises only)

The following is the fastest way to install an agent manually.

Note: The dl.asp download page is available to install partition 1 agents in an on-premise VSA, whether or not tenants are created using the Tenant Management module. The dl.asp page is not available in any partition in SaaS environments.

  1. Log on to any machine you want to install an agent on.
  2. Enter the following URL in the browser of that machine:

http://<YourVSAaddress>/dl.asp

  1. Click the Default Install package to begin installation of the agent on that machine.
  • If other install packages are listed, select your preferred install package.
  • Once the install starts you may have to confirm the installation to ensure it completes.
  1. Logon to your VSA:

http://<YourVSAaddress>

  1. Within the VSA, select the Agent > Manage Agents page.

You should see a new machine account listed on this page for the agent you just created.

Executing the Agent Install Package on the Endpoint Machine

Users can execute the KcsSetup installer on the endpoint machine using any of the following methods:

  • Windows
    • Double-click the KcsSetup to launch it.
    • Open a command line window and type KcsSetup followed by any desired command line switches.
    • Select Run... from the Windows Start menu and type KcsSetup followed by any desired command line switches.
  • MacOS and Linux

NOTE   For MacOS, installing an agent from flash driver is not supported.

  • Double-click KcsSetup to launch it.
  • The full filename for a MacOS agent install package is KcsSetup.app. KcsSetup.app is downloaded as a KcsSetup.zip which contains KcsSetup.app inside a folder titled Agent. Click the KcsSetup.zip file to expand it, click the Agent folder, then click the KcsSetup.app file to execute it.

NOTE   For MacOS, command line switches can only be used when creating the agent install package.

NOTE   For Linux, see Installing Linux Agents for more detailed instructions.

Reinstalling Agents

The Create page enables you to re-install an agent for an existing machine ID account.