Installation and Upgrade Guide for Cisco Unified MeetingPlace Express Release 1.2
Logging in to Cisco Unified MeetingPlace Express

Table Of Contents

Logging in to Cisco Unified MeetingPlace Express

About Interfacing with Cisco Unified MeetingPlace Express

About the root and mpxadmin Users

root User

mpxadmin User

About the Command-Line Interface (CLI)

Logging in to the CLI Using the Console

Logging in to the CLI Using SSH

About CLI Commands

Running Operating System CLI Commands

Running Application CLI Commands

About Logging in to the Cisco Unified MeetingPlace Express Application as a System Administrator

Logging in to the Cisco Unified MeetingPlace Express Administration Center

Changing the Default Web Password for the System Administrator

Logging in to the Cisco Unified MeetingPlace Express Telephone User Interface


Logging in to Cisco Unified MeetingPlace Express


This chapter describes how to log in to Cisco Unified MeetingPlace Express. Topics in this section include:

About Interfacing with Cisco Unified MeetingPlace Express

About the root and mpxadmin Users

About the Command-Line Interface (CLI)

About CLI Commands

About Logging in to the Cisco Unified MeetingPlace Express Application as a System Administrator

About Interfacing with Cisco Unified MeetingPlace Express

There are several different ways to interact with Cisco Unified MeetingPlace Express, including the following:

End-User Interfaces

End users use the End-User Interface on the web, the telephone interface, and the Cisco Unified MeetingPlace Express service (a screen-based interface on the Cisco Unified IP Phone) to schedule and attend meetings, among other things. For complete information about end-user functionality, see the User Guide for Cisco Unified MeetingPlace Express Release 1.2 and the User Guide for Microsoft Outlook Operating with Cisco Unified MeetingPlace Express Release 1.2.

Administration Center

The Administration Center is a web-based interface for system administrators. Here they can configure, maintain, and customize the Cisco Unified MeetingPlace Express application. For complete information about the Administration Center, see the Configuration and Maintenance Guide for Cisco Unified MeetingPlace Express Release 1.2.

Console

System administrators may occasionally need to configure advanced network features and can use the console for this. You can log in to the console in two ways: as mpxadmin or as a root user. See the "About the root and mpxadmin Users" section for more information on these two user types.

Command-Line Interface (CLI)

The Command-Line Interface (CLI) is used to run certain commands. Most of the functionality performed by these commands have been built in to the Cisco Unified MeetingPlace Express Administration Center so that a system administrator can perform the same functions without using the CLI.

About the root and mpxadmin Users

There are two types of administrative users: the root user and the mpxadmin user.

root User

The root user has the highest authority.

For security reasons, we do not recommend logging in directly as the root user. In the Cisco Unified MeetingPlace Express environment, we recommend that you only log in as the root user if you need to reset the root user or mpxadmin user passwords, if you need to run the infocap report, or if you need to uninstall the system.

To get to the root user level, log in as the mpxadmin user and enter su at the command line.

mpxadmin User

The mpxadmin user should be used whenever possible.

About the Command-Line Interface (CLI)

You can log into the CLI from the console and you can log into the CLI remotely using the SSH function. See the following sections:

Logging in to the CLI Using the Console

Logging in to the CLI Using SSH

Logging in to the CLI Using the Console

The console is the monitor and keyboard that are directly attached to the Cisco MCS server where your Cisco Unified MeetingPlace Express system resides.

You can log in to the CLI from the console using either the mpxadmin user or root user IDs. This is the only way you can log in directly as the root user. You can enter operating system CLI commands here.

Follow these steps to log in to the CLI using the console:

Procedure


Step 1 Go to the monitor associated with the Cisco MCS server where you installed the Cisco Unified MeetingPlace Express operating system.

The Cisco Unified MeetingPlace Express operating system login page is displayed.

Step 2 For the username, enter mpxadmin.

Step 3 Enter the password for the mpxadmin user. This was established during installation.

The Cisco Unified MeetingPlace Express operating system desktop appears.

Step 4 Right-click on the desktop and select New Terminal.

A command window appears. You can start entering commands. This is a Linux operating system so all commands should be either Linux commands or Cisco Unified MeetingPlace Express operating system CLI commands. See the "Running Operating System CLI Commands" section for information about the operating system CLI commands.

Step 5 When you are finished with the command window, either enter exit or click the X in the top right corner.


Note Always log out of the Cisco Unified MeetingPlace Express operating system when you are finished.



Logging in to the CLI Using SSH

Only the mpxadmin user can log in to the CLI remotely using SSH. If needed, you can later switch to the root user by entering su.

