Skip To Content

Upgrade ArcGIS Monitor

All ArcGIS Monitor machines in your deployment must be upgraded to the same version.

Prepare to upgrade Monitor

Carefully review the following information and complete any required actions before you upgrade Monitor:

  • If necessary, obtain new authorization files from My Esri and apply them to the ArcGIS Monitor Server machine in your deployment before upgrading.
  • Review the Monitor system requirements to ensure that your hardware meets the current requirements.
  • Create a backup of the Monitor database and all Monitor machines in the deployment, and store the backup files in a secure, remote location.
  • Download the latest ArcGIS Monitor software installation files from My Esri.
  • Do not uninstall the previous version of ArcGIS Monitor Server or ArcGIS Monitor Agent. Running the setup automatically upgrades Monitor Server or Monitor Agent. There is no need to obtain and install each previously released version in sequence.
    Note:

    Only one version can be installed on a machine at a time; when you install a new version, the old version is replaced.

  • For Monitor Agent machines to function, they must be the same version as the Monitor Server machine.
  • Stop the ArcGIS Monitor Server service and ArcGIS Monitor Agent service on all Monitor Server and Monitor Agent machines using Windows Services Manager before you upgrade Monitor. Monitoring is not available when the Monitor services are stopped.

Monitor upgrade order

The recommended order to upgrade the components in your Monitor deployment is as follows:

  1. Upgrade Monitor Server.
  2. Upgrade Monitor Agent.

Steps to upgrade Monitor Server

Once you have your installation files and backup files, complete the upgrade steps for Monitor Server. Do not uninstall Monitor Server before installing the new version.

You can upgrade using an interactive wizard-driven experience by launching the Setup.exe program or run Setup.exe from a command prompt or batch script to silently upgrade Monitor Server. No matter which method you use, the Setup.exe installation file detects and updates the existing installation of Monitor Server.

Upgrade using an interactive wizard-driven experience

After you complete the prerequisites outlined in the Prepare to upgrade Monitor section, complete these steps to upgrade Monitor Server using an interactive wizard. To upgrade using commands instead, proceed to the next section.

  1. Run the Monitor Setup.exe file on the Monitor Server machine in your Monitor deployment.

    Do not uninstall the existing Monitor Server installation.

  2. During the installation, read the license agreement and accept it, or exit if you do not agree with the terms.

    If you accept the license agreement, the Monitor setup program displays the features that will be installed.

  3. When prompted, provide the credentials for the ArcGIS Monitor account.

    Typically, this is the username and password that you defined when the software was installed. If the username or password has changed since the software was installed, you need to provide credentials for the current ArcGIS Monitor account. If you are unsure of the username or password for the account, contact your system administrator.

  4. Once you have updated the Monitor Server installation, open a supported web browser, access Monitor, and verify that the software is updated and licensed.

Upgrade using commands

Rather than run the setup program, you can run the Setup.exe file at a command prompt or in a batch script to update Monitor Server. To avoid receiving a prompt to proceed with the upgrade, run the command in silent mode. To do so, include the /qb parameter in the script.

After you complete the prerequisites outlined in the Prepare to upgrade Monitor section, complete these steps to upgrade Monitor Server:

  1. Run the Monitor Setup.exe file from a command prompt or in a script on the Monitor Server machine in your Monitor deployment.

    Do not uninstall the existing Monitor Server installation.

    The ACCEPTEULA parameter is required to accept the End User License Agreement (EULA) during a silent installation. Specify yes to agree to the EULA and install the software. Specifying no or omitting this parameter results in a failed installation. For more information, review the Master Agreement.

    When upgrading using the Setup.exe file in silent mode, you must specify the ArcGIS Monitor account. Typically, this is the account you defined when installing the software. If the account has changed since you installed, you need to provide the current username and password of the ArcGIS Monitor account.

    If you do not specify the ArcGIS Monitor account, or it does not match the account used by your current installation, the installation process displays a message indicating the credentials could not be validated and it results in a failed installation. If you are unsure of the username or password for the account, contact your system administrator.

    In the following example, the account used by the software is myaccount and the password is my.password:

    <path to ArcGIS Monitor setup download folder>\Setup.exe /qb ACCEPTEULA=yes USER_NAME=myaccount PASSWORD=my.password

    In the following example, the domain account used by the software is mydomain\myaccount and the password is my.password:

    <path to ArcGIS Monitor setup download folder>\Setup.exe /qb ACCEPTEULA=yes USER_NAME=mydomain\myaccount PASSWORD=my.password

    Caution:

    Command line parameters are case sensitive. If you are having trouble upgrading, confirm the case matches the properties as shown in the examples.

  2. Once you have updated the Monitor Server installation, open a supported web browser, access Monitor, and verify that the software is updated and licensed.

