Cisco WebEx Social Installation and Upgrade Guide, Release 3.1
Additional Installation-Related Information
Downloads: This chapterpdf (PDF - 126.0KB) The complete bookPDF (PDF - 1.22MB) | Feedback

Additional Installation-Related Information

Table Of Contents

Additional Installation-Related Information

Enabling or Disabling Cisco WebEx Social Nodes

Using Refresh Buttons

Verifying the Integrity of a Cisco WebEx Social .img File

Obtaining an MD5 Checksum Value from Cisco

Performing an MD5 Checksum Comparison

Performing an MD5 Checksum Comparison on a Microsoft Windows System

Performing an MD5 Checksum Comparison on a Mac System

Performing an MD5 Checksum Comparison on a Linux System

Using the Software Window

Using the Director

Checking Installation-Related Log Files


Additional Installation-Related Information


This section contains the following topics:

Enabling or Disabling Cisco WebEx Social Nodes

Using Refresh Buttons

Verifying the Integrity of a Cisco WebEx Social .img File

Using the Software Window

Using the Director

Checking Installation-Related Log Files

Enabling or Disabling Cisco WebEx Social Nodes

You use the Topology window in the Director to enable and disable App Server, Cache, and Worker nodes in your Cisco WebEx Social cluster.

Some requirements exist regarding the order in which you must enable or disable nodes:

When enabling nodes, App Server roles must be enabled after all other roles are enabled. The order of other roles does not matter.

When disabling nodes, all App Server roles must be disabled first. After that, the order does not matter.

To enable or disable nodes in your Cisco WebEx Social cluster, follow these steps:

Procedure


Step 1 Sign in to the Director with your administrator user ID and password.

Step 2 Select Topology under Deployment.

Step 3 Use the Enable and Disable buttons to start or stop a node (role).


Using Refresh Buttons

The Server List area in the Deployment Topology window in the Director contains Refresh buttons. Use these buttons to fetch version information and to display current operational status of a node. Possible states that the Status column shows are:

Running

Stopped

Not Installed

Unreachable Host

Connection Failed

Verifying the Integrity of a Cisco WebEx Social .img File

The Cisco WebEx Social .img file that you use for an upgrade is a large file, which can occasionally become corrupted when you download it from Cisco.com. Cisco recommends that you verify the integrity of a .img file before you use it. To do so, you obtain an MD5 checksum value that Cisco calculates for the file, then compare that value with an MD5 checksum value that you calculate for the file. An MD5 checksum is a unique 128-bit value that you can use to ensure that various versions of a file are identical.

Verifying the integrity of a .img file is a two-step process, which the following sections describe:

Obtaining an MD5 Checksum Value from Cisco

Performing an MD5 Checksum Comparison

Obtaining an MD5 Checksum Value from Cisco

The first general step to verify the integrity of a Cisco WebEx Social .img file is to obtain an MD5 checksum value for the file from Cisco. To obtain this value, follow these steps:

Procedure


Step 1 Go to http://www.cisco.com.

Step 2 Click Support, then click the Downloads tab.

Step 3 Type webex social in the Find field, then click the Find button.

Step 4 Click the Cisco WebEx Social link that appears in the search results.

Step 5 In the panel on the left of the Download Software window that appears, navigate to the Cisco WebEx Social version that you are installing.

Step 6 Hover your mouse over the .img file name that appears to display the Details window.

Step 7 Make a note of the MD5 Checksum value that appears in the Details window.


Performing an MD5 Checksum Comparison

After you download the .img file, perform a checksum comparison by generating an MD5 checksum value for the file and comparing this value with the checksum value that you obtained from Cisco. To do so, follow the steps in the section that is appropriate for the system to which you downloaded the .img file:

Performing an MD5 Checksum Comparison on a Microsoft Windows System

Performing an MD5 Checksum Comparison on a Mac System

Performing an MD5 Checksum Comparison on a Linux System

Performing an MD5 Checksum Comparison on a Microsoft Windows System

After you download a .img file and obtain its MD5 checksum value from Cisco (see the "Obtaining an MD5 Checksum Value from Cisco" section), follow these steps to perform an MD5 checksum comparison on a system that is running the Microsoft Windows operating system.

Before You Begin

Identify the name of the .img file that you downloaded from Cisco.com and the directory in which you saved the file on the local system.

Install the Microsoft File Checksum Integrity Verifier (FCIV) utility that is required to perform an MD5 checksum, if this utility is not installed on your system. To do so, follow the instructions in the Microsoft knowledge base article How to Compute the MD5 or SHA-1 Cryptographic Hash Values for a file, which is available from the Microsoft website (article ID 889768).

Procedure


Step 1 Click the Windows Start button, choose Run, type cmd in the Run window, and press Enter.

Step 2 In the Command window, use the cd command to make the directory in which you saved the .img file the current directory.

Step 3 Enter the following command, replacing the sample file name shown with the name of the .img file that you downloaded:

FCIV -md5 cisco-webex-social-X.Y.Z.AAAAA.BBB.img

This command displays output that includes an MD5 checksum value, similar to the following example. In this example, the checksum value is shown in bold type for your reference:

1. C:\>fciv -md5 md5sum cisco-webex-social-3.0.1.10305.39.img 
//
// File Checksum Integrity Verifier version 2.05.
//
88a5dba53661da5dcd37f81011201933  cisco-webex-social-3.0.1.10305.39.img
 
   

Step 4 Compare the MD5 checksum value that you generated for the file with the MD5 checksum value that you obtained from Cisco as described in the "Obtaining an MD5 Checksum Value from Cisco" section.

If the checksum values are identical, the .img file that you downloaded is OK to use for an installation or upgrade of Cisco WebEx Social.

