method of procedure to upgrade rms os to red hat ... · enterprise linux 6 x64 update 6 to red hat...

Cisco Systems, Inc. www.cisco.com

Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7

First Published: November 20, 2015

http://www.cisco.com/



2

Contents Scope of MOP .................................................................................................................................................................... 4

Release Components ......................................................................................................................................................... 4

Pre Requisites .................................................................................................................................................................... 4

Assumptions ...................................................................................................................................................................... 4

Process Information ........................................................................................................................................................... 5

Upgrade Timing.............................................................................................................................................................. 5

Requirements ................................................................................................................................................................ 5

Pre Maintenance................................................................................................................................................................ 6

Enable VAMI Login ......................................................................................................................................................... 6

Clone the System ........................................................................................................................................................... 6

Clone Central Node .................................................................................................................................................... 6

Clone Serving Node .................................................................................................................................................. 13

Clone Upload Node .................................................................................................................................................. 13

Maintenance Activity ....................................................................................................................................................... 14

Verify the RHEL Version ............................................................................................................................................... 14

Staging the RHEL 6.7 ISO .............................................................................................................................................. 14

Mount the ISO File ....................................................................................................................................................... 15

Verify the Mounter Partition ....................................................................................................................................... 15

Create the Local Repository File .................................................................................................................................. 15

Cleaning Existing Yum Configuration ........................................................................................................................... 16

Verify the RPMs to be upgraded.................................................................................................................................. 16

Update the RPMs ......................................................................................................................................................... 16

Install the RHEL Security Patch .................................................................................................................................... 17

Central Node Updates ................................................................................................................................................. 17

Reboot the System ....................................................................................................................................................... 18

Verify the RedHat Version ........................................................................................................................................... 18

Start the VMWare Tools Application after OS Upgrade .............................................................................................. 19

Cloning the RHEL Upgraded VMs ..................................................................................................................................... 20

Maintenance Verification ................................................................................................................................................ 20




3

Glossary............................................................................................................................................................................ 21

Appendix .......................................................................................................................................................................... 22

Appendix A – Escalation Contacts ............................................................................................................................ 22

Appendix B – Document Variables .......................................................................................................................... 22

Obtaining Documentation and Submitting a Service Request ........................................................................................ 23



Scope of MOP


4

Scope of MOP This document describes the procedure required to upgrade OS from Red Hat Enterprise Linux 6 x64 Update 1 or Red Hat Enterprise Linux 6 x64 Update 6 to Red Hat Enterprise Linux 6 (Santiago) x64 Update 7.

Release Components This section contains a list of component dependencies for this procedure.

Component Version

Red Hat Enterprise Linux 6 (Santiago) x64 Update 7

Kernel

kernel-2.6.32-573.el6.x86_64

This is RHEL 6 Update 7

Pre Requisites • RMS 4.1 setup running on OS RHEL 6.1

• RMS 5.1 setup running on OS RHEL 6.6

Assumptions It is assumed that the user has firm knowledge and familiarity with using LINUX from the shell command line. For example, the user should know about the following (this is not a comprehensive list):

• How to login to a command line session (typically as root)

• How to edit files with vi or vim

• How to view files (cat, more, less)

• How to SSH to server using putty or terminal.

• Basic IP networking (IP addresses, network masks, etc.)

• VMWare vSphere access

• MOP assumes VMware ESXi5.1 and ESXi5.5

• RHEL 6.7 ISO should be available on the local system.

• IPs of the central node and DNS entries are available and user can login to central node and execute commands in super user mode.

• Assuming Distributed RMS deployment mode.

• Assuming the data store has sufficient free space to clone the nodes.



Process Information


5

Process Information

Upgrade Timing This table describes the proposed timeline for this activity.

Step Start Time Duration

Pre-Maintenance (backup all VMs) T 15 minutes

Maintenance Activities(Upgrade the VMs) T+15 1 hours 15 minutes

Total 1 hour 30 minutes

Requirements This MOP has the following staffing requirements:

• Cisco Ops Team • Cisco AS Team



Pre Maintenance


6

Pre Maintenance

Enable VAMI Login • On each of the nodes (CN, SN, UN), login as a root user and enable the VAMI_login.

Enter: # echo “/opt/vmware/share/vami/vami_login” > /etc/rc.local

Output: The system responds with the command prompt

Clone the System

Clone Central Node 1. Locate the vApp of the Central Node to be cloned

Enter: In VMWare vSphere Client check on the left navigation panel and locate the vApp of central node.

