Install Applications

This chapter details the installation steps for the Crosswork Workflow Manager and CWM Solutions CAPPs.

Install the Crosswork Workflow Manager CAPP

Once you have deployed Crosswork on a VMware or KVM virtual machine, you can install the Crosswork Workflow Manager (CWM) application, which is distributed as a Crosswork CAPP.

Before you begin

Ensure that you have deployed Crosswork successfully on your VMware or KVM host. To verify that Crosswork is installed and functional, log in to Crosswork using an administrative ID at https://CrossworkIP:30603/, where CrossworkIP is the IP address on the virtual machine where Crosswork was installed.

Attention

The download file names given in this topic are subject to change. You can always find the latest versions by pointing your browser to https://software.cisco.com/download/home and searching for Crosswork Workflow Manager 2.

Procedure

Step 1	On a remote host accessible by HTTP, HTTPS or SCP from your Crosswork VM host, create a storage directory to contain the download you will use in this procedure.
Step 2	From https://software.cisco.com/download/home, download to the remote host the Crosswork Workflow Manager file appropriate for the VM deployment you chose: For a VMware deployment: `cw-na-cwm-2.1.0-20-releasecwm210-260124-ova.signed.bin` For a KVM deployment: `cw-na-cwm-2.1.0-20-releasecwm210-260124-qcow2.signed.bin`
Step 3	Use the following command to extract the tar.gz installer bundle from the appropriate signed.bin file: `sh cw-na-cwm-2.1.0-20-releasecwm210-260124-ova.signed.bin` or `sh cw-na-cwm-2.1.0-20-releasecwm210-260124-qcow2.signed.bin` The contents of the installer bundle and files necessary to validate the image are extracted to the same directory on the remote host.
Step 4	Use the following command to extract the tar.gz installer bundle: `tar -vxf cw-na-cwm-2.1.0-20-releasecwm210-260124-ova.tar.gz` or `tar -vxf cw-na-cwm-2.1.0-20-releasecwm210-260124-qcow2.tar.gz` The contents of the installer bundle and files necessary to validate the image are extracted to the same directory on the remote host.
Step 5	Log in to Crosswork using an admin ID and select Administration > Crosswork Manager > Application Management.
Step 6	Click Add new file and select Upload CAPP file (.tar.gz).
Step 7	Using the Add File (.Tar.Gz) page, first select the Protocol you want to use to add the CWM CAPP file to the system. Then: If you selected URL: Enter the URL for the remote host where the CAPP file is stored (including the path to the tar.gz file). If the Basic Auth checkbox is selected, enter the Username and Password needed to access the remote host. If you selected SCP: Enter the file's Server path/Location on the remote host, the remote host server's Host name/IP address, the Port, and the login Username and Password.
Step 8	Click Add. You can select the Job History option to monitor the progress of the CAPP file upload.
Step 9	When the upload completes, the Workflow Manager tile appears on the Applications page, indicating that the application is ready to install.
Step 10	Click the More icon (three dots) on the Workflow Manager tile to display the Workflow Manager installation pop up, then click Install. When installation is complete, the Applications Management > Job History tab should display an "Activation Successful" message.
Step 11	Verify successful installation by choosing Administration > Crosswork Manager > Crosswork Health > Workflow Manager. The Microservices tab displays the microservices, all with Healthy showing in the Status column.

Install the CWM Solutions CAPP

Once you have installed CWM, you can install CWM-S.

Before you begin

Ensure that you have already installed Crosswork Workflow Manager (CWM), as explained in Install the Crosswork Workflow Manager CAPP. If you have done this, you will find the Crosswork Workflow Manager Solutions (CWM-S) installer bundle extracted to the same directory on the remote host where you extracted the Crosswork Workflow Manager (CWM) CAPP installer bundle.

Procedure

Step 1	From https://software.cisco.com/download/home, download to the remote host the Crosswork Workflow Manager file appropriate for the VM deployment you chose: For a VMware deployment: `cw-na-cwm-sol-2.1.0-21-releasecwms210-260124-ova.signed.bin` For a KVM deployment: `cw-na-cwm-sol-2.1.0-21-releasecwms210-260124-qcow2.signed.bin`
Step 2	Use the following command to extract the tar.gz installer bundle from the appropriate signed.bin file: `sh cw-na-cwm-sol-2.1.0-21-releasecwms210-260124-ova.signed.bin` or `sh cw-na-cwm-sol-2.1.0-21-releasecwms210-260124-qcow2.signed.bin` The contents of the installer bundle and files necessary to validate the image are extracted to the same directory on the remote host.
Step 3	Use the following command to extract the tar.gz installer bundle: `tar -vxf cw-na-cwm-sol-2.1.0-21-releasecwms210-260124-ova.tar.gz` or `tar -vxf cw-na-cwm-sol-2.1.0-21-releasecwms210-260124-qcow2.tar.gz` The contents of the installer bundle and files necessary to validate the image are extracted to the same directory on the remote host.
Step 4	Log in to Crosswork using an admin ID and select Administration > Crosswork Manager > Application Management.
Step 5	Click Add new file and select Upload CAPP file (.tar.gz).
Step 6	Using the Add File (.Tar.Gz) page, first select the Protocol you want to use to add the CWM Solutions CAPP file to the system. Then: If you selected URL: Enter the URL for the remote host where the CAPP file is stored (including the path to the tar.gz file). If the Basic Auth checkbox is selected, enter the Username and Password needed to access the remote host. If you selected SCP: Enter the file's Server path/Location, the server's Host name/IP address, Port, and the login Username and Password.
Step 7	Click Add. You can select the Job History option to monitor the upload while it proceeds.
Step 8	When the addition completes, the Workflow Manager Solutions tile appears on the Applications page at the far right, next to the Workflow Managertile, indicating that the Workflow Manager Solutions application is ready to install.
Step 9	Click the More icon (three dots) on the Workflow Manager Solutions tile to display the installation pop up menu, then click Install.
Step 10	When installation is completed, the Application Management > Job History tab should display an "Activation of application Workflow Manager Solutions Successful" message.
Step 11	Choose Administration > Crosswork Manager > Crosswork Health > Workflow Manager Solutions. The Microservices tab should display that the CWM Solutions microservices are in a Healthy state.
Step 12	Finally, CWM Solutions will add three dynamic service pods to CWM. These are worker pods for the three CWM adapters that CWM Solutions installed automatically. You will find them under Administration > Crosswork Manager > Crosswork Health > Workflow Manager (not under Workflow Manager Solutions).