Step 1

In your Docker-capable machine, create a directory where you will store all the files you will use during this installation.

Step 2

Download the OVA file containing the Crosswork Network Controller package from cisco.com to the directory you created. It will contain the Crosswork tar.gz CAPP file, the CWM .ova file, the install.sh installation script, the configuration.json file and Docker installer image tar.gz (along with this instruction).

Step 3

Import the Docker installer image by running the following command. Be sure to adjust the image name as needed:

docker image import <docker-image-name>.tar.gz your-image-name:your-tag

Step 4

Inside the directory, create a .txt file and paste the VMware installation template given below. For this instruction, we'll name the file deployment.tfvars.txt for example purposes.

Cw_VM_Image = ""    # Line added automatically by installer.
ClusterIPStack        = "IPv4"
DataIPNetmask         = "255.255.255.0"
DataIPGateway         = "192.168.1.1"
DNS                   = "DNS"
DomainName            = "domain_name"
CWPassword            = "your_crosswork_password"
VMSize                = "XLarge"
vm_sizes = {
        "xlarge" = {
                vcpus           = 24
                cpu_reservation = 24000
                //Memory in Mbytes
                memory = 128000
        }
}
NTP                   = "ntp.esl.cisco.com"
Timezone              = "Europe/Paris"
EnableSkipAutoInstallFeature = "True"
ManagementVIP     = "your_mgmt_vip"
ManagementIPNetmask = "255.255.255.0"
ManagementIPGateway = "your_mgmt_gateway"
ThinProvisioned = "true"
DataVIP           = "your_data_vip"
CwVMs = {
"0" = {
    VMName                = "your_VM_name",
    ManagementIPAddress = "your_mgmt_ip",
    DataIPAddress       = "your_data_ip",
    NodeType               = "Hybrid"
}
}
VCenterDC = {
VCenterAddress = "your_vcenter_address",
VCenterUser = "your_username",
VCenterPassword = "your_password",
DCname = "your_datacenter_name",
MgmtNetworkName = "VM Network",
DataNetworkName = "SVM Data Network"
VMs = [{
    HostedCwVMs = ["0"],
    Host = "your_VM_host",
    Datastore = "your_VM_datastore",
    HSDatastore = "your_VM_hsdatastore"
  }
]
}
SchemaVersion = "7.1.0" 

Step 5

Edit the parameters to match your deployment.

Step 6

Inside the directory, create another file named product.json file and paste the data below.

{
"product_id": "CWM",
"attribute": {
    "key1": "value1",
    "key2": "value2"
}
} 

Step 7

Open the configuration.json file and provide the following parameters to match your deployment:

{
    "SVM_NAME": "your_VM_name",
    "host": {
        "remote_user": "your_username",
        "remote_password": "your_password",
        "remote_host": "your_scp_host",
        "remote_port": "22",
        "capp_file": "/path/to/capp_file.tar.gz"
    },  

    "cwm_login": {
        "ip": "your_mgmt_ip",
        "cwm_user": "admin",
        "cwm_old_password": "admin",
        "cwm_password": "your_new_password"
    },
    "deployment": {
        "tfvars_path": "/path/to/deployment.tfvars.txt",
        "ova_file": "/path/to/cwm.ova",
        "product_json": "/path/to/product.json"
    }
}

1. for host, provide the details of the SCP server where your Crosswork CAPP file is located like host address and port, your username and password, and the path to the file.

2. for cwm_login, provide your management IP and the default Crosswork username and password. In cwm_password, provide the new password to replace the default one upon installation completion.

3. for deployment, provide the local paths to the deployment.tfvars.txt created in a previous step, to the CWM OVA file and to the product.json file.

Step 8

From the directory, run the installer script:

bash install.sh

Step 9

To follow the installation inside the Docker container, run the following command:

sudo docker ps -a

sudo docker logs your_container_id -f

Step 10

Once the installation script is done and the deployment status reaches 100%, go to http://your_mgmt_vip_address:30603 and log in with the default admin user and the password you provided in configuration.json.