Output:

2. Power off the vApp

Enter: Right click on Central node vApp.



Pre Maintenance


7

Output:

Enter: Click [Power Off]

Output:

Enter: Click [Yes]. The status can be seen on the right side.

Output:

3. Clone the VM

Enter: Select the vApp for central node again, right click



Pre Maintenance


8

Output:

Enter: select “Clone” under “All vCenter Actions”

Output:

Enter: Select the creation type as “Clone an existing vApp” and click on “Next”



Pre Maintenance


9

Output:

Enter: Browse the host where to keep the clone. Once selected It will do automatically run a compatibility test once “Validation Succeed” message is seen under “Compatibility” Click [Next] Otherwise try for another host.

Output:

Enter: Provide a unique name to the clone and select the folder in which the clone should be present



Pre Maintenance


10

Output:

Enter: Select the storage data store and Click [Next]

Output:

Enter: Click [Next]



Pre Maintenance


11

Output:

Enter: Click [Next]



Pre Maintenance


12

Output:

Enter: Click [Finish] and check the below Tab “Recent Tasks”

Output:

4. Verify the completion of the clone

Enter: Verify the clone is created successfully by checking inventory of the host selected for cloning.

In the example below check for “Clone of CENTRAL-BACKUP2-MAY17”



Pre Maintenance


13

Output:

5. Power On the vApp

Enter: Select the Cloned VM then right click and then “Power On”

Output: VM will boot. If VM is booted successfully and you can login to VM via SSH, Clone is properly done. Otherwise delete this clone and recreate it.

Clone Serving Node Locate the Serving Node vApp on the vSphere Client and repeat the steps mentioned in the above ‘Clone Central Node’ section.

Clone Upload Node Locate the Upload Node vApp on the vSphere Client and repeat the steps mentioned in the above ‘Clone Central Node’ section.



Maintenance Activity


14

Maintenance Activity Note: The procedure remains same for RHEL upgrade from 6.1/6.6 to RHEL6.7

Verify the RHEL Version

1. Login to the RMS Nodes (Central, Serving, Upload) as a root user and verify the RHEL version

Enter: # cat /etc/redhat-release

Output: Red Hat Enterprise Linux Server release 6.1 (Santiago)

Red Hat Enterprise Linux Server release 6.6 (Santiago)

Staging the RHEL 6.7 ISO

2. Verify the RHEL 6.7 ISO file is present on the “/” directory of the server (Central, Serving, Upload) else follow the step (A)

Enter: # cd /;

# ls | grep rhel

Output: rhel-server-6.7-x86_64-dvd.iso

A. To copy the ISO file that is not present on the VM then download the “RHEL6.7-tar.gz” package onto the “/” directory of the server (Central, Serving, Upload) and untar.

Enter: # cd /;

# tar –zxvf RHEL6.7-tar.gz;

# mv RHEL6.7/rhel-server-6.7-x86_64-dvd.iso /;

# rm -rf RHEL6.7 RHEL6.7-tar.gz;

# ls | grep rhel

Output: rhel-server-6.7-x86_64-dvd.iso





15

Mount the ISO File

3. Mount the ISO under /rhel67 directory

Enter: # mkdir /rhel67

# mount -o rw,loop rhel-server-6.7-x86_64-dvd.iso /rhel67

Output: The system responds with the command prompt.

Verify the Mounter Partition

4. Verify if the partition is mounted to /mnt directory

Enter: # df -h

Output: Filesystem Size Used Avail Use% Mounted on

/dev/sda3 99G 15G 79G 16% /

tmpfs 7.8G 0 7.8G 0% /dev/shm

/dev/sda1 124M 28M 91M 24% /boot

/dev/sdb1 47G 24G 21G 54% /rms/data

/dev/sdc1 24G 711M 22G 4% /rms/app/CSCOar

/dev/sdd1 24G 357M 22G 2% /rms/app/nwreg2

/rhel-server-6.7-x86_64-dvd.iso

3.6G 3.6G 0 100% /rhel67

Create the Local Repository File

5. Create a yum local repository file pointing to mounted RHEL6.7 ISO directory with the below provided content

Enter: # vi /etc/yum.repos.d/system.repo

Output: [systemrepo]

name=systemrepo

baseurl=file:///rhel67/

gpgcheck=0

enabled=1





16

Cleaning Existing Yum Configuration

6. Clean any existing yum configuration from the system

Note: Please skip the below warnings observed during the execution of the below clean command.

