Cisco Unified MeetingPlace Express, Release 2.x -- How to Work With CLI Commands

From DocWiki

Jump to: navigation, search

The Cisco Unified MeetingPlace Express system has a CLI that can run two types of commands: operating system CLI commands and application CLI commands.


Contents

Running Operating System CLI Commands

The operating system CLI contains the commands listed in Table: Operating System CLI Commands.

Table: Operating System CLI Commands
Command Description

mpx_sys

This is the "master" command and contains all of the other "mpx_" commands within it.


Running this command starts, stops, or restarts all Cisco Unified MeetingPlace Express services.


Syntax: mpx_sys {start | stop | restart | status} [-v]

mpx_app

Running this command starts, stops, or restarts all Cisco Unified MeetingPlace Express application services. Similar to the swstatus command.


Syntax: mpx_app {start | stop | restart | status} [-v]

mpx_db

Running this command starts, stops, or restarts all Cisco Unified MeetingPlace Express database services.


Syntax: mpx_db {start | stop | restart | status} [-v]

mpx_lm

Running this command starts, stops, or restarts all Cisco Unified MeetingPlace Express license manager services.


Syntax: mpx_lm {start | stop | restart | status} [-v]

mpx_si

Running this command starts, stops, or restarts all Cisco Unified MeetingPlace Express system infrastructure services.


Syntax: mpx_si {start | stop | restart | status} [-v]

mpx_snmp

Running this command starts, stops, or restarts all Cisco Unified MeetingPlace Express SNMP services.


Syntax: mpx_snmp {start | stop | restart | status} [-v]

mpx_tomcat

Running this command starts, stops, or restarts all Cisco Unified MeetingPlace Express Tomcat services.


Syntax: mpx_tomcat {start | stop | restart | status} [-v]

mpx_version

Running this command lists all versions of Cisco Unified MeetingPlace Express that are currently installed on your system.


Syntax: mpx_version

mpx_webconf

Running this command starts, stops, or restarts all Cisco Unified MeetingPlace Express web conferencing services.


Syntax: mpx_webconf {start | stop | restart | status} [-v]



If you are not logged in as the root user, then you must enter sudo before you can run any of these commands. For example, to stop all application services, go to the command line and enter the following:


sudo ./mpx_app stop


The preceding example assumes that you are already in the /etc/init.d directory. If you are not in that directory, the command is:


sudo /etc/init.d/mpx_app stop


Caution! Starting or stopping services using the mpx_app, mpx_db, mpx_si, mpx_tomcat, or mpx_webconf commands may cause unpredictable results on the Cisco Unified MeetingPlace Express server. Do not execute these commands unless you have been explicitly told to do so by Cisco TAC.


Because some services depend on others, if you run the mpx commands individually, you must run them in this order:

  • mpx_si
  • mpx_db
  • mpx_lm
  • mpx_app
  • mpx_webconf
  • mpx_tomcat


Running Application CLI Commands

Table: Application CLI Commands lists the application CLI commands.

Table: Application CLI Commands
Command Description

activity

Displays a quick, verbose, or complete status of all ports or for a range of ports. Allows you to make a test call and shows all conferences.


Syntax: activity

alarm

Shows the most important errors in the system, along with how many have occurred.


Syntax: alarm

ccamon

Monitors the Call Control Agent. Allows you to view the call statistics and set the log tracing level.


Syntax: ccamon

checklic

Shows the type and number of licenses installed.

Note: The system may take up to 15 seconds to process this information.


Syntax: checklic

clearalarm

Clears either all the alarms in the alarm table or just the alarm specified.


If there are any major alarms in the alarm table, the system can be configured to call the system administrator after every restart until all major alarms are deleted from the alarm table. See the Configuring the System to Call You if There is a Major Alarm for more information.


Running this command stops the system from calling the system administrator if it is configured to do so.


Syntax: clearalarm <alarm number | all >

cptrace

Lists selected portions of the call processing trace log.


Syntax: cptrace

errorlog

Displays error messages with the following information:

  • Date of the error
  • Time of the error
  • Severity (major, minor, informational, or warning)
  • Exception code
  • Brief description


Syntax: errorlog

eventlog

Displays the call processing trace log. Similar to the cptrace command.


Syntax: eventlog

exc

Displays the meaning of an exception code that was listed in the errorlog command output.


Syntax: exc [-v] <exception code>

infocap

Captures configuration details and logs from the system for a particular time period. The output file is a zip file that is stored in the /tmp directory. The system gives the exact location after compiling the information.

