---
title: "Upgrade icom Router Management to 2025.03.0"
slug: "upgrade-guide-to-2025030-from-2024100-icom-router-management-on-premises-en"
updated: 2025-06-18T07:33:53Z
published: 2025-06-18T07:33:53Z
canonical: "docs.insys-icom.com/upgrade-guide-to-2025030-from-2024100-icom-router-management-on-premises-en"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insys-icom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/kb/docs/installing-icom-router-management-on-ubuntu) 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](/kb/docs/upgrade-postgres-database).

The PostgreSQL version can be checked using the following command:

```shell
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.

```shell
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.

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

### Upgrade preparations

Stop the insysicom-routermgmt systemd service.

```shell
sudo systemctl stop insysicom-routermgmt
```

Stop the insysicom-autoupdate systemd service.

```shell
sudo systemctl stop insysicom-autoupdate
```

Backup the old binaries.

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

```shell
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](https://cloud.insys-icom.com/ui/on-premises-binaries) 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.

```shell
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:

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

For the insysicom-autoupdate binary:

```shell
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.

```shell
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.

```shell
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.

```shell
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.

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

Change the command for `ExecStart` to the following one.

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

```plaintext
[Unit]
...

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

[Install]
...
```

Reload the systemd daemon to apply the changes.

```plaintext
sudo systemctl daemon-reload
```

### Start application server

```shell
sudo systemctl start insysicom-routermgmt
sudo systemctl start insysicom-autoupdate
```

## Confirm upgrade

Confirm that both services are active and running.

```shell
sudo systemctl status insysicom-routermgmt
sudo systemctl status insysicom-autoupdate
```

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

```shell
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.

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