EMC NetWorker SolVe Generator

Solution for Validating your engagement

Topic
Component Type

Selections
Which version are you upgrading from?: 7.6.x
Which version are you upgrading to?: 8.1.x
8.1 version: 8.1 SP1
Choose installation level: Server
Operating System: HP-UX
Is IPv6 used?: No

Generated:
8/3/2014 10:59:06 AM

SolVe Generator Updated:

TobesuryhavtlVSgnpicodew,ayshYnkdifouwptaheclsry.

REPORT PROBLEMS
If you find any errors in this procedure or have comments regarding this application, send email to
[email protected]

Copyright 2008 2015 EMC Corporation. All rights reserved.

Publication Date: August, 2014
EMC believes the information in this publication is accurate as of its publication date. The information is subject to
change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO
REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS
PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an applicable software
license.
For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories
section on EMC Powerlink.
For the most up-to-date listing of EMC trademarks, see the list of EMC Corporation Trademarks on EMC.com.
All other trademarks used herein are the property of their respective owners.

EMC CONFIDENTIAL

version: 5.0.1.4

1 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement

Contents
Download the NetWorker Software and Documentation..............................................................................3

Prepare the NetWorker server.............................................................................................4

Back up the configuration files...........................................................................................5
Pre-installation Considerations for all Operating Systems..............................................6
Considerations for NetWorker Server Hosts File Changes..........................................................................6

General considerations for HP-UX......................................................................................6

HP-UX 11iv3 considerations................................................................................................7
HP-UX 11iv2 requirements...................................................................................................7
HP-UX on PA-RISC considerations.....................................................................................7
Uninstall the NetWorker Software on HP-UX.....................................................................7
Delete the tmp directory.......................................................................................................8
Unzip and extract the NetWorker software package.........................................................8
Install the NetWorker server software on HP-UX......................................................................................... 8

Change the NetWorker servers with access to the machine..........................................10

Start the NetWorker daemons.............................................................................................................. 10

Restore startup script customizations.............................................................................10

Restart the NetWorker daemons.......................................................................................11
Optional, convert VCB client back ups to VADP..............................................................11
Confirm all of the storage nodes are updated..................................................................11
Update the Clone Storage Node attribute.........................................................................11
Authorize the NetWorker server........................................................................................12

EMC CONFIDENTIAL

version: 5.0.1.4

2 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement

Download the NetWorker Software and Documentation

To obtain the latest NetWorker software, and documentation:
1. [ ]
Review the online NetWorker documentation, for example the Administration Guide,
Installation Guide, and Release Notes for the latest information.
2. [ ]

Obtain the online documentation at support.emc.com.

3. [ ]
Obtain the required NetWorker cumulative hotfix media kits that provide customers with
the opportunity to install the latest version of NetWorker including important hotfixes. Cumulative
builds are released approximately once a month and each build contains a rollup of the fixes in each
previous build. If additional hotfixes are required in an environment where a cumulative build is
installed, hotfixes can be generated for use with the latest cumulative version. The cumulative
releases for specific NetWorker versions are available at support.emc.com.

Select the appropriate NetWorker version. Open the Cumulative Fix Summary document for details
regarding fixes that are included in each build, knowledge base articles related to the fixes in each
build, as well as download instructions.

Interoperability and backward compatibility

When you update the NetWorker server or Console server software from 8.0.x to 8.1.x, you can revert to
the NetWorker 8.0.x software without additional steps.
After you update the NetWorker server or Console server to version 8.1.x, you cannot revert to a 7.6.x or
earlier version without additional steps. The NetWorker Installation Guide provides the steps required to
downgrade the NetWorker software.
Before you update any host in the data zone, review information about the interoperability and backwards
compatibility.
The following table summarizes interoperability and backward compatibility requirements.
When updating

Interoperability Information

7.6.x and earlier storage nodes

NetWorker 8.1.x server supports NetWorker 8.0.x and