Note: You can also get this information by following the procedure in the Viewing the System Information Capture (Infocap) Log. Only use this CLI command if you are unable to get the information from the Cisco Unified MeetingPlace Express Administration Center.


Restriction: You must be logged in as the root user to run this command.


Syntax: infocap -b <begin date and time> -e <end date and time>

Note: The begin and end date and times must be in the format [YY]MMDDHHMM. The YY is optional and if not specified, the system uses the current year.

langinfo

Displays information about all installed locales including the following:

  • Locale ID
  • Language code
  • Locale order
  • Locale name
  • Country code
  • Locale version number


Syntax: langinfo

mtginfo

Displays information about a specific meeting. Searches for a meeting based on any of these:

  • Unique conference ID (such as 125). (This number is output by certain commands such as cptrace -C and errorlog. It uniquely identifies a meeting.)
  • Meeting ID (such as 1278). Can optionally use any of the time arguments.
  • Unique user ID (such as 0x65). (This number is output by certain commands such as userinfo. It uniquely identifies a user.) Searches for all meetings that a user has attended or been invited to.
  • Activity. Searches only for active meetings.
  • Time. Searches for all meetings valid at a certain time with the -t argument or between two times when the -s and -e arguments are used together.


Syntax: mtginfo -a <time> -c <unique conf ID> -e <end time> -m <mtg ID> -s <start time> -t <time> -u <unique user ID>

Note: The start and end times must be in the format YYMMDDHHMM. All parameters are optional. If they are not all present, the system starts processing from the right.


Examples:


mtginfo -m 1234 Looks for the meeting with the ID of 1234 at the current time


mtginfo -m 1234 -t 11 Looks for meeting with the ID of 1234 at 11 minutes after the current hour


mtginfo -m 1234 -t 1111111111 Looks for meeting with the ID of 1234 at 11:11am on Nov 11, 2011


mtginfo -a 1430 Looks for meetings that are active at 2:30pm today


mtginfo -s 1430 -e 1530 Looks for meetings that started or ended between 2:30 and 3:30pm today


mtginfo -c 123 Looks for meeting with the unique conference ID of 123


mtginfo -u 123 -t 1111 -e 1211 Looks for meetings that the user with the unique user ID of 123 is invited to between 11:11 and 12:11 today

net

Lists the current network configuration settings and allows you to change them after the system has been installed. Most changes take affect after restarting the system.


Use the net command to set the following:

  • Port configuration parameters, including the primary IP address, subnet mask, secondary IP address, default gateway, MTU, and link parameters (auto-negotiation, speed, duplex).
  • Hostnames
  • Domain name
  • DNS servers
  • NTP servers
  • Static routes


Syntax: net

SSLUtil

Configures SSL for the system, including the following:

  • Shows the current SSL configuration
  • Disables and enables SSL
  • Backs up and restores SSL configurations


Syntax: SSLUtil

swstatus

Displays information about Cisco Unified MeetingPlace Express, including the following:

  • Version number
  • System mode
  • Status of the power supplies
  • List of software modules loaded in to memory, their version number, and their status


Syntax: swstatus

taccli

Displays details on the mixer status, active meetings, participant details, and general statistics, including the following:

  • Cisco Unified MeetingPlace Express request statistics
  • Statistics or status for one or all channels
  • Statistics or details for one or all conferences
  • Mixer status, request failures, and mixer return code table


Also does the following:

  • Resets Cisco Unified MeetingPlace Express request statistics
  • Activates and deactivates tracing
  • Shows the current date and time
  • Starts and stops channel RTP recording


Syntax: taccli

userinfo

Displays information about a specific user. Searches for a user based on any of these:

  • User ID in text form (such as jsmith)
  • Profile number (such as 987-6543)
  • Unique user ID (such as 0x65). The unique user ID is output by certain commands. It uniquely identifies a user but does not display the user's name.


Syntax: userinfo < user ID | profile number | unique user ID >

userutil

Performs administrative functions for any user profile, including:

  • Displays the user ID, the user name, and the profile number for the specified user.
  • Sets a user profile to active, inactive, locked, or the group default.


Restriction: You cannot set the admin user to inactive, locked, or the group default.

  • Resets user passwords (used for the End-User Interface or Administration Center) or user profile passwords (used for the phone interface).


Syntax: userutil {-qpNailg} <user ID> [<password>]

Note: The <password> parameter is only required if you use the -p or the -N argument.

xlatinfo

Used by the auto attend feature to do the following:

  • Print the auto attend translation table.
  • Display the output of different numbers so that you can test the feature.


Syntax: xlatinfo

Rating: 0.0/5 (0 votes cast)

Personal tools