Deployment and Management Guide for Cisco IoT FND on OVA with Postgres and InfluxDB, Release 5.x.x and Later

PDF

Upgrade Cisco IoT FND container images

Updated: February 4, 2026

Overview

Use this procedure to upgrade Cisco IoT FND container images by downloading the latest versions and reloading the containers using the provided upgrade script on your IoT server. This ensures your deployment stays current and secure.

Procedure

1.

Open the SSH terminal and log in to Cisco IoT server as a root user.
2.

Run the following script:

Example:

/opt/fnd/scripts/upgrade.sh 
[root@iot-fnd ~]# /opt/fnd/scripts/upgrade.sh
            This script must be run with root privileges.
            Usage: Load container images: No resource required
            For container reload: No resource required
            1) Load container images
            2) Container reload
            3) Quit
            Enter your choice: 1
            Do you want to download docker image from registry (y/n)?y
            Enter docker registry [devhub-docker.cisco.com]: dockerhub.cisco.com
            Enter docker image tag: 5.0.2-8
            Downloading FND docker image...
            5.0.2-8: Pull complete
            ea3c714182eb: Pull complete
            177abefb5b93: Pull complete
            e696bdc28724: Pull complete
            89dd87262f50: Pull complete
            ff6164c0609f: Pull complete
            89a0b2205b62: Pull complete
            4dbd23bb6e45: Pull complete
            Digest: sha256:2ae8a3cba38ea28156a2c3db55cd8cea0448888a7704479cac33b665d8b2a132
            Status: Downloaded newer image for dockerhub.cisco.com/field-network-director-dev-docker/fnd-image:5.0.2-8
            dockerhub.cisco.com/field-network-director-dev-docker/fnd-image:5.0.2-8
            Downloading Fog Director docker image...
            5.0.2-8: Pulling from fog-director-dev-docker/fogd-image
            5e9a6732a7a3: Pull complete
            55a104320bff: Pull complete
            506e5a93cf62: Pull complete
            9b2523a38071: Pull complete
            8e8389537d47: Pull complete
            e6fcef979884: Pull complete
            e2e278b80221: Pull complete
            63bc79650477: Pull complete
            Digest: sha256:16f3227fbac74804f1e2a77aa57ebeeb5b9f05eb4efb0ddccf242865fe673634
            Status: Downloaded newer image for dockerhub.cisco.com/fog-director-dev-docker/fogd-image:5.0.2-8
            dockerhub.cisco.com/fog-director-dev-docker/fogd-image:5.0.2-8
            1) Load container images
            2) Container reload
            3) Quit
            Enter your choice: 2
            Stopping FND container...
            fnd-container
            Remove FND container...
            fnd-container
            Prune Docker container...
            Starting FND container...
            a02e6388607d79504f082dccf179514e5dc2d6bcd34021beac21baf1a555c266
            Stopping Fog Director container...
            fogd-container
            Remove Fog Director container...
            fogd-container
            Prune Docker container...
            Starting Fog Director container...
            a40aa29e2392e1e99a5f024d3d5838712d66ef638f0c6b0bf209b1932076611c
            1) Load container images
            2) Container reload
            3) Quit
            Enter your choice: 3
            You have new mail in /var/spool/mail/root
            [root@iot-fnd ~]#
3.

Enter 1 to load the container images.

Example:

[root@iot-fnd ~]# /opt/fnd/scripts/upgrade.sh
            This script must be run with root privileges.
            Usage: Load container images: No resource required
            For container reload: No resource required
            1) Load container images
            2) Container reload
            3) Quit
            Enter your choice: 1
            Do you want to download docker image from registry (y/n)? y
            Enter docker registry [devhub-docker.cisco.com]: dockerhub.example.com
            Enter docker image tag: 5.0-1
            Downloading FND docker image...
            5.0.2-8: Pulling from example-docker-repo/fnd-image
            a3ed95caeb02: Pull complete
            4e9f1a5e87b7: Pull complete
            bcd8f8dc5c34: Pull complete
            c5e155d5a1d1: Pull complete
            5b8c6e5e9b45: Pull complete
            b5e3b5c3f5b2: Pull complete
            f5b3c27c7f9f: Pull complete
            Digest: sha256:8d3d7b5e8d3f1c2b1e8b2f1b7c9a1234567890abcdef1234567890abcdef1234
            Status: Downloaded newer image for dockerhub.example.com/example-docker-repo/fnd-image:5.0.2-8
            dockerhub.example.com/example-docker-repo/fnd-image:5.0-1
            Downloading Fog Director docker image...
            5.0-1: Pulling from example-docker-repo/fogd-image
            9f9a1c3f5f12: Pull complete
            6c5a9f7e9b34: Pull complete
            8d5e3b3c5f6b: Pull complete
            b5f1c9e7d1b2: Pull complete
            a5c2b6e4f8e7: Pull complete
            d1e3f5b4c6d3: Pull complete
            Digest: sha256:5e8d3f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5g6h7i8j9k
            Status: Downloaded newer image for dockerhub.example.com/example-docker-repo/fogd-image:5.0.2-8
            dockerhub.example.com/example-docker-repo/fogd-image:5.0.2-8
            1) Load container images
            2) Container reload
            3) Quit
            Enter your choice: 3
            [root@iot-fnd ~]#
4.

Download the latest container image for Cisco IoT FND from devhub-docker.cisco.com.
5.

After the images are downloaded successfully, enter 2 to reload container.

Example:

[root@iot-fnd ~]# /opt/fnd/scripts/upgrade.sh
            This script must be run with root privileges.
            Usage: Load container images: No resource required
            For container reload: No resource required
            1) Load container images
            2) Container reload
            3) Quit
            Enter your choice: 2
            Stopping FND container...
            fnd-container
            Remove FND container...
            fnd-container
            Prune Docker containers...
            Deleted Containers:
            fnd-container
            Starting FND container...
            c8e1f9a8d7c2b3a4e5f6d7c8b9a0b1c2d3e4f5g6h7i8j9k0l1m2n3o4p5q6r7s8
            Stopping Fog Director container...
            fogd-container
            Remove Fog Director container...
            fogd-container
            Prune Docker containers...
            Deleted Containers:
            fogd-container
            Starting Fog Director container...
            b7c6d5e4f3g2h1i0j9k8l7m6n5o4p3q2r1s0t9u8v7w6x5y4z3a2b1c0d9e8f7g6
            1) Load container images
            2) Container reload
            3) Quit
            Enter your choice: 3
            [root@iot-fnd ~]#
6.

Enter 3 to quit the menu.

You've upgraded the Cisco IoT FND containers.