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

Article:TECH76644  |  Created: 2009-01-10  |  Updated: 2012-09-04  |  Article URL http://www.symantec.com/docs/TECH76644
Article Type
Technical Solution

Product(s)

Issue



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


Solution



Details:
Manual: NetBackup Installation Guide UNIX and Linux Release 7.0, Chapter 6: Uninstalling NetBackup Server Software, Page 78

Modification Type: Supplement

Modification:
The NetBackup 7.0 Installation Guide explains how to uninstall NetBackup 7.0.  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 7.0 due to a failed upgrade.  

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 7.0 and reinstalling the previous version of NetBackup.  

NOTE: This process requires a valid NetBackup 6.x catalog backup exists.  It also requires knowing what NetBackup 6.x version and what maintenance packs were installed prior to the NetBackup 7.x upgrade.  

Backing out of a failed upgrade where the master server or media server was upgraded to NetBackup 7.x:
Backing out of an upgrade of a NetBackup master server requires the following basic steps.  First, the NetBackup 7.x software must be completely removed from the system.  Second, the previous NetBackup version and maintenance packs/release updates 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 7.x software from the master server gather the software and maintenance packs/release updates 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 7.x software.

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

For other UNIX servers:
Follow steps 3 through 18 in the Uninstalling NetBackup on All Other UNIX Servers section of Chapter 6 in the NetBackup 7.0 Installation Guide for UNIX.  These steps remove the NetBackup 7.0 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 7.x installation has occurred before the uninstall.  When backing out of a failed NetBackup 7.x upgrade there is no need to make another catalog backup.

3. Once the software has been removed check for any NetBackup 7.x components that were not completely removed.  This helps prevent any future installation issues if the master server is upgraded to NetBackup 7.x 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 6.x version that was running prior to the NetBackup 7.x 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 6.x maintenance packs, visit the Support Web site at:
<http://www.symantec.com/enterprise/support/overview.jsp?pid=15143>

5. Once the NetBackup 6.x 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) 7.0 Troubleshooting Guide for UNIX and Windows, Chapter 7: Disaster Recovery
This outlines the steps and caveats to observe when restoring the NetBackup catalogs.

6. If any NetBackup client systems were upgraded to NetBackup 7.x, it will be necessary to reinstall the previous version of the NetBackup client software.
 
 
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.  
 
Related Documents:
 
VERITAS NetBackup (tm) 7.0 Troubleshooting Guide for UNIX and Windows.
VERITAS NetBackup (tm) 7.0 Installation Guide for UNIX and Linux
 


Legacy ID



337043


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


Terms of use for this information are found in Legal Notices