later storage nodes only.
Update all NetWorker 7.6.x storage nodes to version
8.1.x before updating the NetWorker server. This
includes storage nodes that are operating on standalone
servers and dedicated storage nodes operating on
application servers. Update storage nodes embedded
within the EMC Disk Library (EDL SN) to NetWorker
8.0.x. EDL SN does not support NetWorker 8.1.x.
Note: A NetWorker 8.1.x server disables NetWorker 7.6.x
and earlier storage nodes.

7.5.x NetWorker server

You cannot directly update a NetWorker 7.5.x server to

NetWorker 8.1.x.
Use the following method to update the hosts in a
NetWorker 7.5.x data zone:
1. Update the NetWorker 7.5.x server to version 7.6.x.
2. Update each NetWorker storage node to version

EMC CONFIDENTIAL

version: 5.0.1.4

3 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement
8.1.x. NOTE: Update an EDL SN to NetWorker 8.0
3. Update the NetWorker 7.6.x server to version 8.1.x.
4. Update the NetWorker clients to version 8.1.x.
8.0.x or 8.1 NetWorker server with synthetic full backups

Starting with NetWorker 8.1 SP1, you cannot set the

synthetic full (synth_full) backup level for a group. When
you update the NetWorker server to 8.1 SP1, the backup
level for a group that was configured to use the synth_full
backup level will be blank.
Before you update the NetWorker server software from
8.0.x or 8.1 to 8.1 SP1 and later, change the backup
level from synth_full to incr_synth_full for Groups and
scripts that perform synthetic backups by using the
savegrp command.

7.5.x Console server

Update a NetWorker 7.5.x Console server directly to

NetWorker 8.1.x when the Console server is not the
NetWorker server.

NMM 2.3 clients

NetWorker 8.1.x does not support NMM 2.3. Update

hosts to NMM 2.4 SP1 before you update the NetWorker
server and storage nodes.

Storage node

NetWorker 7.6.x and 8.0.x server supports a NetWorker

8.1.x storage node.

Console server

Console server 8.1.x supports NetWorker 7.6.x and 8.0.x

servers.
When the Console server is not the NetWorker server,
update the Console server before you update the
NetWorker server. NetWorker 7.6.x and 8.0.x Console
servers do not support NetWorker 8.1.x servers.

Clients

NetWorker 8.1.x server supports NetWorker 8.0.x and

7.6.x clients.
The Client Configuration Wizard supports NetWorker 7.6
SP4 or later client only.
NetWorker 7.6.x and 8.0.x servers and storage nodes
support NetWorker 8.1.x clients.

Operating system

Update the operating system first, and then update the

NetWorker software.

Prepare the NetWorker server

Before you update the NetWorker server, ensure that the media database and client file indexes are in a
consistent state and that you have a backup of the databases.
To prepare the NetWorker server, perform these steps from a command prompt on the NetWorker server
as root on UNIX or administrator on Windows.
1. [ ]

Put the NetWorker databases in a consistent state:

EMC CONFIDENTIAL

version: 5.0.1.4

4 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement
nsrim -X
nsrck -m
nsrck -L6
2. [ ]

Record the current location of the NetWorker media database:

nsrls m
3. [ ]

Record the current location of the NetWorker client file indexes:

nsrls
4. [ ]

Record the range of ports the NetWorker software uses:

nsrports
5. [ ]
Perform a back up of the bootstrap, the client file indexes, and the resource database on
the NetWorker server.

For example:
savegrp -O group

To back up all client file indexes, specify a group that contain all the NetWorker clients in the
datazone.
If a group that contains all the clients does not exist, run multiple savegrp commands, specifying a
different group each time, until you back up all clients indexes.
ote:

Ensure the media pool associated with the group has appendable media available.
Record the latest bootstrap save set ID (ssid) including the file number, the record
number, and the associated volume label.
6. [ ]

For example:
mminfo -B
date time
level ssid
10/11/11 16:29:40 full

file
record volume
4254377781
0 0 bootstrap_vol.001

In this example:

The save set ID (ssid) is 4254377781.

The file number is 0.
The record number is 0.
The label of the volume which contains the bootstrap save set is bootstrap_vol.001.

Back up the configuration files

