This chapter contains the following troubleshooting topics:
• About Your Passwords, page 6-1
• About Accessing the System, page 6-3
• About Backing Up, Archiving, and Restoring Data, page 6-5
• About Common Telephone Errors, page 6-7
• About Swapping Out a Disk Drive, page 6-11
• Helpful Information, page 6-12
After reviewing this chapter, if you still have problems with Cisco MeetingPlace Express, contact
Cisco TAC. See the Guide to Cisco MeetingPlace Express Documentation and Support for information
on contacting Cisco TAC.
About Your Passwords
These sections describe procedures for resetting your passwords:
• Recovering the root Password, page 6-1
• Recovering the mpxadmin Password, page 6-2
• Recovering the System Administrator Password Used in the End-User Interface and the
Administration Console, page 6-3
Recovering the root Password
If you forget the password that you created for the root account, follow these steps to reset it:
Procedure
Step 1From a PC, go to Cisco.com and find the appropriate recovery CD image file. There are four recovery
files and all are .iso files:
• For Cisco MCS 7825I-3.0-IPC1 and Cisco MCS 7825-I1-RC1, the file is called
MCS7825IRecoveryBootImage.iso
• For Cisco MCS 7825H-3.0-IPC1 and Cisco MCS 7825-H1-RC1, the file is called
MCS7825HRecoveryBootImage.iso
OL-6665-02
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
6-1
About Your Passwords
Step 2Burn a CD-ROM with the recovery CD image file. The file must be burned as a CD image and not as a
Step 3Go to the Cisco MCS server where your Cisco MeetingPlace Express application is loaded.
Step 4Insert the CD-ROM that you just burned into the Cisco MCS server CD-ROM drive.
Step 5Reboot the server.
Step 6At the prompt, enter linux single. This tells the server to boot up in single user mode.
Step 7At the prompt, enter /root/.security/unimmunize.sh.
Step 8At the prompt, enter passwd root. This tells the server to set a new password for the user called root.
Step 9At the New password: prompt, enter a new password. For security purposes, the password is displayed
Step 4From the menu, select New Terminal. This brings up a terminal session.
Step 5At the prompt, enter /root/.security/unimmunize.sh.
Step 6At the prompt, enter passwd mpxadmin. This tells the server to set a new password for the user called
mpxadmin.
Step 7At the New password prompt, enter a new password. For security purposes, the password is displayed as
asterisks.
NoteYou may see a message that the password you entered is bad. Ignore this message.
Step 8At the Retype new password prompt, re-enter the same password again.
Step 9At the prompt, enter /root/.security/immunize.sh.
Step 10On the desktop, click RedHat > Network Services.
Step 11Click Log out.
About Accessing the System
Recovering the System Administrator Password Used in the End-User Interface
and the Administration Console
If you forget the password that you created for the system administrator account, which is used in the
Administration Center, follow these steps to reset it:
Procedure
Step 1Log in to the Cisco MeetingPlace Express operating system as the mpxadmin user.
Step 2At the password prompt, enter the mpxadmin password. (If you have forgotten the mpxadmin password,
first follow the steps in the “Recovering the mpxadmin Password” section on page 6-2.)
The Cisco MeetingPlace Express operating system desktop appears.
Step 3Right-click on the desktop.
Step 4From the menu, select New Terminal. This brings up a terminal session.
Step 5At the prompt, enter userutil -p admin <newpassword>, where newpassword is the new password.
This tells the server to set a new password for the End-User Interface and Administration Center user
called admin.
Step 6On the desktop, click RedHat > Network Services.
Step 7Click Log out.
About Accessing the System
This section describes what to do if you have problems accessing the Cisco MeetingPlace Express
system.
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
Accessing the System after Uploading the Wrong SSL Certificate or Key
To have SSL work with the Cisco MeetingPlace Express application, you must upload SSL certificates
and enable SSL. See the Administrator’s Configuration and Maintenance Guide for Cisco MeetingPlace Express Release 1.1 for information about doing this. However, if you enter the
wrong certificate or private key name and enable SSL, you cannot access the
Cisco MeetingPlace Express application and you are locked out. Follow these steps to access the
application:
Procedure
Step 1Open a web browser and navigate to http://<localhostname>:8080, where localhostname is your local
hostname.
The Cisco MeetingPlace Express application opens.
Step 2Log in to Cisco MeetingPlace Express.
Step 3At the top of the page, click Administration.
Step 4On the left side of the page:
a. Click Certificate Management.
b. Click Disable SSL.
Step 5Disable SSL by clicking Disable SSL.
Step 6Restart the Cisco MeetingPlace Express system by clicking Restart Now.
This updates the web conferencing configuration files and after the system restarts you should be able
to correctly access the Cisco MeetingPlace Express application.
Open a web browser and navigate to http://<localhostname>, where localhostname is your local
hostname.
Step 7Log in to Cisco MeetingPlace Express.
Step 8At the top of the page, click Administration.
Step 9On the left side of the page:
a. Click Certificate Management.
b. Click Enable SSL.
Step 10Enter the correct certificate or private key names.
Step 11Click Upload Certificates.
Step 12The system displays a dialog box stating that this will restart the server and to only proceed if you are
sure. Click OK to upload the certificates, update the configuration, and restart the server.
If your system still does not enable SSL, the system may have overwritten the private keys that were
created on the system during the initial Certificate Signing Request (CSR) generation. (This can happen
if you generated new CSRs.) In this situation, the recovery steps are as follows:
6-4
Procedure
Step 1Log in to Cisco MeetingPlace Express.
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
Step 2At the top of the page, click Administration.
Step 3On the left side of the page:
a. Click Certificate Management.
b. Click Generate CSRs.
Step 4Enter information in the fields.
Step 5Click Generate CSRs.
The system generates new private keys and stores them in the /usr/local/enrollment directory.
Step 6Send the new CSRs to the CA so that they can reissue the SSL certificates.
Step 7After you receive the SSL certificates from the CA, go to the Enable SSL page and upload them.
About Backing Up, Archiving, and Restoring Data
This section describes how to manually perform the following functions:
• Backing Up Data, page 6-5
• Archiving Data, page 6-6
• Restoring Data, page 6-6
Backing Up Data
Backing up data is the process of saving database files somewhere else so that they are available in case
of a system failure.You can use the Cisco MeetingPlace Express Administration Center to configure the
system to automatically back up data. However, if you want to manually back up data, follow these steps:
NoteIf automatic backup is disabled:
• Only run one backup at a time.
• Backups should be made in the correct order, so first do a L0 backup, then L1, then L2. You cannot
• Be careful when modifying the cron schedule. The cron schedule determines the order of the
Procedure
do a L2 backup immediately after running a L0 backup.
backups.
OL-6665-02
Step 1Log in to the Cisco MeetingPlace Express operating system as the mpxadmin user.
Step 2At the password prompt, enter the mpxadmin password.
The Cisco MeetingPlace Express operating system desktop appears.
Step 3Right-click on the desktop.
Step 4From the menu, select New Terminal. This brings up a terminal session.
Step 5Manually back up the data by entering the following:
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
6-5
About Backing Up, Archiving, and Restoring Data
sudo $MP_DATABASE/db-maintenance/backup.sh
Step 6On the desktop, click RedHat > Network Services.
Step 7Click Log out.
Archiving Data
Archiving is the process of storing database backup files to a remote system over the network, together
with other critical external files. You can use the Cisco MeetingPlace Express Administration Center to
configure the system to automatically archive data. However, if you want to manually archive data,
follow these steps:
Procedure
Step 1Log in to the Cisco MeetingPlace Express operating system as the mpxadmin user.
Step 2At the password prompt, enter the mpxadmin password.
The Cisco MeetingPlace Express operating system desktop appears.
Step 4From the menu, select New Terminal. This brings up a terminal session.
Step 5Manually archive the data by entering the following:
Step 6On the desktop, click RedHat > Network Services.
Step 7Click Log out.
Restoring Data
CautionYou can only restore a database that is from the same version of the Cisco MeetingPlace Express
sudo $MP_DATABASE/db-maintenance/archive.sh
Restoring data recreates the database server data from backed-up storage spaces and logical log files. You may
need to restore your data if you need to replace a failed disk that contains database server data, if there is a
logic error in a program that has corrupted the database, if you need to move your database server data to a
new computer, or if a user accidentally corrupts or destroys data.
To restore data up to the time of the failure, you must have at least one L0 backup. The restore is done using
the Informix command called ontape. Cisco MeetingPlace Express provides a script called restore.sh that
guides you through the restore process. The script is in the $MP_DATABASE/db-maintenance directory.
product. You cannot restore a database from a previous version.
6-6
The names of the databases that you are restoring from and restoring to must be the same.
Follow these steps to restore data:
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
Step 1Log in to the Cisco MeetingPlace Express operating system as the mpxadmin user.
Step 2At the password prompt, enter the mpxadmin password.
The Cisco MeetingPlace Express operating system desktop appears.
Step 3Right-click on the desktop.
Step 4From the menu, select New Terminal. This brings up a terminal session.
Step 5Shut down the Cisco MeetingPlace Express application by entering the following:
mpx_sys stop
Step 6Restore the data by entering the following:
sudo $MP_DATABASE/db-maintenance/restore.sh
Step 7On the desktop, click RedHat > Network Services.
Step 8Click Log out.
About Common Telephone Errors
About Common Telephone Errors
Here are some common errors you may encounter:
• Tips for Failed Calls, page 6-7
• Fixing Undetected Key Presses, page 6-8
• Fixing Failed Incoming Calls, page 6-9
• Fixing Dropped Calls, page 6-9
• Fixing Dead Air During Calls, page 6-10
• Fixing Dropped Packets, page 6-10
Tips for Failed Calls
The following tips should always be used when troubleshooting failed calls:
• Look for network congestion about the time of the call. This can be found via router and switch
statistics.
• Ensure that the Cisco MeetingPlace Express system is set to full-duplex with 100 Mbps network
speed.
• Ensure that the local switch port for the Cisco MeetingPlace Express system has the same
auto-negotiation setting as the Cisco MeetingPlace Express system. You can run the mii-tool
command from the CLI to see the current link setting.
• If Cisco MeetingPlace Express and the local switch (or router) are configured correctly, make sure
that the network on the other side of the switch or router is also set to 100 Mbps, full duplex.
OL-6665-02
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
6-7
About Common Telephone Errors
• Ensure that the Cisco MeetingPlace Express system is not connected to a multiple-device Ethernet
bus. The system works best if micro-segmented to use a single switch port rather than share a bus
with other devices. Sharing a bus can cause excessive collisions which reduce bandwidth and cause
unpredictable bandwidth availability.
• If there is still congestion, you may have to take standard congestion reduction measures such as
these:
–
–
–
• Get a trace of network traffic. This trace should be taken as close to the eth0 port as possible.
• Some phones provide network error statistics about how many bad frames have been received. See
if the particular phone has these statistics. If so, see if the phone has registered the reception of a
large number of bad frames.
• Verify the configuration of the device that routes calls to Cisco MeetingPlace Express.
Reduce traffic in the local LAN by adding more switches and distributing the network devices
between them.
Reduce the number of devices on the local LAN (and thus the traffic) by adding more routers to
create more (but smaller) LANs. There might also be unused ports on the local router in which
case more routers are not needed.
Change network device settings to reduce unnecessary traffic such as adding Access Control
Lists (ACLs) to the local router to filter out irrelevant traffic.
• Check for any firewalls between the phone and Cisco MeetingPlace Express that may prevent calls.
Fixing Undetected Key Presses
If you think that the Cisco MeetingPlace Express system is not detecting you when you press the keys
on your phone, try these steps:
Procedure
Step 1Log in to the Cisco MeetingPlace Express operating system as the root user.
Step 2At the password prompt, enter the root password.
The Cisco MeetingPlace Express operating system desktop appears.
Step 3Right-click on the desktop.
Step 4From the menu, select New Terminal. This brings up a terminal session.
Step 5At the CLI, enter the following:
eventlog -b<mmddhhmm> -e<mmddhhmm>
For the start time (the -b value), enter a time shortly before the call failed. For the stop time (the -e value),
enter a time shortly after the call failed.
Step 6Check the DID/DNIS and input events to determine which port is yours.
Step 7Look later in the trace to see if DTMFs sent from your phone were being detected. If they are not
detected, then check the following:
6-8
• Verify that the telephony network is using RFC 2833 digits or out-of-band digits. (The
Cisco MeetingPlace Express system does not support in-band digits.)
• Network congestion might be preventing the RFC 2833 digits or out-of-band digits from reaching
the system.
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
• Check if G.729 coders are being used somewhere in your network, instead of G.711. G.729 will
seriously corrupt in-band digits (DTMF) causing these digits to either be lost or changed. If this is
happening and RFC 2833 is not a good choice, consider converting to a pure G.711 network.
Fixing Failed Incoming Calls
If you are not able to receive incoming calls, do the following:
Procedure
Step 1Log in to the Cisco MeetingPlace Express operating system as the root user.
Step 2At the password prompt, enter the root password.
The Cisco MeetingPlace Express operating system desktop appears.
Step 3Right-click on the desktop.
Step 4From the menu, select New Terminal. This brings up a terminal session.
Step 5At the CLI, enter the following:
About Common Telephone Errors
eventlog -b<mmddhhmm> -e<mmddhhmm>
For the start time (the -b value), enter a time shortly before the call failed. For the stop time (the -e value),
enter a time shortly after the call failed.
Step 6Determine if the Cisco MeetingPlace Express system registered the call signaling packets.
• If the system registered the call, look for a reason in the trace log why the call was disconnected.
Enter one of these commands:
eventlog -b<mmddhhmm> -e<mmddhhmm> -v
eventlog -b<mmddhhmm> -e<mmddhhmm> -G -v
• If the system did not register the call in the trace log, the problem might be a configuration problem
on the device that routes calls to Cisco MeetingPlace Express. Also, check if any firewalls may be
preventing the call from reaching the system.
Fixing Dropped Calls
If calls are connected to the system, but then disconnect during the call, do the following:
Procedure
Step 1Log in to the Cisco MeetingPlace Express operating system as the root user.
Step 2At the password prompt, enter the root password.
The Cisco MeetingPlace Express operating system desktop appears.
OL-6665-02
Step 3Right-click on the desktop.
Step 4From the menu, select New Terminal. This brings up a terminal session.
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
6-9
About Common Telephone Errors
Step 5At the CLI, enter the following:
eventlog -b<mmddhhmm> -e<mmddhhmm>
For the start time (the -b value), enter a time shortly before the call failed. For the stop time (the -e value),
enter a time shortly after the call failed.
Step 6Check for a “far end disconnect event.” If you see this, the disconnect may have been initiated outside
of the Cisco MeetingPlace Express system. Check for errors on the devices between the phone and the
Cisco MeetingPlace Express system.
Step 7If you do not see a “far end disconnect event,” the Cisco MeetingPlace Express system hung up on you
first. Review the trace log to try to determine why the system hung up on you.
Step 8If your system uses Cisco CallManager contact the Cisco CallManager network administrator to get a
call session trace indicating why Cisco CallManager sent the disconnect event to you.
Fixing Dead Air During Calls
If you think that your call has been disconnected, but your phone still shows that the call is active, follow
these steps:
Step 1If you are in a meeting, enter #21 to hear a roll call of all meeting participants.
Do you hear anything?
• If yes, you have at least one-way audio (that is, you can hear but not speak).
• If you do not hear anything, either there is no audio either way or Cisco MeetingPlace Express
cannot detect your DTMF keypresses.
Step 2Provide this information to your network administrator and try to get a call session trace from
Cisco CallManager.
Fixing Dropped Packets
If you determine that packets are being dropped (as determined by RTCP statistics) or delivered with
errors and then dropped at the endpoints, consider changing the following call configuration parameters:
Procedure
Step 1Log in to Cisco MeetingPlace Express.
Step 2At the top of the page, click Administration.
Step 3On the left side of the page:
6-10
a. Click System Configuration.
b. Click Call Configuration.
c. Click Audio Parameters.
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
Step 4In the Default G.711 packet size (milliseconds) field, enter 10.
A smaller packet size reduces the damaging effect of a lost packet. However, network traffic increases
slightly.
Step 5Set the Voice activity detect field to yes.
This reduces outgoing packets to callers. The Cisco MeetingPlace Express system only transmits
packets if someone is actively speaking during a meeting. However, there might be a slight delay when
someone starts speaking causing part of their initial syllable to not be heard.
Step 6Determine how to configure the phones in your organization to use Voice Activity Detect (VAD). This
way, the phones only send packets to the Cisco MeetingPlace Express system when the phone detects
sound on your handset or headset.
Step 7Set the Maximum jitter buffer (milliseconds) field to 250.
This is the maximum value allowed. This higher value introduces more delays into conversations, but
also reduces packet loss due to sudden surges in traffic.
Step 8To maximize bandwidth, have the network administrator check that the your
Cisco MeetingPlace Express system and the local switch that your system connects to are both running
in 100 Mbps full duplex mode.
About Swapping Out a Disk Drive
About Swapping Out a Disk Drive
This section describes how to swap out a hard-disk drive on your Cisco MCS server. Each Cisco MCS
server has multiple hard-disk drives so it is possible to continue using the Cisco MeetingPlace Express
system if a hard-disk drive fails. However, there will be no redundancy and if the system goes down, you
can lose your operating system, application, and data.
Before You Begin
Step 1Determine the model number of your Cisco MCS server.
Step 2Determine which hard-disk drive on your Cisco MCS server has failed.
Step 3Order the replacement hard-disk drive. The replacement hard-disk drive must be the same model as the
one it is replacing.
Swapping Out a Disk Drive on a Cisco MCS 7825
All versions of the Cisco MCS 7825 (Cisco MCS 7825-H1-RC1, Cisco MCS 7825-I1-RC1,
Cisco MCS 7825H-3.0-IPC1, and Cisco MCS 7825I-3.0-IPC1) have front-accessible, simple-swap
SATA hard-disk drives. The SATA hard-disk drives are accessible through openings in the front bezel of
the server. If a hard-disk drive fails, schedule server downtime, power down the server, and replace the
failed SATA drive by removing it (each drive is equipped with a front latch that positively mates the drive
to the server) and replacing it with an unconfigured spare hard-disk drive.
Follow these steps to change the disk:
OL-6665-02
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
6-11
Helpful Information
Procedure
Step 1Turn off the server and all peripheral devices.
Step 2Disconnect the power cord and all external cables.
Step 3Remove the bad hard-disk drive.
Step 4Insert the new hard-disk drive.
Step 5Connect the power cord and all external cables.
Step 6Turn on the power.
Step 7Reinstall the Cisco MeetingPlace Express operating system and restore the application and your data
from a backup.
Swapping Out a Disk Drive on a Cisco MCS 7835
All versions of the Cisco MCS 7835 (Cisco MCS 7835-H1-RC1, Cisco MCS 7835-I1-RC1,
Cisco MCS 7835H-3.0-IPC1, and Cisco MCS 7835I-3.0-IPC1) support up to six Small Computer
System Interface (SCSI) hot-plug hard drives (or five hot-plug hard drives and one hot-plug tape drive)
that are configured using RAID 1. These are hot-swappable SCSI drives, so you can change them without
powering down the server.
Follow these steps to change a hard-disk drive if it fails:
/opt/cisco/meetingplace_express/application/logsContains most of the logs
/opt/cisco/meetingplace_express/application/versionsContains a directory for each version
/opt/cisco/meetingplace_express/uninstallerContains the uninstall script
/opt/cisco/meetingplace_express/database/db-maintenanceContains the backup, archive, and restore
Exception Codes
Helpful Information
files
installed
database scripts
The Cisco MeetingPlace Express system generates exception codes whenever there is an internal
problem. There are many exception codes and they are not all documented here. Instead, only those
exception codes that are meaningful and that you can possibly fix are included.
To find these error codes, run the errorlog CLI command.
Table 6-2 contains the most frequently seen and important exception codes for the
Cisco MeetingPlace Express system.
NoteSome exception codes are listed as a decimal number and others as a hexadecimal number. For
clarification, both code numbers are listed.
Table 6-2Important Exception Codes in Cisco MeetingPlace Express
Code
(Dec)
1311570x20055MAJOR Time has been set backwards.
Code
(Hex)SeverityDisplay TextComments
The system clock has been set
Some resource reservations may
be lost.
back to at least the previous
month since the last time the
Cisco MeetingPlace Express
application was running. This
can result in loss of some
resource reservation records.
Recommended Action:
Verify the system clock.
Always shut down the
Cisco MeetingPlace Express
application before changing
the clock.
OL-6665-02
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
Table 6-2Important Exception Codes in Cisco MeetingPlace Express (continued)
Code
(Dec)
Code
(Hex)SeverityDisplay TextComments
1311920x20078MAJOR The CS is behind ## seconds.
Conf ##, Next Event ##, Time ##
1311980x2007EINFONo ports left to extend meeting.
Erc ##,Now ##, Length ##, Ports
##
1966860x3004EMINORToo many conference events.
Next event = ##, Conf = ##, Max
events = ##
The conference management
software has fallen behind
processing conference life
cycle events. This can indicate
the system is overloaded. It
can be a normal result of a
system being down for a while.
Repeated alarms about a
failure to catch up may
indicate a software defect.
Recommended Action:
No action required.
The
Cisco MeetingPlace Express
system was unable to extend a
meeting due to lack of
available voice ports.
Recommended Action:
No action required.
Probably indicates too many
people entering or leaving a
meeting at the same time,
overloading the ability of the
Cisco MeetingPlace Express
system to queue up entry or
exit announcements.
6-14
Recommended Action:
No action required.
1968480x300F0MINORAllocation of access ports to
units has been fixed. Thank you!
A “too many access ports”
condition (see error message
0x300F1) has been resolved.
Recommended Action:
No action required.
1968490x300F1MINORToo many access ports compared
to licenses ##.
The configured number of
voice ports exceeds the
number of valid licenses,
where ## is the configured
value. This may be caused by
the license being temporary
expired.
Recommended Action:
No action required.
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1
Table 6-2Important Exception Codes in Cisco MeetingPlace Express (continued)
Code
(Dec)
Code
(Hex)SeverityDisplay TextComments
4587880x70024MAJOR Module timed out on “are you
there” query, class=##
4588890x70089WARNStopping exception log due to
flooding.
4588900x7008AINFOLost ## exception events;
logging resumed.
One of the major software
modules (identified by the
class number) failed to
respond to a query from the
system integrity manager
(SIM). This restarts the
system.
Recommended Action:
Report all such occurrences to
Cisco TAC for problem
diagnosis.
The exception logging process
stops logging if incoming
messages exceed a certain rate.
This prevents the logging
mechanism from stealing
critical resources when the
system is overloaded.
Recommended Action:
No action required.
The exception logging process
dropped the indicated number
of messages due to overload.
Normal logging has now
resumed.
4589160x700A4MAJOR System crashed: restarted by the
integrity manager.
1572903 0x180027INFOCPGS: Too many conference
participants; can’t create voice
file.
Recommended Action:
No action required.
Alarm generated as the system
comes back up; triggered by a
flag set during a reboot
initiated by the system
integrity manager (SIM).
Recommended Action:
No action required.
The cumulative number of
guest participants in a meeting
has exceeded the system’s
ability to store name
recordings for that meeting.
The user name is not being
recorded. This normally
happens only during stress
testing.
Recommended Action:
No action required.
6-16
Administrator’s Installation, Upgrade, and Troubleshooting Guide for Cisco MeetingPlace Express Release 1.1