Upgrading Contrail Command using Backup Restore Procedure

Run the following docker exec contrail_command command on the Contrail Command node to backup the DB.

Contrail Networking Release 2005 or later:

docker exec contrail_command commandutil convert --intype rdbms --outtype yaml --out /etc/contrail/db.yml -c /etc/contrail/command-app-server.yml; mkdir ~/backups; mv /etc/contrail/db.yml ~/backups/

Contrail Networking Release 2003 or earlier:

docker exec contrail_command contrailutil convert --intype rdbms --outtype yaml --out /etc/contrail/db.yml -c /etc/contrail/contrail.yml; mkdir ~/backups; mv /etc/contrail/db.yml ~/backups/

Specify the desired version of Contrail Command container (container_tag) in the deployer input file (command_servers.yml) and deploy playbook.

You must use PostgreSQL in the command_servers.yml file.

The step depends on how you have deployed the Contrail Command.

• Contrail Command is deployed using docker installation:

  docker run -td --net host -v <ABSOLUTE_PATH_OF_COMMAND_SERVERS_FILE>:/command_servers.yml --privileged --name contrail_command_deployer_<contrail_container_tag> hub.juniper.net/contrail/contrail-command-deployer:<<contrail_container_tag>

• Contrail Command is deployed through juju-charms:

  juju config contrail-command image-tag=<contrail_container_tag>

  After entering this command, enter the juju config contrail-command image-tag command to ensure the Contrail Command container is associated with the new image tag.

  If the command output displays the old image tag, wait several minutes then retry the juju config contrail-command image-tag command.

  If the command output displays the new image tag, proceed to the next step. If the command output continues to display the old image tag, re-enter the juju config contrail-command image-tag=contrail_container_tag to upgrade the container.

The contrail_container_tag for any Contrail Release 20 software can be obtained from README Access to Contrail Networking Registry 20xx.

Contrail Networking Release 2005 or later:

Migrate the yaml formatted db dump to the new database schema:

docker exec contrail_command mkdir /root/backups 
docker cp /root/backups/db.yml contrail_command:/root/backups/ 
docker exec contrail_command commandutil migrate --in /root/backups/db.yml --out /root/backups/db_migrated.yml

Contrail Networking Release 2003 or earlier:

Modify the yaml-formatted db dump by adding or removing the fields per the new database schema.

Contrail Networking Release 2005 or later:

docker exec contrail_command commandutil convert --intype yaml --in /root/backups/db_migrated.yml --outtype rdbms -c /etc/contrail/command-app-server.yml

Contrail Networking Release 2003 or earlier:

docker exec contrail_command mkdir /root/backups docker cp /root/backups/db.yml contrail_command:/root/backups/
docker exec contrail_command contrailutil convert --intype yaml --in ~/backups/db.yml --outtype rdbms -c /etc/contrail/contrail.yml