DOCUMENTATION: What are the steps needed to back out of a failed Veritas NetBackup (tm) 6.5 installation on UNIX/Linux systems.

Article:TECH52786  |  Created: 2008-01-22  |  Updated: 2008-01-22  |  Article URL http://www.symantec.com/docs/TECH52786
Article Type
Technical Solution

Product(s)

Environment

Issue



DOCUMENTATION: What are the steps needed to back out of a failed Veritas NetBackup (tm) 6.5 installation on UNIX/Linux systems.

Solution



Manual: NetBackup Installation Guide UNIX and Linux Release 6.5, Chapter 5: Uninstalling NetBackup Server Software, Page 63

Modification Type: Supplement

Modification:
The NetBackup 6.5 Installation Guide explains how to uninstall NetBackup 6.5.  It includes the steps for Solaris servers as well as other UNIX and Linux servers.  This chapter does not include the steps required when uninstalling NetBackup 6.5 due to a failed upgrade.   There are some additional considerations in this scenario which this document attempts to address.  This document also tries to address how to recover NetBackup 5.x media servers after the nbpushdata -modify_5x_hosts command has been run.  For instructions on backing out of a failed NetBackup 6.5 installation on Windows systems, refer to the Related Documents section below.

NOTE: Prior to any rollback, please contact Symantec Technical Support to assist in determining the cause of the upgrade failure.  Resolving the cause of the upgrade failure is often easier and less time-consuming than reverting to the previous version of NetBackup.  If it does become necessary to back out of the upgrade, time spent understanding the cause of the failure can help to ensure a smoother upgrade experience on subsequent attempts.  This is frequently an easier alternative to removing NetBackup 6.5 and reinstalling the previous version of NetBackup.  To contact Symantec Enterprise Support visit the following Web site:
 http://www.symantec.com/enterprise/support/contact_techsupp.jsp?pid=15143

NOTE: This process requires a valid NetBackup 5.x catalog backup exists.  It also requires knowing what NetBackup 5.x version and what maintenance packs were installed prior to the NetBackup 6.5 upgrade.  The only exception to this would be a NetBackup 5.x media server where no software was upgraded and only the nbpushdata -modify_5x_hosts command was run.

Backing out of a failed upgrade where the master server or media server was upgraded to NetBackup 6.5:
Backing out of an upgrade of a NetBackup master server requires the following basic steps.  First, the NetBackup 6.5 software must be completely removed from the system.  Second, the previous NetBackup version and maintenance packs must be reinstalled.  Finally, the NetBackup catalog backup made before the upgrade must be recovered.  After these steps the master server will be restored to the state it was prior to the upgrade.

Before removing the NetBackup 6.5 software from the master server gather the software and maintenance packs needed to restore the system to the version it was running prior to the upgrade.  Once this is done then:

1. Make sure a valid NetBackup catalog backup from the previous version is available prior to removing any software.  This is needed to restore the catalogs after the previous NetBackup version has been reinstalled.

2. Log into the master server as root and prepare the uninstall the NetBackup 6.5 software.

For Solaris servers:
Follow steps 3 through 19 in the Uninstalling NetBackup on Solaris Servers section of Chapter 5 in the NetBackup 6.5 Installation Guide for UNIX.  These steps remove the NetBackup 6.5 software from the system.  

For other UNIX servers:
Follow steps 3 through 15 in the Uninstalling NetBackup on All Other UNIX Servers section of Chapter 5 in the NetBackup 6.5 Installation Guide for UNIX.  These steps remove the NetBackup 6.5 software from the system.  

When backing out of a failed upgrade there is no need to follow step 2 to make another catalog backup.  The installation guide assumes a successful NetBackup 6.5 installation has occurred before the uninstall.  When backing out of a failed NetBackup 6.5 upgrade there is no need to make another catalog backup.

3. Once the software has been removed check for any NetBackup 6.5 components that were not completely removed.  This helps prevent any future installation issues if the master server is upgraded to NetBackup 6.5 at a later date.  Check for the following directories.  These should be completely removed from the master server.  
# ls -l /usr/openv
/usr/openv: No such file or directory
# ls -l /opt/openv
/opt/openv: No such file or directory
# ls -l /opt/VRTSpbx
/opt/VRTSpbx: No such file or directory
# ls -l /opt/VRTSicsco
/opt/VRTSicsco: No such file or directory
If any files exist in these directories, contact Symantec Technical services to help verify the uninstall was successful.  For Solaris systems run pkginfo and verify all the proper SYMC and VRTS subsystems have been removed.

