Professional Documents
Culture Documents
version 8.2.2
Installation/Upgrade Guide
Version: Product Number: NVG-105-8.2.2-EN-01
NVG-105-8.2.2-EN-01 05/01/09
Copyrights
This software product is copyrighted and all rights are reserved. The distribution and sale of this
product are intended for the use of the original purchaser only per the terms of the License
Agreement. All other product trademarks are the property of their respective owners.
The NetVault: Backup v8.2.2 - Installation/Upgrade Guide documentation is copyrighted and all
rights are reserved.
This document may not, in whole or part, be copied, photocopied, reproduced, translated,
reduced or transferred to any electronic medium or machine-readable form without prior consent
in writing from BakBone Software.
THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-
INFRINGEMENT.
BakBone Software
9540 Towne Centre Drive, Suite 100 San Diego, California 92121 866.484.2663
Table of Contents
Preface 9
Chapter 1: Introduction 11
- Windows ........................................................................................................................................ 66
PREFACE
About this Document
This guide provides complete details on installing the NetVault: Backup Server and
Client software. It does not provide information on the NetVault: Backup features
and functionality. For details on using NetVault: Backup, refer to the NetVault:
Backup Administrator’s Guide.
Target Audience
This guide is intended for Backup Administrators and other technical personnel
who are responsible for designing and implementing a backup strategy for the
organization. A good understanding of the operating systems under which the
NetVault: Backup Server and Clients are running is assumed.
Organization
The Installation/Upgrade Guide is organized as follows:
Chapter 1: Introduction gives an overview of NetVault: Backup and describes
the features and benefits of the product.
Chapter 2: NetVault: Backup Architecture Overview gives an overview of
NetVault: Backup deployment and architecture.
Chapter 3: Pre-installation Requirements describes the pre-installation
requirements for the NetVault: Backup system.
Chapter 4: NetVault: Backup Server Installation describes the procedure for
installing the NetVault: Backup Server software.
Chapter 5: NetVault: Backup Client Installation describes the procedure for
installing the NetVault: Backup Client software.
Chapter 6: Unattended Installation of NetVault: Backup ddescribes how to
install NetVault: Backup Server and Client in a non-interactive mode.
Chapter 7: Upgrading NetVault: Backup describes how to perform an
upgrade.
Chapter 8: NetVault: Backup Plugin Installation provides information on
installing NetVault: Backup Plugins.
Chapter 9: Licensing NetVault: Backup – This chapter provides information
on licensing NetVault: Backup.
Chapter 10: Uninstallation describes the procedures for uninstalling NetVault:
Backup.
10 Preface
Technical Support
BakBone Software is dedicated to providing friendly, expert advice to NetVault
customers. Our highly trained professionals are available to answer your
questions, offer solutions to your problems and generally help you make the most
of your NetVault purchase. Log on to our Web site for more information:
http://support.bakbone.com
Documentation Updates
For the latest documentation updates, refer to the BakBone Software Knowledge
Base. BakBone's Knowledge Base article for NetVault: Backup v8.2.2 can be
found at the following link:
http://kb.bakbone.com/4338
NetVault: Backup
Installation/Upgrade Guide
11
Chapter 1:
INTRODUCTION
This chapter gives an overview of NetVault: Backup and describes the features
and benefits of the product. The information in this chapter is organized into the
following topics:
NetVault: Backup – At a Glance
Key Benefits
Feature Summary
Increased Automation
NetVault: Backup's event notification enhancements and policy based job
management features provide increased automation, especially when
deployed across heterogeneous storage networks. NetVault: Backup enables
administrators to define, manage and monitor jobs from remote clients, while
the flexible notification feature ensures business continuance with the ability
to define event contexts and triggers, tailoring the product to meet your
unique requirements.
Lower Total Cost of Ownership
By dramatically simplifying implementation and networked storage
administration, NetVault: Backup ensures improved data availability while
reducing the associated labor costs. The product can significantly lower TCO
and provide a return on initial software investment in as little as six to nine
months.
Chapter 2:
NETVAULT: BACKUP
ARCHITECTURE OVERVIEW
This chapter gives an overview of NetVault: Backup architecture. The information
in this chapter is organized into the following topics:
NetVault: Backup Architecture – An Overview
Architecture Components
VMware Plugin
e
e vic
p eD
e Ta
ic
ev
p eD rve
r
Ta e
eS
Fil
y
ib rar
eL
N
A
p
Ta
L
al
Vir
tu NA rve
r
S eS
e
Fil
d
he
ac
Att ge
ion ork tora
tat tw S
s Ne
W ork
tor
tra e
nis as lly
mi tab ver ca ice
Ad Da Ser mi Dev
na
Dy ared
Sh
N
A
ge
S
an r
ch ve
Ex Ser
I
S
C
IS
r/
e
y
rox r
ib
F
B P ve e
VC Ser Ta
p
al
irtu ry
r e d VL i b r a
a
l
tua es Sh NetVault: Backup
Vir chin
Ma Server
14 Chapter 2
NetVault: Backup Architecture Overview
The NetVault: Backup Server must be deployed first, followed by the individual
Clients. This arrangement of a single NetVault: Backup Server and its associated
Clients constitutes a NetVault: Backup Domain.
NDMP
The Network Data Management Protocol (NDMP) is designed to efficiently
transfer large blocks of data across a LAN or SAN to a storage device. For
Network Attached Storage devices utilizing NDMP, backups are performed
via a high performing protocol rather than using less efficient file sharing
methods such as NFS or CIFS. NetVault: Backup can send NDMP data
directly to a locally attached SCSI device, a SAN-attached storage device
(tape or VTL) or to a storage device elsewhere on the network. NetVault:
Backup offers advanced NDMP features such as Browsable Volume and
Direct Access Restore (DAR) support, which helps restore files quickly by fast
positioning to the required data on the storage device (tape or VTL). Files can
be selected and restored at the directory level. NDMP is the only truly server-
less backup technology.
Dynamically Shared Devices
Dynamically Shared Devices (DSD) is LAN-free backup at its best by allowing
more than one system to utilize a tape drive connected to a Fiber Channel
SAN, IP SAN using iSCSI. Tape drives (Physical or Virtual) are dynamically
assigned on demand to any SmartClient, NDMP device, or NetVault: Backup
Server for duration of the backup/restore.
Application Plugin Modules
NetVault: Backup supports Application Plugin Modules (APMs) for online
backups for a wide variety of database and messaging applications – such as
Oracle, SQL Server, Exchange, MySQL, PostgreSQL, Lotus Notes/Domino,
DB2, Informix, and Sybase. With the APMs, NetVault: Backup Servers and
Clients can be enhanced to perform application specific backups. Interfacing
with the native APIs, NetVault: Backup draws data from the applications and
catalogs backup data according to application type, all in a simple point-and-
click manner, within NetVault: Backup's GUI.
NetVault: Backup
Installation/Upgrade Guide
17
Chapter 3:
PRE-INSTALLATION
REQUIREMENTS
This chapter describes the pre-installation requirements for the NetVault: Backup
system. The information in this chapter is organized into the following topics:
Planning New Installations
Determine NetVault: Backup Server and Client Machines
Determine NetVault: Backup Database (NVDB) Location
Determine NetVault: Backup Machine Names
Prerequisites
Platform Specific Prerequisites
Additional Requirements on Linux-based Systems
Additional Notes
Important: A NetVault: Backup Server can serve as a Client to itself for the backups and
restores of its local data.
18 Chapter 3
Pre-installation Requirements
Important: Each file and directory backed up requires an average number of bytes for an
index entry in the NVDB. This average is based on a formula of 71 bytes plus the average
number of characters contained in the files that make up a target file system.
How Many Generations of Each File are Being Kept - Each generation is a
separate instance of a file or directory backup. For example, if the same file is
backed up seven times, using default backup settings, there are seven
generations of the file held on media and indexed in the NVDB. By default,
backups have an infinite life (i.e., the number of generations increases for
every backup, causing the NVDB to continuously grow in size). Most systems
cannot handle this amount of storage requirement, so one of the NetVault:
Backup Administrator's tasks is to ensure that a suitable Backup Life is
applied to each backup (a setting found in the Advanced Options tab of the
NetVault: Backup
Installation/Upgrade Guide
19
Backup window). For more information on Backup Life, refer to the
NetVault: Backup Administrator’s Guide.
Illegal Characters in a Machine Name - Although the core software will still
function regardless of how the machine is named, certain aspects of
20 Chapter 3
Pre-installation Requirements
NetVault: Backup may not function properly when the NetVault: Backup
machine name includes any of the following characters:
Non-Number/Letter Alpha-Numeric Characters - This includes, “! @ #
$ % ^ & * ( )” as well as the colon (“:”), and hyphen (“-”).
Japanese/Korean/Chinese Characters
Important: It is highly recommended that only the following characters be used when
generating a NetVault: Backup machine name: standard uppercase characters (e.g., “A - Z”),
standard lowercase characters (e.g., “a - z”), and standard numerals (e.g., “0 - 9”).
3.2 Prerequisites
The following requirements must be met before starting a NetVault: Backup Server
or Client installation.
Review Release Notes and Supported Platform Matrix – Prior to initiating
an installation of NetVault: Backup, it is of critical importance that you
thoroughly review the Release Notes. This document may contain important
information regarding installation and use of the NetVault: Backup software.
You must also review the NetVault: Backup Supported Platform Matrix to
verify the platforms, operating system versions, devices and application
versions supported by the current release of NetVault: Backup.
NetVault: Backup Graphic Requirements – To properly use the NetVault:
Backup GUI, it is recommended that you set your system’s screen resolution
to 1280 x 1024 or higher. Low resolution settings may result in display issues
when using the GUI.
Permissions – All target machines must have O/S permissions set that will
allow the user to install software components.
System Memory – Memory requirements on a target system can vary based
on the intended use.
User Mode (Runlevel) – On Linux/UNIX platforms, boot into multi-user
mode.
Disable Anit-virus Software – While it is possible to leave anti-virus
software running on a target machine, it is recommended that you disable this
software before attempting to perform an installation or upgrade of NetVault:
Backup. The NetVault: Backup installation process may conflict with anti-virus
software during installation and various NetVault: Backup operations may not
function properly after the installation.
Ensure TCP/IP Connectivity and Name Resolution – Once the machines
which will host the NetVault: Backup Server and Client software have been
established, it is necessary to ensure that good TCP/IP connectivity and
Name Resolution exists between the proposed NetVault: Backup Server and
each potential NetVault: Backup Client.
22 Chapter 3
Pre-installation Requirements
3.3.1 AIX
On AIX, load the NetVault SCSI Driver contained in the file image as described
below:
On AIX 5.x, use the SMIT utility to load the NetVault SCSI Driver.
On AIX 6.1, issue the following command to install the AIX5changer
(assuming the binary is in /tmp):
installp -acqd /tmp/aix5changer netvault.chm
Then, issue the following command to automatically search and configure the
media changer:
/usr/lpp/netvault/addchm
3.3.5 Linux/Unix
The NetVault: Backup installation will fail on Linux/UNIX platforms if the installation
directory is a mount point. The NetVault: Backup installation script tries to delete
24 Chapter 3
Pre-installation Requirements
the existing contents on the mount point (which isn’t allowed in a UNIX-based
environment) and the installation will fail. To work around this issue, create a sub-
directory below the mount point, and install NetVault: Backup to that directory.
Important: The various distributions of Linux might have slight differences. As a result, the
list given here is only representative.
libICE.so.6
libSM.so.6
libX11.so.6
libXext.so.6
libXp.so.6
libXt.so.6
NetVault:
Backup
dependencies
listed using the
“find”
command on a
system
running Linux
(e.g., a
RedHat
distribution of
Linux)
For OpenMotif, you will require a 32-bit binary since its GUI is a 32-bit
application.
Even though NVDB is not installed on NetVault: Backup Clients, the
installation script prompts for the NVDB path during client installations on
Solaris platform. This path can be left as is during installation, as NVDB
location is irrelevant for NetVault: Backup Clients.
NetVault: Backup
Installation/Upgrade Guide
29
Chapter 4:
Important: All of the prompts revealed during the installation process have a default
selection for which it is possible to simply hit the Enter key to automatically select this default
value and continue. These options will appear at the end of each prompt, enclosed in brackets
(“[ ]”). For a detailed example of these prompts, refer to the section Example Installation on a
Linux/UNIX-based System on page 45.
Important: All of the prompts revealed during the installation process have a default
selection for which it is possible to simply hit the Enter key to automatically select this default
value and continue. These options will appear at the end of each prompt, enclosed in brackets
(“[ ]”). For a detailed example of these prompts, refer to the section Example Installation on a
Linux/UNIX-based System on page 45.
NetVault: Backup
Installation/Upgrade Guide
31
Important: All of the prompts revealed during the installation process have a default
selection for which it is possible to simply hit the Enter key to automatically select this default
value and continue. These options will appear at the end of each prompt, enclosed in brackets
(“[ ]”). For a detailed example of these prompts, refer to the section Example Installation on a
Linux/UNIX-based System on page 45.
32 Chapter 4
NetVault: Backup Server Installation
Important: All of the prompts revealed during the installation process have a default
selection for which it is possible to simply hit the Enter key to automatically select this default
value and continue. These options will appear at the end of each prompt, enclosed in brackets
(“[ ]”). For a detailed example of these prompts, refer to the section Example Installation on a
Linux/UNIX-based System on page 45.
Important: All of the prompts revealed during the installation process have a default
selection for which it is possible to simply hit the Enter key to automatically select this default
value and continue. These options will appear at the end of each prompt, enclosed in brackets
(“[ ]”). For a detailed example of these prompts, refer to the section Example Installation on a
Linux/UNIX-based System on page 45.
Important: All of the prompts revealed during the installation process have a default
selection for which it is possible to simply hit the Enter key to automatically select this default
value and continue. These options will appear at the end of each prompt, enclosed in brackets
(“[ ]”). For a detailed example of these prompts, refer to the section Example Installation on a
Linux/UNIX-based System on page 45.
Important: All of the prompts revealed during the installation process have a default
selection for which it is possible to simply hit the Enter key to automatically select this default
value and continue. These options will appear at the end of each prompt, enclosed in brackets
(“[ ]”). For a detailed example of these prompts, refer to the section Example Installation on a
Linux/UNIX-based System on page 45.
Important: All of the prompts revealed during this process have a default selection for
which it is possible to simply hit the Enter key to automatically select this default value and
continue. These options will appear at the end of each prompt, enclosed in brackets (“[ ]”). For
a detailed example of these prompts, refer to the section Example Installation on a Linux/
UNIX-based System on page 45.
Important: All of the prompts revealed during this process have a default selection for
which it is possible to simply hit the Enter key to automatically select this default value and
continue. These options will appear at the end of each prompt, enclosed in brackets (“[ ]”). For
a detailed example of these prompts, refer to the section Example Installation on a Linux/
UNIX-based System on page 45.
2. With the CD-ROM inserted in the drive, initiate a terminal session and issue
the command listed below:
pkgadd -d /cdrom/netvault/solaris_x86/netvault
3. With the installation successfully initiated, a step-by-step setup process will
begin. Follow the on-screen prompts as they are given and provide the
desired information.
4. When confronted with the “Should a Client or Server version of NetVault
be installed?” select “S” for a NetVault: Backup Server installation and
press Enter to continue.
Important: All of the prompts revealed during this process have a default selection for
which it is possible to simply hit the Enter key to automatically select this default value and
continue. These options will appear at the end of each prompt, enclosed in brackets (“[ ]”). For
a detailed example of these prompts, refer to the section Example Installation on a Linux/
UNIX-based System on page 45.
Important: All of the prompts revealed during this process have a default selection for
which it is possible to simply hit the Enter key to automatically select this default value and
continue. These options will appear at the end of each prompt, enclosed in brackets (“[ ]”). For
a detailed example of these prompts, refer to the section Example Installation on a Linux/
UNIX-based System on page 45.
Important: All of the prompts revealed during this process have a default selection for
which it is possible to simply hit the Enter key to automatically select this default value and
continue. These options will appear at the end of each prompt, enclosed in brackets (“[ ]”). For
a detailed example of these prompts, refer to the section Example Installation on a Linux/
UNIX-based System on page 45.
Important: All of the prompts revealed during this process have a default selection for
which it is possible to simply hit the Enter key to automatically select this default value and
continue. These options will appear at the end of each prompt, enclosed in brackets (“[ ]”). For
a detailed example of these prompts, refer to the section Example Installation on a Linux/
UNIX-based System on page 45.
NetVault: Backup
Installation/Upgrade Guide
41
Important: The decompressed files directory will contain two executables, setup.exe and
install.exe. To support the use of all language formats, ensure that the install.exe file is used to
initiate the installation. For English version, select setup.exe.
Via Installation CD - Insert the CD into the CD-ROM drive. Locate and
run the install.exe file. The file should be located as follows:
<CD-ROM drive>\netvault\windows\netvault\install.exe
Figure 4-2: 3. With the executable file
The Choose launched, an installation
Installation wizard will be activated,
Type window
with the Server
offering step-by-step
radial button instructions via individual
selected for a windows. Using what was
Server
installation of established during the pre-
NetVault: requisite phase, process
Backup
each window’s request and
click on the Next button to
continue.
4. When confronted with the window asking for the type of installation, select the
Server radio button and click on the Next button to continue with the
installation process.
Important: For a detailed explanation of the windows offered in this wizard, refer to the
section Example Installation on a Windows-based System on page 48.
42 Chapter 4
NetVault: Backup Server Installation
4.9.2 Solaris 10
Important: This procedure is only required for Solaris 10 machines with direct-attached
backup devices. If performing an installation of NetVault: Backup to a machine that does not
control a device, this process can be skipped.
Library devices directly attached to a Solaris 10 system require that you configure/
use the “sgen” driver utility in order to completely add the library device to the
NetVault: Backup Server (e.g., in order for the NetVault: Backup Server to access
the library device’s robotic arm when a user adds a library). It is strongly
recommended that you accommodate for this issue, prior to installing. Follow the
steps below to accomplish this:
1. Log in to the machine to which the device is directly attached and launch a
terminal session. Ensure that the device is recognized by the operating
system, by inputting the following commands:
cfgadm -al
cfgadm -al -o show_FCP_dev XX:WWN
cfgadm -o force_update -c unconfigure/configure XX or
XX:WWN or XX:WWN:LUN
2. From the terminal session prompt, navigate to the following directory:
/kernel/drv/
3. In this directory, locate the file “sgen.conf” and open it for editing. Ensure
that the sgen driver is configured to attach to the target device (e.g., the
“sgen” line of this file should look similar to the folowing:
name="sgen" parent="fp" target=0 lun=0;
NetVault: Backup
Installation/Upgrade Guide
43
Important:
1. Fibre channel devices need to be bound with “WWN” entries. Therefore, the “sgen”
line should look something like the following example:
name="sgen" parent="fp" target=0 lun=0 fc-port-
wwn="1000000cc4c8m0";
2. Editing the sgen.conf file may require that you reboot the target system
4. Validate that the sgen driver has successfully created the necessary device
files by:
Step 1: Checking to ensure that the “/devices” directory exists:
/devices/pci@7c,0/pci1022,7458@2/pci1077,1401/fp@0,0
/sgen@w1000000cc4c8m0
Step 2: Checking to ensure that the “/dev/scsi/changer” directory
contains the appropriate files and these files have been properly
associated to the target device:
/dev/scsi/changer/c2t1000000cc4c8m0d0
5. Create a symbolic link in the “/dev” directory for the NetVault: Backup device
file associated with the hardware path used in the “/dev/scsi/changer”
directory:
ln -s /devices/pci@7c,0/pci1022,7458@2/pci1077,1401/
fp@0,0
/sgen@w1000000cc4c8m0 /dev/nv0
6. Validate that the symbolic link was successfully created, and that it has the
correct permissions, by issuing the following command from the prompt:
/dev/nv0 -> pci@7c,0/pci1022,7458@2/pci1077,1401/fp@0,0
/sgen@w1000000cc4c8m0,0:changer
4.9.4 Windows
Important: This procedure is only required for a Microsoft Windows system that has a
backup device directly attached to it. If the installation target does not control a device, this
process can be skipped.
On Windows, the locally-attached backup devices must not be under the control of
the Windows Removable Storage service. You must disable the Windows
Remote Storage Manager on the machine. To remove devices from this service,
perform the following steps:
1. Boot the Windows machine and log in as an Administrator-level user (i.e.,
logged on as the standard Administrator account or an account with this
same level of access).
2. From the desktop after successful boot, right-click on the My Computer icon
and choose the Manage command from the pop-up menu that appears in
order to access the Computer Management window.
3. Navigate through each level of the tree until the desired device is displayed.
4. Right-click on the device and select Properties.
5. On the General tab, clear the Enable library check box.
6. Click Apply to set the change, and then OK to exit the dialog box.
Figure 4-3:
The Enable
library item de-
selected.
NetVault: Backup
Installation/Upgrade Guide
45
Important: This section only details the prompts that are offered once an installation has
been executed on a Linux/UNIX-based machine. For complete details on the steps required to
initiate an installation, please see the relevant operating system’s section outlining this
procedure in this chapter.
Figure 4-5:
The initial
screen of the
license
agreement of
NetVault:
Backup, as
displayed
when the “D”
option is
selected
2. The next prompt asks which version of NetVault: Backup should be installed.
The following selections are available:
Figure 4-6:
The installation
type prompt
appears next
C (Default Selection) - This refers to a “Client” installation of NetVault:
Backup. With this type of installation the machine will be set up to serve as
a client of the NetVault: Backup Server (i.e., its data can be backed up
under the control of a NetVault: Backup Server). This machine will either
need to be added to an existing NetVault: Backup Server or use its GUI to
access the Domain Management window and select an existing NetVault:
Backup Server to act as its domain manager. This installation offers the
quickest install and requires a lesser amount of space on the target
machine.
S - This refers to a “Server” installation of NetVault: Backup. The
recipient machine can then be configured to regulate the backup of all
NetVault: Backup machines that are later added to it (i.e., NetVault:
Backup Clients). With this installation a little more space is required as the
NetVault: Backup Server software requires a directory to house the NVDB
-- a database that contains all relevant information pertaining to NetVault:
Backup operations.
NetVault: Backup
Installation/Upgrade Guide
47
Figure 4-7: 3. With the installation
The installation type selected, the next
location prompt requests the
prompt
appears next
user to input a desired
installation directory for NetVault: Backup. The default installation directory
“[/usr/netvault]” (“[/opt/netvault]” on Solaris machines) can be selected
by hitting the Enter key. This directory will be automatically created and the
installation will reside there. Otherwise, a directory can be manually input for
use.
Important: If selecting a directory other than the default, this directory must exist prior to
installation. The installation software will not automatically create a directory.
The NVDB
location
prompt
Important: As with the installation directory, when selecting a directory other than the
default for the NVDB, this directory must exist prior to installation. The installation software
will not automatically create a directory.
The installation
process as it is
performed
followed by the
message
stating the
“Installation
completed
successfully”
Important: This section only details the actual installation wizard and not the steps
required to initiate a Windows-based O/S install. For complete details on these steps, please
see the relevant operating system’s section outlining this procedure.
Important: If the setup.exe file is used to initiate the installation, the language selection
option does not appear, because the setup.exe file is meant for installing the English-only
version of NetVault: Backup. The Setup Wizard, described in step 2, is the first window that
appears when setup.exe is run.
Important:
1. If a directory other than the default is selected as a location to house the NVDB, this
directory must exist prior to installation. If a non-existent directory is input in this field,
NetVault: Backup will not automatically create it and the installation will fail.
2. The “Select NetVault Database Folder” window only appears when installing the
NetVault: Backup Server software. You will not be prompted to select a NVBD folder if
you are installing the NetVault: Backup Client software.
Chapter 5:
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45. Note that no prompt will be
displayed for installation type (Server or Client).
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45. Note that no prompt will be
displayed for installation type (Server or Client).
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45. Note that no prompt will be
displayed for installation type (Server or Client).
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45. Note that no prompt will be
displayed for installation type (Server or Client).
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
NetVault: Backup
Installation/Upgrade Guide
57
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
58 Chapter 5
NetVault: Backup Client Installation
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
62 Chapter 5
NetVault: Backup Client Installation
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
Important: For a detailed example of the full installation process, refer to the section
Example Installation on a Linux/UNIX-based System on page 45.
64 Chapter 5
NetVault: Backup Client Installation
Important: The decompressed files directory will contain two executable files, setup.exe
and install.exe. In order to support the use of all language formats, ensure that the install.exe
file is used to initiate the installation. For English version, select setup.exe.
Via Installation CD - Insert the CD into the CD-ROM drive. Locate and
run the install.exe file. The file should be located as follows:
<CD-ROM drive>\netvault\windows\netvault\install.exe
Figure 5-23: 2. With the executable file launched, an installation
The Choose wizard will be activated, offering step-by-step
Installation instructions via individual windows. Using what
Type window
with the Server
was established during the prerequisite phase,
radial button process each window’s request and click on the
selected for a Next button to continue.
Server
installation of 3. When confronted with the window asking for the
NetVault:
Backup
type of installation, select the Client radial button
and click on the Next button to continue with the installation process.
Important: For a detailed explanation of the windows offered in this wizard, refer to the
section Example Installation on a Windows-based System on page 48.
NetVault: Backup
Installation/Upgrade Guide
65
5.10.4 Ubuntu
On Ubuntu, modify the startup script for NetVault: Backup as described below.
This is required because the /var/lock folder resides on a temporary file system on
Ubuntu and gets emptied each time the operating system is shut down.
1. Open the file /usr/netvault/etc/startup.sh.
2. Find the following section of the startup.sh file:
if [$OS = Linux]
then
touch /var/lock/subsys/netvault
Add the following entry (shown in bold) to the startup.sh file:
if [$OS = Linux]
then
[-d /var/lock/subsys] || mkdir -p /var/lock/subsys
touch /var/lock/subsys/netvault
66 Chapter 5
NetVault: Backup Client Installation
5.10.6 Windows
On Windows, the locally-attached backup devices must not be under the control of
the Windows Removable Storage service. You must disable the Windows
Remote Storage Manager on the machine. For details on this post-installation
requirement on Windows, refer to Windows on page 44.
NetVault: Backup
Installation/Upgrade Guide
67
Chapter 6:
UNATTENDED INSTALLATION OF
NETVAULT: BACKUP
This chapter describes how to install NetVault: Backup Server and Client in
non-interactive mode. The information in this chapter is organized into the
following topics:
Unattended Installation on Windows
msiexec
Installation Procedure
Examples
Unattended Installation on Linux/UNIX Using the Installer Program
Linux Common Installer
Installation Procedure
Examples
Unattended Installation on Solaris and MP-RAS UNIX Using pkgadd
pkgask
pkgadd
Installation Procedure
Examples
6.1.1 msiexec
The syntax for an unattended installation using msiexec is given below:
msiexec /quiet /package <Windows Installer Package>
[Optional Parameters]
/quiet – This option performs the installation in a quiet mode without any user
interaction.
/Package – Specifies the NetVault: Backup installation file. Provide the full
file path if the package does not reside in the current directory.
68 Chapter 6
Unattended Installation of NetVault: Backup
6.1.3 Examples
Following are a few examples of the msiexec command:
To perform an uninterrupted installation of NetVault: Backup Client with the
default values for all parameters, issue the following command:
msiexec /quiet /package <file path for the extracted
files>/netvault.msi
To perform an uninterrupted installation of NetVault: Backup Server with the
default values for all parameters, issue the following command:
msiexec /quiet /package <file path for the extracted
files>/netvault.msi CLIENTSERVER=2
To specify a NetVault: Backup name during an uninterrupted installation of
NetVault: Backup Server, issue the following command:
msiexec /quiet /package <file path for the extracted
files>/netvault.msi CLIENTSERVER=2
LOGICAL_NAME=”NVBU-Server” Password=”abcxyz12”
To install the Japanese version of NetVault: Backup Server, issue the
following command:
msiexec /quiet /package <file path for the extracted
files>/netvault.msi CLIENTSERVER=2
LOGICAL_NAME=”NVBU-Server” Password=”abcxyz12”
NVLANGUAGE=”Japanese”
To specify an installation directory for NetVault: Backup Server, issue the
following command:
msiexec /quiet /package <file path for the extracted
files>/netvault.msi CLIENTSERVER=2
LOGICAL_NAME=”NVBU-Server” Password=”abcxyz12”
TARGETDIR=”D:\TstDir”
70 Chapter 6
Unattended Installation of NetVault: Backup
6.2.3 Examples
Following is a sample response file for the NetVault: Backup Server
installation:
PKG_BASE="/usr/netvault"
DB_DIR="/usr/netvault/db"
PASSWORD="abcxyz12"
CHOSEN_CLASSES="core server dataplugin devicectl gui
onlinehelp"
LOGICAL_NAME="NVBU-Server"
NVLANGUAGE="English"
Following is a sample response file for the NetVault: Backup Client
installation:
PKG_BASE="/usr/netvault"
DB_DIR="/usr/netvault/db"
PASSWORD="abcxyz12"
CHOSEN_CLASSES="core dataplugin devicectl gui onlinehelp"
LOGICAL_NAME="NVBU-Client"
NVLANGUAGE="English"
Important: For a NetVault: Backup Client installation, do not include the server component
when setting the CHOSEN_CLASSES variable.
72 Chapter 6
Unattended Installation of NetVault: Backup
6.3.1 pkgask
A response file is a text file which provides answers for the questions that would
be asked during the installation process. The pkgask command performs a
dummy installation of the package, and records all the answers in a response file.
Each answer is stored as a value for a variable identified in the response file. The
syntax for pkgask is given below:
pkgask -r <response file> <package>
response file – Name of the response file. Full file path must be specified if
you do not want to create the file in the current directory. The response file
will contain values for the following variables:
PKG_BASE – The installation directory for NetVault: Backup.
DB_DIR – The location for the NVDB.
PASSWORD – The password for NetVault: Backup Server or Client.
CHOSEN_CLASSES – The NetVault: Backup components that are to be
installed. The standard components include the following:
core
dataplugin
devicectl
gui
online help
For NetVault: Backup Server installation, the following component is also
included:
server
LOGICAL_NAME – The name for the NetVault: Backup Server or Client.
NVLANGUAGE – The language settings for NetVault: Backup. This
variable will take one of the following values:
Chinese (for Chinese Traditional)
ChineseSimp (for Chinese Simple)
English
French
German
NetVault: Backup
Installation/Upgrade Guide
73
Japanese
Korean
These values are case-sensitive.
<package> – The name of the package that is to be installed.
6.3.2 pkgadd
The syntax for an unattended installation using pkgadd is given below:
pkgadd -n -a <admin file> -d <device> -r <response file>
<package>
-n – This option performs the installation in a non-interactive mode. The
default mode is interactive
-a <admin> – The installation administration file to use. An administration file
specifies the default installation actions by assigning values to installation
parameters. For example, it allows administrators to specify whether to
perform an interactive or a non-interactive installation, or how to proceed
when the package being installed already exists on the system, etc.
-d <device> – full path name to the directory or the identifiers for fixed or
removable device that contains the package to be installed.
-r <response file> – Full file path for a response file that was created from a
previous pkgask session.
<package> – The name of the package that is to be installed.
6.3.4 Examples
Following is a sample response file for the NetVault: Backup Server
installation:
PKG_BASE="/usr/netvault"
DB_DIR="/usr/netvault/db"
PASSWORD="abcxyz12"
CHOSEN_CLASSES="core server dataplugin devicectl gui
onlinehelp"
LOGICAL_NAME="NVBU-Server"
NVLANGUAGE="English"
Following is a sample response file for the NetVault: Backup Client
installation:
PKG_BASE="/usr/netvault"
DB_DIR="/usr/netvault/db"
PASSWORD="abcxyz12"
CHOSEN_CLASSES="core dataplugin devicectl gui onlinehelp"
LOGICAL_NAME="NVBU-Client"
NVLANGUAGE="English"
Important: For a NetVault: Backup Client installation, do not include the server component
when setting the CHOSEN_CLASSES variable.
Chapter 7:
UPGRADING NETVAULT:
BACKUP
This chapter describes how to perform an upgrade. The information in this chapter
is organized into the following topics:
Upgrade – Overview
Pre-upgrade Procedures
Back up the Existing NVDB
Stop NetVault: Backup Processes
Remove Extraneous NetVault: Backup Installation Files
Disable Anti-Virus Software
Upgrade Procedure
Upgrade Considerations
Upgrade on Linux/UNIX
Upgrade on Solaris and MP-RAS
Upgrade on Windows
Post Upgrade Procedure
Post-Upgrade NVDB Summary
Does the System Require a Reboot After Upgrade?
Post-upgrade Requirement on Solaris 10 NetVault: Backup Server
Known Upgrade Issues
Important: After the successful recovery of the NVDB, all details pertaining to all previous
logs will be stored in the “logs_restored_<YYYYMMDD>” library (i.e., where
“<YYYYMMDD>” pertains to date information, in the format “YearMonthDate”).
NetVault: Backup v7.1.1 included a file entitled “pchXXXX.npk” that was used to
properly update earlier installations (where “XXXX” will vary based on the O/S in
use on the target machine). When v7.1.1 is installed, this file is placed in the
following directory (where “...” refers to the complete path to the NetVault: Backup
installation directory):
.../netvault/packages
During an upgrade, NetVault: Backup will attempt to automatically add any
previously installed “.npk” files, as it locates them. As a result, this file will be
loaded and NetVault: Backup will appear to upgrade successfully. However, when
attempting to launch the NetVault: Backup GUI, an error message will be launched
and the NetVault: Backup GUI will be inaccessible. Therefore, it is necessary to
manually remove any files entitled “pchsXXXX.npk” from this directory before
attempting an upgrade to version 8.2.
78 Chapter 7
Upgrading NetVault: Backup
Important: If the current version of NetVault: Backup is already installed on your machine,
running the install.exe again will result in NetVault: Backup being completely removed (i.e.
important NetVault components such as the NetVault Database).
Important: If an additional upgrade to version 7.1.3 or 7.3.1 is required, all of the previous
pre-requisite procedures must be performed prior to performing this upgrade, and again when
performing the second upgrade to the latest version.
NetVault: Backup
Installation/Upgrade Guide
79
7.3.2 Upgrade on Linux/UNIX
This procedure can be used to perform an upgrade on the following platforms:
AIX
HP-UX (Itanium)
Linux (all versions)
1. Log on to the system with root-level user account.
2. Depending on how the installation file was obtained, perform one of the
following:
Installation CD-ROM – Mount the CD-ROM, and navigate to the following
directory:
/cdrom/netvault/<OS Name>/netvault
Binary Downloaded from Web site – Navigate to the directory that
contains the downloaded binary, and de-compress the file using a de-
compression utility (e.g., tar -xvzf <binary name>).
3. Issue the following command:
./install
4. Respond to the following installation prompts:
1. Have you read and agreed to the terms of the license?
Press one of the following keys:
y – To accept the license agreement. The installation will continue if
you press y (the license agreement will not be displayed).
n – To reject the license agreement. The installation will terminate if
you press n.
d – To display the license agreement. This is the default value. If you
press d, the agreement will be displayed in parts. The percentage of
text displayed is shown at the bottom. To display the next part, press
Enter. BakBone Software strongly recommends that the license
agreement be thoroughly reviewed before proceeding with the
upgrade.
2. This program will upgrade your existing installation of NetVault. Are
you sure you want to continue? (y q) [q]:
Press y to continue; q to exit.
3. WARNING!!! It is ESSENTIAL that a NetVault Database backup has
been carried out BEFORE upgrade. Are you sure you want to
continue? (y q) [q]:
Press y to continue; q to exit.
4. Should a client or server version of NetVault be installed? (c s) [c]:
80 Chapter 7
Upgrading NetVault: Backup
Press c to install the Client version; s to install the Server version. Note
that the installation type must match the existing NetVault: Backup
installation. A NetVault: Backup Client cannot be upgraded to Server and
vice versa.
5. The installation will proceed. Upon completion, the following message will be
displayed – Installation completed successfully. NetVault: Backup is now
successfully upgraded and ready for use.
Important: This section is applicable only if you are upgrading from 7.4.0 or an earlier
version.
The newer versions of NetVault: Backup use the Solaris supplied SGEN device
driver to connect to all library changers’ “robotic devices”. Older versions (ver.
7.4.0 and earlier) of NetVault: Backup use a native component, “nvdriver” to
perform this communication. After upgrading from 7.4.0 or previous builds you
must complete one of the following additional processes to convert your existing
devices to the new SGEN Drive.
Important: BakBone Software recommends that you employ Method 1, as this provides a
more resilient and future proof solution.
Method 1: Remove Existing Devices and All Jobs that Target the
Removed Devices - As the title states, you must remove any devices in use,
and then delete any existing jobs that target these devices. While this method
presents the most overall work, it offers the best overall solution to the issue.
It offers the easiest method for adding additional backup devices in the future
(i.e., once you have converted to the SGEN device driver in place of NetVault:
Backup’s driver, you will be able to easily add new devices using the
NetVault: Backup GUI). To properly use this method, follow the steps outlined
below:
1. Perform a complete backup of the existing NVDB on the Solaris 10
NetVault: Backup Server that is to be upgraded.
2. Access the Job Management window and thoroughly review all pertinent
jobs that target any devices that are currently under the control of this
NetVault: Backup Server. Make note of all settings and options.
3. With all settings noted, delete all existing jobs that target devices
controlled by this NetVault: Backup Server.
4. Access the Device Management window of the GUI. Remove all devices
that are currently under the control of this NetVault: Backup Server.
5. Upgrade to latest NetVault: Backup Server software on the target Solaris
10 system.
6. Stop NetVault: Backup services (i.e., using the NetVault: Backup
Configurator).
7. Navigate to the following directory on the Solaris 10 system (where “...”
refers to the complete path to the installation of NetVault: Backup):
...\netvault\config
84 Chapter 7
Upgrading NetVault: Backup
8. Locate the “scsi.cfg” file and open it for editing with a text editor. Locate
the [SCSI] stanza, and edit it to appear as follows:
[SCSI]
Use NV driver=FALSE
Important: If the [SCSI] stanza is all that exists in the scsi.cfg file, you can simply delete
this file to obtain the necessary result. However if any other entries exist in this file, it must
remain in the “...\netvault\config” directory (and you must edit the file to appear as outlined
above).
4. The resulting output will appear, similar to the following for each device:
/dev/nv42 -> ../devices/pci@1c,600000/scsi@2,1/
nv@5,0:42
The last segment of information reveals “/nv@5,0:42”. This information
consists of the SCSI ID - “5”, the LUN value - “0”, and the device instance
number - “42”. Record all of these values for each device revealed.
5. Determine which of the identified devices are actually in use by using the
“prtconf” command:
prtconf | grep nv, | grep <device instance number>
If a value of “nv, instance <device instance number>” is returned, the
device is in use, and should be re-configured using the remaining steps
illustrated here. Otherwise, it can remain unchanged.
6. Remove the existing NetVault: Backup driver by issuing the following
command:
rem_drv nv
7. With the driver removed, ensure that it’s related configuration file is
renamed, in order to remove it, but also preserve this file for future access,
if necessary. This can be accomplished by issuing the following
command:
rename /usr/kernel/drv/nv.conf /usr/kernel/drv/
nvold.conf
8. Navigate to the following directory:
/kernel/drv/
9. Locate the “sgen.conf” file and open it for editing.
10.Add the following stanza to it:
#NV additions
device-type-config-list=“changer”
name=“sgen” class=“scsi” target=<SCSI ID> lun=<LUN
value>
The “SCSI ID” and “LUN value” variables in the final line apply to what
you recorded in Step 4 for these values.
11. Save and close the file.
Important: If further changers are to be added in the future, it may be beneficial to add
'name' entries for all of the currently unused “target” and “lun” combinations (i.e., in order to
distinguish a specific device).
12.Update the SGEN driver to use the new configuration, by issuing the
following command:
NetVault: Backup
Installation/Upgrade Guide
87
update_drv sgen
There will now be a new link created to the SCSI device using Solaris 10’s
native SGEN driver, and saved in the format “c<x>t<SCSI ID>d<LUN
value>” (e.g., “c2t5d0”), in the directory, “/dev/scsi/changer/”. Navigate
to this directory, and make note of this link name (i.e., using the SCSI ID -
“t<x>” and LUN value “d<x>” to identify the file).
13.It is next necessary to identify the device to which the created link file
applies. Issue the following command to accomplish this (where
“c<x>t<x>d<x>” applies to the link file identified in “/dev/scsi/changer/”:
ls -l /dev/scsi/changer/c<x>t<x>d<x>
The command should return a result similar to the following:
/dev/scsi/changer/c<x>t<x>d<x> -> ../../../devices/
pci@1c,600000/scsi@2,1/sgen@5,0:changer
14.Note all of the resulting information that occurs (e.g., in the above
example, the resulting information consists of “/devices/pci@1c,600000/
scsi@2,1/sgen@5,0:changer”).
15.Navigate back to the directory housing the NetVault: Backup driver entry
for this specific device -- “/dev/nv<X>” (i.e., the path revealed for the
selected device back in Step 4 -- “/dev/nv42” in that example), delete the
entry in this directory, but leave the directory itself intact.
16.Re-link the new SGEN driver device by issuing the following command
(i.e., where the variable “<path information for device>” refers to the
resulting information recorded from Step 14, and the variable “<x>” refers
to the device’s instance number -- as noted in Steps 4 and 15).
ln -s <path information for device> /dev/nv<x>
17. Restart NetVault: Backup services (i.e., via the NetVault: Backup
Configurator). The device will be available in NetVault: Backup, using the
SGEN driver.
Error appears when upgrading NetVault: Backup 7.1.2 to 7.4 on NCR MP-RAS and
Solaris operating systems
Symptom The following error message appears when upgrading from NetVault:
Backup version 7.1.2 to 7.4 on MP-RAS or Solaris systems:
“Current Administration requires that a unique instance of the <nv6server>
package be created. However, the maximum number of instances of the
package which may be supported at one time on the same system has
already been met.”
Cause The line “instance=unique” in the file “/var/sadm/pkg/install/admin/default”
causes the upgrade failure.
Solution Open the default file located at:
/var/sadm/pkg/install/admin/default
using any text editor (e.g., vi) and change the line
“instance=unique”
to
“instance=overwrite”
If the file is not found in the specified location, issue the following command
to locate it:
find / -name default -print
If the Oracle RMAN APM is Installed, Oracle Instances Running on the Oracle Server
Must Be Shut Down at NetVault: Backup Upgrade
Symptom (Windows-based systems only) NetVault: Backup upgrade fails if the Oracle
RMAN APM is installed and Oracle instances are running on the Oracle
Server during the upgrade.
Cause The Oracle instances use the orasbt.dll that uses NetVault: Backup core
libraries. When NetVault: Backup is upgraded, the upgrade process
attempts to remove these NetVault: Backup core libraries, but cannot do so
because they are in use.
Solution The OracleServiceSID must be stopped on the Oracle Database host
machine, or the orasbt.dll must be unloaded. Otherwise, the upgrade may
lose all configuration settings, and it may be necessary to remove NetVault:
Backup.
90 Chapter 8
NetVault: Backup Plugin Installation
Chapter 8:
Important: The “<####>” variable revealed in each file name above refers to version
information for the selected plugin. As new releases of the NetVault: Backup are offered, these
number values may change for new versions of these plugins. However, the first three
characters of each file will stay constant.
92 Chapter 8
NetVault: Backup Plugin Installation
Chapter 9:
LICENSING NETVAULT:
BACKUP
This chapter provides information on licensing NetVault: Backup. The information
in this chapter is organized into the following topics:
Licensing NetVault: Backup
Locating Machine IDs
Requesting a License Key
Installing a License Key
3. Select Properties from the pop-up menu to reveal the Client Properties
box. The Machine ID is displayed in the System tab.
Important: To view details on a given NetVault: Backup Client, it must be added to the
relevant NetVault: Backup Server (the machine being used for this process). For details on
adding a NetVault: Backup Client, refer to the NetVault: Backup Administrator’s Guide.
Important: In order to view details on a given NetVault: Backup Client, it must first be
added to the relevant NetVault: Backup Server (the machine being used for this process). For
details, refer to the NetVault: Backup Administrator’s Guide.
Chapter 10:
UNINSTALLATION
This chapter describes the procedures for uninstalling NetVault: Backup. The
information in this chapter is organized into the following topics:
Uninstalling NetVault: Backup
Uninstalling from a Linux/UNIX-based O/S
Uninstalling from a Windows-based O/S
Uninstalling from a Solaris (SPARC/x86/x86-64) or NCR MP-RAS O/S
Important: Using the complete procedures listed below, NetVault: Backup Database
entries will be deleted. It is important to note that the loss of this data may result in the loss of
records recorded by NetVault: Backup which pertain to specific backup jobs. However, the
actual backed up data will remain intact.
Important: This process requires the editing of the Windows Registry. Therefore, it is
strongly recommended that only a system administrator attempt to remove NetVault: Backup
from a target Windows-based system.
98 Chapter 10
Uninstallation
Important: Windows Registry entries pertain to the use of Windows itself as well as any
other installed applications. Therefore, it is strongly recommended that the NetVault: Backup
Ltd entries outlined in the previous procedure be the only entries accessed. Deletion or
manipulation of any other Windows Registry entries may negatively affect the use of other
applications or even Windows itself.
Important: If your original installation of NetVault: Backup was a 7.x version, and you have
upgraded to version 7.4, the process covered in the section, New Installations (version 8.x),
above is all that needs to be used to remove the software.