--- title: "Upgrade auf Version 2025.03.0" slug: "upgrade-guide-to-2025030-from-2024100-icom-router-management-on-premises" tags: ["iRM", "icom Router Management", "On-Premises", "Installation"] updated: 2025-10-01T15:01:29Z published: 2025-10-01T15:01:29Z canonical: "docs.insys-icom.com/upgrade-guide-to-2025030-from-2024100-icom-router-management-on-premises" --- > ## 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 auf Version 2025.03.0 ## Preface This guide outlines the upgrade process for the icom Router Management Server (On-Premises). It assumes that a working installation of icom Router Management Server 2024.07.0 is in place, which was installed following the instructions in the icom Router Management Server (On-Premises) [Install Guide](/kb/docs/installing-icom-router-management-on-ubuntu) after July 2024. If the icom Router Management Server (On-Premises) was installed before December 2022, contact the support hotline to schedule a migration due to significant changes in the folder structure and naming conventions. ## Supported version icom Router Management Server (On-Premises) Version 2024.10.0 ## 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 Download the latest version from the link provided by the support team. Create a directory in the home directory and copy the installation archive, `irm_linux_2024_10_0.zip`, into this newly created directory. ```shell mkdir dist unzip irm_linux_2024_10_0.zip -d dist ls -aFl dist ``` The output should display the contents of the `dist` directory. - insysicom-routermgmt - insysicom-autoupdate The systemd service needs to be stopped. ```shell sudo systemctl stop insysicom-routermgmt ``` The old binary must be backed up. ```shell sudo cp /opt/insysicom-routermgmt/bin/insysicom-routermgmt /opt/insysicom-routermgmt/bin/insysicom-routermgmt.old ``` ## Upgrade process ### Upgrade application server Copy the new binary to the correct location. ```shell sudo cp ./dist/insysicom-routermgmt /opt/insysicom-routermgmt/bin ``` Mark the new binary as executable. ```shell sudo chown insysicom-routermgmt:insysicom-routermgmt /opt/insysicom-routermgmt/bin/insysicom-routermgmt sudo chmod +x /opt/insysicom-routermgmt/bin/insysicom-routermgmt ``` Configure the necessary environment variables and execute the database migration. If the default database credentials provided in the installation guide were not utilized, or if the database is hosted on a different server than the application, please refer to the correct values in the configuration file located at `/opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf`. ```shell sudo -i -u insysicom-routermgmt /opt/insysicom-routermgmt/bin/insysicom-routermgmt system upgrade -c /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf exit ``` To prepare insysicom-routermgmt for communication with insysicom-autoupdate, change the following variables to the specified values in the `insysicom-routermgmt.conf` file: ```shell sudo vi /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf ``` **/opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf** ```plaintext ... bonaventure_grpc_server_port: 50052 bonaventure_grpc_server_host: "127.0.0.1" ... ``` ### Add the new autoupdate application Copy the autoupdate binary to the correct location. ```shell sudo cp ./dist/insysicom-autoupdate /opt/insysicom-routermgmt/bin ``` Mark it as executable. ```shell sudo chown insysicom-routermgmt:insysicom-routermgmt /opt/insysicom-routermgmt/bin/insysicom-autoupdate sudo chmod +x /opt/insysicom-routermgmt/bin/insysicom-autoupdate ``` To configure the autoupdate service, you need to create an environment file in the same directory as the router management configuration file. ```shell sudo vi /opt/insysicom-routermgmt/etc/insysicom-autoupdate.env ``` Add the following content: ```plaintext AUTOUPDATE_HTTP_PORT=8082 AUTOUPDATE_GRPC_PORT=50052 AUTOUPDATE_HTTP_READ_TIMEOUT=60s AUTOUPDATE_SHUTDOWN_TIMEOUT=10s FILE_STORAGE_TYPE=filesystem ``` The permissions for the newly created environment file must be set. ```shell sudo chown insysicom-routermgmt:insysicom-routermgmt /opt/insysicom-routermgmt/etc/insysicom-autoupdate.env ``` Settings, that already exist in the router management configuration file, are added to the environment file. ```shell sudo -i -u insysicom-routermgmt echo "MASTER_KEY=$(grep -oP '(?<=barracuda_master_key: ).*' /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf)" >> /opt/insysicom-routermgmt/etc/insysicom-autoupdate.env echo "DATABASE_ARGS=\"$(grep -oP '(?<=barracuda_database_args: ).*' /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf) $(grep -oP 'dbname=.*' /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf)\"" >> /opt/insysicom-routermgmt/etc/insysicom-autoupdate.env echo "DATA_DIRECTORY=$(grep -oP '(?<=barracuda_data_path: ).*' /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf)" >> /opt/insysicom-routermgmt/etc/insysicom-autoupdate.env ``` Initialize the autoupdate application. ```shell set -a source /opt/insysicom-routermgmt/etc/insysicom-autoupdate.env set +a /opt/insysicom-routermgmt/bin/insysicom-autoupdate -migrate exit ``` Create a systemd service for the autoupdate application. ```shell sudo vi /etc/systemd/system/insysicom-autoupdate.service ``` > [!NOTE] > Please note! > > If Postgres does **not** run on the same machine, please remove the line `After=postgresql.service` from the Unit section of your service **/etc/systemd/system/insysicom-autoupdate.service** ```plaintext [Unit] Description=INSYS icom Autoupdateserver After=postgresql.service [Service] Type=simple User=insysicom-routermgmt Group=insysicom-routermgmt WorkingDirectory=/var/opt/insysicom-routermgmt StandardOutput=file:/var/opt/insysicom-routermgmt/autoupdate_stdout.log StandardError=file:/var/opt/insysicom-routermgmt/autoupdate_stderr.log SyslogIdentifier=insysicom_autoupdate EnvironmentFile=/opt/insysicom-routermgmt/etc/insysicom-autoupdate.env ExecStart=/opt/insysicom-routermgmt/bin/insysicom-autoupdate -serve [Install] WantedBy=multi-user.target ``` Enable the autoupdate service. ```shell sudo systemctl enable insysicom-autoupdate ``` ### Adapt cronjobs For the application to work correctly, the existing cronjob must be adapted and a new one has to be added. ```shell sudo crontab -e ``` Edit the existing cronjob to use the `-c` parameter. ```plaintext 30 4 * * * /opt/insysicom-routermgmt/bin/insysicom-routermgmt system fetchDeviceInfo -c /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf; ``` And add the following line to the crontab file: ```plaintext 0 0 * * * /opt/insysicom-routermgmt/bin/insysicom-routermgmt system updateLicenseStatus -c /opt/insysicom-routermgmt/etc/insysicom-routermgmt.conf; ``` ### Adapt Nginx configuration In the nginx site-configuration, edit the `/autoupdate/` location by changing the `proxy_pass` port from `9202` to `8082`. ```shell sudo vi /etc/nginx/sites-enabled/insysicom-routermgmt ``` /etc/nginx/sites-enabled/insysicom-routermgmt ```json location /autoupdate/ {        proxy_pass http://127.0.0.1:8082;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;    } ``` ### Start application server ```shell sudo systemctl start insysicom-routermgmt sudo systemctl start insysicom-autoupdate ``` ## Confirm upgrade Access the web interface of the icom Router Management Server (On-Premises) and verify the version number in the system information menu, or alternatively, utilize the `curl` command to check the version number. ```shell curl http://localhost:9203/api/admin/software-version ``` example output: ```shell {"buildVersion":"2024.10.0", ... } ```