4. Reinstall the NetBackup 5.x or 6.0 version that was running prior to the NetBackup 6.5 upgrade.  It is necessary to install the add-on products and database agents that were installed prior to the upgrade.
a. Load the appropriate NetBackup Installation CD into the drive and run the install script.
# cd /cdrom
# ./install
b. Follow the on screen instructions to install the software.   Be sure to enter the exact master server hostname that was used before.  This is necessary to ensure NetBackup works properly after restoring the catalogs.
c. If any database agents or options need to be installed load the NetBackup Options CD into the drive and run the install script.
# cd /cdrom
# ./install
d. Follow the on screen instructions to install the software.
e. Download and install the appropriate maintenance packs.  This is needed in order to bring the master server to the version that existed before the upgrade.  To download the NetBackup 5.x or 6.0 maintenance packs, visit the Support Web site at:

5. Repeat these same steps for any media servers that were upgraded to NetBackup 6.5.   Different steps are required if the media server remained at NetBackup 5.x and the nbpushdata -modify_5x_hosts command was run to migrate the media and volume database information.  If this is the case, refer to the Backing out of a failed upgrade where the media server remained at NetBackup 5.x section below.

6. Once the NetBackup 5.x or 6.0 software has been reinstalled it is necessary to restore the NetBackup catalogs.  This is done using the bprecover command.  For more information on the syntax for the bprecover command, refer to the appropriate Troubleshooting Guide, found below, in the Related Documents section.
- Veritas NetBackup (tm) 5.0 Troubleshooting Guide for UNIX and Windows, Chapter 7: Disaster Recovery
- Veritas NetBackup (tm) 5.1 Troubleshooting Guide for UNIX and Windows, Chapter 7: Disaster Recovery
- Veritas NetBackup (tm) 6.0 Troubleshooting Guide for UNIX and Windows, Chapter 7: Disaster Recovery
This outlines the steps and caveats to observe when restoring the NetBackup catalogs.

7. If any NetBackup client systems were upgraded to NetBackup 6.5, it will be necessary to reinstall the previous version of the NetBackup client software.

Backing out of a failed upgrade where the media server remained at NetBackup 5.x:
NetBackup 6.x supports the use of a NetBackup 5.x media server.  This allows an upgrade of the master server without requiring the immediate upgrade of all media servers.  However, there are still changes that are made to the NetBackup 5.x media server that must be undone when backing out of an upgrade.  If the nbpushdata -modify_5x_hosts command has been run the vm.conf, robotic_def, ltidevs and mediaDB files will be converted to a NetBackup 6.x format. The steps to back out of an upgrade involving a NetBackup 5.x media server are different than a NetBackup 6.x media server.  This is the only system that does not require a valid NetBackup 5.x catalog backup exist in order to back out of the upgrade.  

1. Stop the NetBackup services on the 5.x media server.
# cd /usr/openv/netbackup/bin/goodies
# ./netbackup stop

2. If the NetBackup master server was downgraded to NetBackup 5.x then edit the /usr/openv/volmgr/vm.conf file and remove the following entry:
NOT_DATABASE_HOST
This option is only needed when connecting to a NetBackup 6.x master server.

3. The nbpushdata -modify_5x_hosts command will create backup copies of the volmgr database files.  To restore these files run the following commands:
# cd /usr/openv/volmgr/database
# cp robotic_def.tpacbak robotic_def
# cp ltidevs.tpacbak ltidevs
# cp mediaDB.bak mediaDB

4. Restart the NetBackup services on the 5.x master server.
# cd /usr/openv/netbackup/bin/goodies
# ./netbackup start

Once the NetBackup master server has been properly recovered, run a series of backup and restore tests to verify connectivity between the master server, media servers and clients.  




Legacy ID



290186


Article URL http://www.symantec.com/docs/TECH52786


Terms of use for this information are found in Legal Notices