The NetWorker software installation process overwrites the existing NetWorker startup script files. Back
up the configuration files prior to installing the NetWorker software.
To back up the NetWorker configuration files:
1. [ ]

Log in to the target machine as root.

2. [ ]

Create a backup copy of the /sbin/init.d/networker file.

Back up the syslog.conf file before removing the previous version of the NetWorker software. The
NetWorker entries created during the NetWorker 7.6.x and earlier software installation process are
deleted, when the NetWorker software is removed.
EMC CONFIDENTIAL

version: 5.0.1.4

5 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement
In the NetWorker 8.0 and later software, the syslog.conf file is not modified during the installation process.

Pre-installation Considerations for all Operating Systems

Misconfigured loopback entries in the hosts file can cause backups to fail. When an entry is made in the
hosts file for localhost, localhost must be entered before aliases (for example, loopback) the order is:
address localhost alias
For example:
IPv6 localhost entry:
::1 localhost loopback
IPv4 localhost entry:
127.0.0.1 localhost loopback

Considerations for NetWorker Server Hosts File Changes

NetWorker server always takes the first alias specified in the OS hosts file as the NetWorker server name.
If the first alias in hosts file is different than the current NetWorker server name client resource, the next
time the NetWorker daemons/services start, NetWorker will rename the NetWorker server to the first alias
listed in the hosts file. This will assign a different clientid to the NetWorker servers client resource and will
result in a failure to restore backups for both the NetWorker server and configured clients.
To avoid this issue, when modifying the hosts file makes sure that the first alias for the IP address of the
NetWorker server matches exactly the name defined for the client resource of the NetWorker server.

General considerations for HP-UX

Perform these tasks before you install the NetWorker software on HP-UX.
1. [ ]
Review the NetWorker Software Compatibility Guide for the latest information about
supported HP-UX operating systems for each NetWorker installation type.
2. [ ]

Ensure that the kernel parameter maxfiles_lim is set to a minimum value of 8192.

3. [ ]

Set the nfile value, according to the following formula:

The nfile setting + (number of expected concurrent save times)

The minimum value for the number of expected concurrent save times is 50.
For example:
nfile = 1 X 50
4. [ ]

Ensure that the /etc/nsswitch.conf file contains an ipnodes policy:

ipnodes=files

If you do not specify an ipnodes policy, the NetWorker daemons fail to start with a
message similar to the following:
lgtolmd: Failed to resolve the IPv6 localhost address ::1. Please verify an
entry for the IPv6 localhost address exists in your /etc/hosts file and an
"ipnodes" policy has been added to your /etc/nsswitch.conf file.

EMC CONFIDENTIAL

version: 5.0.1.4

6 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement

HP-UX 11iv3 considerations

Before installing the NetWorker software on HP-UX 11iv3, review the following considerations:
If stape is used on an HP-UX11iv3 NetWorker server or storage node, install patch PHKL_36312 or
later.
This will enhance tape device compatibility.
For HP-UX NetWorker servers and storage nodes that are configured to use tape devices, install
PHKL_41474 or higher.
This is required for CDI support.
If you back up the /dev directory to a local HP-UX 11iv3 storage node, then the backup may fail, and
the system may fail to respond.
To avoid this issue, implement one of these options:
ote:

Do not back up the /dev directory.

ote:
Do not specify ALL in the client Save Set attribute or use a directive to exclude the /dev
directory from the backup.
ote:

Do not specify save sets that include the /dev directory in the backup.

ote:

Use a remote storage node.

HP-UX 11iv2 requirements

Before installing the NetWorker software on HP-UX 11iv2, ensure that the PHSS_37500 and
PHSS_39101 patches are installed on the machine.

HP-UX on PA-RISC considerations

This section describes the software considerations for HP-UX on PA-RISC.
Before installing the NetWorker software on HP-UX RISC, ensure that the following patches are installed
on the machine:
QPK1123(B.11.23.0712.070a) 1185010 Quality Pack Depot
PHSS_37492

Uninstall the NetWorker Software on HP-UX