Steps to upgrade Monitor Agent

Once you have your installation files and backup files, complete the upgrade steps on each Monitor Agent machine in your Monitor deployment. All Monitor Agent machines in your deployment must run the same Monitor release. Do not uninstall Monitor Agent before installing the new version.

You can upgrade using an interactive wizard-driven experience by launching the Setup.exe program or run Setup.exe from a command prompt or batch script to silently upgrade Monitor Agent. No matter which method you use, the Setup.exe installation file detects and updates the existing installation of Monitor Agent.

Upgrade using an interactive wizard-driven experience

After you complete the prerequisites outlined in the Prepare to upgrade Monitor section, complete these steps to upgrade Monitor Agent using an interactive wizard. To upgrade using commands instead, proceed to the next section.

  1. Run the Monitor Setup.exe program on each Monitor Agent machine in your Monitor deployment.

    Do not uninstall the existing Monitor Agent installation.

  2. During the installation, read the license agreement and accept it, or exit if you do not agree with the terms.

    If you accept the license agreement, the Monitor setup program displays the features that will be installed.

  3. When prompted, provide the credentials for the ArcGIS Monitor account.

    Typically, this is the username and password that you defined when the software was installed. If the username or password has changed since the software was installed, you need to provide credentials for the current ArcGIS Monitor account. If you are unsure of the username or password for the account, contact your system administrator.

  4. Once you have updated the Monitor Agent installation, open a supported web browser, access Monitor, and verify that the Monitor Agent machine is connected to Monitor Server.

Upgrade using commands

Rather than run the setup program, you can run the Setup.exe file at a command prompt or in a batch script to update Monitor Server. To avoid receiving a prompt to proceed with the upgrade, run the command in silent mode. To do so, include the /qb parameter in the script.

After you complete the prerequisites outlined in the Prepare to upgrade Monitor section, complete these steps to upgrade Monitor Server:

  1. Run the Monitor Setup.exe file from a command prompt or in a script on each Monitor Agent machine in your Monitor deployment.

    Do not uninstall the existing Monitor Agent installation.

    The ACCEPTEULA parameter is required to accept the End User License Agreement (EULA) during a silent installation. Specify yes to agree to the EULA and install the software. Specifying no or omitting this parameter results in a failed installation. For more information, review the Master Agreement.

    When upgrading using the Setup.exe file in silent mode, you must specify the ArcGIS Monitor account. Typically, this is the account you defined when installing the software. If the account has changed since you installed, you need to provide the current username and password of the ArcGIS Monitor account.

    If you do not specify the ArcGIS Monitor account, or it does not match the account used by your current installation, the installation process displays a message indicating the credentials could not be validated and it results in a failed installation.

    In the following example, the account used by the software is myaccount and the password is my.password:

    <path to the ArcGIS Monitor setup download>\setup.exe /qb ACCEPTEULA=yes ADDLOCAL=Agent USER_NAME=myaccount PASSWORD=my.password

    In the following example, the domain account used by the software is mydomain\myaccount and the password is my.password:

    <path to ArcGIS Monitor setup download folder>\Setup.exe /qb ACCEPTEULA=yes ADDLOCAL=Agent USER_NAME=mydomain\myaccount PASSWORD=my.password

    Caution:

    Command line parameters are case sensitive. If you are having trouble upgrading, confirm the case matches the properties as shown in the examples.

  2. Once you have updated the Monitor Agent installation, open a supported web browser, access Monitor, and verify that the Monitor Agent machine is connected to Monitor Server.

Considerations after upgrading

Monitor backups that you created before upgrading cannot be used to restore a Monitor deployment. It is recommended that you create a backup of the Monitor database and all Monitor machines in the deployment after upgrading. After upgrading, confirm that your deployment is collecting data as expected by accessing Monitor and viewing collection details and component details.