You need a remote connection with a non-configurable terminal emulation program, such as the Windows SSH client, to log in to the CLI remotely using SSH.

The following is an example of how to log in to the CLI using SSH:

Procedure


Step 1 Go to Start > Programs > SSH Secure Shell > Secure Shell Client.

Step 2 Click Quick Connect.

Step 3 In the Connect to Remote Host dialog box, enter the following values:

Host Name: IP address of your Cisco Unified MeetingPlace Express system

User Name: mpxadmin

Port Number: 22

Authentication Method: leave as <Profile Settings>

Step 4 Click Connect.

Step 5 In the Enter Password dialog box, enter the password for the mpxadmin user. This was established during installation.

Step 6 Click OK.

The system displays the command line and you can now enter commands.


About CLI Commands

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

Running Operating System CLI Commands

Running Application CLI Commands

Running Operating System CLI Commands

The operating system CLI contains the commands listed in Table 6-1.

Table 6-1 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 6-2 lists the application CLI commands.

Table 6-2 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. 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

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. Every bug report should include this information. Run this command immediately after the event in question occurs, preferably within a day and definitely before restarting the system.

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 logging in to the Cisco Unified MeetingPlace Express application and going to the Administration Center. Click Services > Logs > View System Information Capture. Only use this CLI command if you are unable to get the information from the Cisco Unified MeetingPlace Express Administration Center.

Note 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 locale ID, the language code, the locale order, the locale name, the country code, and the locale version number.

Syntax: langinfo

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

swstatus

Displays information about Cisco Unified MeetingPlace Express, such as the version number, the system mode, and the status of the power supplies, as well as the list of software modules loaded in to memory and their version number and 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

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.

Note You cannot set the user ID called admin 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.


About Logging in to the Cisco Unified MeetingPlace Express Application as a System Administrator

The previous sections describe how to log in to and use the Cisco Unified MeetingPlace Express operating system. This section describes how to log in as a system administrator to the Cisco Unified MeetingPlace Express application and how to change the web password for the system administrator.

For complete information about using the Cisco Unified MeetingPlace Express Administration Center, see the Configuration and Maintenance Guide for Cisco Unified MeetingPlace Express Release 1.2.

Topics in this section include:

Logging in to the Cisco Unified MeetingPlace Express Administration Center

Changing the Default Web Password for the System Administrator

Logging in to the Cisco Unified MeetingPlace Express Telephone User Interface

Logging in to the Cisco Unified MeetingPlace Express Administration Center

Follow the steps in this procedure to log in to the Cisco Unified MeetingPlace Express Administration Center as a system administrator for the first time.

Procedure


Step 1 On the desktop, double-click the Cisco Unified MeetingPlace Express icon.

The system should bring up the Cisco Unified MeetingPlace Express application Attend page.

Step 2 From the menu bar at the top of the page, click Log In.

Step 3 On the Log In page, enter the following information:

Field
Value to Enter

Username

admin

Password

cisco



Note The password is case-sensitive.


Step 4 Click Log In.

Step 5 From the menu bar at the top of the page, click Administration.


Changing the Default Web Password for the System Administrator

For security reasons, because the default password is published, we strongly encourage you to change the password for the system administrator.

Procedure


Step 1 Log in to the Administration Center of the Cisco Unified MeetingPlace Express application. See the "Logging in to the Cisco Unified MeetingPlace Express Administration Center" section for complete details.

Step 2 On the left, click User Configuration > User Profile Management.

Step 3 Under Select Search Rule, enter admin in the Begins with field and click Search.

Step 4 Click edit.

Step 5 In the User password field, enter a new password. Confirm the new password by entering it again in the User password confirm field.

Step 6 Click Save.



Note Another way of changing the default password for the system administrator is described in the Troubleshooting Guide for Cisco Unified MeetingPlace Express Release 1.2.


Logging in to the Cisco Unified MeetingPlace Express Telephone User Interface

Follow the steps in this procedure to log in to the Cisco Unified MeetingPlace Express Telephone User Interface (TUI) as a system administrator for the first time. You can use any phone to do this.

Procedure


Step 1 Use any phone to call your Cisco Unified MeetingPlace Express system.


Note If you are unsure of the number to call, log in to Cisco Unified MeetingPlace Express on the web. The system displays the phone number to call in the top right corner.


Listen to the welcome announcement and menu options.

Step 2 To access your profile, press 2#.

Step 3 When prompted to enter your profile number, enter 0001#. This is the profile number for the system administrator.

Step 4 When prompted to enter your profile number PIN, enter 24726#.