Document1 12/11/2012 2:36 AM Last saved by vjaye

EMC Solutions for NetWorker Procedure Generator

Topic
Upgrading NetWorker

Selections Made
Which version are you upgrading from?: 7.4.x Which version are you upgrading to?: 7.6.x Which release of 7.6?: 7.6 SP2 Choose Installation Level: Client Operating System: Solaris Is AlphaStor installed on this machine?: No Is DPA/EBA installed on this machine?: No Is HomeBase installed on this machine?: No JRE 1.5 Installed?: No JRE 1.6 Installed?: No IPv6 installed?: No VCB backups?: No CIFS backups?: No Configure ConnectEMC (Windows x86 only)?: No LDAP Authentication for NMC Configured?: No Include Management Console configuration steps?: No Include basic Management Console navigation tips?: No

Procedure Generated on: 1/6/2012 8:03:07 PM

REPORTING PROBLEMS: If you find any errors in this procedure or have comments regarding this application, please send email to PG-Feedback@emc.com. .

Table of Contents
Download the NetWorker Software and Documentation .............................................................................. 3 Pre-installation Considerations for all Operating Systems .................................................................... 3 Considerations for NetWorker server hosts file changes ......................................... 3

Pre-Installation Considerations on Solaris Operating Systems

Tune shared memory use/open files for Solaris 9 ........................................................................................ 4 Disable TCP Fusion on Solaris 10 ................................................................................................................ 4

Document1 12/11/2012 2:36 AM Last saved by vjaye TCP Performance Tuning ............................................................................................................................. 4 Configure Jumbo frames ............................................................................................................................... 5 Install the required Solaris 10 patch for x86/Sparc ....................................................................................... 5 Install the required CDE/Motif patch on Solaris 10 Sparc V240 ................................................................... 5 Solaris 10 on Sparc and x86 with Intel Gigabit Ethernet Card considerations ............................................. 6 Confirm that libm.so.2 is available for Direct SCSI backups ......................................................................... 6 Disable the vold daemon with optical drives on Solaris 9 ............................................................................. 6 Server error when configuring LDAPS authority on Solaris .......................................................................... 6 SSL Key Length Limitation on Solaris AMD 64............................................................................................. 7 Java (JRE) is no longer shipped with NetWorker. ........................................................................................ 7 Prevent drive ordering issues in a SAN environment ................................................................................... 7

Backup the GST Database Uninstall the NetWorker Software on Solaris

Install the NetWorker for Solaris client .......................................................................................................... 8 Optional Java installation .................................................................................................................... 10 Optional NetWorker Management Console installation ...................................................................... 10 Review customizations and start the daemons ................................................................................... 11

Document1 12/11/2012 2:36 AM Last saved by vjaye

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 on powerlink.emc.com at: Support > Technical Documentation and Advisories > Software ~ J-O ~ Documentation > NetWorker Family 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 desired hotfixes for specific NetWorker releases are available in the following section on powerlink.emc.com: Home > Products > Software E-O > NetWorker > Key Enhancements/Support Notes 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. IMPORTANT: As new cumulative builds are released the corresponding Cumulative Build documentation is also updated. Click on the Alert Me! button to automatically receive an email notification whenever new NetWorker cumulative builds are released.

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.

Document1 12/11/2012 2:36 AM Last saved by vjaye

Pre-Installation Considerations on Solaris Operating Systems

This section describes pre-installation considerations for Solaris.

Tune shared memory use/open files for Solaris 9

Tune shared memory open files on Solaris 9: 1. [ ] Make a copy of the /etc/system file. For example: /etc/system.orig 2. [ ] Modify the values for the following parameters in /etc/system if the values are lower than the recommended values listed below: set set set set set set set set msgsys:msginfo_msgmni=1024 msgsys:msginfo_msgtql=1024 semsys:seminfo_semmni=2048 semsys:seminfo_semmns=2048 semsys:seminfo_semopm=128 shmsys:shminfo_shmmax=33554432 shmsys:shminfo_shmmni=512 rlim_fd_max=4096

Note: Setting these values incorrectly can cause the system to become unbootable. To recover, type boot, and type /etc/system.orig for the name of the system file.

