Upgrade icom Router Management to 2025.03.0

Preface

This guide describes the upgrade process of icom Router Management Server (On-Premises). It assumes that you have a working icom Router Management Server installation 2024.10.0a that has been installed using the icom Router Management Server (On-Premises) Install Guide after June 2024. If you have installed icom Router Management Server (On-Premises) before September 2023, please contact our support hotline to schedule a migration because there have been breaking changes in the folder structure and naming in general.

Supported version

icom Router Management Server (On-Premises) Version 2024.10.0a

Preparations

PostgreSQL version

If PostgreSQL is installed in a version lower than 14, it must be updated before the upgrade process. To do so, follow the instructions in the PostgreSQL version upgrade guide.

The PostgreSQL version can be checked using the following command:

sudo -u postgres psql -c "SELECT version();"

Backup PostgreSQL database

The PostgreSQL database should be backed up before starting the upgrade process. The pg_dump command is used to create the backup.

sudo -i -u postgres pg_dump -d insysicomroutermgmt -f /tmp/insysicomroutermgmt_backup.bin -Fc

The database can be restored using the pg_restore command only if necessary.

sudo -i -u postgres pg_restore -d insysicomroutermgmt /tmp/insysicomroutermgmt_backup.bin -Fc

Upgrade preparations

Stop the insysicom-routermgmt systemd service.

sudo systemctl stop insysicom-routermgmt

Stop the insysicom-autoupdate systemd service.

sudo systemctl stop insysicom-autoupdate

Backup the old binaries.

sudo cp /opt/insysicom-routermgmt/bin/insysicom-routermgmt /opt/insysicom-routermgmt/bin/insysicom-routermgmt.old

sudo cp /opt/insysicom-routermgmt/bin/insysicom-autoupdate /opt/insysicom-routermgmt/bin/insysicom-autoupdate.old

Download the new version from the INSYS icom Router Management Cloud or from the link provided by our support team. Copy the zip file to your server. Create a directory in your home and copy the installation zip file irm_linux_2025_03_0.zip into this directory.

mkdir dist
unzip irm_linux_2025_03_0.zip -d dist
ls -aFl dist

You should see the insysicom-routermgmt and insysicom-autoupdate binaries in the dist directory.

Mark the new binaries as executable if the ls command did not show the executable flag indicated by * behind the file name.

For the insysicom-routermgmt binary:

sudo chown insysicom-routermgmt:insysicom-routermgmt dist/insysicom-routermgmt
sudo chmod +x dist/insysicom-routermgmt

For the insysicom-autoupdate binary:

sudo chown insysicom-routermgmt:insysicom-routermgmt dist/insysicom-autoupdate
sudo chmod +x dist/insysicom-autoupdate

Upgrade process

Upgrade application server

Copy the new binary to the correct location.

sudo cp ./dist/insysicom-routermgmt /opt/insysicom-routermgmt/bin/
sudo cp ./dist/insysicom-autoupdate /opt/insysicom-routermgmt/bin/

Set required environment variables and run the database migrations.

Migrate the database for the insysicom-routermgmt service.

sudo -i -u insysicom-routermgmt
/opt/insysicom-routermgmt/bin/insysicom-routermgmt system upgrade -c /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf
exit

Migrate the database for the insysicom-autoupdate service.

set -a
source /opt/insysicom-routermgmt/etc/insysicom-autoupdate.env
set +a
/opt/insysicom-routermgmt/bin/insysicom-autoupdate -migrate

The result should be Migration completed successfully or No pending migrations, depending on the current state of the database.

Change command for autoupdate systemd service

The command for starting the autoupdate service has changed.

Open the systemd service file for the autoupdate service.

sudo vi /etc/systemd/system/insysicom-autoupdate.service

Change the command for ExecStart to the following one.

/etc/systemd/system/insysicom-autoupdate.service

[Unit]
...

[Service]
...
ExecStart=/opt/insysicom-routermgmt/bin/insysicom-autoupdate -serve-autoupdate

[Install]
...

Reload the systemd daemon to apply the changes.

sudo systemctl daemon-reload

Start application server

sudo systemctl start insysicom-routermgmt
sudo systemctl start insysicom-autoupdate

Confirm upgrade

Confirm that both services are active and running.

sudo systemctl status insysicom-routermgmt
sudo systemctl status insysicom-autoupdate

Should the autoupdate service not be running, try restarting it.

sudo systemctl restart insysicom-autoupdate

Visit the icom Router Management Server (On-Premises) web interface and check the version number in the system information menu or use curl to do so.

curl http://localhost:9203/api/admin/software-version