Enterprise-on-Premise (EOP) administrators can upgrade the Contrast language agents independently within the Contrast application. In earlier releases of Contrast, the agents were bundled with the application updater artifact. Administrators now have the ability to download a new agent from the Contrast Hub Site and copy the individual agent artifact(s) to a directory on the Contrast application. No restart of the application is required; the agent artifact dynamically reloads and becomes accessible for download.
EOP installations of the Contrast application (starting with version 3.2.7) are automatically configured to support a new directory: $CONTRAST_HOME/data/agents. This directory includes sub-directories for each of the agent languages.
contrast-service@dev1eop1:~/contrast/data/agents$ ls -lrta drwxrwxr-x 2 contrast-service contrast-service 4096 Apr 25 19:59 node drwxrwxr-x 2 contrast-service contrast-service 4096 Apr 25 19:59 java drwxrwxr-x 2 contrast-service contrast-service 4096 Apr 25 19:59 dotnet drwxrwxr-x 6 contrast-service contrast-service 4096 Apr 25 19:59 . drwxr-xr-x 13 contrast-service contrast-service 4096 Apr 25 20:01 ..
Agents are provided from the Contrast Hub Site and occasionally as a patch through Contrast's Support Site. Your can download the agent from one of those two locations, and copy it to the server hosting the Contrast application. Place it in the directory $CONTRAST_HOME/data/agents/agentName. As mentioned above, no restart is necessary.
If you encounter any issues after completing the configuration, read the troubleshooting article.
Contrast Enterprise-on-Premise (EOP) customers may occasionally need a new license file. There are two possible approaches for updating this file: A SuperAdmin can log into the application and update the license in the UI, or you can replace the license file on the local file system. If the license is expired, you must use the file system method.
- Username: firstname.lastname@example.org
- Password: Provided when the trial license is originally downloaded from Hub. (Contact your account team or Support for the password.)
Obtain a new license from Hub, your account manager or the technical support team.
Rename the new license file contrast.new.lic.
Stop the Contrast application service.
sudo service contrast-server stopor other appropriate command for the distribution/configuration. Verify that all Contrast application processes have stopped by executing
ps aux | grep contrast, and confirm there are no processes listed. If myslqld is still running, it may take a few minutes to terminate on its own after stopping the service. If it doesn't terminate, contact Support. Do not kill the processes.
Note: Don't move the current contrast.lic file. Contrast needs both the old and new license files to upgrade the license.
ls -lto list the directory contents with permissions and owners.) A backup of the current license called contrast.lic.bak will be created in the same directory when the new one is consumed during startup.
sudo chown contrast_service:contrast_service contrast.new.licto change the owner and group. Execute
sudo chmod 644 contrast.new.licto change the permissions.
Start the Contrast application as normal.
sudo service contrast-server startor other appropriate command for the distribution/configuration.
The new license automatically takes effect.
To update all instances of the Contrast application, follow the steps for the file system method described above for each application instance that's running. Contrast is currently exploring an alternative for distributed configurations that enables you to update all instances at once; however, a solution hasn't been implemented.
Updating Contrast's IP address is fairly straightforward. Whether you moved the installation or had to change the hostname or IP address, you can let Contrast know in a few simple steps.
Note: You must also replace your agents so they know the new address to which they now report.