Upgrade Java Agent

  1. Read the Release Notes for information about changes in Java Agent.

  2. Back up the directories for the agent installation and the web application container configuration:

  3. Redirect client traffic away from the protected web application.

  4. Stop the web application container where the agent is installed.

  5. Remove the old Java Agent, as described in Remove Java Agent.

  6. Install the new agent, as described in Install Java Agent.

    The installer creates new AgentConfiguration.properties and AgentBootstrap.properties files, containing properties for the agent version.

  7. Review the agent configuration:

    • In local configuration mode, see the AgentConfiguration.properties file. Use the backed-up copy of the configuration file for guidance, the agent’s Release Notes, and AM’s Release Notes to check for changes. Update the file manually to include properties for your environment.

      The AgentBootstrap.properties file created by the installer contains bootstrap properties relevant to the new version of the agent.

    • In remote configuration mode, review the agent’s Release Notes and AM’s Release Notes to check for changes. If necessary, change the agent configuration using the AM console.

  8. Secure communication between AM and the agent with appropriate keys. For information, see Configuring AM Servers to Communicate With Java Agents.

  9. Start the web application container where the agent is installed.

  10. Check that the agent is performing as expected. For example, navigate to a protected page on the web site and confirm whether you can access it according to your configuration.

  11. Allow client traffic to flow to the protected web application.