Before removing the NetWorker software, remove the NetWorker module software including the
NetWorker Module for Databases and Applications. The appropriate module installation guide describes
how to uninstall the module software.
Use the swremove utility to uninstall the NetWorker software.
To uninstall the NetWorker software packages:
1. [ ]

Log on to the target machine as root.

2. [ ]
Shutdown the NetWorker and NMC (if installed) daemons when there are no backups and
recoveries running:
/sbin/init.d/gst stop

EMC CONFIDENTIAL

version: 5.0.1.4

7 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement
nsr_shutdown
3. [ ]

Confirm that the daemons are stopped:

ps ef | grep nsr
ps ef | grep gstd
4. [ ]

To start the NetWorker software removal process, type:

swremove &

ote:

For the character interface, omit the & symbol from the swremove command.
On the Software Selection window, select the NetWorker software to be removed.

5. [ ]
6. [ ]

On the Actions window, select Remove.

This runs an analysis of the remove operation.

7. [ ]

To confirm that the analysis did not detect any problems, click Logfile.

8. [ ]

Fix any reported problems before continuing with the operation.

9. [ ]

On the Remove Analysis window, click OK to proceed with the remove operation.

10. [ ]

On the Remove window, click Done.

11. [ ]

On the File menu, select Exit.

12. [ ]

Verify that all the files are removed from /opt/networker directory.

Delete the tmp directory

When the NetWorker software is uninstalled, delete the contents of the NetWorker tmp directory, /nsr/tmp.

Unzip and extract the NetWorker software package

Unzip the NetWorker software package on the target machine:
1. [ ]
From a command prompt, navigate to the directory that contains the NetWorker software
package and extract the package contents:

a. If the file was zipped, unzip the downloaded file to access the tar file:
gunzip file_name
b. Extract the individual package files from the archive:
tar -xvf file_name

Install the NetWorker server software on HP-UX

To install the NetWorker server software on HP-UX:
1. [ ]

Log in to the target host as root.

2. [ ]

Make a copy of the rpc.org file:

cp /etc/rpc /etc/rpc.org

EMC CONFIDENTIAL

version: 5.0.1.4

8 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement
At the system prompt, type:

3. [ ]

swinstall &
If you are using the character interface, do not include the & symbol.
4. [ ]

Press the Enter key.

5. [ ]

On the Specify Source window, provide the location of the NetWorker installation files:

a. In the Source Depot Type field, press Enter and select Local Directory.
b. In the Source Host Name field, ensure that the hostname of the target machine is selected.
c. In the Source Depot Path field, type the full path of the NetWorker.pkg file.

For example:
/tmp/hpux11_ia64/NetWorker.pkg

Click Ok.

6. [ ]

7. [ ]
On the SD Install - Software Selection window, select and mark the NWr-Client, NWrNode and NWr-Server packages and each optional package, as required. The following table
provides a list of the available NetWorker packages.
To install the:

Select these packages:

Server software

NWr-Client
NWr-Node
NWr-Server

French language support

NWr-FR

Japanese language support

NWr-JA

Korean language support

NWr-KO

Simplified Chinese language support

NWr-ZH

Man pages

NWr-Man

8. [ ]

Press Enter.

9. [ ]

On the Actions menu, click Install.

10. [ ]

Verify the status of the install analysis.

ote: To review the log file and verify that the swinstall program did not encounter errors, click
Logfile.
ote:

Correct any problems before proceeding with the installation.

11. [ ]

To proceed with the installation, click OK.

12. [ ]

To review the log file for error or warning messages generated during installation, click

Logfile.
13. [ ]

When the installation completes, click Done.

14. [ ]

Exit swinstall.

Change the NetWorker servers with access to the machine

By default, any NetWorker server can:
EMC CONFIDENTIAL

version: 5.0.1.4

9 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement
Back up this machine.
Perform a directed recover to this machine.
To specify the NetWorker servers that are allowed to perform backups and directed recoveries on this
machine:
1. [ ]

Shut down the NetWorker daemons:

nsr_shutdown
2. [ ]

Edit or create the /nsr/res/servers file.

Specify the NetWorker servers, one per line, that require access to the machine.
Consider the following:

