How To Update DNIF Image


We periodically release an upgrade for DNIF components on the Docker Hub repository.

You can easily upgrade your DNIF images by following these steps:

Check Your Existing Version

Before you start your upgrade process, you can check for the existing version of DNIF installed on your system by executing this command:

#docker images

You should get output that looks like this:

Check for existing version of DNIF

Stopping Your DNIF Container

Before you start your upgrade process, you need to stop the running instance of your DNIF container by following these steps:

  • If you know where the docker-compose.yml file is present within your system, you can traverse to the folder containing the file and execute the following command:

    $docker-compose down
    

    Or, you can specify its path remotely by executing the following command:

    $docker-compose -f /path/to/docker-compose.yml down
    

    where /path/to/docker-compose.yml is the path to your docker-compose.yml file.

Upgrading your DNIF image

Next, to upgrade the existing docker-image, you can use the docker pull command. This command downloads the latest docker-image from the Docker-Hub repository into your system.

####Syntax

$docker pull image-name[:TAG]

The text [:TAG] in the above command, needs to be replaced by a specific tag number for available releases.

As per your installed component, you can checkout and select the specific version for your component from the below links and can replace the text [:TAG] with that tag number.

Available release versions as of now

You can check for available release tags on these links:

DNIF container Available release
dnif/ship-ad https://hub.docker.com/r/dnif/ship-ad/tags/
dnif/ship-ds https://hub.docker.com/r/dnif/ship-ds/tags/
dnif/ship-cr https://hub.docker.com/r/dnif/ship-ds/tags/
dnif/ship-a10 https://hub.docker.com/r/dnif/ship-ds/tags/

For Example:

To upgrade to the latest release of dnif/ship-ds container.

  $docker pull dnif/ship-ds:latest

Note - Most of the time, you’ll use this command with version TAG set to latest. This will keep you updated with the latest release of dnif-images.

To upgrade or pull specific version of dnif/ship-ds container.

$docker pull dnif/ship-ds:6.7.1

Note - In the above example, 6.7.1 is the version TAG of docker-image used to fetch or upgrade to a specific version of docker-image. This type of command is used occasionally for the scenarios, where there is a special need for specific dnif-image.

Starting Your DNIF Container

We are ready to start the running instance of your DNIF container by following these steps:

  • If you know where the docker-compose.yml file is present within your system, you can traverse to the folder containing the same and execute the following command:

    $docker-compose up
    

    Or, you can specify its path remotely by executing the following command:

    $docker-compose -f /path/to/docker-compose.yml up
    

    where /path/to/docker-compose.yml is the path to your docker-compose.yml file.