Cisco Unified MeetingPlace - Application Server Hotfix Installation FAQ

From DocWiki

(Difference between revisions)
Jump to: navigation, search
(FAQ)
(FAQ)
Line 126: Line 126:
*Q.  How to verify the installation version
*Q.  How to verify the installation version
*A.  For App server use '<b>swstatus</b>' command:
*A.  For App server use '<b>swstatus</b>' command:
-
$ swstatus
+
<b>$ swstatus</b>
NOTE: it will list output similar to this one:
NOTE: it will list output similar to this one:
 +
<pre>
<pre>
Conference server 8.5.4.14
Conference server 8.5.4.14

Revision as of 14:13, 27 August 2012

Introduction

This page will provide information required to successfully install hotfixes on Cisco Unified MeetingPlace Application server. Here you will find answers on Frequently Asked Questions in regards to transferring files to MP Application server, decompressing files, moving them to the appropriate location, verifying hotfix file integrity, installing the hotfix, rolling back, etc.

Cisco MeetingPlace hotfixes and patches are now distributed through a Hotfix/Patch Installation Package format with a lightweight installer. The Patch Installation Package is provided in a gzip file with this filename pattern: MP<major_release_number><maintenance_release_number>_<hotfix_number>_<component_name>_<full_version_number>.bin.gz where:

  • major_release_number --- The major version of the software (for example, 8.5, 8.0, 7.1 shown without dot).
  • maintenance_release_number --- The MR number (for example, MR1, MR2,...).
  • hotfix_number --- Current HF number for given component.
  • component_name --- Name of the component: APP, Multinode(ConfMgr, Admin, bcl, and other Java components). Applicable for Audio Only deployments and Outlook component.
  • full_version_number --- Full version number without dots (8.5.4.19).

Example: MP85MR2_HF2_MultiNode_85419.bin.gz

Patches and Hotfixes are developed on top of a full installation version.

The Patch/Hotfix Installation Package is cumulative. For example, HF3 package contains all the fixes included in HF1 and HF2, as well as new fixes in HF3. In order to ensure the stability and consistency of the overall installation, installing patch/hotfix with, for example, number 5, causes all earlier patches/hotfixes (from 1 to 5) to be installed.

Installation instructions

Please review Readme file which is distributed with every Patch/Hotfix release for general instructions.

FAQ

This section provides information about commonly encountered issues and how to resolve them.


