Space List

Introduction

The SpaceList tool produces lists of Spaces and, optionally, also allows Spaces on CMS to be deleted.

The Space lists are logged; each list is also written to a csv file.

The lists produced are:

• A list of Spaces created by VQCM
• A list of all the Spaces on CMS
• A list of all the Spaces on CMS not created by VQCM

A typical usage pattern is that customers want to “clean-up” Spaces that have been created on CMS by Cisco Meeting App users.

Contacting Support

CAUTION: We strongly recommend that the first time you use this tool, you do so under guidance from our customer support team. Please contact support@vqcomms.com

Before you start

Please back-up your VQ Conference Manager (either by exporting the database or via a VM Snapshot) and your CMS Call Bridges.

Running SpaceList

Note: SpaceList must be run with Administrator permissions.

Installing SpaceList

1. Download SpaceList (VQCM 3.12.x) from our VQ Customer Portal

2. Unzip it into a convenient folder

3. In the folder, you will find a configuration file “Config”. It will look like this:

   Configuration file example

   {
     “VQCM”: {
       “Fqdn”: “vqcm.mydomain.com”,
       “Authorization”: {
         “LoginFqdn”: “login.mydomain.com”,
         “Client”: {
           “ClientId”: “MyClientId”,
           “Secret”: “squirrel”
         }
       }
     },
     “CallBridge”: {
       “Ip”: “192.168.1.10”,
       “Https”: true,
       “Username”: “username”,
       “Password”: “password”
     }
   }
   

   Please open it using WordPad (the file was created on a Linux system and doesn’t have line breaks; it is difficult to read the file using NotePad).

Usage

Running SpaceList without any arguments results in SpaceList producing 3 csv files:

File Name	Description
CmCreatedSpaces.csv	A list of all the Spaces created by VQCM.
SpacesOnCms.csv	A list of all the Spaces on the CMS node
CmsCreatedSpaces.csv	A list of all the Spaces not created by VQCM. Use this file to identify the CMS Create Spaces you want to delete; remove the Spaces you want to keep and then run SpaceList a second time, passing in the list of Spaces to delete, via the "-f" argument and the file name containing the Spaces to delete. SpaceList will then delete all the Spaces listed in the file.

Running SpaceList with the "-f" argument results in SpaceList deleting all of the Spaces contained within the .csv file from CMS.

Configuration option descriptions

Parameter	Description	Note
Fqdn	The FQDN for VQ Conference Manager
LoginFqdn	The FQDN for VQ's Identity Server
ClientID	The ClientId configured in VQCM-Admin
Secret	The Secret configured in VQCM-Admin
CallBridge	The IP address and CMS API username/password	https will normally be true

 

Command line arguments
-f	Filename.csv containing list of Spaces to delete from CMS
-s	Skip “are you sure” prompt. Useful when running the utililty as an automated script.