Veritas NetBackup™ Upgrade Guide
- About changes in NetBackup 8.1.2
- Planning for an upgrade
- Master server upgrade
- Media server upgrade
- MSDP upgrade for NetBackup
- NetBackup Deployment Management with VxUpdate
- Appendix A. Reference
- About the NetBackup web user interface
Performing local, remote, or clustered server upgrades on Windows systems
Use the following procedure to upgrade to NetBackup 8.1.2 on a local, a remote, or a clustered computer.
To upgrade the NetBackup binaries for a local, remote, or clustered server on Windows
- Log on to the system where you want to initiate the NetBackup upgrade. Be sure to log on with administrator privileges.
To upgrade local Windows systems, log on to the computer directly at the console.
To upgrade remote Windows systems, log on to a system with network access to all of the hosts where you want to install NetBackup.
To upgrade clustered Windows systems, log on to the active node (the node with the shared disk).
- Navigate to the directory where the ESD images (downloaded files) reside and run Browser.exe to start the NetBackup Installation Wizard.
- On the initial browser screen (Home), click Installation.
- On the Installation screen, click Server Software Installation.
- On the Welcome screen, review the content and click Next.
- (Conditional) If you previously installed NetBackup 8.1.2 on this host, you see the Program Maintenance dialog.
Select Modify to change installation settings for the local host, or to use the local host as a platform to perform push installation to remote hosts.
Select Repair to restore NetBackup 8.1.2 to its original state on the local host.
Select Remove to remove NetBackup 8.1.2 from the local host.
- On the License Agreement screen, do the following:
I agree to and accept the terms of the license agreement.
You must select this item to upgrade the software.
- On the Veritas NetBackup Installation Type screen, provide the following information:
Where to install
For a local upgrade, select Install to this computer only.
For a remote upgrade, select Install to multiple computers on your network.
For a clustered upgrade, the only option is Install a clustered master server.
Select this option to upgrade NetBackup with the default settings.
Select this option to override the default NetBackup settings.
- On the NetBackup License and Server Type screen, provide the following information:
For upgrades, the license for the existing installation type determines which components you can select.
For remote upgrades, the license that you enter here gets pushed to the other nodes. Your license may enable add-on products. If you push NetBackup to nodes that have an add-on product already installed, your license works for the add-on product(s).
For remote or for clustered upgrades, the following occurs during the upgrade process to verify that you have the proper credentials to perform the upgrade:
When you select a clustered system for upgrade, NetBackup determines if you have proper administrator credentials on all nodes in the cluster. If you do not have the proper credentials, the system is not added to the list.
If you have the proper credentials, NetBackup performs a second check to determine if a license is needed. If a license is needed and one was not entered, the system cannot be added to the list. You must enter a valid license to upgrade on that node. If you enter an invalid license, this screen remains visible until a valid license is entered.
Click NetBackup Master Server to proceed to upgrade the master server software.
Click NetBackup Media Server to proceed to upgrade the media server software.
On the Customer Registration Key screen, enter the location of the customer registration key. You download this file from the Veritas Smart Meter site and place the file on the appropriate master server. More information about Veritas Smart Meter is available.
During install and upgrade to NetBackup 8.1.2, please allow the installer to copy the
veritas_customer_registration_key.jsonfile to its final destination. NetBackup can set the file permission and ownership correctly through this process. If you place the file onto your systems outside of the install or the upgrade process, the process may not work correctly.
Be aware that NetBackup does not support the short file name format (8.3 format) for the customer registration key file name.
- On the NetBackup Web Services screen, enter the Web Services Password.
This password is the password for the NetBackup web services user account. You must create this account before you install the master server. More information is available.
On the NetBackup Web Services screen, specify the account type and the account details.
What types of acccounts should we use?
Select either Local or Domain (Active Directory).
Select Local if you want to associate the web server with a user and a group account that exist on the local host.
Select Domain (Active Directory) if you want to associate the web server with a user and a group account that exist on a trusted Windows domain.
What are the existing account details
Specify the information as shown:
Domain - If you chose the Domain (Active Directory) account type, specify the name of the domain to which the user and the group accounts belong.
Group - Specify the name of the group account to associate with the web server.
User - Specify the name of the user account to associate with the web server. For security reasons, do not specify a user account that has administrative privileges on the host.
Password - Specify the password of the user account in the User field.
More information is available.
- This step applies only to Custom upgrades. For Typical installations, skip to the next step.
This step describes how to select and configure the NetBackup Features, NetBackup Port Numbers, and the NetBackup Services.
NetBackup Port Numbers
On this screen, you can change port numbers, if it is necessary in your configuration.
You may need to change a port number if you encounter conflicts when NetBackup and another industry product try to share the same port. Another example is if a port conflict occurs with a firewall, which may cause security issues.
To change a port number, select the port number that you want to replace and type the new number.
On this screen, provide the following startup account and startup type information for NetBackup services:
Specify either Local System account or This account.
By default, the Local System account is selected, so that NetBackup uses the built-in system account. When this option is selected, the fields below it are disabled.
To specify a different system account:
Select This account.
Enter the account information in the following fields:
This option determines whether NetBackup services start automatically if you need to restart the NetBackup host. The default is Automatic.
To start NetBackup services manually after a restart, select Manual.
Start job-related NetBackup services following installation
By default, job-related services are set to start automatically after the upgrade has completed.
To prevent job-related services from starting automatically, click on the box to clear the check mark.
Safe Abort Option
This option determines how the upgrade proceeds if a restart is required as part of the upgrade.
If you select this option and the upgrade process determines that a restart is required, the upgrade stops. The system is then rolled back to its original state.
If you do not select this option, the upgrade proceeds even if the upgrade process determines that a restart is required.
- On the NetBackup System Names screen, provide the following information:
Master Server Name
For master server installations, enter the name of the local computer.
For media server installations, you must change the name to the master server name to which the media server is configured.
For clustered servers, this field is NetBackup Virtual Host Name. Veritas strongly recommends that you not change this value.
Enter the names of any additional NetBackup master servers and media servers that you want to communicate with this server. Include the names of computers where you plan to install NetBackup later.
To enter more than one name, separate each name with a comma or press Enter after each name.
Media Server Name
This field appears only for NetBackup Enterprise media server installations.
When you install media server software, this field defaults to the local server name.
OpsCenter Server Name (Optional)
OpsCenter is a web-based administration and management tool for NetBackup.
If you have an OpsCenter server or plan to install one, enter the server name or the IP address for that server here.
For a clustered server, do not use the virtual name. Instead, use the actual host name of the cluster node.
For remote upgrades only, on the Veritas NetBackup Remote Hosts screen, specify the hosts where you want NetBackup installed.
Windows Destination Systems
Right-click Windows Destination Computers and select from the drop-down menu, or use the following methods:
Click here to search the network for the hosts where you want to upgrade NetBackup.
On the Available Systems dialog box, select the computer to add and click Next.
On the Remote Computer Login Credentials dialog box, enter the user name, the password, and the domain of the account for NetBackup to use on the remote computers.
If you plan to upgrade multiple remote computers, click the box next to Remember User Name and Password. Selecting this option prevents the need to enter this information for each remote computer.
When you provide credentials, you select host nodes and add them to the Windows Destination Systems list. These are the nodes on which you remotely upgrade NetBackup. Make sure that you select your local host when you select systems to install.
Each time you choose a system, NetBackup performs system and license checks. For example, it verifies the system for a server upgrade that matches the type that you selected, as follows:
NetBackup not installed: Considers the remote to be verified.
NetBackup already installed: Compares the upgrade type on that system to the upgrade type that you request.
Invalid combination: Notifies you of the problem and disallows the choice. One example of an invalid combination is to try to install a Remote Administration Console on a remote system that is already a master server.
Remote system not a supported platform or level: Notifies you of the problem and disallows the choice.
The upgrade procedure also verifies that you have proper administrator credentials on the remote system. If you do not have administrator credentials, the Enter Network Password screen appears, and prompts you to enter the administrator's user name and password.
Click OK and continue selecting destination systems.
This process repeats for each node that you select. You can elect to retain the user name and password. In that case, you are prompted only when the user name or password is not valid.
Note the following about the push-install process in a clustered environment:
You can upgrade NetBackup on any number of nodes. However, the clustering service sets the limit for the number of nodes in a cluster, not NetBackup.
Language packages and other NetBackup add-on products cannot be upgraded with the push method. Add-on products must be upgraded on each individual node in the cluster group. For instructions on how to upgrade these products, refer to the NetBackup documentation that supports each product.
NetBackup pushes to the other nodes only the license you enter at the beginning of the upgrade. Your license may enable add-on products. If you push NetBackup to nodes that have an add-on product already installed, your license works for that product.
Click here to import a text file that contains a list of host names. When you create the text file, the host names must be defined in the following format:
Click here to add a host manually.
On the Manual Remote Computer Selection dialog box appears, enter the Domain and the Computer Name, then click OK.
On the Remote Computer Login Credentials dialog box, enter the User Name and the Password of the account to be used to perform the upgrade on the remote computers.
If you plan to add and upgrade multiple remote computers, click the box next to Remember User Name and Password. Selecting this option prevents the need to enter this information for each remote computer.
To remove a host from the Destination Systems list, select the host and click here.
Click here to change the destination for NetBackup file installation on the selected remote host.
- For cluster upgrades only, on the Cluster Settings screen, review the information displayed. All information except the Public Network is displayed for informational purposes and cannot be changed. If you need to change the public network, select the correct public network from the drop-down.
Click Cluster Configuration. When the successful cluster configuration message appears, click Next.
- On the Ready to Install the Program screen, review the Installation Summary that shows your selections from the previous steps.
Then select one of the following options:
Click Install to start the installation.
Click Back to view the previous screens and make any changes, then return to this screen and click Install.
Click Cancel to cancel the upgrade.
After you click Install, the upgrade process begins and a screen appears that shows you the upgrade progress. This process may take several minutes.
For remote or for cluster upgrades only, right-click on a system in the dialog box to see the upgrade status. Up to five upgrades occur simultaneously. When an upgrade is completed, another one begins so that a maximum of five upgrades are in progress.
- For remote upgrades only, when all remote upgrades have completed, click Finish.
- On the Installation Complete screen, select from the following options:
View installation log file
An upgrade log file provides detailed installation information and shows whether any errors occurred.
Examine the upgrade log at the following location:
When you perform a remote upgrade to multiple computers, this option only lets you view the log for the local computer. Each computer that you selected for upgrade contains its own upgrade log file. To view the log file of a remote computer, open a Windows Explorer window and enter \\<COMPUTERNAME>.
Search the upgrade log for the following error indications:
Strings that include
Return Value 3.
Important log messages that are color coded as follows:
Yellow = warning.
Red = error.
Select one of the following to complete the upgrade:
If you are done upgrading software on all servers, click the box next to Launch NetBackup Administration Console now and click Finish.
The NetBackup Administration Console starts a Configuration Wizard so that you can configure your NetBackup environment.
If you have more server software to upgrade, click Finish.
You can move on to the next computer and upgrade the necessary server software.
- If any NetBackup cluster configuration is modified manually or by any external script, make sure that the change is reflected correctly in NetBackup cluster registry. Contact Veritas Enterprise technical support if you have questions.
- The binaries are successfully installed. Proceed to the post-installation procedure.
More information is available.