Upgrading the Wazi Analyze container

Edit online
Before you decide to upgrade the IBM Wazi Analyze container, the following steps need to be performed to preserve the existing Java Projects and their analysis.
  1. Stop the IBM Wazi Analyze Server by following the instructions in Starting up and shutting down the server.
  2. Copy the Java Projects directory location that has been mapped into IBM Wazi Analyze. This location needs to be reused when configuring a new version of IBM Wazi Analyze container.
  3. Back up the autoDB.txt file.
    1. Start command prompt (cmd.exe) as an administrator in the environment where the IBM Wazi Analyze container is running.
    2. Execute the docker ps -a --format "{{.ID}}\t{{.Names}}" command to retrieve the ID and the name of the existing IBM Wazi Analyze container.
    3. Copy the IBM Wazi Analyze container ID and name and replace them in the following docker commands.
    4. Back up the autoDB.txt file by using the docker exec -it <container ID> bash -c "cp /home/wazianalyze/etc/autoDB.txt /home/wazianalyze/data/autoDB.txt" command.
  4. Stop or remove the old container and image if not needed anymore. At least stopping the old container is required, because the same port cannot be mapped twice if it is already mapped in a running container. Also, the same file-system path cannot be mounted in another running container.

    1. To stop a running container, use the information present on the docker stop documentation page.

    2. To remove the old container, start command prompt (cmd.exe) as an administrator in the environment where the IBM Wazi Analyze container is deployed and run:
      docker rm -f <container name or ID>
    3. To remove the old image, start command prompt (cmd.exe) as an administrator in the environment where the IBM Wazi Analyze container is deployed and run:
      docker rmi -f <docker image ID>
      Note: To see the list of all images run:
      docker images
  5. Configure the new version of IBM Wazi Analyze container and make sure to reuse the same Java Projects directory location copied in step 2.
  6. Once new version of IBM Wazi Analyze Container has been configured, restore the old autoDB.txt file that was backed up in step 3.
    1. Start command prompt (cmd.exe) as an administrator in the environment where the IBM Wazi Analyze container is running.
    2. Execute the docker ps -a --format "{{.ID}}\t{{.Names}}" command to retrieve the ID and name of the existing IBM Wazi Analyze container.
    3. Copy the IBM Wazi Analyze container ID and name and replace them in the following docker commands.
    4. Restore the autoDB.txt file by using the docker exec -it <container ID> bash -c "cp /home/wazianalyze/data/autoDB.txt /home/wazianalyze/etc/autoDB.txt" command.
  7. Restart the IBM Wazi Analyze Server by following the instructions in Starting up and shutting down the server.