OS

  • Q. How to copy the hotfix file to the MP Application server using an SCP client (e.g. WinSCP)
  • A. If using Linux-like OS:
  1. Open console/terminal and navigate (cd) to the location of file.bin.gz
  2. Use 'scp' command to copy the file to the app server: $ scp file.bin.gz mpxadmin@app_server.com: NOTE: replace 'app_server.com' with FQDN of your application server.
  3. Enter 'mpxadmin' credentials and track copy progress.
  • A. If using MS Windows download the tool from this page [1]
  1. Extract files into a WinSCP folder
  2. Run WinSCP.exe
  3. Enter Host name (MP Application server's IP address),
  4. User name (mpxadmin), Password (mpxadmin's password),and click Login
  5. Once you have established connection, just drag the hotfix file file.bin.gz from the left pane (your desktop) to the right pane (which is /home/mpxadmin directory on MP App server)
  6. Close WinSCP tool


CLI

All prompts are shown with '$'(mpxadmin) or '#' (root) prefix

  • Q. How to SSH to MP Application server?
  • A. Use ssh client for your OS (Putty, SecureCRT, etc.). For details consult appropriate documentation shipped with program.

Most Linux distros already have installed ssh client which can be used from console/terminal. Log in using 'mpxadmin' credentials. You will be placed in 'home' directory of 'mpxadmin' user (/home/mpxadmin)


  • Q. How to become 'root'?
  • A. Login to SSH as mpxadmin, then change to 'root' user:

$ su -

NOTE: Enter 'root' password when prompted


  • Q. How to check current directory?
  • A. Run: $ pwd

NOTE: Command will prompt current directory. Note down some of important directories:

/home/mpxadmin

/mpx-record

/lat/bin


  • Q. How to change directory?
  • A. Use 'cd' command (cd /path/to/the/directory ).

To go to mpx-record: $ cd /mpx-record

To go to mpxadmin's home: $ cd /home/mpxadmin


  • Q. How to list files?
  • A. Use 'ls' command. '-l' switch will show details:

$ ls -l


  • Q. How to move or copy a file?
  • A. Use 'mv' or 'cp' command:

To move file.bin to mpx-record: $ mv file.bin /mpx-record

To copy file.bin to mpx-record: $ cp file.bin /mpx-record


  • Q. How to change file permissions?
  • A. Use 'chmod' command. For the use with MP hotfixes '755' permissions are used:

To change permissions of file.bin to '755', run: $ chmod 755 file.bin


  • Q. How to gunzip the file?
  • A. Use 'gunzip' command:

To gunzip file.bin.gz, run: $ gunzip file.bin.gz

Extracted file will be 'file.bin'


  • Q. How to verify the checksum value of the file.bin:
  • A. Use 'cksum' command:

$ cksum file.bin

NOTE: Expected value is given in appropriate Readme file.


  • Q. How to execute (run) hotfix installer (file.bin)
  • A. If file.bin is in /mpx-record:

# cd /mpx-record

# ./file.bin


  • Q. How to verify the installation version
  • A. For App server use 'swstatus' command:

$ swstatus

NOTE: it will list output similar to this one:

Conference server 8.5.4.14
System mode: Up
Media control: Up
MODULE NAME          STATUS     VERSION
SIM                  UP         "07/02/12 06:15 Rel_8_5_4_14"
DBSERVER             UP         "07/02/12 05:58 Rel_8_5_4_14"
SNMPD                UP         "07/02/12 06:15 Rel_8_5_4_14"
GS                   UP         "07/02/12 06:00 Rel_8_5_4_14"
CICMSERVER           UP         "07/02/12 06:14 Rel_8_5_4_14"
CPSERVER             UP         "07/02/12 06:14 Rel_8_5_4_14"
CCA                  UP         "07/02/12 06:03 Rel_8_5_4_14"
POSERVER             UP         "07/02/12 05:59 Rel_8_5_4_14"
CONFSCHED            UP         "07/02/12 06:08 Rel_8_5_4_14"
TRIGGER_WATCH        UP         "07/02/12 06:16 Rel_8_5_4_14"
POCLIENT             UP         "07/02/12 06:22 Rel_8_5_4_14"
VOICESERVER          UP         "07/02/12 06:13 Rel_8_5_4_14"
GWSIMMGR             UP         "07/02/12 06:16 Rel_8_5_4_14"
NMPAGENT             UP         "07/02/12 06:15 Rel_8_5_4_14"


UI

  • Q. How to put the server in Maintenance mode?
  • A.

a. Browse to MBD Administration Center > Maintenance > Maintenance Configuration

b. Click on "Start Maintenance Mode Now" button

c. Click "OK" at this warning pop-up: "Warning. Application will be put into maintenance mode. All meetings will be terminated."

NOTE: Once Maintenance mode is started, the system will display the following message in red: "This node is down for maintenance"


  • Q. How to bring the node back from Maintenance Mode?
  • A.

a. Browse to MBD Administration Center > Maintenance > Maintenance Configuration

b. Click on "Stop Maintenance Mode Now" button

c. Click "OK" at this warning pop-up:

"Warning. Application will restart and any maintenance windows that are currently active or will be active in less than one hour, will be cleared. Application restarting. Please wait 10 minutes for the node to be fully functional."

NOTE 1: During the process of stopping Maintenance Mode, the system will display the following messages in red:

"This node is down for maintenance. MeetingPlace Application is in the process of restarting. Please wait a few minutes."

NOTE 2: Once Maintenance mode is stopped and the system is back up, the system will display the following messages in blue: "This node is not in maintenance mode. MeetingPlace Application is Running."


  • Q. How to verify Outlook plugin version when new MP plugin is distributed to clients?
  • A. For Outlook 2003:

a. Start MS Outlook 2003

b. Go to Tools-> Options-> MeetingPlace

c. Verify that correct plugin version is displayed

For Outlook 2007/2010:

a. Start MS Outlook 2007/2010

b. Click on MeetingPlace toolbar-> About MeetingPlace for Outlook

c. Verify that correct plugin version is displayed


  • Q. How to verify java component version?
  • A.

a. Browse to MBD Administration Center

b. In the footer of the page you should see the version system is running.

NOTE: You should see a line similar to this one:

Version: 8.5.4.14  Send us your feedback
© 1993-2012 Cisco Systems, Inc. All Rights Reserved.

Rating: 5.0/5 (3 votes cast)

Personal tools