If the checksum values are not identical, .img file that you downloaded is corrupt. In this case, download the file from Cisco.com again and rerun the procedure in this section.


Performing an MD5 Checksum Comparison on a Mac System

After you download a .img file and obtain its MD5 checksum value from Cisco (see the "Obtaining an MD5 Checksum Value from Cisco" section), follow these steps to perform an MD5 checksum comparison on a system that is running an Apple Mac operating system.

Before You Begin

Identify the name of the .img file that you downloaded from Cisco.com and the directory in which you saved the file on the local system.

Procedure


Step 1 Open a terminal window on the Mac system.

Step 2 In the Terminal window, use the cd command to make the directory in which you saved the .img file the current directory.

Step 3 Enter the following command, replacing the sample file name shown with the name of the .img file that you downloaded:

md5 cisco-webex-social-X.Y.Z.AAAAA.BBB.img

This command displays output that includes an MD5 checksum value, similar to the following example. In this example, the checksum value is shown in bold type for your reference:

1. C:\>fciv -md5 md5sum cisco-webex-social-3.0.1.10305.39.img 
//
// File Checksum Integrity Verifier version 2.05.
//
88a5dba53661da5dcd37f81011201933  cisco-webex-social-3.0.1.10305.39.img
 
   

Step 4 Compare the MD5 checksum value that you generated for the file with the MD5 checksum value that you obtained from Cisco as described in the "Obtaining an MD5 Checksum Value from Cisco" section.

If the checksum values are identical, the .img file that you downloaded is OK to use for an installation or upgrade of Cisco WebEx Social.

If the checksum values are not identical, .img file that you downloaded is corrupt. In this case, download the file from Cisco.com again and rerun the procedure in this section.


Performing an MD5 Checksum Comparison on a Linux System

After you download a .img file and obtain its MD5 checksum value from Cisco (see the "Obtaining an MD5 Checksum Value from Cisco" section), follow these steps to perform an MD5 checksum comparison on a system that is running the Linux operating system.

Before You Begin

Identify the name of the .img file that you downloaded from Cisco.com and the directory in which you saved the file on the local system.

Procedure


Step 1 Use an SSH client to access the system and log in as the admin user.

Step 2 Use the cd command to make the directory in which you saved the .img file the current directory.

Step 3 Enter the following command, replacing the sample file name shown with the name of the .img file that you downloaded:

md5sum cisco-webex-social-X.Y.Z.AAAAA.BBB.img

This command displays output that includes an MD5 checksum value, similar to the following example. In this example, the checksum value is shown in bold type for your reference:

[admin@director-d deployer]$ md5sum cisco-webex-social-3.0.1.10305.39.img 
88a5dba53661da5dcd37f81011201933  cisco-webex-social-3.0.1.10305.39.img
 
   

Step 4 Compare the MD5 checksum value that you generated for the file with the MD5 checksum value that you obtained from Cisco as described in the "Obtaining an MD5 Checksum Value from Cisco" section.

If the checksum values are identical, the .img file that you downloaded is OK to use for an installation or upgrade of Cisco WebEx Social.

If the checksum values are not identical, .img file that you downloaded is corrupt. In this case, download the file from Cisco.com again and rerun the procedure in this section.


Using the Software Window

You can use the Software window in the Director window for upgrades provided that you have received a patch in the form of an .img file. To upgrade to the latest version of Cisco WebEx Social using the provided .img file, perform the following steps.

Before You Begin

Verify the integrity of the installation image file as described in the "Verifying the Integrity of a Cisco WebEx Social .img File" section.

Procedure


Step 1 Sign in to the Director with your administrator user ID and password.

Step 2 Select Software Maintenance under Deployment.

Step 3 In the Host Name field, enter the fully qualified domain name or the IP address of the Linux/Unix node where you placed the patch .img file.

Step 4 In the File Name field, enter the complete path and file name of the .img file.

Step 5 In the Linux/Unix User Name field, enter the user ID of the node on which the patch .img file has been placed.

Step 6 In the Password field, enter the password for the User ID that you entered.

Step 7 Click Upload.

The software version that you uploaded appears in the Available Upgrade Version field in the Upgrade area of the window.

Step 8 Click Upgrade.

The software on each node in your Cisco WebEx Social cluster is upgraded.


Note You can monitor the upgrade process by checking the opt/logs/date logs. You can monitor the upgrade process by checking the opt/logs/date/node-hostname_messages logs


Step 9 Allow up to 15 minutes for the Director to automatically restart.

Step 10 Sign in to the Director with administrator credentials.

Step 11 Click the Topology tab.

Step 12 Verify that all the nodes have been upgraded to the desired version by checking the "Version Info" column next to each node.

If "Error" appears for any node, use an SSH client to connect to the node showing the symptom, log in as the admin user, and run the following command to identify the error:

sudo service puppet debug

Step 13 Because the Cache, App Server, and Worker nodes will be in the Disabled state after a successful upgrade, do the following from the Topology tab of the Deployment window:

a. Enable Cache nodes.

b. Enable App Server nodes.

c. Enable Worker nodes.

Step 14 Allow up to 15 minutes for the App Server nodes to become enabled.

Monitor the /opt/cisco/quad/deploy folder on App Server nodes for all .war files to be consumed. When these files are consumed, Cisco WebEx Social should be ready for use.


Using the Director

The Director is used for setting values of specific properties to complete configuration for some Cisco WebEx Social features. See Cisco WebEx Social Administration Guide for information about when to set properties.

Checking Installation-Related Log Files

You can check the progress of the upgrade process for a node by opening the following log files on the Director:

/opt/logs/date/hostname_messages

/opt/logs/date/hostname_puppet.log