Install an agent

If you are an on-premises customer, you first need to install and configure Contrast.

To instrument your applications and get going, you need to install an agent before you can see data in the Contrast application.

Select the agent that applies to your application:

Important

Once installed, agents will need to be upgraded. You should install a new agent whenever you make a nominal change to your application. Whenever you redeploy your application upgrade to the latest agent.

In addition to installation there are some additional steps to take to get Contrast up and running:

  • If developers at your organization would like to work with code earlier in the SDLC then you should also install the Contrast CLI.

  • Once you finish installation you will need to enable Assess and Protect if you are using those products. Assess, Protect and OSS require appropriate licenses.

After installing the agent and restarting the application server, the agent should start and immediately connect to the Contrast application. If this doesn't happen, something may be preventing the agent from communicating with the application:

  • Firewalls that don't allow traffic to the Contrast application's IP address and port: You need to configure host or network firewall.

  • Web gateways and proxies that require authentication: Try downloading the agent again and setting the proper configurations before installing the new agent.

  • Contrast application server URL is misconfigured, so the agent is attempting to communicate with the wrong address. You can change this in the agent configuration, if necessary.

Note

Each application in the same organization must have a unique name. If multiple applications have the same name, Contrast incrementally appends each instance of the display name (for example, App1, App1 (1), App1 (2)).