Disable TCP Fusion on Solaris 10

If used, TCP Fusion should be disabled on Solaris 10 NetWorker servers and storage nodes. To disable TCP Fusion: 1. [ ] Edit the /etc/system file and add this line:
set ip:do_tcp_fusion = 0

2. [ ] Reboot to enforce the change.

TCP Performance Tuning

For high-speed network interfaces, increase the size of TCP send/receive buffers from their default values as required: 1. [ ] Increase the maximum buffer size to control how large the send and receive buffers are set to by an application if below 10485760. a. Run ndd /dev/tcp tcp_max_buf to determine current value. b. Run ndd -set /dev/tcp tcp_max_buf 10485760 to increase the value 2. [ ] Increase the maximum value of the TCP congestion window (cwnd) can grow to in bytes if below 10485760. c. Run ndd /dev/tcp tcp_cwnd_max to determine current value. d. Run ndd -set /dev/tcp tcp_cwnd_max 10485760 to increase the value 3. [ ] Increase the TCP receive-Buffers if below 65536: a. Run ndd /dev/tcp tcp_recv_hiwat to determine current value.

Document1 12/11/2012 2:36 AM Last saved by vjaye b. Run ndd -set /dev/tcp tcp_recv_hiwat 65536 to increase the value 4. [ ] Increase the TCP transmit Buffers if below 65536: a. Run ndd /dev/tcp tcp_xmit_hiwat to determine current value. b. Run ndd -set /dev/tcp tcp_xmit_hiwat 65536 to increase the value

Configure Jumbo frames

It is recommended to use jumbo frames in environments capable of handling them. If both the source and the computers, and all equipment in the data path are capable of handling jumbo frames, increase the MTU to 9 KB: Use the following command to configure jumbo frames for an nxge device.
ndd -set /dev/nxge<#> accept-jumbo 1

where <#> is replaced with the driver instance number Note: To determine the instance number of a following device, run the command nxge /etc /path_to_inst

Install the required Solaris 10 patch for x86/Sparc

To avoid shared memory corruption causing possible hangs or failures of the NetWorker services on a NetWorker server, Sun patch142900-03 (or later) on Sparc or Sun Patch 142901-03 (or later) on x86 or later must be applied. To confirm this patch is applied: 1. [ ] On Solaris Sparc servers, type this command:
showrev -p | grep 142900

2. [ ] On Solaris x86 servers, type this command:

showrev -p | grep 142901

Note: This patch has dependencies on other system patches. Ensure that all requirements are met before applying the patch.

Install the required CDE/Motif patch on Solaris 10 Sparc V240

In order for nwrecover to function correctly, Sun patch 119280-10 (or later) on Sparc or Sun patch 119281-10 (or later) on x86 must be applied. To confirm this patch has been applied: 3. [ ] On Solaris Sparc servers, run the following command:
showrev -p | grep 119280

4. [ ] On Solaris x86 servers, type the following command:

showrev -p | grep 119281

Note: This patch has dependencies on other system patches. Ensure that all requirements documented in the patch are met before applying the patch.

Document1 12/11/2012 2:36 AM Last saved by vjaye

Solaris 10 on Sparc and x86 with Intel Gigabit Ethernet Card considerations
Backups of large savesets may fail on Solaris 10 systems if an Intel Gigabit Ethernet card (e1000g driver) is used. To avoid this issue, Sun patch 102712-01 (or later) on Sparc or Sun patch 102711-01 (or later) on x86 must be applied. To confirm this patch has been applied: 1. [ ] On Solaris Sparc servers, run the following command:
showrev -p | grep 102712

2. [ ] On Solaris x86 servers, type the following command:

showrev -p | grep 102711

Confirm that libm.so.2 is available for Direct SCSI backups

Direct SCSI backup and restore is a NetWorker feature that allows back up to business continuance volumes (BCVs) on an EMC Symmetrix server. It also allows the backup and recover of raw devices over a SCSI bus. Direct SCSI backups facilitate the migration of an EDM server using EDM OIM to backup and restore Symmetrix BCVs to a NetWorker server. On Solaris 9 and 10 servers, /usr/lib/libm.so.2 is required for Direct SCSI backup and restores: 1. [ ] On the Solaris server, cd to /usr/lib. 2. [ ] Type ls -la | grep libm* and confirm in the output that libm.so.2 exists. 3. [ ] If libm.so.2 does not exist, link libm.so.1 using the following command:
ln -s /usr/lib/libm.so.1 /usr/lib/libm.so.2