When no servers are specified, any NetWorker server can back up this machine.
When no servers are specified, any NetWorker server can perform a directed recovery to the client.
When adding NetWorker servers, specify both the short name and FQDN for each NetWorker server.
The first entry in this file becomes the default NetWorker server.

Start the NetWorker daemons

Start the NetWorker daemons and confirm that they start successfully.
To start the NetWorker daemons, type:
/sbin/init.d/networker start
To confirm that the NetWorker daemons started successfully, type:
ps -ef | grep nsr

Restore startup script customizations

This section describes how to add startup script customizations that were made on previous versions of
the NetWorker software, to the new nsrrc file.
The NetWorker 8.0 software introduces support for a new environment variable file. This file, nsrrc, is
sourced prior to starting the nsrexecd and nsrd processes. This new file will not be overwritten by
subsequent software updates.
Add environment variables previously defined in the NetWorker startup files to this new file:
1. [ ]
Review the startup script file that was copied before the previous version of the
NetWorker software was removed.

ote: Do not overwrite the new startup files with the contents of the .orig files. The old customizations must be
added to the new environment variable file.
2. [ ]
Create a Bourne shell script file called nsrrc in the /nsr directory.
3. [ ]

Add the required environment variables and the export command to the nsrrc file.

For example:
ENV_VAR_NAME=value
export ENV_VAR_NAME
4. [ ]
Save the file.
EMC CONFIDENTIAL

version: 5.0.1.4

10 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement
5. [ ]

Stop the NetWorker daemons.

6. [ ]

Start the NetWorker daemons.

Restart the NetWorker daemons

During a NetWorker server update only:
1. [ ]

Stop the NetWorker daemons

2. [ ]

Start the NetWorker daemons.

This is required to complete the update process.

Optional, convert VCB client back ups to VADP

A backup and recovery of VMware virtual clients that uses the vStorage APIs for Data Protection (VADP)
program is supported with the NetWorker 7.6 SP2 software and later. Prior to NetWorker 7.6 SP2, virtual
NetWorker clients were protected with VMware Consolidated Backups (VCB) program.
After installing the NetWorker software on the NetWorker server and the VM Proxy server, run the
nsrvadpserv_tool command on the NetWorker server to convert virtual clients from VCB to VADP
backups. The NetWorker Release 8.0 VMware Integration Guide provides more information.

Confirm all of the storage nodes are updated

The NetWorker 8.0 server does not support a NetWorker 7.6.x and earlier storage node. Ensure that all
NetWorker storage nodes are updated to the NetWorker 8.0 software.

Update the Clone Storage Node attribute

When you update the NetWorker server software to NetWorker 8.0 and later, a new Clone Storage Node
attribute is automatically created for each existing Storage Node resource. This attribute is used to
determine which storage node is used when writing clone data.
In the NetWorker 7.6.x and earlier software, the Clone Storage Node attribute was present in each
NetWorker client resource. After a NetWorker server software update, the Clone Storage Node attribute is
still present in each client resource but the attribute is read-only and the attribute is not used by the
NetWorker 8.0 server to determine which storage node to use when the writing clone data for the client.
By default, the Clone Storage Node attribute for each storage node resource does not contain any values.
If required, after updating the NetWorker server software, modify the Clone Storage Node attribute for
each storage node. The section Directing clones to a special storage node in the NetWorker 8.0
Administration Guide provides more information.

Authorize the NetWorker server

The NetWorker software adds a required update enabler code to the NetWorker server configuration
database. This enabler code cannot be deleted. The update enabler code expires 45 days after the
NetWorker server update, unless capacity-based licensing is used.
Contact EMC Licensing within 45 days of upgrading the NetWorker server to permanently authorize the
update enabler. The NetWorker 8.0 Licensing Guide describes how to authorize an update enabler and
how to use the capacity-based license model.

EMC CONFIDENTIAL

version: 5.0.1.4

11 of 12

EMC NetWorker SolVe Generator

Solution for Validating your engagement
ote: If the update enabler expires or the authorization code is not applied, the NetWorker software will
not function at the new release level.

EMC CONFIDENTIAL

version: 5.0.1.4

12 of 12