Update the OpenContrail nodes

Update the OpenContrail nodes¶

After you prepare the cluster model of your MCP cluster, proceed to updating the OpenContrail controller nodes and the OpenContrail vRouter packages on the compute nodes.

Warning

During the update process, the following resources are affected:

The instance(s) running on the compute nodes can be unavailable for up to 30 seconds.
The creation of new instances is not possible during the same time interval.

Therefore, you must plan a maintenance window as well as test the update on a staging environment before applying it to production.

To update the OpenContrail nodes:

Log in to the Jenkins web UI.
Verify that you do not have any unapproved scripts in Jenkins:
1. Navigate to Manage Jenkins > In-process script approval.
2. Approve pending scripts if any.
Open the Deploy - update Opencontrail 4X pipeline.

Specify the following parameters:

Parameter	Description and values
SALT_MASTER_CREDENTIALS	The Salt Master credentials to use for connection, defaults to `salt`.
SALT_MASTER_URL	The Salt Master node host URL with the `salt-api` port, defaults to the `jenkins_salt_api_url` parameter. For example, `http://172.18.170.27:6969`.
STAGE_CONTROLLERS_UPDATE	Select to update the OpenContrail controller nodes.

Click Deploy.

To update the OpenContrail vRouter packages on the compute nodes:

Log in to the Jenkins web UI.
Open the Deploy - update Opencontrail 4X pipeline.

Specify the following parameters:

Parameter	Description and values
COMPUTE_TARGET_SERVERS	Add `I@opencontrail:compute` or target the global name of your compute nodes, for example `cmp001*`.
COMPUTE_TARGET_SUBSET_LIVE	Add `1` to run the update first on only one of the nodes defined in the COMPUTE_TARGET_SERVERS field. After this stage is done, in the pipeline job console, you will be asked to continue the update the remaining nodes defined in the COMPUTE_TARGET_SERVERS field.
SALT_MASTER_CREDENTIALS	The Salt Master credentials to use for connection, defaults to `salt`.
SALT_MASTER_URL	The Salt Master node host URL with the `salt-api` port, defaults to the `jenkins_salt_api_url` parameter. For example, `http://172.18.170.27:6969`.
STAGE_COMPUTES_UPDATE	Select to update the compute nodes.

Click Deploy. For details how to monitor the deployment process, see: MCP Deployment Guide: View the deployment details.

The Deploy - update Opencontrail 4X pipeline workflow:

If STAGE_COMPUTES_UPDATE is selected, update the OpenContrail packages on the compute nodes in two iterations:
1. Update the sample nodes defined by COMPUTE_TARGET_SUBSET_LIVE.
2. After a manual confirmation, update all compute nodes targeted in COMPUTE_TARGET_SERVERS.
If STAGE_CONTROLLERS_UPDATE is selected, download a new version of controller, analytics, and analytics db containers.
Stop the running analytics and analytics db containers on nal nodes and start the updated containers.
Stop the running controller containers on ntw nodes and start the updated containers.

View Previous Section

Update Virtlet