Software Update Procedure

WARNING

Before proceeding, the following documentation needs to be reviewed and completed Login to Netaxis Docker Registry

The following chapters describe the generic update procedure for the Self Care Portal when deployed in a Docker environment. Be sure to refer to the specific version release notes for any additional instructions or requirements related to that version.

In order to find the configuration file of the docker containers, run the docker ps command and

bash

docker inspect <docker container name> | grep "com.docker.compose.project.config_files"

It will give us the location of the docker-compose file, which in our case is :

bash

com.docker.compose.project.config_files": "/opt/apio_core/docker-compose.yml

Move to the /opt/apio_core directory and make a backup of the docker-compose.yml file.

bash

[root@core-app-1 apio_core]# cd /opt/apio_core/
[root@core-app-1 apio_core]# cp docker-compose.yml docker-compose.yml.bak.20250312

WARNING

if the machine is air-gapped or cannot reach the internet, you can do the following instead.

In a machine that currently has access to the internet, pull the image as you normally would and use the following command to save it : docker save image-name > name_of_file.tar.gz You can then, transfer the TAR file into the air gapped machine and use the following command to load it into Docker docker load -i name_of_file.tar.gz

check that it is correctly loaded with docker image ls | grep image-name

Edit the docker-compose.yml file and update the tag version of the image.

bash

...
ucch:
    image: distribution.bxl.netaxis.be/apio_bsft/roger:4.2.1
    restart: always
    ports:
      - "0.0.0.0:443:443"

    volumes:
      - ./log/ucch-nginx:/var/log/nginx
      - /opt/portals/uc_controlhub/etc/nginx/conf.d/ucch.conf:/etc/nginx/conf.d/ucch.conf
      - /opt/portals/uc_controlhub/etc/nginx/conf.d/netaxis.conf:/etc/nginx/conf.d/netaxis.conf

...

Stop the running containers.

bash

[root@core-app-1 apio_core]# docker compose down
[+] Running 6/6
 ✔ Container apio-ucch-1  Removed                                                   3.4s
...

Bring up the new services based on the updated docker-compose.yml configuration by running the following command:

[root@core-app-1 apio_core]# docker compose up -d
[+] up 18/18
 ✔ Image distribution.bxl.netaxis.be/apio_bsft/roger:4.2.1 Pulled                                                                                                                                                     25.9s
 ✔ Network apio-default                           Created                                                                                                                                                    0.0s
 ✔ Container apio-ucch-1                          Started                                                                                                                                                    0.1s

Ensure that all the services are up and stable by checking the status of the containers.

bash

[root@core-app-1 apio_core]# docker compose ps
NAME                    IMAGE                                             COMMAND                  SERVICE     CREATED          STATUS          PORTS
3f5e21269c34   distribution.bxl.netaxis.be/apio_bsft/roger:4.2.1      "/docker-entrypoint.…"   4 weeks ago   Up 2 weeks   0.0.0.0:8000->80/tcp, 0.0.0.0:9443->443/tcp, 0.0.0.0:2443->8443/tcp   apio-ucch-1

Software Update Procedure ​

Software Update Procedure