You can access DNA Spaces Connector 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 a 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 to 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.cmxconnector

Command: connectorctl rollback

Description: This command is used would like to roll back to a previous image. This is especially useful when an upgrade fails.

Parameters: None

Example:

[cmxadmin@connector ~]$ connectorctl rollback

Command: connectorctl generatecert

Description: This command generates a new self-signed 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.  

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