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

Upgrading Cisco WebEx Social

Table Of Contents

Upgrading Cisco WebEx Social

Supported Upgrade Paths

Upgrading to Release 3.1

Upgrading to Release 3.1 SR1

Upgrading to Release 3.1 SR2

Upgrading to Release 3.1 SR3


Upgrading Cisco WebEx Social


This chapter describes how to upgrade Cisco WebEx Social to release 3.1. It includes these topics:

Supported Upgrade Paths

Upgrading to Release 3.1

Upgrading to Release 3.1 SR1

Upgrading to Release 3.1 SR2

Upgrading to Release 3.1 SR3

Supported Upgrade Paths

You can upgrade to Cisco WebEx Social release 3.1 only from the current SR release of Cisco WebEx Social 3.0.

You can upgrade to Cisco WebEx Social release 3.1 SR1 only from Cisco WebEx Social release 3.1.

You can upgrade to Cisco WebEx Social release 3.1 SR2 only from Cisco WebEx Social release 3.1 SR1.

You can upgrade to Cisco WebEx Social release 3.1 SR3 only from Cisco WebEx Social release 3.1 SR2.

Upgrading to Release 3.1

To Upgrade to Cisco WebEx Social 3.1, perform the following steps. The upgrade process can take up to 20 minutes per node, depending on the amount of data in your database.

You can reduce the time that the database upgrade process takes by deploying up to four Worker nodes before you begin the upgrade procedure. These nodes increase the speed of the data migration part of the upgrade process. After the upgrade completes, you can remove the Worker nodes that you do not require for normal operation.

Before You Begin

If a new NFS share will be used for Cisco Webex Social, copy the cms folder from the old share to the new share to migrate images and documents. For example, use this command:

cp -rp old_nfs_path/cms new_nfs_path/cms

Perform a partial reindex of the Image Gallery before you upgrade to this Cisco WebEx Social release. To do so, from the Control Panel in Quad, select Server Administration > Partial Re-indexing > Media > Image Gallery.

Procedure


Step 1 Upgrade the Cisco WebEx software by using the provided .img file and the Software Maintenance window under Deployment on the Quad Director node, but do not reenable the Cache, App Server, and Worker nodes.

For instructions, see the "Using the Software Window" section.

Step 2 Take these actions to migrate Cisco WebEx Social data and schema to the format that the new release requires:

a. Use an SSH client to access any App Server node, log in as the admin user, and enter these commands:

sudo service puppet debug

sudo service monit stop

sudo service puppet stop

b. Take these actions:

1. Use a text editor to edit this file:

/opt/cisco/quad/tomcat/webapps/ROOT/WEB-INF/classes/portal-ext.properties.

2. Set the upgrade.schema.enabled flag value to false.

3. Set the upgrade.ext.enabled flag value to true.

4. Save the portal-ext.properties file.

c. Take these actions in the Director to enable the Cache node and the newly added Worker nodes:

1. Click Topology in the left panel.

2. Click Enable in the Operational Status column for the Cache role.

3. Click Enable in the Operational Status column for each Worker role.

d. Enter this command in the App Server command shell:

sudo service quad start

e. Enter the following command to monitor the process of the data migration, where app_server_hostname is the hostname of the App Server node that you are accessing and date is the current date in yyyy_mm_dd format:

tail -f /opt/logs/date/app_server_hostname_appserver.log

Wait until you see the following line before you continue to the next step:

UpgradeProcessSprint20_3_1.doUpgrade(): Complete...
 
   

f. After data is migrated successfully, enter these commands:

sudo service monit start

sudo service puppet debug

Step 3 In the Director, click Enable in the Operational Status column for each App Server node.

Step 4 Sign in to a non-Director Cisco WebEx Social node as system administrator and take these actions:

a. Click the down-arrow to the right of your name in the Global Navigation bar.

b. Select Account Settings from the drop-down menu.

c. Click the right-arrow next to Server.

d. Click Server Administration in the Server drawer.

e. In the Server Administration window, click the Log Properties tab, and, for the Search log group, choose INFO from the drop-down list for this group in the Level field.

f. In the Server Administration window, click the Resources tab.

g. Check the Use Faster Multi-Threaded approach check box next to Re-Index all search Indexes under Actions.

h. Click Execute next to Re-Index all search Indexes under Actions.


Upgrading to Release 3.1 SR1

You can upgrade to Cisco WebEx Social release 3.1 SR1 only from Cisco WebEx Social release 3.1. To perform this upgrade, perform the following steps.

Before You Begin

