NetVault : Backup version 8.2.1 Installation/Upgrade Guide Version: Product Number: NVG-105-8.1-EN-01 NVG-105-8.2.1-EN-01 01/13/09
Copyrights NetVault: Backup v8.2.1 - Installation/Upgrade Guide Software Copyright 2009 BakBone Software Documentation Copyright 2009 BakBone Software 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.1 - 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. THIS PUBLICATION COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED INTO NEW EDITIONS OF THE PUBLICATION. BAKBONE SOFTWARE MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS PUBLICATION AT ANY TIME. BakBone Software 9540 Towne Centre Drive, Suite 100 San Diego, California 92121 866.484.2663
Table of Contents Preface 7 About this Document... 7 Target Audience... 7 Organization... 7 Recommended Additional Reading... 8 Technical Support...8 Documentation Updates... 8 Chapter 1: Introduction 9 NetVault: Backup At a Glance... 9 Key Benefits... 9 Feature Summary... 10 Chapter 2: NetVault: Backup Architecture Overview 11 NetVault: Backup Architecture An Overview... 11 - Architecture Components... 12 Chapter 3: Pre-installation Requirements 15 Planning New Installations... 15 - Determine NetVault: Backup Server and Client Machines... 15 - Determine NetVault: Backup Database (NVDB) Location... 16 - Determine NetVault: Backup Machine Names... 17 Prerequisites... 19 Platform Specific Prerequisites... 21 - AIX... 21 - Asian Linux 3 (64-bit)... 21 - Debian 4.0 (64-bit)... 21 - FreeBSD 7 (32-bit)... 21 - Linux/Unix... 22 - RHEL 4 Itanium... 22 - RHEL 5.x... 22
NetVault : Backup 4 Installation/Upgrade Guide - Ubuntu 8.04 (64-bit)... 23 Additional Requirements on Linux-based Systems... 23 - Required Shared Library Files... 24 - Finding the Missing Packages... 24 - Installing the Required Packages... 25 Additional Notes... 25 Chapter 4: NetVault: Backup Server Installation 27 AIX Installation... 27 - Installing from the Installation CD-ROM on AIX...27 - Installing from the Downloaded Binary File on AIX... 28 HP-UX Itanium Installation... 29 - Installing from the Installation CD-ROM on HP-UX Itanium... 29 - Installing from the Downloaded Binary File on HP-UX Itanium... 30 Linux x86/x86-64 Installation... 31 - Installing from the Installation CD-ROM on Linux x86/x86-64... 31 - Installing from the Downloaded Binary File on Linux x86/x86-64... 32 Linux Itanium Installation... 32 - Installing from the Installation CD-ROM on Linux Itanium... 32 - Installing from the Downloaded Binary File on Linux Itanium... 33 MP-RAS Installation... 34 - Installing from the Installation CD-ROM on MP-RAS...34 - Installing from the Downloaded Binary File on MP-RAS... 35 Solaris x86/x86-64 Installation... 35 - Installing from the Installation CD-ROM on Solaris x86/x86-64... 35 - Installing from the Downloaded Binary File on Solaris x86/x86-64... 36 Solaris (SPARC) Installation... 37 - Installing from the Installation CD-ROM on Solaris (SPARC)... 37 - Installing from the Downloaded Binary File on Solaris (SPARC)... 38 Windows Installation... 39 Platform Specific Post-installation Requirements... 40 - Debian 3.1 and Ubuntu 7.04... 40 - Solaris 10... 40 - Windows... 41 Example Installation on a Linux/UNIX-based System... 43
NetVault : Backup 5 Installation/Upgrade Guide Example Installation on a Windows-based System... 46 Chapter 5: NetVault: Backup Client Installation 51 AIX Installation... 51 - Installing from the Installation CD-ROM on AIX...51 - Installing from the Downloaded Binary File on AIX... 52 FreeBSD Installaiton... 52 - Installing from the Installation CD-ROM on FreeBSD...52 - Installing from the Downloaded Binary File on FreeBSD... 53 HP-UX Itanium Installation... 53 - Installing from the Installation CD-ROM on HP-UX Itanium... 53 - Installing from the Downloaded Binary File on HP-UX Itanium... 54 Linux x86/x86-64 Installation... 54 - Installing from the Installation CD-ROM on Linux x86/x86-64... 55 - Installing from the Downloaded Binary File on Linux x86/x86-64... 55 Linux Itanium Installation... 56 - Installing from the Installation CD-ROM on Linux Itanium... 56 - Installing from the Downloaded Binary File on Linux Itanium... 57 MP-RAS Installation... 58 - Installing the Installation CD-ROM on MP-RAS... 58 - Installing from the Downloaded Binary File on MP-RAS... 58 Solaris x86/x86-64 Installation... 59 - Installing from the Installation CD-ROM on Solaris x86/x86-64... 59 - Installing from the Downloaded Binary File on Solaris x86/x86-64... 59 Solaris (SPARC) Installation... 60 - Installing from the Installation CD-ROM on Solaris (SPARC)... 60 - Installing from the Downloaded Binary File on Solaris (SPARC)... 61 Windows Installation... 61 Platform Specific Post-installation Requirements... 63 - Debian 3.1... 63 - Debian 4.0 (32-bit)... 63 - Debian 4.0 (64-bit)... 63 - Ubuntu... 63 - Solaris x86-x86-64... 64
6 Table of Contents - Windows... 64 Chapter 6: Upgrading NetVault: Backup 65 Upgrade Overview...65 Pre-upgrade Procedures...66 - Backup the Existing NVDB... 66 - Stopping NetVault: Backup Processes...66 - Removing Extraneous NetVault: Backup Installation Files... 66 - Disabling Anti-Virus Software...67 Upgrade Procedure...67 - Upgrading from v7.x and Later Versions... 67 - Upgrading from Earlier Versions...67 Post Upgrade Procedure...68 - Post-Upgrade NVDB Summary...68 - Does the System Require a Reboot After Upgrade?... 68 - Post-upgrade Requirement on Solaris 10 NetVault: Backup Server... 68 Known Upgrade Issues...73 Chapter 7: NetVault: Backup Plugin Installation 76 Installing NetVault: Backup Plugins...76 - Installing Optional Plugins and APMs... 76 - Installing NetVault: Backup Core Plugins...77 - Removing a Plugin or APM... 78 Chapter 8: Licensing NetVault: Backup 79 Licensing NetVault: Backup...79 - Locating Machine IDs... 79 - Requesting a License Key... 80 - Installing a License Key... 80 Chapter 9: Uninstallation 82 Uninstalling NetVault: Backup...82 - Uninstalling from a Linux/UNIX-based O/S... 82 - Uninstalling from a Windows-based O/S... 83 - Uninstalling from a Solaris (SPARC/x86/x86-64) or NCR MP-RAS O/S... 85
NetVault: Backup 7 Installation/Upgrade Guide 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 This chapter gives an overview of NetVault: Backup and describes the features and benefits of the product. Chapter 2: NetVault: Backup Architecture Overview This chapter gives an overview of NetVault: Backup deployment and architecture. Chapter 3: Pre-installation Requirements This chapter describes the preinstallation requirements for the NetVault: Backup system. Chapter 4: NetVault: Backup Server Installation This chapter describes the procedure for installing the NetVault: Backup Server software. Chapter 5: NetVault: Backup Client Installation This chapter describes the procedure for installing the NetVault: Backup Client software. Chapter 6: Upgrading NetVault: Backup This chapter describes how to perform an upgrade. Chapter 7: NetVault: Backup Plugin Installation This chapter provides information installing NetVault: Backup Plugins. Chapter 8: Licensing NetVault: Backup This chapter provides information on licensing NetVault: Backup. Chapter 9: Uninstallation This chapter describes the procedures for uninstalling NetVault: Backup.
8 Preface Recommended Additional Reading NetVault : Backup Getting Started Guide This guide is intended for a firsttime user. It describes how to set up a NetVault: Backup system quickly and perform a test backup and restore. NetVault : Backup Administrator s Guide This guide describes how to use NetVault: Backup and provides comprehensive information on all NetVault: Backup features and functionality. NetVault : Backup Configurator Guide This guide explains how to configure the default settings for NetVault: Backup. NetVault : Backup Command Line Interface Guide This guide provides detailed description of the command line utilities. You can download these guides from the BakBone website at the following address: http://www.bakbone.com/documentation 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.1 can be found at the following link: http://kb.bakbone.com/4140
NetVault: Backup 9 Installation/Upgrade Guide 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 1.1 NetVault: Backup At a Glance NetVault: Backup offers enhanced data protection and enterprise-class functionality that delivers ease of use while scaling to meet the demands of any sized environment, from a single server to complex, heterogeneous environment. The flexible, modular architecture provides proven reliability and high performance, with a unique combination of features designed to reduce deployment costs and Total Cost of Ownership (TCO) by enabling you to implement a solution designed to meet current as well as future needs. Whether you are managing a few servers or a multi-site networked storage environment, there is a NetVault: Backup package designed to fit your needs. 1.2 Key Benefits Rapid Deployment NetVault: Backup's automated installation and device configuration features make it easy to add, manage or re-deploy distributed data management components throughout a growing enterprise storage environment. With our modular architecture you can license only those components you need today, while easily expanding the system as your storage environment or performance requirements grow. Enhanced Administrator Productivity Policy based job management and enhanced reporting capabilities simplify maintenance of your data protection strategies. Many activities such as job definition and event notification can be defined and modified at a group level, making administrative tasks quicker and easier.
10 Chapter 1 Introduction 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. 1.3 Feature Summary Extensive application data protection Broad platform support VMware protection without scripting Policy based job management Powerful reporting capabilities Advanced SAN/NAS support Comprehensive NDMP support Command Line Interface (CLI) options Full media management Powerful Disk-to-Disk backup options Dynamic device sharing Event notification Open file protection
NetVault: Backup 11 Installation/Upgrade Guide 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 2.1 NetVault: Backup Architecture An Overview Figure 2-1: Architectural overview of NetVault: Backup system NetVault: Backup Server Software NetVault: Backup Application Plugin Module NetVault: Backup Client Software with SmartClient License NetVault: Backup Client Software VMware Plugin NetVault: Backup GUI NDMP Plugin NetVault: Backup Server Virtual Tape Library Tape Device LAN WAN NAS File Server File Server Tape Device Administrator Workstation Virtual Machines VCB Proxy Server Exchange Server Database Server Fiber/ISCSI Network Attached Storage Shared Virtual Tape Library SAN NetVault: Backup Server Dynamically Shared Device
12 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. 2.1.1 Architecture Components A NetVault: Backup deployment consists of the following components: NetVault: Backup Server The NetVault: Backup Server is the main component of the NetVault: Backup solution. It provides for the job management, media management, device management, client management, reporting, notifications and logging. The NetVault: Backup Server maintains a history of backups in the NetVault database, enabling users to quickly identify which file, database instance or email storage group they want to restore. Stand-alone tape drives or tape libraries may be attached directly to the NetVault: Backup Server. The NetVault: Backup Server software is installed on each of the machines designated as a NetVault: Backup Server. NetVault: Backup Clients NetVault: Backup Clients are basically the file servers, database servers, or mail servers you need to protect. NetVault: Backup Clients are managed by the NetVault: Backup Server and transfers the backup/restore data across the LAN/WAN. NetVault: Backup Clients can be any number of Windows, Linux, Mac OS X, or UNIX machines. NetVault: Backup Client software is installed on each of the machines designated as a NetVault: Backup Client. Additionally one or more Application Plugin Modules or Plugins can be installed on any of the NetVault: Backup Client machines. NetVault: Backup SmartClients NetVault: Backup SmartClients are NetVault: Backup Clients with one or more locally-attached tape drives or tape libraries which may be physical or virtual. SmartClients can share tape drives with a NetVault: Backup Server, NAS Device, and other SmartClients. SmartClients speed up the backup process by allowing the data stream to flow directly to the attached storage device rather than being slowed down by traveling across the network.
NetVault: Backup 13 Installation/Upgrade Guide Figure 2-2: NetVault: Backup Clients and SmartClients Figure 2-3: NetVault: Backup VTL Virtual Tape Library A Virtual Tape Library (VTL) is a user configured tape library on a disk subsystem to allow Disk to Disk (D2D) backups, and ultimately Disk to Disk to Tape (D2D2T) backups. Virtual Tape Libraries allow users to run simultaneous backups from multiple clients to the same disk device which reduces backup windows. Additionally, a Virtual Tape Library speeds up restores because the backup is stored on random access drives as apposed to reading the backup from sequential tape. Shared Virtual Tape Library A Shared Virtual Tape Library (SVTL) allows multiple NetVault: Backup Clients of varying operating systems to share same raw disk for LAN-free backups via Fibre Channel or iscsi.
14 Chapter 2 NetVault: Backup Architecture Overview 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 performance protocol rather than using less efficient file sharing method 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 serverless 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-andclick manner, within NetVault: Backup's GUI.
NetVault: Backup 15 Installation/Upgrade Guide 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 3.1 Planning New Installations Review this section when planning a new NetVault: Backup system. 3.1.1 Determine NetVault: Backup Server and Client Machines Installation of NetVault: Backup involves installing a NetVault: Backup Server and any number of NetVault: Backup Clients. The NetVault: Backup Server must be deployed first, with the Server version of NetVault: Backup installed there, followed by each individual Client. Therefore, the first step in the operation is to determine which machine will serve as the NetVault: Backup Server, and which machines will be NetVault: Backup Clients: NetVault: Backup Server - This machine will house the Server version of NetVault: Backup and it will accessed to manage all NetVault: Backup operations (i.e., administer backup and recovery operations for any number of NetVault: Backup Clients). NetVault: Backup Client(s) - Each of these machines will house the Client version of NetVault: Backup and each will serve as backup/restore targets.
16 Chapter 3 Pre-installation Requirements Important: Once established, a NetVault: Backup Server can serve as a Client unto itself (i.e., the Server can be accessed and backups/restores of its own local data can be performed). 3.1.2 Determine NetVault: Backup Database (NVDB) Location With the machine that is to serve as the NetVault: Backup Server determined, the next step is to choose a directory on a drive/volume with enough free space to house NetVault: Backup and its database. The typical NetVault: Backup Server installation requires about 50MB of free disk space. However, the NVDB will grow as operations are performed in NetVault: Backup (e.g., backups, restores and reports generated). It is critical that space considerations be made for the growing of this database. NetVault: Backup operations could halt if its database can not be updated due to space limitations. When the NetVault: Backup Server software is installed, the installation includes a NVDB directory (db or nvdb) containing four sub-directories: Install - Very small directory. Contains the modules binary file detailing which modules are installed). Keys - Very small directory. Contains license key files for the main software and any plugins or APMs installed. MediaDatabase - This directory grows to be rather large with use of NetVault: Backup. Holds records for media and backups performed. ScheduleDatabase - Small directory (generally less than 10 MB in size) Holds records for all backup and restore jobs). The only portion of the database for which size requirements are an issue is the MediaDatabase. The NetVault: Backup Administrator of a particular NetVault: Backup domain must estimate the anticipated size of the database to allocate adequate disk space for growth. To calculate these requirements, the following information is necessary: The Approximate Number of Files and Directories Being Backed Up in the NetVault: Backup Domain (i.e., on the NetVault: Backup Server and all NetVault: Backup Clients). 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
NetVault: Backup 17 Installation/Upgrade Guide 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 Backup window). For more information on Backup Life, refer to the NetVault: Backup Administrator s Guide. 3.1.2.a Example Calculation With an average file/directory name of eight characters for a target file system, if 200,000 files and 15,000 directories were backed up once, approximately 17.5 MB will be required for NVDB indexing. If the same files and directories were backed up three times, 52.5 MB would be required. If backed up 5 times, 87.5 MB would be required, and so on. Database Size Calculation Formula Approximate number of files and directories backed up per machine Multiplied by Approximate number of generations to be kept using Backup Life options a Multiplied by Number of machines backed up Multiplied by (71 bytes + average file name length b ) 3.1.2.b NVDB Index Entry Size Limitations A single NVDB index entry is generated for each NetVault: Backup backup job created/submitted. It is important to note that NetVault: Backup must adhere to a maximum size requirement of four Gigabytes (4 GB) for each of these individual index entries. Index entries of this size will only occur with very large jobs (e.g., a backup job that contains a few million files and directories). If a backup job is run that requires an index entry larger than this maximum, it will most likely fail. Therefore it is recommended that large jobs requiring the backup of a few million files be broken down into multiple jobs to avoid this. For complete details on backing up data, refer to the NetVault: Backup Administrator s Guide. 3.1.3 Determine NetVault: Backup Machine Names During the installation process of the NetVault: Backup software (regardless of installation type (e.g., Client vs. Server) or Operating System platform), it is necessary to input a NetVault: Backup name for the machine. This name is used in NetVault: Backup for the purpose of recognizing it over the network. Hence, each NetVault: Backup Client must have a unique name. At default, a value will be displayed matching the machine s Operating System-tied name. With this in mind, the following should be taken into consideration:
18 Chapter 3 Pre-installation Requirements Important: It is of critical importance that the following points be reviewed in order to properly name a NetVault: Backup Server/Client for complete use. Illegal Characters in a Machine Name - Although the core software will still function regardless of how the machine is named, certain aspects of 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 ). Underscore Character in a Machine Name - It is possible to use an underscore ( _ ) in the name of a NetVault: Backup machine (e.g., as a substitute for a space -- NVBU_Server, or to replace any of the illegal characters named in the point above). However, conflicts will arise when referencing a machine named in this manner in NetVault: Backup s Command Line Interface (CLI). The CLI sees the use of an underscore in its syntax as a replacement for a space, because a space is not recognized. For example, if a machine whose actual name is NVBU_Server is included in a CLI command, NetVault: Backup will, in reality, search for a machine named NVBU Server. Not finding a machine named this, the CLI request will fail and return an error. Therefore, if the CLI is to be used with the target machine, it is recommended that the machine be given a name that does not include any underscore characters. For complete details on the use of NetVault: Backup s CLI utility, please see the NetVault: Backup Command Line Interface User s Guide. NetVault: Backup Client Systems must be Given Different Names - When performing a Client version install of NetVault: Backup, you must assign a unique name value for each Client system. 3.1.3.a Best Practice When performing an installation to establish the NetVault: Backup Server, it is recommended that the NetVault: Backup name used be different than the machine s O/S-tied name. As a recommended example, use a name value signifying that the machine is the NetVault: Backup Server. This is recommended in case it is ever necessary to relocate the NetVault: Backup Server to a different machine (e.g., because of hardware failure). In relocating a NetVault: Backup Server, a backup of the NetVault: Backup Server Database (NVDB) is required.
NetVault: Backup 19 Installation/Upgrade Guide The NVDB is integral to NetVault: Backup operations and is tied to the NetVault: Backup Server via its NetVault: Backup name. If relocating, a fresh installation of the Server version of NetVault: Backup would be required on the new machine, followed by a restore of the backed up NVDB to this new machine. During the installation, the NetVault: Backup name assigned must be the same as the name used for the original installation, in order to successfully proceed to the restore of the NVDB. Therefore, if the original NetVault: Backup Server was named using the default setting of it s O/S-tied name, the relocation target s installation of NetVault: Backup would have to be named using this same O/S-generated name, even though its actual machine name is something different. This could result in confusion when performing future backups and restores, especially if the machine previously set up as the NetVault: Backup Server is ever brought back on line. For details on relocation of the NVDB, refer to the NetVault: Backup Administrator s Guide. 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 runlevel 3 (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 antivirus software during installation and various NetVault: Backup operations may not function properly after the installation.
20 Chapter 3 Pre-installation Requirements Figure 3-1: The way the required variables should appear for ulimit settings to successfully install all NetVault: Backup components 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. Check Backup Device Mapping/Connections It is necessary to determine what backup devices are to be used (e.g., tape libraries and standalone drives) and map them out. Generally, the NetVault: Backup Server is set up to contain one or more of these devices (i.e., they are directly attached to the machine acting as the NetVault: Backup Server). However, this is not required and a usable backup device can be attached to a machine configured as a NetVault: Backup Client. This is referred to as a NetVault: Backup SmartClient TM. It is also important to ensure that these devices are connected and functional and that backups can be performed to them (e.g., through the use of any native O/S tools used for minimal backup operations on the device. If these native backup tools can't see an attached backup device, then neither will NetVault: Backup) Configure ulimit Variables (Linux/UNIX Platforms Only) UNIX-based O/Ss utilize a default setting for various size limitations that may create a conflict when attempting to install NetVault: Backup (e.g., the file size (blocks) and virtual memory (kbytes) settings, which may use a default setting that is too low). Failure to increase these values from their default may result in a core dump error message and a failed installation of various NetVault: Backup components. A recommended setting of unlimited is suggested to remedy this issue. To accomplish this, launch a terminal session and perform these steps: 1. Issue the command: ulimit -a
NetVault: Backup 21 Installation/Upgrade Guide 2. A list of the values currently set as limits will be displayed. If the values for either of the following settings are anything other than unlimited, issue the following command to change the setting accordingly: File Size (Blocks) ulimit unlimited Virtual Memory (Kbytes) ulimit -v unlimited 3. Issue the command ulimit -a to re-list these statistics after modification to verify that they are properly set. 3.3 Platform Specific Prerequisites 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.2 Asian Linux 3 (64-bit) To install and run NetVault: Backup v8.2 on a 64-bit Asian Linux 3 machine, you must create the following symbolic link as Asian Linux 3 does not use libxm.so.3 anymore ln -s /usr/lib/libxm.so.4.0.0 /usr/lib/libxm.so.3 3.3.3 Debian 4.0 (64-bit) Before starting the installation, perform the following steps: 1. Install ia32-libs and then issue the command ldconfig on this system 2. Download the i386 version of libmotif3 from http://packages.debian.org and then use dpkg -x libmotif3 to extract. 3. Copy all extracted files in usr/x11r6/lib to /usr/lib32 3.3.4 FreeBSD 7 (32-bit) To install and run the FreeBSD NetVault 8.2 distribution on a FreeBSD 7 platform create two symbolic links on your target machine using the following commands: ln -s /lib/libcam.so.4 /usr/lib/libcam.so.3
22 Chapter 3 Pre-installation Requirements ln -s /lib/libc.so.7 /usr/lib/libc.so.6 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 the existing contents on the mount point (which isn t allowed in a UNIXbased 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. 3.3.6 RHEL 4 Itanium The openmotif21-2.1.30-11.rhel4.4.ia64.rpm package located on disc 4 of the RHEL 4, U1 ia64 installation CDs, must be installed on all DR Client machines running this O/S. A standard installation of this O/S may not request this CD, so the component may not be present. To install the component, follow the steps below: 1. Insert CD 4 into the drive on the target DR Client, and launch a terminal session prompt. 2. Navigate to the CD-ROM drive, and issue the following command: rpm -i openmotif21-2.1.30-11.rhel4.4.ia64.rpm 3.3.7 RHEL 5.x On RHEL 5.x systems, you must install the following packages from the installation CD: x86-32 libxp-1.0.0-*.i386.rpm x86-64 libxp-1.0.0-*.i386.rpm libxmu-1.0.2-*.i386.rpm openmotif22-2.2.3-*.i386.rpm (required only to display the GUI) Itanium llibxp-1.0.0-*.ia64.rpm llibxmu-1.0.2-*.ia64.rpm openmotif22-2.2.3-*.ia64.rpm (required only to display the GUI)
3.3.8 Ubuntu 8.04 (64-bit) NetVault: Backup 23 Installation/Upgrade Guide On Ubuntu 8.04 (64-bit), perform the following steps: 1. Install Ubuntu Server 8.04 64-bit. 2. sudo su 3. apt-get install ia32-libs lib32nss-mdns 4. tar -xzvf <NetVault: Backup binary file> 5. cd netvault 6../install The install will fail. 7. ldconfig (It is important that you run ldconfig before you remove the /usr/netvault directory.) 8. rm -rf /usr/netvault 9../install To make the NetVault: Backup GUI work, perform the following steps: 1. apt-get install ubuntu-desktop 2. Reboot 3. Go to http://packages.ubuntu.com/hardy/libmotif3 4. Download the i386 version of libmotif3. 5. dpkg -x libmotif3. 6. cd usr/lib 7. mv * /usr/lib32 8. nvgui& 3.4 Additional Requirements on Linux-based Systems For Linux installations, certain shared library files must be present on the system for NetVault: Backup to run. These include the shared C libraries and X Windows System libraries.this appendix outlines these requirements. Note that the requirements mentioned in this section of the guide are not prerequisites to installing NetVault: Backup. The installation script will run without interruption, installing the software to the specified directory, even if these required packages are not available on the system. However, the NetVault installation will not run if these dependencies are not present on the system.
24 Chapter 3 Pre-installation Requirements 3.4.1 Required Shared Library Files These shared library files are available as RPM packages. A standard installation of RedHat or SUSE Linux will include the packages containing the required files by default. For customized installations of Linux, however, the availability of the following files must be ensured. Important: The various distributions of Linux might have slight differences. As a result of which the list given here is only representative. 3.4.1.a 3.4.1.b X Window System Shared Libraries These libraries provide the GUI functionality. On Linux systems running NetVault: Backup, the following X Window System shared library files must be available. libice.so.6 libsm.so.6 libx11.so.6 libxext.so.6 libxp.so.6 libxt.so.6 Shared C Libraries These libraries provide the standard library functions, including the system calls. On Linux systems running NetVault: Backup, the following shared C libraries must be available. libc.so.6 libdl.so.2 linux-gate.so.1 (a virtual shared library that is exported by the kernel to provide a way to make system calls faster) 3.4.2 Finding the Missing Packages As mentioned earlier, on systems that do not have the above-mentioned packages NetVault: Backup will not start after installation. In such a scenario, the following command can be issued from the NetVault: Backup installation directory (e.g., /usr/netvault/ - by default) to obtain a list of NetVault dependencies and to determine any missing ones. find./ xargs file egrep 'shared object executable' cut -d: -f1 xargs ldd egrep -v '^\.' perl -pe 's/ *\(.*$//' sort -u Following is an example output of this command in a RedHat Linux installation:
NetVault: Backup 25 Installation/Upgrade Guide Figure 3-1: NetVault: Backup dependencies listed using the find command on a system running Linux (e.g., a RedHat distribution of Linux) The missing dependencies will be reported as Not Found as shown in the figure. 3.4.3 Installing the Required Packages As mentioned earlier, these required files are available as RPM packages and can be installed using the RPM utility. For more information on rpm, please see the man page for this command. A configuration tool like YaST (Yet another Setup Tool) can also be used for searching and installing packages. Once the package containing the required file is found by the tool, the Install command can be selected from the Package menu in order to install the file. For more information on YaST, please see the user guide for this tool. 3.5 Additional Notes Review the following notes before starting the NetVault: Backup Server or Client installation: By default, both NetVault: Backup and NetVault: Replicator are installed on...\netvault directory. If the target machine contains an installation of the NetVault: Replicator, append the backup to the default installation path as shown below to avoid overwriting NetVault: Replicator installation files: Linux/UNIX-based Operating Systems: /backup Windows-based Operating Systems: \backup This will install NetVault: Backup to the...\netvault\backup directory. This only applies to a new instal-lation of NetVault: Backup, not an upgrade.
26 Chapter 3 Pre-installation Requirements 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 27 Installation/Upgrade Guide Chapter 4: NETVAULT: BACKUP SERVER INSTALLATION This chapter describes the procedure for installing the NetVault: Backup Server software. The information in this chapter is organized into the following topics: AIX Installation HP-UX Itanium Installation Linux x86/x86-64 Installation Linux Itanium Installation MP-RAS Installation Solaris x86/x86-64 Installation Solaris (SPARC) Installation Windows Installation Platform Specific Post-installation Requirements Example Installation on a Linux/UNIX-based System Example Installation on a Windows-based System 4.1 AIX Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 4.1.1 Installing from the Installation CD-ROM on AIX To install the NetVault: Backup Server software from a CD-ROM, perform the following steps: 1. Mount the CD-ROM drive. 2. While still logged on with the root level account, insert the CD-ROM into the drive and initiate a terminal session. 3. From the prompt, issue the command: cd /cdrom/netvault/aix/netvault./install
28 Chapter 4 NetVault: Backup Server Installation 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 6. 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 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 43. 4.1.2 Installing from the Downloaded Binary File on AIX These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. The downloaded file will be in a compressed state and must first be decompressed (i.e., using the necessary O/S-related decompression software). Once complete, initiate a terminal session and navigate to the directory in which the decompressed files reside. 2. From the prompt, issue the command:./install 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. 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.
NetVault : Backup 29 Installation/Upgrade Guide 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 43. 4.2 HP-UX Itanium Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 4.2.1 Installing from the Installation CD-ROM on HP-UX Itanium To install the NetVault: Backup Server software from a CD-ROM, perform the following steps. 4.2.1.a 4.2.1.b Mounting the CD-ROM Drive on HP-UX Itanium If not already performed, it is necessary to mount the CD-ROM drive. To accomplish this, perform the following steps: 1. Log into the system using the root level account. 2. Start the PFS Daemons, utilizing the following commands: # nohup /usr/sbin/pfs_mountd & # nohup /usr/sbin/pfsd 4 & 3. Mount the CD-ROM using the following command: # pfs_mount -o xlat=unix /dev/rdsk/cxtxd0 /mountpoint Running the Installation File from CD on HP-UX Itanium Perform the following steps to initiate an installation of NetVault: Backup: 1. While still logged on with the root level account, insert the CD-ROM into the drive and initiate a terminal session. From the prompt, issue the command: cd /cdrom/netvault/hpux_ia64/netvault./install 2. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information.
30 Chapter 4 NetVault: Backup Server Installation 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 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 43. 4.2.2 Installing from the Downloaded Binary File on HP-UX Itanium These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. The downloaded file will be in a compressed state and must first be decompressed (i.e., using the necessary HP-UX Itanium O/S-related decompression software). Once complete, initiate a terminal session and navigate to the directory in which the decompressed files reside. 2. From the prompt, issue the command:./install 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. 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 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 43.
4.3 Linux x86/x86-64 Installation NetVault : Backup 31 Installation/Upgrade Guide NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 4.3.1 Installing from the Installation CD-ROM on Linux x86/ x86-64 To install the NetVault: Backup Server software from a CD-ROM, perform the following steps: 1. Log on to the target machine with the root-level account. 2. With the CD-ROM in the drive, initiate a terminal session and input the following command (assuming that all versions of Linux should automount the CD-ROM drive): 32-bit Linux cd /cdrom/netvault/linux_x86_32/netvault 64-bit Linux cd /cdrom/netvault/linux_x86_64/netvault On some Linux installations (e.g., RHEL 5), if a CD-ROM is auto-mounted, installation from the CDROM will fail with error message "bash:./install: / bin/sh bad interpreter: Permission denined". To avoid this problem, the CD-ROM needs to be mounted manually without the noexec mount option. Example: umount /media/ mount -t iso9660 /dev/cdrom /media 3. Execute the install file, by typing the following:./install 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. 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 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 43.
32 Chapter 4 NetVault: Backup Server Installation 4.3.2 Installing from the Downloaded Binary File on Linux x86/x86-64 These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log on to the target machine with the root-level account. 2. The downloaded file will be in a compressed state and must first be decompressed (i.e., using Linux s native decompression utilities either via its GUI or a terminal session). Once complete, navigate to the directory in which the decompressed files reside. 3. Execute the install file, by typing the following:./install 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. 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 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 43. 4.4 Linux Itanium Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 4.4.1 Installing from the Installation CD-ROM on Linux Itanium To install the NetVault: Backup Server software from a CD-ROM, perform the following steps: 1. Log on to the target machine with the root-level account. 2. With the CD-ROM in the drive, initiate a terminal session and input the following command (assuming that all Linux Itanium installations should automount the CD-ROM drive):
NetVault : Backup 33 Installation/Upgrade Guide cd /cdrom/netvault/linux_ia64/netvault On some Linux installations (e.g., RHEL 5), if a CD-ROM is auto-mounted, installation from the CDROM will fail with error message "bash:./install: / bin/sh bad interpreter: Permission denined". To avoid this problem, the CD-ROM needs to be mounted manually without the noexec mount option. Example: umount /media/ mount -t iso9660 /dev/cdrom /media 3. Execute the install file, by typing the following:./install 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. 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 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 43. 4.4.2 Installing from the Downloaded Binary File on Linux Itanium These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log on to the target machine with the root-level account. 2. The downloaded file will be in a compressed state and must first be decompressed (i.e., using Linux s native decompression utilities either via its GUI or a terminal session). Once complete, navigate to the directory in which the decompressed files reside. 3. Execute the install file, by typing the following:./install 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information.
34 Chapter 4 NetVault: Backup Server Installation 5. 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. 4.5 MP-RAS Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 4.5.1 Installing from the Installation CD-ROM on MP-RAS To install the NetVault: Backup Server software from a CD-ROM, perform the following steps. 4.5.1.a 4.5.1.b Mounting the CD-ROM Drive on MP-RAS If the CD-ROM drive is not currently mounted, this must be done in order to access the drive for installation. To manually mount the CD-ROM, launch a terminal window and issue the following commands (the below example assumes that the mount point /cdrom/cdrom0 already exists): su root mount -r -F cdfs <CD-ROM device node> /cdrom Running the Installation File from CD on MP-RAS NetVault: Backup software is installed to an MP-RAS machine through a standard pkgadd installation. The mount point information for the CD-ROM drive is required (as illustrated in the previous section) in order to issue proper command from a command line prompt. 1. Log on to the target machine with the root level account. 2. With the CD-ROM inserted in the drive, initiate a terminal session and issue the command listed below: pkgadd -d /cdrom/netvault/mpras/netvault 3. With the installation successfully initiated, a step-by-step set up 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.
NetVault : Backup 35 Installation/Upgrade Guide 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 43. 4.5.2 Installing from the Downloaded Binary File on MP-RAS These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log into the system with the root level account. 2. The downloaded file will be in a compressed state (e.g., <filename>.z ) and must first be decompressed (i.e., using the necessary MP-RAS O/S-related decompression software). Once complete, launch a terminal window and add the package for installation, by typing the following: pkgadd -d /<full path to installation files>/netvault 3. With the installation successfully initiated, a step-by-step set up 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 43. 4.6 Solaris x86/x86-64 Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 4.6.1 Installing from the Installation CD-ROM on Solaris x86/ x86-64 To install the NetVault: Backup Server software from a CD-ROM, perform the following steps.
36 Chapter 4 NetVault: Backup Server Installation 4.6.1.a 4.6.1.b Mounting the CD-ROM Drive in Solaris x86/x86-64 If the CD-ROM drive is not currently mounted, this must be done in order to access the drive for installation. To manually mount the CD-ROM, use the following commands (the below example assumes that the mount point /cdrom/cdrom0 already exists): 1. Initiate a command line terminal and issue the following commands: su root mount -r -F cdfs <CD-ROM device node> /cdrom Running the Installation File from CD on Solaris x86/x86-64 NetVault: Backup software is installed to a Solaris machine through a standard pkgadd installation. The mount point information for the CD-ROM drive is required (as illustrated in the previous section) in order to issue proper command from a command line prompt. 1. Log on to the target machine with the super user ID. 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 set up 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 43. 4.6.2 Installing from the Downloaded Binary File on Solaris x86/x86-64 These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log into the target machine using the Super User ID. 2. The downloaded file will be in a compressed state (e.g., <filename>.z ) and must first be decompressed (i.e., using the necessary Solaris 10 (x86)
NetVault : Backup 37 Installation/Upgrade Guide O/S-related decompression software). Once complete, initiate a terminal session and navigate to the directory in which the decompressed files reside. 3. Add the package for installation by typing the following: pkgadd -d. netvault 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. 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 43. 4.7 Solaris (SPARC) Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 4.7.1 Installing from the Installation CD-ROM on Solaris (SPARC) To install the NetVault: Backup Server software from a CD-ROM, perform the following steps. 4.7.1.a 4.7.1.b Mounting the CD-ROM Drive on Solaris (SPARC) If the CD-ROM drive is not currently mounted, this must be done in order to access the drive for installation. To manually mount the CD-ROM, use the following commands (the below example assumes that the mount point /cdrom/cdrom0 already exists): 1. Initiate a command line terminal and issue the following commands: su root mount -r -F cdfs <CD-ROM device node> /cdrom Running the Installation File from CD on Solaris (SPARC) NetVault: Backup software is installed to a Solaris machine through a standard pkgadd installation. The mount point information for the CD-ROM drive is
38 Chapter 4 NetVault: Backup Server Installation required (as illustrated in the previous section) in order to issue proper command from a command line prompt. 1. Log on to the target machine with the super user ID. 2. With the CD-ROM inserted in the drive, initiate a terminal session and issue the command listed below: pkgadd -d /cdrom/netvault/solaris_sparc/netvault 3. With the installation successfully initiated, a step-by-step set up 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 43. 4.7.2 Installing from the Downloaded Binary File on Solaris (SPARC) These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log into the target machine using the Super User ID. 2. The downloaded file will be in a compressed state (e.g., <filename>.z ) and must first be decompressed (i.e., using the necessary Solaris (SPARC) O/S-related decompression software). Once complete, initiate a terminal session and navigate to the directory in which the decompressed files reside. 3. Add the package for installation by typing the following: pkgadd -d. Alternatively, you can issue the following command from the parent directory: pkgadd -d netvault 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. 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.
NetVault : Backup 39 Installation/Upgrade Guide 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 43. 4.8 Windows Installation To complete an installation of the NetVault: Backup Software on Windows, perform the following steps: 1. Ensure that you are logged into the system as an Administrator-level user. 2. Access the required installation executable file, based on how these files were obtained: Via Web Download - The downloaded file should be in a compressed state. Decompress this file to the desired directory, navigate to this directory and locate the following file: <Decompressed Files Directory>\install.exe 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. Figure 4-2: The Choose Installation Type window with the Server radial button selected for a Server installation of NetVault: Backup 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 3. With the executable file launched, an installation wizard will be activated, offering step-by-step instructions via individual windows. Using what was established during the prerequisite phase, process 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.
40 Chapter 4 NetVault: Backup Server Installation 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 46. 4.9 Platform Specific Post-installation Requirements 4.9.1 Debian 3.1 and Ubuntu 7.04 The following steps must be performed on these operating systems after installation: 1. While logged in as the root-level user, initiate a terminal session prompt. 2. Issue the following commands in succession: # update-rc.d netvault defaults 99 mkdir /var/lock/subsys 4.9.2 Solaris 10 Important: This procedure is only required for Solaris 10 machines that have a backup device directly attached to it. 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:
NetVault : Backup 41 Installation/Upgrade Guide name="sgen" parent="fp" target=0 lun=0; 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-portwwn="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: Check 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.3 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:
42 Chapter 4 NetVault: Backup Server Installation Figure 4-3: The Enable library item deselected. 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 choose Properties from the pop-up menu. 5. In the Properties dialog box that is revealed, and the General tab selected, click on the Enable library checkbox in order to de-select it. 6. Click Apply to set the change, and then OK to exit the dialog box.
NetVault : Backup 43 Installation/Upgrade Guide 4.10 Example Installation on a Linux/UNIX-based System The section below details the prompts that will be offered once an installation of NetVault: Backup has been properly executed on a Linux/UNIX-based operating system (O/S). This example pertains to the following supported O/S: AIX HP-UX Itanium Linux (all versions) MP-RAS Solaris 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-4: The first prompt revealed when performing an installation of NetVault: Backup 1. The first prompt will ask for acceptance of NetVault: Backup s License Agreement. The following selections can be input: Y - for Yes, the agreement is accepted. The installation process will continue (i.e., the license agreement will not be displayed). N - for No, that it is not accepted and the installation process will quit. D - for Display of the license agreement information so that it can be read. This is the default for this prompt. If this option is selected, the NetVault: Backup License Agreement will be displayed in sections with a percentage value shown at the bottom of the screen. This value accounts for how much of the agreement has been displayed. Each time the Enter key is pressed, more of the agreement will be displayed and this value will increase. Continuously holding down the Enter key will scroll through the entire agreement, and end with the next prompt.
44 Chapter 4 NetVault: Backup Server Installation Figure 4-5: The initial screen of the license agreement of NetVault: Backup, as displayed when the D option is selected Important: BakBone Software strongly recommends that this License Agreement be thoroughly reviewed prior to continuing with the installation. Figure 4-6: The installation type prompt appears next 2. The next prompt asks which version of NetVault: Backup should be installed. The following selections are available: 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 for 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 45 Installation/Upgrade Guide Figure 4-7: The installation location prompt appears next 3. With the installation type selected, the next prompt requests the 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. Figure 4-8: The NVDB location prompt 4. If a Server ( S ) installation of NetVault: Backup was selected, the next prompt will request a location for the NVDB. The default directory, /usr/netvault/db ( /opt/netvault/db on Solaris machines) can be used by pressing the Enter key. The directory will be automatically created, and the NVDB file will be created therein. Otherwise, a desired directory can be manually input. 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. Figure 4-9: The enter NetVault: Backup name prompt Figure 4-10: Both prompts of the password input phase 5. The next prompt asks for a NetVault: Backup name for this installation. The name is how this machine will be recognized by other NetVault: Backup machines on the network. The default value offered is the current machine s actual system name. This can be used by simply hitting the Enter key. Prior to selecting a name, refer to the section review the section Determine NetVault: Backup Machine Names on page 17. 6. The next prompt requests that the user input a password value for this installation of NetVault: Backup. This password value is associated with the given NetVault: Backup name and is used to allow/limit access to it by other NetVault: Backup machines (e.g., if this machine is to be added to
46 Chapter 4 NetVault: Backup Server Installation Figure 4-11: The installation process as it is performed followed by the message stating the Installation completed successfully another NetVault: Backup machine as a Client, this password value would need to be input to do so). After input once, a second request will appear asking the user to input this same password a second time for verification. 7. With all necessary values properly input, the installation process will begin as files are extracted and installed. Upon completion, the last displayed message in the terminal will state this fact and return the user to the directory prompt which contains the installation files. NetVault: Backup is now successfully installed and ready for use. 4.11 Example Installation on a Windows-based System This section cover the installation wizard that appears once the install.exe file has been properly launched on a Windows-based operating system. 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. Figure 4-12: The language selection option revealed during the installation of NetVault: Backup for Windows 2000 1. With the install.exe file run, the first installation window will launch. Select the desired language from the drop-down list and click on OK to initiate the installation.
NetVault : Backup 47 Installation/Upgrade Guide 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. Figure 4-13: The NetVault: Backup Installation Wizard window for Windows 2000 Figure 4-14: A cut-away version of the License Agreement window as revealed in the Installation Wizard Figure 4-15: The Choose Installation Type window of the Installation Wizard 2. Once the language is selected, the first window of the Setup Wizard will appear. Read the notes contained within this window and click on Next to proceed. 3. The next window to appear contains the License Agreement information. Read this information thoroughly and select the I Agree option in order to continue by clicking on the Next button (i.e., this button is greyedout and unavailable until the I Agree option is selected). 4. With the License Agreement accepted, the next window to appear is Choose Installation Type. From this window select the desired type of installation (e.g., Client vs. Server) and click on the Next button to continue (for more information on the differences between a Client and Server installation, see Step 2., of the section Example Installation on a UNIX-based O/S on page 44).
48 Chapter 4 NetVault: Backup Server Installation Figure 4-16: The Installation Wizard s Machine Name window where it is possible to input a name identifier for this installation of NetVault: Backup Figure 4-17: The Choose Password window which allows an installer to password protect this installation of NetVault: Backup Figure 4-18: The Select Installation Folder window of the Installation Wizard 5. The Machine Name window is used to input a NetVault: Backup name for this installation. This name is how this machine will be recognized by other NetVault: Backup machines on the network. Prior to selecting a name, refer to the section Determine NetVault: Backup Machine Names on page 17. 6. With a desired name value input, click on the Next button to proceed, and access the Choose Machine Password window. Use the fields located here to input a desired value in the Password field, followed by an exact duplicate of this password in the Retype Password field. This password value is associated with the given NetVault: Backup name and is used to allow/limit access to it by other NetVault: Backup machines (e.g., if this machine is to be added to another NetVault: Backup machine as a Client, this password value would need to be input to do so). 7. The next window to appear is the Select Installation Folder window. Here, the desired directory for the NetVault: Backup Installation can be set. In addition to a field that allows for the manual input of this information (e.g., the Folder field), various other options are made available:
NetVault : Backup 49 Installation/Upgrade Guide Figure 4-19: The NetVault: Backup Disk Space dialog box Figure 4-20: The Select NetVault Database Folder window of the Installation Wizard The Browse Button - Use this button to launch a Windows Explorer window that allows for the selection of a desired directory for installation. The Disk Cost Button - When this button is used, NetVault: Backup will complete a brief scan of the available drives/ partitions on the target machine and report information in a separate window which describes space availability before and after a NetVault: Backup installation, for each. 8. The next window to appear is the Select NetVault Databse Folder window. In this window, type the name of the directory in which NVDB will be stored, or navigate to the directory name using the Browse button. Click on Next to proceed. 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 NetVault: Backup on the NetVault: Backup Server. You will not be prompted to select a NVBD folder if you are installing NetVault: Backup on a client. Figure 4-21: The Confirm Installation window that appears to allow for confirmation of installation 9. The next window to appear is the Confirm Installation window. This window confirms that the installer
50 Chapter 4 NetVault: Backup Server Installation Figure 4-22: The Installation Complete window that will appear upon successful installation is ready to install NetVault: Backup. Click Next to start the installation. 10.When the installation is complete, the Installation Complete window will appear. The installation process is now complete. The Close button can now be clicked to close the installation wizard and return to the desktop. NetVault: Backup is now ready for use on this machine.
NetVault : Backup 51 Installation/Upgrade Guide Chapter 5: NETVAULT: BACKUP CLIENT INSTALLATION This chapter describes the procedure for installing the NetVault: Backup Client software. The information in this chapter is organized into the following topics: AIX Installation FreeBSD Installaiton HP-UX Itanium Installation Linux x86/x86-64 Installation Linux Itanium Installation MP-RAS Installation Solaris x86/x86-64 Installation Solaris (SPARC) Installation Windows Installation Platform Specific Post-installation Requirements 5.1 AIX Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 5.1.1 Installing from the Installation CD-ROM on AIX To install the NetVault: Backup Client software from a CD-ROM, perform the following steps: 1. Log on to the potential Client machine using the root level account. Mount the CD-ROM, if it is not already mounted. 2. From the prompt, issue the command: cd /cdrom/netvault/aix/netvault./install 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information.
52 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 43. Note that, no prompt will be displayed for installation type (Server or Client). 5.1.2 Installing from the Downloaded Binary File on AIX These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. The downloaded file will be in a compressed state and must first be decompressed (i.e., using the necessary O/S-related decompression software). Once complete, initiate a terminal session and navigate to the directory in which the decompressed files reside. 2. Execute the install file, by typing the following:./install 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. Note that, no prompt will be displayed for installation type (Server or Client). 5.2 FreeBSD Installaiton NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 5.2.1 Installing from the Installation CD-ROM on FreeBSD To install the NetVault: Backup Client software from a CD-ROM, perform the following steps: 1. Log on to the potential Client machine using the root level account and mount its CD-ROM drive. The steps are given below: su root mount -rt cd9660 <CD-ROM device node> /cdrom 2. Issue the following commands at the prompt: cd /cdrom/netvault/freebsd/netvault./install
NetVault : Backup 53 Installation/Upgrade Guide 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. Note that, no prompt will be displayed for installation type (Server or Client). 5.2.2 Installing from the Downloaded Binary File on FreeBSD These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. The downloaded file will be in a compressed state and must first be decompressed (i.e., using the necessary FreeBSD O/S-related decompression software). Once complete, initiate a terminal session and navigate to the directory in which the decompressed files reside. 2. Execute the install file, by typing the following:./install 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. Note that, no prompt will be displayed for installation type (Server or Client). 5.3 HP-UX Itanium Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 5.3.1 Installing from the Installation CD-ROM on HP-UX Itanium To install the NetVault: Backup Client software from a CD-ROM, perform the following steps: 1. Log on to the potential Client machine using the root level account and mount its CD-ROM drive. The steps are given below: 1. Start the PFS Daemons, utilizing the following commands: # nohup /usr/sbin/pfs_mountd &
54 Chapter 5 NetVault: Backup Client Installation # nohup /usr/sbin/pfsd 4 & 2. Mount the CD-ROM using the following commands: # pfs_mount -o xlat=unix /dev/rdsk/cxtxd0 /mountpoint 2. From the prompt, issue the command: cd /cdrom/netvault/hpux_ia64/netvault./install 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.3.2 Installing from the Downloaded Binary File on HP-UX Itanium These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. The downloaded file will be in a compressed state and must first be decompressed (i.e., using the necessary HP-UX (Itanium) O/S-related decompression software). Once complete, initiate a terminal session and navigate to the directory in which the decompressed files reside. 2. Execute the install file, by typing the following:./install 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.4 Linux x86/x86-64 Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods.
NetVault : Backup 55 Installation/Upgrade Guide 5.4.1 Installing from the Installation CD-ROM on Linux x86/ x86-64 To install the NetVault: Backup Client software from a CD-ROM, perform the following steps: 1. Log on to the target machine with the root-level account. 2. With the CD-ROM in the drive, initiate a terminal session and input the following command (assuming that all versions of Linux should automount the CD-ROM drive): 32-bit Linux cd /cdrom/netvault/linux_x86_32/netvault 64-bit Linux cd /cdrom/netvault/linux_x86_64/netvault On some Linux installations (e.g., RHEL 5), if a CD-ROM is auto-mounted, installation from the CDROM will fail with error message "bash:./install: / bin/sh bad interpreter: Permission denined". To avoid this problem, the CD-ROM needs to be mounted manually without the noexec mount option. Example: umount /media/ mount -t iso9660 /dev/cdrom /media 3. Execute the install file, by typing the following:./install 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. When confronted with the Should a Client or Server version of NetVault: Backup be installed? select C for a NetVault: Backup Client installation and press Enter. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.4.2 Installing from the Downloaded Binary File on Linux x86/x86-64 These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log on to the target machine with the root-level account.
56 Chapter 5 NetVault: Backup Client Installation 2. The downloaded file will be in a compressed state and must first be decompressed (i.e., using Linux s native decompression utilities either via its GUI or a terminal session). Once complete, navigate to the directory in which the decompressed files reside: 3. Execute the install file, by typing the following:./install 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. When confronted with the Should a Client or Server version of NetVault: Backup be installed? select C for a NetVault: Backup Client installation and press Enter. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.5 Linux Itanium Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 5.5.1 Installing from the Installation CD-ROM on Linux Itanium To install the NetVault: Backup Client software from a CD-ROM, perform the following steps: 1. Log on to the potential Client machine with the root-level account. 2. With the CD-ROM in the drive, initiate a terminal session and input the following command (assuming that all Linux Itanium installations should automount the CD-ROM drive): cd /cdrom/netvault/linux_ia64/netvault On some Linux installations (e.g., RHEL 5), if a CD-ROM is auto-mounted, installation from the CDROM will fail with error message "bash:./install: / bin/sh bad interpreter: Permission denined". To avoid this problem, the CD-ROM needs to be mounted manually without the noexec mount option. Example: umount /media/ mount -t iso9660 /dev/cdrom /media 3. Execute the install file, by typing the following:
NetVault : Backup 57 Installation/Upgrade Guide./install 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. When confronted with the Should a Client or Server version of NetVault: Backup be installed? select C for a NetVault: Backup Client installation and press Enter. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.5.2 Installing from the Downloaded Binary File on Linux Itanium These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log on to the potential Client machine with the root-level account. 2. The downloaded file will be in a compressed state and must first be decompressed (i.e., using Linux s native decompression utilities either via its GUI or a terminal session). Once complete, navigate to the directory in which the decompressed files reside. 3. Execute the install file, by typing the following:./install 4. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 5. When confronted with the Should a Client or Server version of NetVault: Backup be installed? select C for a NetVault: Backup Client installation and press Enter. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43.
58 Chapter 5 NetVault: Backup Client Installation 5.6 MP-RAS Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 5.6.1 Installing the Installation CD-ROM on MP-RAS To install the NetVault: Backup Client software from a CD-ROM, perform the following steps: 1. Log on to the potential Client machine using the root level account and mount its CD-ROM drive, if necessary (i.e., using the steps outlined in Mounting the CD-ROM Drive on MP-RAS on page 34). 2. Insert the CD-ROM into the drive and initiate a terminal session. From the prompt, issue the command: pkgadd -d /cdrom/netvault/mpras/netvault 3. With the installation successfully initiated, a step-by-step set up 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: Backup be installed? select C for a NetVault: Backup Client installation and press Enter to continue. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.6.2 Installing from the Downloaded Binary File on MP-RAS These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log into the system with the root level account. 2. The downloaded file will be in a compressed state (e.g., <filename>.z ) and must first be decompressed (i.e., using the necessary MP-RAS O/S-related decompression software). Once complete, launch a terminal window and add the package for installation, by typing the following: pkgadd -d /<full path to installation files>/netvault 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information.
NetVault : Backup 59 Installation/Upgrade Guide 4. When confronted with the Should a Client or Server version of NetVault: Backup be installed?, select C for a NetVault: Backup Client installation and press Enter to continue. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.7 Solaris x86/x86-64 Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 5.7.1 Installing from the Installation CD-ROM on Solaris x86/ x86-64 NetVault: Backup software is installed to a Solaris through a standard pkgadd installation. The mount point information for the CD-ROM drive is required (as illustrated in the previous section) in order to issue proper command from a command line prompt. 1. Log on to the potential Client machine using the super user ID, and mount its CD-ROM drive, if necessary (i.e., using the steps outlined in Mounting the CD-ROM Drive in Solaris x86/x86-64 on page 36). 2. Insert the CD-ROM into the drive and initiate a terminal session. From the prompt, issue the command: pkgadd -d /cdrom/netvault/solaris_x86/netvault 3. With the installation successfully initiated, a step-by-step set up 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: Backup be installed? select C for a NetVault: Backup Client installation and press Enter to continue. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.7.2 Installing from the Downloaded Binary File on Solaris x86/x86-64 These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps:
60 Chapter 5 NetVault: Backup Client Installation 1. Log into the potential Client system using the Super User ID. 2. After initial download, the file will be in a compressed state (e.g., <filename>.z ) and must first be decompressed using the necessary Solaris 10 (x86) O/S-related decompression software. 3. With the binary file decompressed, navigate to the directory in which the decompressed files reside from the terminal session prompt. 4. Add the package for installation by typing the following: pkgadd -d. netvault 5. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 6. When confronted with the Should a Client or Server version of NetVault: Backup be installed?, select C for a NetVault: Backup Client installation and press Enter to continue. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.8 Solaris (SPARC) Installation NetVault: Backup can be installed either via the installation CD-ROM or the binary file downloaded from BakBone Software s Web site. This following sections describe these two installation methods. 5.8.1 Installing from the Installation CD-ROM on Solaris (SPARC) NetVault: Backup software is installed on Solaris (SPARC) through a standard pkgadd installation. The mount point information for the CD-ROM drive is required (as illustrated in the previous section) in order to issue proper command from a command line prompt. 1. Log on to the potential Client machine using the super user ID, and mount its CD-ROM drive, if necessary (i.e., using the steps outlined in Mounting the CD-ROM Drive in Solaris x86/x86-64 on page 36). 2. Insert the CD-ROM into the drive and initiate a terminal session. From the prompt, issue the command: pkgadd -d /cdrom/netvault/solaris_sparc/netvault 3. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information.
NetVault : Backup 61 Installation/Upgrade Guide 4. When confronted with the Should a Client or Server version of NetVault: Backup be installed? select C for a NetVault: Backup Client installation and press Enter to continue. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.8.2 Installing from the Downloaded Binary File on Solaris (SPARC) These instructions assume that you have successfully downloaded the appropriate binary file from BakBone Software s Web site. In addition, this file must be accessible to the potential NetVault: Backup Server machine. To complete an installation of this type, perform the following steps: 1. Log into the potential Client system using the Super User ID. 2. After initial download, the file will be in a compressed state (e.g., <filename>.z ) and must first be decompressed using the necessary Solaris (SPARC) O/S-related decompression software. 3. With the binary file decompressed, navigate to the directory in which the decompressed files reside from the terminal session prompt. 4. Add the package for installation by typing the following: pkgadd -d. Alternatively, you can issue the following command from the parent directory: pkgadd -d netvault 5. With the installation successfully initiated, a step-by-step set up process will begin. Follow the on-screen prompts as they are given and provide the desired information. 6. When confronted with the Should a Client or Server version of NetVault: Backup be installed?, select C for a NetVault: Backup Client installation and press Enter to continue. Important: For a detailed example of the full installation process, refer to the section Example Installation on a Linux/UNIX-based System on page 43. 5.9 Windows Installation To complete an installation of the Client version of NetVault: Backup on a Windows-based machine, follow the procedure detailed below: 1. Log in to the potential Client system as an Administrator-level user and access the required installation executable files, based on how these files were obtained:
62 Chapter 5 NetVault: Backup Client Installation Via Web Download - The downloaded file should be in a compressed state. Decompress this file to the desired directory, navigate to this directory and locate the following file: <Decompressed Files Directory>\install.exe Important: The decompressed files directory will contain two executables, 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. Figure 5-23: The Choose Installation Type window with the Server radial button selected for a Server installation of NetVault: Backup 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 2. With the executable file launched, an installation wizard will be activated, offering step-by-step instructions via individual windows. Using what was established during the pre-requisite phase, process each window s request and click on the Next button to continue. 3. When confronted with the window asking for the 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 46.
5.10 Platform Specific Post-installation Requirements 5.10.1 Debian 3.1 NetVault : Backup 63 Installation/Upgrade Guide The following steps must be performed on these operating systems after installation: 1. While logged in as the root-level user, initiate a terminal session prompt. 2. Issue the following commands in succession: # update-rc.d netvault defaults 99 mkdir /var/lock/subsys 5.10.2 Debian 4.0 (32-bit) After installing the NetVault: Backup software, issue the following command at the prompt: ln -s $NETVAULTHOME/etc/startup.sh /etc/rc2.d/s99netvault 5.10.3 Debian 4.0 (64-bit) After installing the NetVault: Backup software, issue the following command at the prompt: ln -s $NETVAULTHOME/etc/startup.sh /etc/rc2.d/s99netvault 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
64 Chapter 5 NetVault: Backup Client Installation 5.10.5 Solaris x86-x86-64 If the Client machine has a locally attached library device that will be added to the NetVault: Backup Server for use (i.e., the Client is to be configured as a NetVault: Backup SmartClientTM), you must follow the process outlined in the section, Solaris 10 on page 40 in order to properly configure the library s robotic arm changer device. 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 41.
NetVault : Backup 65 Installation/Upgrade Guide Chapter 6: 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 Backup the Existing NVDB Stopping NetVault: Backup Processes Removing Extraneous NetVault: Backup Installation Files Disabling Anti-Virus Software Upgrade Procedure Upgrading from v7.x and Later Versions Upgrading from Earlier Versions 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 6.1 Upgrade Overview Upgrading is a relatively simple procedure, but a few general rules apply to all version upgrades: A NetVault: Backup Server can only support Clients of the same version as itself, or older. It can not, however, support Clients running a newer version of the software. When upgrading, it is critical that the NetVault: Backup Server be upgraded before upgrading any NetVault: Backup Clients. If using NetVault: Backup s Domain Management functionality to remotely manage an instance of the NetVault: Backup Server, the machine controlling it will require an upgrade as well.
66 Chapter 6 Upgrading NetVault: Backup Important: Of the points made above, all are important, but it is critical that the NetVault: Backup Server be upgraded first, before any Clients. 6.2 Pre-upgrade Procedures To protect from an upgrade failure, it is very important to first perform the following operations in the existing installation of NetVault: Backup. 6.2.1 Backup the Existing NVDB The first step in preparing for an upgrade is to perform a backup of the existing NVDB. In the event that an upgrade is unsuccessful, the previous version of NetVault: Backup can be reinstalled, and this backup of the database can be recovered to allow for troubleshooting of the failed upgrade (i.e., without interfering with an existing backup schedule). For details on a backup of the NVDB with the NetVault Databases Plugin, refer to NetVault: Backup Administrator s Guide. 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 ). 6.2.2 Stopping NetVault: Backup Processes Before upgrading, it is necessary to close the NetVault: Backup Configurator. If NetVault: Backup detects that any of its processes are running during an upgrade, the upgrade will fail and the user will get an error message referring to the output of a pre-install script. If this occurs, close the NetVault: Backup Configurator and re-attempt the upgrade. 6.2.3 Removing Extraneous NetVault: Backup Installation Files Important: This pre-requisite only applies to upgrades from version 7.1.1. 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: Backup/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
NetVault : Backup 67 Installation/Upgrade Guide 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. 6.2.4 Disabling Anti-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 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. 6.3 Upgrade Procedure The following sections detail the procedures involved in 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). 6.3.1 Upgrading from v7.x and Later Versions Based on the operating system in use, run the install program as usual. The installation software will scan the system for an existing installation of NetVault: Backup and once found, a prompt will appear noting that NetVault: Backup is already installed. The install program will ask to upgrade the existing version to the latest version. Once confirmed, the upgrade procedure will begin and use the existing directories for the current installation (e.g.,.../netvault: Backup6/ for older upgrade installations, and.../netvault: Backup/ for 7.x and later installations). 6.3.2 Upgrading from Earlier Versions If using a version of NetVault: Backup earlier than 7.x (e.g., versions 6.5.x and earlier), it is not possible to perform a straight upgrade to the latest version. It is first necessary to successfully upgrade the system to either version 7.1.3 or 7.3.1, and then perform a second upgrade to the latest version. Contact BakBone Technical Support for information on obtaining the necessary software to perform a successful upgrade. 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.
68 Chapter 6 Upgrading NetVault: Backup 6.4 Post Upgrade Procedure A backup taken of an earlier version of the NVDB cannot be restored to the new version because the database will have changed format after upgrade. However, all pre-existing data contained within the database, pre-upgrade will still be present after a successful upgrade. Therefore, it is highly recommended that a backup of this newly updated version of the NVDB be the first job performed, so a valid fail safe will be available. 6.4.1 Post-Upgrade NVDB Summary 1. Backup the NVBD To preserve its contents in the event of a failed upgrade (i.e., this backup can then be re-applied to a repair installation of the old version of NetVault: Backup). 2. Run the Install Program to Perform the Upgrade 3. Backup the New NVDB To create a fail safe backup image of the newly created version of the database. 6.4.2 Does the System Require a Reboot After Upgrade? Once all of the preceding procedures have been completed and NetVault: Backup is opened, if it starts successfully, the upgrade can be assumed to have been successful. If NetVault: Backup will not start then a reboot should be performed. 6.4.3 Post-upgrade Requirement on Solaris 10 NetVault: Backup Server 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
NetVault : Backup 69 Installation/Upgrade Guide (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: Backup\config 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: Backup\config directory (and you must edit the file to appear as outlined above). 9. Navigate to the following directory: /kernel/drv/ 10.Locate the sgen.conf file and open it with a text editor. Edit the file to appear as follows. Lines shown below, prefaced with a # are existing lines in the file. Locate each and preface it with a # in order to leave it in the file, but have NetVault: Backup ignore the entry. Non- # prefaced lines indicate new entries that must be added. #name= sgen class="scsi" target=0 lun=0; #name= sgen class="scsi" target=1 lun=0;
70 Chapter 6 Upgrading NetVault: Backup #name="sgen" class="scsi" target=2 lun=0; #name="sgen" class="scsi" target=3 lun=0; #name="sgen" class="scsi" target=4 lun=0; #name="sgen" class="scsi" target=5 lun=0; #name="sgen" class="scsi" target=6 lun=0; #name="sgen" class="scsi" target=7 lun=0; #name="sgen" class="scsi" target=8 lun=0; #name="sgen" class="scsi" target=9 lun=0; #name="sgen" class="scsi" target=10 lun=0; #name="sgen" class="scsi" target=11 lun=0; #name="sgen" class="scsi" target=12 lun=0; #name="sgen" class="scsi" target=13 lun=0; #name="sgen" class="scsi" target=14 lun=0; #name="sgen" class="scsi" target=15 lun=0; #NV additions - auto generated by postinstall device-type-config-list="changer"; name="sgen" class="scsi" target=0 lun=0; name="sgen" class="scsi" target=1 lun=0; name="sgen" class="scsi" target=2 lun=0; name="sgen" class="scsi" target=3 lun=0; name="sgen" class="scsi" target=4 lun=0; name="sgen" class="scsi" target=5 lun=0; name="sgen" class="scsi" target=6 lun=0; name="sgen" class="scsi" target=7 lun=0; name="sgen" class="scsi" target=8 lun=0; name="sgen" class="scsi" target=9 lun=0; name="sgen" class="scsi" target=10 lun=0; name="sgen" class="scsi" target=11 lun=0; name="sgen" class="scsi" target=12 lun=0; name="sgen" class="scsi" target=13 lun=0; name="sgen" class="scsi" target=14 lun=0; name="sgen" class="scsi" target=15 lun=0; 11.With the file properly edited save and close it. 12.Issue the following command to generate a required link at /dev/scsi/changer :
NetVault : Backup 71 Installation/Upgrade Guide devfsadm -v -i sgen 13.Restart NetVault: Backup services (i.e., via the NetVault: Backup Configurator). 14.Re-add the removed device(s). 15.Re-create all deleted jobs (i.e., using the information gathered in Step 2). Method 2: Edit the sgen.conf file to Include Applicable Devices - Overall, this is the shortest method to employ. However, it only accommodates those devices that are currently under the control of the NetVault: Backup Server (i.e., if you need to add additional devices to the NetVault: Backup Server at a later date, they will not be automatically recognized by the software, and additional configuration steps would be required). This method also presents a potential risk because if the machine is re-configured, the links that are manually created here may be lost, preventing NetVault: Backup from detecting the devices. 1. Log in to the existing Solaris 10 NetVault: Backup Server, using an account with at least super-user level access. 2. Stop NetVault: Backup services (i.e., using the NetVault: Backup Configurator) 3. Open a terminal session and issue the following command to list the current NetVault: Backup driver entries: ls -l /dev/nv* 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:
72 Chapter 6 Upgrading NetVault: Backup 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: 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
NetVault : Backup 73 Installation/Upgrade Guide 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. 6.5 Known Upgrade Issues This section describes the various issues with upgrading NetVault: Backup, its symptoms, causes and solutions. Three Way Windows-based O/S Upgrade Issue Symptoms When a three stage upgrade on Windows is performed as follows, two NetVault: Backup entries will appear in the Add/Remove programs list: Start with ver. 7.0 and Upgrade to a 7.1 build prior to Dec 23, 2003 Upgrade to the latest build Cause This occurs because NetVault: Backup version 8.2 was installed permachine, but NetVault: Backup data was installed per-user. With the new Windows Installer, products cannot upgrade products that were installed differently in terms of per-machine vs per-user installation. NetVault: Backup should only support per-machine installs, but an error in earlier 7.1 builds meant that upgrades were installed per-user. When this occurs, the upgrade will be successful and NetVault: Backup should function correctly. However: Removing either entry from the Add/Remove programs list will cause NetVault: Backup to stop functioning. Depending on which order packages are removed, NetVault: Backup shortcuts may not be correctly removed. 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.
74 Chapter 6 Upgrading NetVault: Backup Error appears when upgrading NetVault: Backup 7.1.2 to 7.4 on NCR MP-RAS and Solaris operating systems Cause Solution The line instance=unique in the file /var/sadm/pkg/install/admin/default causes the upgrade failure. 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 Error appears when launching an installation from a mapped drive letter on a terminal server Symptoms Cause Error 2755 appears after launching an installation from a mapped drive letter to a terminal server. Windows 2000 does not support passing mapped drive letter information between terminal server sessions. Since the Windows Installer service runs as a service in the console session, mapped drive letters established in remote sessions are not visible to the Windows Installer service, resulting in this error. This only applies when running the service in Application Server mode, not Remote Admin mode. This limitation does not exist in Windows XP and later operating systems. NetVault: Backup Libraries Locked by Non-NetVault: Backup Processes Symptoms Upgrade failure occurred because winnt\system32\lib files could not be deleted due to sharing violations. Cause The DB2 APM causes this problem. After the DB2 APM is installed, DB2 has the NetVault: Backup hook library loaded. Loading this library also causes DB2 to load the dependent NetVault: Backup libraries libnv6.dll, libnv6plugin.dll and libnv6os.dll. Because these libraries are in use, NetVault: Backup cannot overwrite them during an upgrade. This causes NetVault: Backup programs used in the upgrade to fail as they end up trying to link against the old versions of the libraries. Solution Stop the DB2 APM, re-attempt the upgrade, and re-start the DB2 APM. 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.
NetVault : Backup 75 Installation/Upgrade Guide If the Oracle RMAN APM is Installed, Oracle Instances Running on the Oracle Server Must Be Shut Down at NetVault: Backup Upgrade Cause Solution 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. 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.
76 Chapter 7 NetVault: Backup Plugin Installation Chapter 7: NETVAULT: BACKUP PLUGIN INSTALLATION This chapter provides information installing NetVault: Backup Plugins. The information in this chapter is organized into the following topics: Installing NetVault: Backup Plugins Installing Optional Plugins and APMs Installing NetVault: Backup Core Plugins Removing a Plugin or APM 7.1 Installing NetVault: Backup Plugins NetVault: Backup offers a selection of components that are used in conjunction with the NetVault: Backup GUI to perform specific backup and recovery operations -- either to backup specific types of data or to add more functionality to the GUI itself. These are broken down into two families: Optional Plugins and Application Plugin Modules (APMs) - This pertains to any number of optional components that are licensed separately from the NetVault: Backup Server Editions (WorkGroup, DataCenter, Enterprise) and include the NDMP, VMware, SnapVault, SnapShot Manager, Snap Mirror to Tape Plugins and the Oracle, SQL Server, Exchange, SharePoint, MySQL, PostgreSQL, DB2, Lotus Notes/Domino, Sybase, Informix, and TeraData Application Plugin Modules. Core NetVault: Backup Plugins - This consists of the plugins that are automatically installed with a default installation of NetVault: Backup. The following sections offer information and instructions on the installation of these APMs and plugins. 7.1.1 Installing Optional Plugins and APMs Due to specific pre-installation and post-installation instructions that are required on a per-apm/plugin basis, individual user s guides have been generated that offer complete installation instructions. Please refer to BakBone Software s Web site to obtain these individual user s guides: http://www.bakbone.com/documentation/
7.1.2 Installing NetVault: Backup Core Plugins NetVault : Backup 77 Installation/Upgrade Guide Separate installation procedures are not required for NetVault: Backup s Core Plugins, which are automatically included with a standard installation of the software. Core Plugins include the following: File System Plugin Consolidate Incremental Backups Plugin Data Copy Plugin NetVault Databases Plugin Raw Device Plugin 7.1.2.a Re-Installing a NetVault: Backup Core Plugin In the event that a NetVault: Backup Core Plugin was removed from a target system, the instructions that follow can be utilized to re-install it. 1. Open the NetVault: Backup Client Management window by clicking the Client Management button on the command toolbar (or by selecting Client Management from the Administration pull-down menu). 2. In the Clients frame, right-click on the machine serving as the NetVault: Backup Server and choose Install Software from the pop-up menu. 3. A window will launch allowing you to navigate to the desired directory to select the file for installation. Navigate to the following directory (where... represents the complete path to the installation of NetVault: Backup on the target machine):.../netvault: Backup/packages/standard 4. A list of files will be displayed. Based on the plugin that is to be re-installed, select one of the following files: con<####>.npk - Consolidate Incremental Backups Plugin cpy<####>.npk - Data Copy Plugin nvd<####>.npk - NetVault Databases Plugin nvf<####>.npk - File System Plugin raw<####>.npk - Raw Device Plugin 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.
78 Chapter 7 NetVault: Backup Plugin Installation Figure 7-24: The Install Software dialog box 5. Click Open to begin the installation process. When the installation is complete, a successful installation message will appear in the Install Software dialog box. 6. The plugin has now been re-installed and is ready for use. 7.1.3 Removing a Plugin or APM Removal of NetVault: Backup APMs and Plugins varies based on type. The sections that follow outline the removal of the two types of NetVault: Backup APMs/Plugin (i.e., NetVault: Backup Core Plugins vs. Optional Plugins and APMs). Important: Prior to attempting to remove any NetVault: Backup APM/Plugin component, it is recommended that you consult BakBone Technical Support to ensure that removal will not negatively affect NetVault: Backup and its functionality. 7.1.3.a 7.1.3.b Removing NetVault: Backup Core Plugins It is strongly recommended that all of NetVault: Backup s Core Plugins be left installed and not removed. Only remove a NetVault: Backup Core Plugin at the recommendation of, and under full guidance of a BakBone Technical Support representative. NetVault: Backup Core Plugins consist of the following: File System Plugin Consolidate Incremental Backups Plugin Data Copy Plugin NetVault Databases Plugin Raw Device Plugin Removing Optional Plugins and APMs In the same manner as installation, removal of an optional APM/Plugin may require additional steps be performed to successfully remove the component. Therefore, the individual user s guides that have been generated for each optional APM/Plugin should be consulted for these instructions. Please refer to BakBone Software s web site to obtain these individual user s guides: http://www.bakbone.com/documentation
NetVault : Backup 79 Installation/Upgrade Guide Chapter 8: 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 8.1 Licensing NetVault: Backup Figure 8-1: The dialog box that is revealed when an operation is accessed after the 45-day evaluation has ended Once installed, the NetVault: Backup software is operational for 45 days. Once this evaluation period has ended, NetVault: Backup functionality will be discontinued unless a license key is obtained. To license the software, locate the relevant machine IDs, and contact BakBone License Support. A License Key will be issued which then needs to be installed. 8.1.1 Locating Machine IDs Figure 8-2: The Machine ID as revealed in the System tab of the Client Properties window To get the IDs of your NetVault: Backup machine (normally the NetVault: Backup Server): 1. Open the Client Management window by clicking on either of the available Client Management buttons in the command toolbar (or select the Client Management command from the Administration pull-down menu). 2. Select the desired machine from the Clients list and right click on it. 3. Select Properties from the pop-up menu to reveal the Client Properties box. The Machine ID is displayed in the System tab.
80 Chapter 8 Licensing NetVault: Backup 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. 8.1.2 Requesting a License Key A license key is required in order to continue using NetVault: Backup past its trial period. To request a NetVault: Backup License Key, it is necessary to contact BakBone Software Licensing Support and provide the following information: Machine ID of NetVault: Backup Server and any APMs - Provide the Machine s ID gained in the process detailed above for the NetVault: Backup Server as well as any applicable Application Plugin Modules installed on that machine. Machine ID of NetVault: Backup Clients and any APMs - A NetVault: Backup Client system (one on which the Client version of the software is installed), is not licensable, although any NetVault: Backup APMs installed on the system are. Provide the Machine ID(s) for these NetVault: Backup Clients as well as the name(s) of the Application Plugin Module(s) installed. 8.1.2.a Contacting BakBone Licensing Support To obtain a license key from BakBone Licensing Support, submit the request via BakBone s on-line product licensing form at: http://www.bakbone.com/support/product_licensing 8.1.3 Installing a License Key A NetVault: Backup License Key is valid only for the Machine ID for which it is issued. License Keys are e-mailed directly to the customer. To install a license key, perform the following steps. You can also install the license keys via the NetVault: Backup Configurator. For details, refer to the NetVault: Backup Configurator 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. 1. Open the NetVault: Backup Client Management window by clicking the Client Management button on the command toolbars (or by selecting Client Management from the Administration pull-down menu). 2. Select the desired machine from the Clients list and right click on it. 3. Select Install License Key from the pop-up menu.
NetVault : Backup 81 Installation/Upgrade Guide Figure 8-3: The License Key dialog boxes 4. The Enter Key String dialog box will appear. Enter the key in the Enter Key String box. It is recommended that the key be copied directly from the e-mail into the Enter Key String box to avoid possible errors. Click OK. 5. If the license key is installed successfully, a message dialog box will appear. Click on OK to exit this box and return to the Client Management window. 6. Click OK to complete the license key installation.
82 Chapter 9 Uninstallation Chapter 9: 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 9.1 Uninstalling NetVault: Backup This section offers complete uninstallation instructions for each operating system supported with this release of NetVault: Backup. Instructions are given for both Client and Server versions. 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. 9.1.1 Uninstalling from a Linux/UNIX-based O/S The instructions offered in this section apply to the removal of NetVault: Backup from the following supported Operating Systems: AIX HP-UX Itanium Linux x86/x86-64 Linux Itanium Follow the steps below to successfully remove NetVault: Backup from any of the above-named operating systems: 1. From a terminal session, navigate to the root prompt. 2. Review the points below and select the appropriate uninstall command, based on the installation history of NetVault: Backup for the target machine: 7.x Upgrades/New Installations - If the original installation of NetVault: Backup on the target machine was a 7.x version, issue the following command at the prompt:
NetVault : Backup 83 Installation/Upgrade Guide./<path to NetVault: Backup installation>/netvault/ util/uninstall./<path to NetVault: Backup installation>/netvault/util/uninstall Older Upgrade Installations - If the original installation on the target machine was a 6.x version of NetVault: Backup that has been upgraded to a 7.x version, issue the following command at the prompt:./<path to NetVault: Backup installation>/netvault6/ util/uninstall 3. Follow the on-screen instructions to remove the software. 9.1.2 Uninstalling from a Windows-based O/S 1. Access the Control Panel window in Windows (e.g., via Start > Settings > Control Panel). 2. From this window, locate the Add/Remove Programs icon and double-click on it to launch this utility. 3. In the list of installed programs, navigate to the NetVault: Backup item. Select it and click on the Remove button. A dialog box will launch requesting confirmation of the remove request. Click on Yes to continue (or No to abort). 4. The removal process will begin, and several dialog boxes will be launched, monitoring its progress. 5. Not all NetVault: Backup files are removed during the previous process. Therefore, it is necessary to manually remove the NetVault: Backup installation directory and all of its contents. This directory will be located as follows (where... represents the path to the installation):.../netvault 6. With the directory deleted, NetVault: Backup has been uninstalled. 9.1.2.a Completing the Uninstall: Editing the Windows Registry With the previous process complete, all files pertaining to NetVault: Backup have been removed from the target system and it can be used as normal. However, a NetVault: Backup installation records various entries in the Windows Registry that are required for its use (and only NetVault: Backup s use). These entries can be left in the Registry with no negative effects to the target system. However, if it is ever necessary to re-install NetVault: Backup on this system, these entries must be removed from Registry, otherwise reinstallation of NetVault: Backup will not be possible. The procedure that follows can be used to successfully remove these Registry entries. 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.
84 Chapter 9 Uninstallation Figure 9-4: The Run window with the regedit command input Figure 9-5: Deleting the NetVault: Backup Ltd folder item from the HKEY_ CURRENT_ USER Registry key on a Windows 2000 system 1. Log into the target system using a Windows Administrator-level account. 2. From the Start menu, select the Run command. In the window that appears, type the following command, followed by clicking on the OK button: regedit 3. The Registry Edit utility will be launched. In the left-hand pane of this window, a tree-structure will be revealed beneath the My Computer parent item. 4. Locate the HKEY_CURRENT_USER key and click on its accompanying + icon to expand it (or double-click on the item). 5. Locate the Software key and expand this item. In the tree structure that is revealed, locate the key entitled NetVault: Backup Ltd and click on it to select it. 6. Delete this key (e.g., by either pressing the Delete key or by right-clicking on it and selecting Delete from the pop-up menu). 7. In the dialog box that appears, confirm the delete request by clicking on the Yes button. 8. Close the HKEY_CURRENT_USER key (e.g., by double-clicking on it or clicking on its accompanying - icon). 9. Repeat steps 4-8, using the HKEY_LOCAL_MACHINE key, in order to delete the NetVault: Backup Ltd folder that exists there. 10.With both NetVault: Backup Ltd folder items deleted, this process is complete and the Registry Edit window can be closed.
NetVault : Backup 85 Installation/Upgrade Guide 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. 9.1.3 Uninstalling from a Solaris (SPARC/x86/x86-64) or NCR MP-RAS O/S The sub-sections that follow, illustrate how to successfully remove an installation of NetVault: Backup, based on installation type (i.e., new installation vs. an upgrade). The instructions offered are to be used regardless of NetVault: Backup version installed (i.e., Client vs. Server) 9.1.3.a 9.1.3.b New Installations (version 8.x) 1. Launch a terminal session. 2. Regardless of NetVault: Backup version installed (i.e., Client vs. Server), issue the following command to initiate the uninstallation process. pkgrm netvault 3. Upon successful completion, a message will be displayed in terminal session window indicating this. Older Upgrade Installations (from 6.5.x) If your system at one time ran a 6.5.x version of NetVault: Backup and has been upgraded ultimately to current version, the uninstall must be performed in two separate phases. Each of these phases is covered in the following sub-sections. 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. Phase 1: Remove the Upgrade Installation 1. Launch a terminal session. 2. Regardless of NetVault: Backup version installed (i.e., Client vs. Server), issue the following command to initiate the uninstallation process. pkgrm netvault 3. Upon successful completion, a message will be displayed in the terminal session window indicating this.
86 Chapter 9 Uninstallation Phase 2: Remove the Original Installation 1. While still in the terminal session window, issue the following command, based on the NetVault: Backup version installed: NetVault: Backup Server pkgrm nv6server NetVault: Backup Client pkgrm nv6client 2. Follow the on-screen instructions to remove the software.