Fusion for Broadworks

Appearance

Software Update Procedure ​

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

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

bash
...
ucch:
    image: docker.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 docker.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   docker.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