Upgrade

Upgrading on Debian or Ubuntu

Upgrading server and agent

  1. It’s recommended to check database for possible inconsistencies prior to the upgrade. To do this, stop the server and run command:

    nxdbmgr check

    Proceed to the next step only if database checker does not report any errors!

  2. To update NetXMS server and agent packages run command:

    apt-get update && apt-get upgrade

    During package upgrade database schema should be upgraded as well and NetXMS server would start automatically. However, in some cases (e.g. if database engine packages were also upgraded) automatic database upgrade may not happen. If this is the case, NetXMS server won’t get started and it’s log would show, e.g.: Your database has format version 41.07, but server is compiled for version 41.18. To upgrade the database, run command:

    nxdbmgr upgrade

    Once database upgrade is complete, start the server.

Management client

Desktop Management Client:

  1. Download the latest version from http://www.netxms.org/download. You will need Linux installer (named nxmc-VERSION-linux-gtk-x86.tar.gz or nxmc-VERSION-linux-gtk-x64.tar.gz, for example nxmc-4.4.3-linux-gtk-x64.tar.gz).

  2. Extract and replace old management client with the new one.

    tar zxvf nxmc-VERSION-linux-gtk-x86.tar.gz -C /DIRECTORY

  3. Run nxmc file from extracted catalog.

Web Management Client:

  1. Download latest version of WAR file from Web Interface Binaries section http://www.netxms.org/download/ (named nxmc-VERSION.war, for example nxmc-4.4.3.war).

  2. Replace old WAR file with the new one.

    Sometimes it’s possible that new WAR file is not detected and previous version of WAR continues to run. In this case stop servlet container, delete the WAR file. Then start servlet container and copy the war file to webapps directory.

Upgrading on Red Hat, Fedora, CentOS or ScientificLinux

Upgrading

Server

  1. Download the latest version from http://www.netxms.org/download, if you don’t have it. You will need source archive (named netxms-VERSION.tar.gz, for example netxms-1.2.15.tar.gz). Please note that in the following steps VERSION will be used as a substitution for an actual version number.

  2. Unpack the archive:

$ tar zxvf netxms-1.2.15.tar.gz

  1. Change directory to netxms-version and run configure script:

$ cd netxms-1.2.15

$ sh ./configure --enable-release-build --with-server --with-mysql

Be sure to include all options that were used at installation time.

  1. Run make:

$ make

  1. Stop NetXMS server.

  2. Stop NetXMS agent.

  3. Check database for possible inconsistencies:

$ nxdbmgr check

Proceed to the next step only if database checker does not report any errors!

  1. Run make install:

$ make install

  1. Upgrade database:

$ nxdbmgr upgrade

  1. Start NetXMS agent.

  2. Start NetXMS server.

Agent

  1. Download the latest version from http://www.netxms.org/download, if you don’t have it. You will need source archive (named netxms-VERSION.tar.gz, for example netxms-1.2.15.tar.gz). Please note that in the following steps VERSION will be used as a substitution for an actual version number.

  2. Unpack the archive:

tar zxvf netxms-1.2.15.tar.gz

  1. Change directory to netxms-version and run configure script:

cd netxms-1.2.15

sh ./configure --enable-release-build --with-agent

Be sure to include all options that were used at installation time.

  1. Run make and make install:

make

  1. Stop NetXMS agent.

  2. Run make install:

make install

  1. Run agent:

$ /usr/local/bin/nxagentd -d

Management Client

Desktop Management Client:

  1. Download the latest version from http://www.netxms.org/download. You will need Linux installer(named nxmc-VERSION-linux-gtk-x86.tar.gz or nxmc-VERSION-linux-gtk-x64.tar.gz, for example nxmc-4.4.3-linux-gtk-x64.tar.gz).

  2. Extract and replace old management client with the new one.

    tar zxvf nxmc-VERSION-linux-gtk-x86.tar.gz -C /DIRECTORY

  3. Run nxmc file from extracted catalog.

Web Management Client:

  1. Download latest version of WAR file from Web Interface Binaries section http://www.netxms.org/download/ (named nxmc-VERSION.war, for example nxmc-4.4.3.war).

  2. Replace old WAR file with the new one.

    Sometimes it’s possible that new WAR file is not detected and previous version of WAR continues to run. In this case stop servlet container, delete the WAR file. Then start servlet container and copy the war file to webapps directory.