This system is not registered to Red Hat Subscription Management. You can use subscription-manager to register.

Enter: # yum clean all

Output: Loaded plugins: product-id, subscription-manager

Updating Red Hat repositories.

Cleaning repos: systemrepo

Cleaning up Everything

Verify the RPMs to be upgraded

7. Check the list of RPMs whose updates are available

Note: Please skip the below warnings observed during the execution of the below command.


Enter: # yum check-update

Output: The system responds with the list of upgradable rpms

Update the RPMs

8. Apply the command to update the rpms

Note: Please skip the warnings observed during the execution of the below update command.

Enter: # yum update -y






17

Install the RHEL Security Patch

Note: Please skip the below warnings observed during the execution of the below command.


Enter: # yum install yum-security


Central Node Updates Note:

• Skip these updates on Serving and Upload Nodes • Skip these updates if the RHEL upgrade path is from 6.6 to 6.7

9. After the successful rpm upgrades perform the below steps on the CENTRAL NODE

a. As a root user revert the postgres port setting.

Enter: # sed -i 's/PGPORT=5432/PGPORT=5435/' /etc/rc.d/init.d/postgresql


b. Stop the ‘Network Manager’ and update the DNS server entries in “/etc/resolv.conf” file using ‘vi’ editor.

Enter: service NetworkManager stop

chkconfig NetworkManager off

echo “nameserver 72.163.128.140” >> /etc/resolv.conf

echo “nameserver 10.105.233.60” >> /etc/resolv.conf






18

Reboot the System

10. Reboot the system for the changes to reflect

Enter: # reboot

Output: The system goes down for reboot.

Verify the RedHat Version

11. Once the system is ‘up’ after the reboot, as a ‘root’ user verify that the redhat version is updated to 6.7

Enter: # cat /etc/redhat-release

Output: Red Hat Enterprise Linux Server release 6.7 (Santiago)





19

Start the VMWare Tools Application after OS Upgrade

12. After verifying the redhat version start the vmware tools application on all the RMS nodes and verify the same from vSphere client on the VMs Summary tab

Enter: # /usr/bin/vmware-config-tools.pl -d




Cloning the RHEL Upgraded VMs


20

Cloning the RHEL Upgraded VMs

13. As a root user execute the below command on all the RMS Nodes (Central/Serving/Upload) to avoid network unreachability issue while cloning the VM after RHEL upgrade

Enter: # mv /etc/udev/rules.d/70-persistent-net.rules /root


Maintenance Verification

14. Verify that all the VMs (Central, Serving, Upload) are up and running and are accessible

15. Login to all the VMs (Central, Serving, Upload) as a root user and verify the installed kernel on the machine

Enter: $ ssh 10.32.102.68

Output: System returns with the password prompt.

Enter: $ su -

Output: System returns with the password prompt.

Enter: # uname –r

Output: 2.6.32-573.el6.x86_64



Glossary


21

Glossary

Terminology Definition

Active-Active Redundant system supporting near-real-time failover from primary to standby.

BAC Broadband Access Center

DB Database

FAP Femtocell Access Point

AP Access Point (Generic form of Femto Access Point)

FGW Femto Gateway

RDU Regional Distribution Unit, a part of the BAC that interfaces with the OSS north bound and DPE south bound and is the master data store

Primary Currently desired active system at any point in time (East RDU)

Standby Currently desired inactive system at any point in time (West RDU)

CSG Closed Subscriber Group

CSG ID Closed Subscriber Group ID

SIA Service Interface Agreement

SP Service Provider

ZTPS Zero-Touch Provisioning System



Appendix


22

Appendix

Appendix A – Escalation Contacts

Appendix B – Document Variables

This section contains a list of all the server-related document variables and the codes necessary to update them.

CENTRAL_VM_DNS1 72.163.128.140 CENTRAL_VM_DNS2 10.105.233.60

Do not update these variables.



Obtaining Documentation and Submitting a Service Request


23

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation at: http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html.

Subscribe to what’s New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.


http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html


THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

All printed copies and duplicate soft copies are considered un-Controlled copies and the original on-line version should be referred to for latest version.

Cisco has more than 200 offices worldwide. Addresses, phone numbers, and fax numbers are listed on the Cisco website at www.cisco.com/go/offices.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

© 2015 Cisco Systems, Inc. All rights reserved.


http://www.cisco.com/go/offices

http://www.cisco.com/go/trademarks

method of procedure to upgrade rms os to red hat ... · enterprise linux 6 x64 update 6 to red hat...

Documents