method of procedure to upgrade rms os to red hat ... · enterprise linux 6 x64 update 6 to red hat...
TRANSCRIPT
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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Cisco Systems, Inc. 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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Cisco Systems, Inc. www.cisco.com
3
Glossary............................................................................................................................................................................ 21
Appendix .......................................................................................................................................................................... 22
Appendix A – Escalation Contacts ............................................................................................................................ 22
Appendix B – Document Variables .......................................................................................................................... 22
Obtaining Documentation and Submitting a Service Request ........................................................................................ 23
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Scope of MOP
Cisco Systems, Inc. www.cisco.com
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.
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Process Information
Cisco Systems, Inc. www.cisco.com
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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Pre Maintenance
Cisco Systems, Inc. www.cisco.com
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.
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Pre Maintenance
Cisco Systems, Inc. www.cisco.com
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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Pre Maintenance
Cisco Systems, Inc. www.cisco.com
8
Output:
Enter: select “Clone” under “All vCenter Actions”
Output:
Enter: Select the creation type as “Clone an existing vApp” and click on “Next”
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Pre Maintenance
Cisco Systems, Inc. www.cisco.com
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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Pre Maintenance
Cisco Systems, Inc. www.cisco.com
10
Output:
Enter: Select the storage data store and Click [Next]
Output:
Enter: Click [Next]
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Pre Maintenance
Cisco Systems, Inc. www.cisco.com
11
Output:
Enter: Click [Next]
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Pre Maintenance
Cisco Systems, Inc. www.cisco.com
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”
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Pre Maintenance
Cisco Systems, Inc. www.cisco.com
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.
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Maintenance Activity
Cisco Systems, Inc. www.cisco.com
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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Maintenance Activity
Cisco Systems, Inc. www.cisco.com
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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Maintenance Activity
Cisco Systems, Inc. www.cisco.com
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.
This system is not registered to Red Hat Subscription Management. You can use subscription-manager to register.
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
Output: The system responds with the command prompt.
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Maintenance Activity
Cisco Systems, Inc. www.cisco.com
17
Install the RHEL Security Patch
Note: Please skip the below warnings observed during the execution of the below command.
This system is not registered to Red Hat Subscription Management. You can use subscription-manager to register.
Enter: # yum install yum-security
Output: The system responds with the command prompt.
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
Output: The system responds with the command prompt.
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
Output: The system responds with the command prompt.
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Maintenance Activity
Cisco Systems, Inc. www.cisco.com
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)
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Maintenance Activity
Cisco Systems, Inc. www.cisco.com
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
Output: The system responds with the command prompt.
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Cloning the RHEL Upgraded VMs
Cisco Systems, Inc. www.cisco.com
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
Output: The system responds with the command prompt.
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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Glossary
Cisco Systems, Inc. www.cisco.com
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
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Appendix
Cisco Systems, Inc. www.cisco.com
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.
Method of Procedure to Upgrade RMS OS to Red Hat Enterprise Linux 6.7
Obtaining Documentation and Submitting a Service Request
Cisco Systems, Inc. www.cisco.com
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.
Cisco Systems, Inc. www.cisco.com
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.