Disable the vold daemon with optical drives on Solaris 9

To disable the vold daemon: 1. [ ] Log in as root on the NetWorker storage node, and remove or move all script files matching the following:
/etc/rc2.d/*volmgt

2. [ ] Type the following command:

/etc/init.d/volmgt stop

Note: Beginning in NetWorker 7.5, Solaris 8 is not supported and NetWorker License Manager is not supported on Opteron.

Server error when configuring LDAPS authority on Solaris

Attempt to configure LDAPS authority with gstd running on Solaris will fail with the following error: ldap_set_option(LDAP_OPT_X_TLS,1) failed with message 'Can't contact LDAP server Note: If LDAPS (LDAP over SSL) is used to authenticate users, and the NMC server must support LDAP v3 authentication, do not install the NMC server on the Solaris server. However, the NMC server can be installed on a Linux, Windows, AIX or HP-UX server for LDAPS authentication. The NMC server can be installed on a Solaris server if both LDAP and LDAPS, or only LDAP, protocols are enabled on the directory server.

Document1 12/11/2012 2:36 AM Last saved by vjaye

SSL Key Length Limitation on Solaris AMD 64

The default OpenSSL library on Solaris for AMD 64 does not support AES key lengths greater than 128bits. To workaround this limitation, install the Solaris 10 Encryption kit for i386 architecture, which includes the SUNWcryman, SUNWcry, and SUNWcryr packages. The Solaris 10 Encryption kit supports 256-bit key length AES encryption. The Solaris 10 Encryption kit is available at, http://www.sun.com/download/index.jsp?tab=2. Scroll to S to locate the link. Note: If the encryption kit is not installed, the nsrd daemon might not start.

Java (JRE) is no longer shipped with NetWorker.

When the NMC client starts, if a supported version of Java is not detected on the client, a message displays with instructions on how to install the appropriate version of Java. Note: A supported version of JRE must be installed on the NMC server if the Console command line reporting functionality (gstclreport) is required.

Prevent drive ordering issues in a SAN environment

Ensure that persistent binding is enabled in the fabric to prevent device target-id changes in the future. The HBA documentation provides details on how to setup persistent bindings in a SAN environment.

Backup the GST Database

Ensure there is a current backup of the GST database for the NetWorker Management Console (NMC) server. If a Client resource was not created when the NMC was installed and configured, create the Client resource: 3. [ ] From the Console window, click Setup. 4. [ ] From the Setup menu, select Set Database Backup Server. 5. [ ] In the NetWorker server attribute, type the name of the NetWorker server to back up the NMC server database. 6. [ ] Select the Create Client resource on this server attribute. 7. [ ] In the Client name attribute, type the name of the NMC server. 8. [ ] Click Ok. 9. [ ] Complete the Client resource with the following attributes: Name: the name of the NMC server computer. Save set:
NMCASA:/gst_on_server_name/lgto_gst

where server_name is the short name of the host on which the NMC server was installed. Backup Command:
savepsm (Windows NMC server) savepsm.sh (UNIX NMC server)

10. [ ] Add this client to a group and perform a full backup. To perform a full backup of this client in a defined group:

Document1 12/11/2012 2:36 AM Last saved by vjaye

savegrp v c <client> -l full -G <group>

where: <client> is the client name of the NMC server. <group> is the name of the group containing the NMC server.

Uninstall the NetWorker Software on Solaris

To uninstall the NetWorker software on Solaris: 1. [ ] Log on to the Solaris machine as root user. 2. [ ] Create a backup copy of NetWorker script files:
cp /etc/init.d/networker /etc/init.d/networker.7xx

Note: Customizations to the NetWorker startup script files are overwritten when NetWorker is installed. Be sure to make a copy of any customizations required after an installation. 3. [ ] Create a backup copy of the lus driver configuration.
cp /usr/kernel/drv/lus.conf /usr/kernel/drv/lus.conf.7xx

Note: This is not required on Solaris 10. 4. [ ] Shutdown the NetWorker daemons when there are no backups and recoveries running:
nsr_shutdown

5. [ ] Confirm that all NetWorker daemons have been stopped:

ps ef | grep nsr

6. [ ] Determine which packages need to be removed:

pkginfo | grep i lgto

7. [ ] Uninstall all of the NetWorker packages listed in the pkginfo output in the order listed below. Exclude packages not listed by the pkginfo command:
pkgrm LGTOlicm LGTOserv LGTOnode LGTOclnt LGTOman LGTOnmc LGTOfr LGTOja LGTOko LGTOzh

Note: Do not choose the default option All to remove the NetWorker software packages. Choosing this option removes all the software packages (not just NetWorker software) that were installed on the computer using the pkgadd utility. Also, do not remove the /nsr or the NMC database folders after uninstalling the software.

Install the NetWorker for Solaris client

To install the NetWorker Solaris client: 1. [ ] Make a copy of the following files which the NetWorker software installation modifies:
cp /etc/rpc /etc/rpc.org cp /etc/syslog.conf /etc/syslog.conf.org

2. [ ] Use the command line to navigate to the downloaded the NetWorker package. 3. [ ] Unzip the downloaded file to access the tar file.
gunzip <file_name>

4. [ ] Extract the individual package files from the archive

Document1 12/11/2012 2:36 AM Last saved by vjaye

tar xvf <file_name>

5. [ ] Type the following command:

pkgadd d <path_to_install_files>

The following output displays:

The following packages are available: 1 2 3 4 5 6 7 8 9 10 LGTOclnt LGTOfr LGTOja LGTOko LGTOlicm LGTOman LGTOnmc LGTOnode LGTOserv LGTOzh NetWorker Client (sparc) 7.6.Build.xxx NetWorker French Language Pack (sparc) 7.6.Build.xxx NetWorker Japanese Language Pack (sparc) 7.6.Build.xxx NetWorker Korean Language Pack (sparc) 7.6.Build.xxx NetWorker License Manager (sparc) 7.6.Build.xxx NetWorker Man Pages (sparc) 7.6.Build.xxx NetWorker Management Console (sparc) 7.6.Build.xxx NetWorker Storage Node (sparc) 7.6.Build.xxx NetWorker Server (sparc) 7.6.Build.xxx NetWorker Chinese Language Pack (sparc) 7.6.Build.xxx

Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:

6. [ ] Based on the above example, type 1. Note: There is also the option to install other NetWorker components such as the NetWorker License Manager. Type the number of the other optional components you wish to install. . If you choose to install the NetWorker Management Console (NMC), It is recommended to install it on a client machine. However, do NOT install it at this time. Install the NMC later, as described in Optional NetWorker Management Console installation, in this procedure. With 7.6.x, the HomeBase agent is automatically installed. 7. [ ] When all selections are made, press Enter to proceed. 8. [ ] When prompted to change the installation directory, press Enter to accept the default /var/nsr, or type the required path, and press Enter. 9. [ ] When prompted to add to the Servers file, type y and press Enter to add the hostname of the NetWorker servers. The client can only be backed up by NetWorker servers in this list. Note: If no servers are listed in the Servers file, any NetWorker server can backup this client. 10. [ ] When prompted to start the NetWorker daemons, type n and press Enter. 11. [ ] When prompted to continue the installation, type y and press Enter. 12. [ ] When the installation completes, type q to quit. 13. [ ] If not installing the NMC server on this host, proceed to Review customizations and start the daemons.

Document1 12/11/2012 2:36 AM Last saved by vjaye

Optional Java installation

To install JRE: 1. [ ] Before installing NMC, Java Runtime Environment 1.5 or later must be installed. Note: On Solaris 10, JRE 1.5 versions earlier than 1.5.0_09 are not supported. On Solaris 9, NMC help will not launch on JRE versions earlier than 1.5.0_09. 2. [ ] Java is no longer shipped with NetWorker, and Java can be obtained from the following location: https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US//USD/ViewProductDetail-Start?ProductRef=jre-6u12-oth-JPR@CDS-CDS_Developer Note: The download location might change in the future. 3. [ ] Select the platform and language, make the appropriate choices, agree to the Java License and click Continue. Note: If running in a pure IPv6 environment or NMC bundled with 7.6 SP1, install JRE version 1.6. 4. [ ] At the final download screen, click the JRE available under Available Files to begin the download. 5. [ ] A security warning might display. Click Save to continue the download. 6. [ ] Select a location to save the JRE, and click Save. 7. [ ] When the download completes, navigate to the java file from the command line. 8. [ ] Change the file permissions to allow it to run:
chmod +x jre-6u12-solaris-sparc.sh

Note: The file name can change depending on the version of Java. 9. [ ] Navigate to the downloaded Java files, and run the install script
./jre-6u12-solaris-sparc.sh

The script creates an install directory where it is run. 10. [ ] When prompted to accept the licensing agreement, review the License Agreement, type yes and press Enter to continue. 11. [ ] Proceed to the NMC installation.

Optional NetWorker Management Console installation

To install the NMC: 1. [ ] Install NMC:
pkgadd d <path_to_install_files>

The following output displays:

The following packages are available: 1 2 LGTOclnt LGTOfr NetWorker Client (sparc) 7.6.Build.xxx NetWorker French Language Pack (sparc) 7.6.Build.xxx

10

Document1 12/11/2012 2:36 AM Last saved by vjaye

3 4 5 6 7 8 9 10 LGTOja LGTOko LGTOlicm LGTOman LGTOnmc LGTOnode LGTOserv LGTOzh NetWorker Japanese Language Pack (sparc) 7.6.Build.xxx NetWorker Korean Language Pack (sparc) 7.6.Build.xxx NetWorker License Manager (sparc) 7.6.Build.xxx NetWorker Man Pages (sparc) 7.6.Build.xxx NetWorker Management Console (sparc) 7.6.Build.xxx NetWorker Storage Node (sparc) 7.6.Build.xxx NetWorker Server (sparc) 7.6.Build.xxx NetWorker Chinese Language Pack (sparc) 7.6.Build.xxx

Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:

2. [ ] Based on the above example, type 7. Note: If the environment has only LDAPS (also known as LDAP over SSL), and there is no native NetWorker user authentication, do not install the NMC server on a Solaris server. 3. [ ] When prompted to install NMC, type a path with enough free space. Note: NMC requires a minimum of 350 MB however, it is recommended to have more space available for NMC reporting features. 4. [ ] When prompted to specify a user/group with limited privileges for NMC to run the web server, set it for a non-root user. For example, Solaris operating systems have a default user/group [nobody/nobody] to use. Note: If the default group [nobody/nobody] does not exist, and a user/group has not been created with limited privileges, create a non-root user/group with limited privileges. 5. [ ] When prompted for the web server port, press Enter to accept the default, or type the required port number, and press Enter. 6. [ ] When prompted for the GST server port, press Enter to accept the default, or type the required port number, and press Enter. 7. [ ] When prompted for the NMC database, press Enter to accept the default, or type the required path, and press Enter. If prompted to keep the old database, choose y and press Enter. 8. [ ] When prompted for the installation location for the NetWorker binaries, press Enter to accept the default, or type the required path and press Enter. 9. [ ] When prompted to start the daemons, type n. 10. [ ] If the install folder (/opt/LGTOnmc by default) does not exist, when prompted to create the directory, type y and press Enter. 11. [ ] When prompted to continue the installation, type y. 12. [ ] When the installation completes, type q to quit.

Review customizations and start the daemons

To review the customizations:

11

Document1 12/11/2012 2:36 AM Last saved by vjaye 1. [ ] Review the startup script file that was copied during the uninstall operation: /etc/init.d/networker.7xx 2. [ ] Make the necessary modifications to the following file: /etc/init.d/networker Note: Do not overwrite the new files with the contents of the old 7xx files. The old customizations must be included in the new script and configuration file. 3. [ ] Start the NetWorker daemons and the NetWorker NMC daemon (gstd) if it was installed.
/etc/init.d/networker start /etc/init.d/gst start

12