Step 1

Download the CAPP files: Navigate to cisco.com and download the signed Crosswork Network Controller tier CAPP that you require to a directory in your machine. For the purpose of these instructions, we will use the file name cnc-advantage-7.1.0-46.tar.gz-250625.tar.gz.

Step 2

(Optional) CAPP files are automatically validated in the backend when you add them to the Crosswork Network Controller UI. If the upload fails, you can manually extract and validate the CAPP file using these steps:

1. Extract the CAPP file.

   tar -xvf <signature file>
   

   Example:

   cd <folder where tar was download>
   tar -xvf cnc-advantage-7.1.0-46.tar.gz-250625.tar.gz 
   README
   cnc-advantage-7.1.0-46.tar.gz
   cw-na-cncadvantage-7.1.0-46-releasecnc710-250606.tar.gz.signature
   CW-CCO_RELEASE.cer
   cisco_x509_verify_release.py3
   cisco_x509_verify_release.py

2. Use python script to validate the signature of each file you plan to use.

   Note	Use python --version to find out the version of Python on your machine.

   If you are using Python 2.x, use the following command to validate the file:

   python cisco_x509_verify_release.py -e <.cer file> -i <.tar.gz file> -s <.tar.gz.signature file> -v dgst -sha512

   If you are using Python 3.x, use the following command to validate the file:

   python cisco_x509_verify_release.py3 -e <.cer file> -i <.tar.gz file> -s <.tar.gz.signature file> -v dgst -sha512

   Example:

   python cisco_x509_verify_release.py3 -s cw-na-cncadvantage-7.1.0-46-releasecnc710-250606.tar.gz.signature -i cnc-advantage-7.1.0-46.tar.gz.tar.gz -e CW-CCO_RELEASE.cer
   Retrieving CA certificate from http://www.cisco.com/security/pki/certs/crcam2.cer ...
   Successfully retrieved and verified crcam2.cer.
   Retrieving SubCA certificate from http://www.cisco.com/security/pki/certs/innerspace.cer ...
   Successfully retrieved and verified innerspace.cer.
   Successfully verified root, subca and end-entity certificate chain.
   Successfully fetched a public key from CW-CCO_RELEASE.cer.
   Successfully verified the signature of cnc-advantage-7.1.0-46.tar.gz.tar.gz using CW-CCO_RELEASE.cer
   

   Note	If you do not have python installed, go to python.org and download the version of python that is appropriate for your work station.

Step 3

Add the CAPP file to Crosswork Network Controller UI:

1. Log into Cisco Crosswork and in the homepage, click on Administration > Crosswork Manager. The Crosswork Summary page is displayed with Crosswork Cluster and Crosswork Platform Infrastructure tiles.

   You can click on the tiles to get more information.

2. Click on Application Management and select the Applications tab.

3. Click Add new file > Upload application bundle (.tar.gz).

   The Add Application Bundle (.tar.gz) dialog box is displayed.

4. In the dialog box, choose either URL or SCP as your preferred protocol. Based on your selection, fill in the additional fields with the required information.

   Click Add to proceed.

   Note	When installing a Crosswork Network Controller package, there is no need to untar the package. You can add the package tarball as-is to the Crosswork UI and the applications within are automatically added. You can then install the individual applications as needed.

5. The add operation progress is displayed on the Applications screen. You can also view the installation progress in the Job History tab.

   Note	When loading a Crosswork Network Controller package, the loading process may stop at 50% for a while depending on the resources your host platform has available.

   The newly added application files are displayed as tiles on the Applications screen.

Step 4

Install the Application CAPP file:

1. Click on the Install prompt on the application tile. You can also click on the tile, and select the Install option from the drop down list.

   Important

   After you install Crosswork Cluster and Crosswork Data Gateway, these Crosswork Network Controller applications must be installed in the following sequence: Element Management Functions (available in Essentials tier) Crosswork Optimization Engine (available in Advantage tier) Crosswork Active Topology (available in Advantage tier) Crosswork Service Health (available in Advantage tier)

   The application is now installed. You can observe the change in the application tile icon. Once an application is installed, all the related-resources, UI screens and menu options are dynamically loaded in the Crosswork UI.

   Note	Once an application is installed, the 90-day evaluation period will automatically start. You can register the application with your Cisco Smart Account in the the Smart License tab.

2. After an application is installed, it must be activated to become functional. The first-time installation also activates a CAPP file. However, if the activation fails after a successful installation, you can manually activate the application. To manually activate an application, click the on the application tile, and select Activate.

   Note	In a single VM deployment, applications are installed and activated automatically, eliminating the need for separate activation.

Step 5

Repeat step 3 for installing any remaining applications.

Step 6

(Optional) Click on the application tile, and select the View Details option to view details of the installed application.

Step 7

Once an application (or all applications) have been installed, check the health of the environment to make sure all the applications are healthy. It can take up to an hour for all the processes to launch and for the applications to report as healthy. If a newly installed application is not healthy after an hour, contact the Cisco Customer Experience team.

Step 1

Log into Cisco Crosswork and in the homepage, click on Administration > Crosswork Manager.

Step 2

Click the Application Management tab.

Step 3

Click Add new file > Upload auto-install (.yaml).

Step 4

Click Browse and select the auto-action file from your machine.

Step 5

Click Upload to proceed.