The DNA Spaces Connector can also be accessed via the command line interface.You can use the interface for the following tasks:

• Upgrading the DNA Spaces Connector to a specified image. You can download an DNA Spaces Connector upgrade image from cisco.com (CCO).  The image can be downloaded to any location on the virtual machine (VM).  Note that the DNA Spaces Connector upgrade image is different from the OVA file used deploy the DNA Spaces Connector.
  
• Rolling back the DNA Spaces Connector to a previous version.
  
• Generating a fresh SSL certificate. 

Command: connectorctl upgrade image

Description: This command upgrades the DNA Spaces Connector using the image specified as a parameter.

Parameters: Upgrade image downloaded from CCO

Example:

[cmxadmin@connector ~]$ connectorctl upgrade connector-215.comxconnector

Command: connectorctl rollback

Description: This command is used when upgrade fails and you must roll back to the previous image.  

Parameters: None

Example:

[cmxadmin@connector ~]$ connectorctl rollback

Command: connectorctl generateCert

Description: This command generates a new SSL certificate.

Parameters: None

Example: 

[cmxadmin@connector ~]$ connectorctl generateCert
Generating RSA private key, 2048 bit long modulus
........
......
e is 65537 (0x10001)
Signature ok
subject=/C=US/ST=CA/L=San Jose/O=Cisco/CN=localhost
Getting Private key
generateCert successful.

Command: connectorctl setProxyCert certificate

Description: This command sets the HTTPS proxy’s certificate.  parameter is the certificate file name.

Parameters: File name of Certificate

Usage Guidelines: User must first copy the certificate file into any folder (on the VM) that the cmxadmin user can access, before running the command.

Example: 

[cmxadmin@connector ~]$ connectorctl setProxyCert cert.pem 
New cert exists.
Restarting connector container ...
Connector container was restarted.
setProxyCert successful.

Command: connectorctl help

Description: This command displays the commands available on the DNA Spaces Connector command line interface.

Parameters: None

Example: 

[cmxadmin@connector ~]$ connectorctl help
connectorctl upgrade {image}               Upgrade to the given image
connectorctl rollback                      Rollback to the previous image
connectorctl generateCert                  Generate new SSL certificate
connectorctl help                          Show help message for the command line tool