<%@ page isELIgnored="true" %> <%@ taglib uri="cms" prefix="cms" %> Agent Upgrade

Agent Upgrade

You should upgrade the server before upgrading any agents. AnthillPro supports an auto-upgrade feature to upgrade running agents.

The upgrade can be performed through the AnthillPro Web UI at Agents > Agent. Select the agents you want to upgrade and then click the Upgrade Agents button to begin the auto-upgrade process. The upgrade can take some time, so refresh the page to view progress.

  • Because of extensive agent-server communication changes made for version 3.6, if you are upgrading to AnthillPro 3.6 the following applies: Communication port. A new port needs to be opened to the server (default value of this port is 7915) for agent communication.Windows service (upgrading from 3.5 to 3.6.1). AnthillPro will attempt to upgrade agent Windows services and restart them after upgrade. However, if the agent service is running as a user that does not have permission to modify the service settings, the Windows service will need to be remove and reinstalled.

If you need to manually upgrade an agent, stop the agent and follow the same instructions as an installation. When asked for the directory to install the agent, enter the existing agent directory.

  1. Shut down the server and agent.

  2. Follow steps 1 to 4 of the installation process.

  3. Give the Directory where the AnthillPro agent should be upgraded.

  4. Input Y to upgrade an existing AnthillPro agent.

  5. Give the home directory of the JRE/JDK used to run the agent.

  6. Relay connection. Enter the default N if not using Urbancode's Distributed Servers product, available under separate license. If using Distributed Servers, see Installing Distributed Servers before continuing.

    If you are interested in using the Agent Relay for agent-server communication, contact .

  7. Determine if internal communication should use SSL. Default is N.

    When using SSL, you need to turn it on for both the server and the agent -- otherwise the agents will not be able to connect to the server. If you are using the agent relay, ensure that SSL is turned on for all three components: server, agent, and agent relay. This rule also applies if using mutual authentication.

    • If using SSL, determine if communication should be mutually authenticated. Default is N.

  8. If the AnthillPro agent is installed as a Windows service: Input the unique name in the dialog box and click OK to stop and remove service (Windows service will be recreated, if desired, at the end of the upgrade process).

    • If more than one AnthillPro agent is installed as a Windows service, make sure the correct service name is entered.

    See also Install Agent as Windows Service.