Step 1 - Set up Service Account for Cisco Meeting Server (CMS)

To utilize CMS meeting and user reporting APIs, a service account with read-only administrator access must be created:

1. SSH into the CMS box using any convenient command line utility.
2. Login with the Administrator account (e.g. admin@10.10.10.200).
3. Enter the following command: user add vyopta_svc api
4. Type in the vyopta_svc user account password.

Note: By default, CMS provisions new account passwords with a 180-day duration, meaning that you will need to update the password on the service account twice yearly. If your corporate service account policies permit, you may want to extend this default duration before adding the vyopta_svc account.

To change the default user account password duration, after logging into the CMS command line interface with your administrator account, but before adding the vyopta_svc account, enter the following command:

user rule password_age NNNN

where NNNN is the number of days before a password expires. So to set the default expiration to yearly, enter:

user rule password_age 1825

If you have already added the Vyopta service account but want to extend its expiration duration, you still enter the above command, followed by:

passwd vyopta_svc

You'll then be prompted to confirm your administrator password to allow you to do this, then simply reenter the existing password on the vyopta_svc account. It does not need to change to be refreshed -- and if you do change it, you will need to update it on the Vyopta apps management portal.

5. To verify that the API role is set (and the password expiration, if changed), enter the following command: user list 
6. Close the SSH session.
   
   Figure 1-1: CMS User Account Information

Step 2 - Add a CMS Connector

To add a CMS Connector requires the following:

• Access to your organization’s CMS Webpage from the Vyopta Data Collector
• Credentials for the CMS read-only API service account established in the previous step (Section 1, Set up a Service Account for Cisco Meeting Server (CMS))

Please follow the instructions below to add the CMS instance:

1. Navigate to  the Vyopta Admin Portal and log in with your Vyopta credentials
2. Select the Infrastructure menu or Icon, then select New Infrastructure
3. From the selection of infrastructure types, click +CMS
   
   
   
4. Fill in the connection and account details for your CMS:
   
5. Name: Enter a user friendly name
   Description: Enter the server description
   Host Address: Enter either the IP address or the URL for the server
   Host Port: Enter the host port (typically port 443)
   Login: Enter the username for the service account created in Step 1
   Password: Enter the password for the service account created in Step 1
   Protocol: Select either HTTP or HTTPS
6. Click save and save the configuration settings.
7. A new menu will now appear, allowing you to specify the parameters of the CMS server
   
8. Server Type: Select VM, X2, or X3
   Max 720P Calls: Enter the maximum number of 720P calls supported
   Media Tokens Limit: Enter the number of media tokens if needed
   Server Media Load Limit: Enter the server media load limit
   Select the option for CMS is Edge Only if necessary
   
   Note: If you are on a fractionally licensed X2 / X3 then please add as a VM instead and specify your max concurrent HD calls.
   
   
9. At this point, select save, and enable the server by clicking the slider button at the top of the configuration window. The system will attempt to connect to and validate the CMS server. Once validated, a URL link will be displayed for the CDR forward URL. Copy this and paste it into the CDR Forward URL field under CMS settings.
   
10. For Acano versions prior to 1.8 or for deployments which require more than 2 CDR streams, please contact support@vyopta.com

Note: Port 22280 is the default port over which the Vyopta Data Collector will listen for inbound CMS CDR data. If this port is not open in your network environment then you can Submit a ticket

Cisco Meeting Server (CMS) Reference Table