Upgrading on Windows

Upgrade

Server

  1. Download the latest version from http://www.netxms.org/download, if you don’t have it. You will need Windows installer (named netxms-VERSION.exe, for example netxms-1.2.15.exe).

  2. Stop NetXMS server.

  3. Check database for possible inconsistencies:

C:\NetXMS\bin> nxdbmgr check

Proceed to the next step only if database checker does not report any errors!

  1. Run NetXMS installer and follow the prompts. Normally, you will not need to change any settings on installation wizard windows. Alternatively, you can run the installer with /SILENT option to disable any prompts:

C:\Download> netxms-1.2.15.exe /SILENT

  1. Check whether NetXMS Server service is running again. If it’s not, most likely you have to upgrade your database to newer version. To upgrade database, use nxdbmgr utility:

C:\NetXMS\bin> nxdbmgr upgrade

  1. Start NetXMS server, if it is not already started.

Agent

We highly recommend using centralized agent upgrade feature for agent upgrades. However, if you decide to upgrade agent manually, it can be done in just a few steps:

  1. Download the latest version from http://www.netxms.org/download, if you don’t have it. You will need Windows Agent installer (named nxagent-VERSION.exe or nxagent-VERSION-x64.exe, for example nxagent-4.4.3.exe).

  2. Run NetXMS agent installer and follow the prompts. Normally, you will not need to change any settings on installation wizard dialog windows. Alternatively, you can run installer with /SILENT option to disable any prompts:

    C:Download> nxagent-4.4.3.exe /SILENT

Management Client

Desktop Management Client:

  1. Download the latest version from http://www.netxms.org/download. You will need Windows installer(named nxmc-VERSION-win32-x86.zip or nxmc-VERSION-win32-x64.zip, for example nxmc-4.4.3-win32-x64.zip).

  2. Replace old old folder with content of the zip.

  3. Run nxmc.exe file from extracted catalog.

Web Management Client:

  1. Download latest version of WAR file from Web Interface Binaries section http://www.netxms.org/download/ (named nxmc-VERSION.war, for example nxmc-4.4.3.war).

  2. Replace old WAR file with the new one. Default path: INSTALLATION_DIR\\webapps.

    Sometimes it’s possible that new WAR file is not detected and previous version of WAR continues to run. In this case stop servlet container, delete the WAR file. Then start servlet container and copy the war file to webapps directory.

Generic upgrade using source tarball

Server

  1. Download the latest version from http://www.netxms.org/download, if you don’t have it. You will need source archive (named netxms-VERSION.tar.gz, for example netxms-1.2.15.tar.gz). Please note that in the following steps VERSION will be used as a substitution for an actual version number.

  2. Unpack the archive:

$ tar zxvf netxms-1.2.15.tar.gz

  1. Change directory to netxms-version and run configure script:

$ cd netxms-1.2.15

$ sh ./configure --enable-release-build --with-server --with-mysql

Be sure to include all options that were used at installation time.

  1. Run make:

$ make

  1. Stop NetXMS server.

  2. Stop NetXMS agent.

  3. Check database for possible inconsistencies:

$ nxdbmgr check

Proceed to the next step only if database checker does not report any errors!

  1. Run make install:

$ make install

  1. Upgrade database:

$ nxdbmgr upgrade

  1. Start NetXMS agent.

  2. Start NetXMS server.

Agent

  1. Download the latest version from http://www.netxms.org/download, if you don’t have it. You will need source archive (named netxms-VERSION.tar.gz, for example netxms-1.2.15.tar.gz). Please note that in the following steps VERSION will be used as a substitution for an actual version number.

  2. Unpack the archive:

tar zxvf netxms-1.2.15.tar.gz

  1. Change directory to netxms-version and run configure script:

cd netxms-1.2.15

sh ./configure --enable-release-build --with-agent

Be sure to include all options that were used at installation time.

  1. Run make and make install:

make

  1. Stop NetXMS agent.

  2. Run make install:

make install

  1. Run agent:

$ /usr/local/bin/nxagentd -d

Centralized agent upgrade

You can use Package management functionality to perform centralized upgrade of NetXMS agents.