Upgrading from an earlier version

Upgrading server

Before starting the upgrade process, it is recommended to back up your existing NOM installation folder.

Version specific notes

1.3

All metrics will be deleted as part of the migration that runs on upgrade to version 1.3.

This is due to a major change to the metric storage model making previous metrics incompatible with this version.

1.4

The initial startup of 1.4 after upgrade may take longer than usual, especially if the persistence store contains a large amount of query log data.

This is due to additions to the query log model which require existing data to be migrated.

On Linux

  1. Back up any files you’ve modified inside the current NOM server directory. This usually includes etc/neo4j-ops-manager-server.service and any files inside certificates/ directories.

  2. Download latest NOM server package for your platform.

  3. Stop NOM server by running systemctl stop neo4j-ops-manager-server.

  4. Extract the downloaded package into the existing installation directory.

  5. Copy the backed up files back into their corresponding locations.

  6. Start NOM server by running systemctl start neo4j-ops-manager-server.

  7. Verify that the server is operating as expected by checking logs.

On Windows

  1. Back up any files you’ve modified inside the current NOM server directory. This usually includes bin/server.xml and any files inside certificates/ directories.

  2. Download latest NOM server package for your platform.

  3. Stop NOM server by running ./bin/server.exe stop inside current NOM server directory.

  4. Extract the downloaded package into the existing installation directory.

  5. Copy the backed up files back into their corresponding locations.

  6. Start NOM server by running ./bin/server.exe start.

  7. Verify that the server is operating as expected by checking logs.

Upgrading agents

Each NOM server package contains corresponding NOM agent packages for every supported platform.
You can either use them or download the corresponding agent binaries from Download Center.

  1. Get the corresponding NOM agent package for your platform.

  2. Stop NOM agent by running ./bin/agent service stop.

  3. Extract the downloaded package into the existing installation directory.

  4. Start NOM agent by running ./bin/agent service start.

  5. Verify that the agent is operating as expected by checking logs.