If you did not perform the reindex process when you upgraded to Cisco WebEx Social release 3.1, do so now as described in Step 4 in the "Upgrading to Release 3.1" section.

Procedure


Step 1 Upgrade the Cisco WebEx software by using the provided .img file and the Software Maintenance window under Deployment on the Quad Director node, but do not reenable the Cache, App Server, and Worker nodes.

For instructions, see the "Using the Software Window" section.

Step 2 Take these actions to migrate CiscoWebEx Social data and schema to the format that the new release requires:

a. Use an SSH client to access any App Server node, log in as the admin user, and enter these commands:

sudo service puppet debug

sudo service monit stop

sudo service puppet stop

b. Take these actions:

1. Use a text editor to edit this file:

/opt/cisco/quad/tomcat/webapps/ROOT/WEB-INF/classes/portal-ext.properties.

2. Set the upgrade.schema.enabled flag value to:

false

3. Set the upgrade.ext.enabled flag value to:

true

4. Set the upgrade.ext.processes value to:

com.liferay.portal.upgrade.sprint20.migrate.communitymembers.
MembersCountMigratePublisher

5. Save the portal-ext.properties file.

c. Take these actions in the Director to enable the Cache node and the newly added Worker nodes:

1. Click Topology in the left panel.

2. Click Enable in the Operational Status column for the Cache role.

3. Click Enable in the Operational Status column for each Worker role.

d. Enter this command in the App Server command shell:

sudo service quad start

e. Enter the following command in a command shell on the Director node to monitor the process of the data migration, where app_server_hostname is the hostname of the App Server node that you are accessing and date is the current date in yyyy_mm_dd format:

tail -f /opt/logs/date/app_server_hostname_appserver.log

Wait until you see the following line before you continue to the next step:

[MIGRATION] - [main] - [] - []: 100% communities sent to the worker node for getting 
the members count
 
   

f. Take these actions in the App Server command shell:

1. Use a text editor to edit this file:

/opt/cisco/quad/tomcat/webapps/ROOT/WEB-INF/classes/portal-ext.properties.

2. Set the upgrade.ext.enabled flag value to:

false

3. Delete the value that was set for upgrade.ext.processes.

4. Save the portal-ext.properties file.

g. After data is migrated successfully, enter these commands in the App Server command shell:

sudo service monit start

sudo service puppet debug

Step 3 In the Director, click Enable in the Operational Status column for each App Server node.

Step 4 Sign in to a non-Director Cisco WebEx Social node as system administrator and take these actions:

a. Click the down-arrow to the right of your name in the Global Navigation bar.

b. Select Account Settings from the drop-down menu.

c. Click the right-arrow next to Server.

d. Click Server Administration in the Server drawer.

e. In the Server Administration window, click the Resources tab.

f. Click Execute next to Index JSON and Analytics Stores under Actions.


Upgrading to Release 3.1 SR2

You can upgrade to Cisco WebEx Social release 3.1 SR2 only from Cisco WebEx Social release 3.1 SR1. To perform this upgrade, perform the following steps.

Procedure


Step 1 Upgrade the Cisco WebEx software by using the provided .img file and the Software Maintenance window under Deployment on the Quad Director node.

For instructions, see the "Using the Software Window" section.

Step 2 Sign in to a non-Director Cisco WebEx Social node as system administrator and take these actions:

a. Click the down-arrow to the right of your name in the Global Navigation bar.

b. Select Account Settings from the drop-down menu.

c. Click the right-arrow next to Server.

d. Click Server Administration in the Server drawer.

e. In the Server Administration window, click the Resources tab.

f. Click Execute next to Index JSON and Analytics Stores under Actions.

Step 3 Sign in to a non-Director Cisco WebEx Social node as system administrator, enter the following URL in the Address field of your web browser, and then press the Enter key.

Replace host with the fully qualified domain name (FQDN) of an App Server node. Replace port with an HTTPS port number if the client system does not communicate with the host on the default port 443.

http://host[:port]/html/portlet/enterprise_admin/settings/microPostsUpdateLastModifiedDate.jsp?action=upgrade

When you see a message similar to the following, the upgrade is complete:

Upgrade started at: Tue Jan 8 12:47:42 GMT 2013
Upgrade completed successfully at: Tue Jan 8 12:47:42 GMT 2013
 
   

Upgrading to Release 3.1 SR3

You can upgrade to Cisco WebEx Social release 3.1 SR3 only from Cisco WebEx Social release 3.1 SR2. To perform this upgrade, follow the instructions in the "Using the Software Window" section.