Upgrading Orchestrator Service Manually

1.

Download the target NDO release image.

Browse to the Nexus Dashboard Orchestrator page on DC App Center:

https://dcappcenter.cisco.com/nexus-dashboard-orchestrator.html
From the Version dropdown, choose the version you want to install and click Download.
Click Agree and download to accept the license agreement and download the image.

2.

Log in to your Nexus Dashboard.

3.

Re-enable the existing version of Nexus Dashboard Orchestrator.

If you had to disable the NDO service in order to upgrade the Nexus Dashboard platform as described in the previous section, you must re-enable it before upgrading to this release.

Note

Enabling the older version of NDO in the newer Nexus Dashboard is required for the upgrade purposes only and is not supported for production functionality. You must upgrade to NDO release 4.2(1) or later as described in the next steps before using the service after it's re-enabled.

4.

Upload the new NDO image to your Nexus Dashboard.

From the left navigation menu, select Services.
In the Nexus Dashboard's Services screen, select the Installed Services tab.
From the Actions menu in the top right of main pane, select Upload App.
In the Upload App window, choose the location of the image

If you downloaded the application image to your system, choose Local.

If you are hosting the image on a server, choose Remote.
Choose the file.

If you chose Local in the previous substep, click Select File and select the app image you downloaded.

If you chose Remote, provide the full URL to the image file, for example http://<ip-address>:<port>/<full-path>/cisco-mso-<version>.nap.
Click Upload to add the app to the cluster.

A new tile will appear with the upload progress bar. Once the image upload is completed, the Nexus Dashboard will recognize the new image as an existing application and add it as a new version.

5.

Wait for the new image to initialize.

It may take up to 20 minutes for the new application image to become available.

6.

Activate the new image.

In the OperateServices page, select the Installed Services tab.
In the top right corner of the Nexus Dashboard Orchestrator tile, click the menu (...) and choose Available Versions.
In the available versions window, click Activate next to the new image.

Note

Do not Disable the currently running image before activating the new image. The image activation process will recognize the currently running image and perform the upgrade workflows necessary for the currently running version.

It may take up to 20 additional minutes for all the application services to start and the GUI to become available. The page will automatically reload when the process is completed.

7.

Delete the old service image.

Because service downgrades are not supported, we recommend that you delete the older images from your Nexus Dashboard after you upgraded.

In the Services page, select the Installed Services tab.
In the top right corner of the Nexus Dashboard Orchestrator tile, click the menu (...) and choose Available Versions.
In the available versions window, click the delete icon next to the image you want to delete.

Before you begin

Procedure

What to do next

Need help?

	1.	Download the target NDO release image. Browse to the Nexus Dashboard Orchestrator page on DC App Center: https://dcappcenter.cisco.com/nexus-dashboard-orchestrator.html From the Version dropdown, choose the version you want to install and click Download. Click Agree and download to accept the license agreement and download the image.
	2.	Log in to your Nexus Dashboard.
	3.	Re-enable the existing version of Nexus Dashboard Orchestrator. If you had to disable the NDO service in order to upgrade the Nexus Dashboard platform as described in the previous section, you must re-enable it before upgrading to this release. Note Enabling the older version of NDO in the newer Nexus Dashboard is required for the upgrade purposes only and is not supported for production functionality. You must upgrade to NDO release 4.2(1) or later as described in the next steps before using the service after it's re-enabled.
	4.	Upload the new NDO image to your Nexus Dashboard. From the left navigation menu, select Services. In the Nexus Dashboard's Services screen, select the Installed Services tab. From the Actions menu in the top right of main pane, select Upload App. In the Upload App window, choose the location of the image If you downloaded the application image to your system, choose Local. If you are hosting the image on a server, choose Remote. Choose the file. If you chose Local in the previous substep, click Select File and select the app image you downloaded. If you chose Remote, provide the full URL to the image file, for example `http://<ip-address>:<port>/<full-path>/cisco-mso-<version>.nap`. Click Upload to add the app to the cluster. A new tile will appear with the upload progress bar. Once the image upload is completed, the Nexus Dashboard will recognize the new image as an existing application and add it as a new version.
	5.	Wait for the new image to initialize. It may take up to 20 minutes for the new application image to become available.
	6.	Activate the new image. In the OperateServices page, select the Installed Services tab. In the top right corner of the Nexus Dashboard Orchestrator tile, click the menu (`...`) and choose Available Versions. In the available versions window, click Activate next to the new image. Note Do not Disable the currently running image before activating the new image. The image activation process will recognize the currently running image and perform the upgrade workflows necessary for the currently running version. It may take up to 20 additional minutes for all the application services to start and the GUI to become available. The page will automatically reload when the process is completed.
	7.	Delete the old service image. Because service downgrades are not supported, we recommend that you delete the older images from your Nexus Dashboard after you upgraded. In the Services page, select the Installed Services tab. In the top right corner of the Nexus Dashboard Orchestrator tile, click the menu (`...`) and choose Available Versions. In the available versions window, click the delete icon next to the image you want to delete.

Overview

Before you begin

Procedure

What to do next

Need help?