LaserVault Universal Backup Device (UBD) Installation Guide

LaserVault Universal Backup Device (UBD)
Installation Guide
Version 1.01.000.178
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected]
Page 1
LaserVault UBD Installation Guide
Table of Contents
INTRODUCTION ........................................................................................................................................... 3
SOFTWARE MAINTENANCE .......................................................................................................................... 4
ATTO FIBER CHANNEL HOST ADAPTER INSTALLATION .................................................................................. 5
LASERVAULT UBD INSTALLATION ................................................................................................................. 6
LASERVAULT UBD REGISTRY ...................................................................................................................... 17
LASERVAULT UBD WEB INSTALLATION ....................................................................................................... 19
LASERVAULT UBD WEB MANAGER ............................................................................................................. 38
LASERVAULT UBD LIBRARY INSTALLATION ................................................................................................. 47
LASERVAULT UBD MENU AND COMMANDS ............................................................................................... 48
LASERVAULT UBD BACKUP SAMPLE CL 1 .................................................................................................... 49
LASERVAULT UBD BACKUP SAMPLE CL 2 .................................................................................................... 50
LASERVAULT UBD BACKUP SAMPLE CL 3 .................................................................................................... 51
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 2
Introduction
This document is intended for users who manage LaserVault UBD on iSeries machines and
Windows servers and includes general program information. This guide should be used in
conjunction with, and not as a replacement to, your Software Maintenance Plan.
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 3
Software Maintenance
It is important to keep current with all LaserVault maintenance contracts. Preventative
maintenance for LaserVault products is delivered by distributing library and server software
web update notifications via email.
LaserVault UBD Library and Windows software patch updates are released on an “As Needed”
basis with a new full version of LaserVault software available once every 12 months. Software
patches will include LaserVault UBD Library and Windows server issue fixes and minor
enhancements. New releases of LaserVault UBD Library and Windows server software will
include all previously released issue fixes and minor enhancements as well as any previously
not released issue fixes and major enhancements.
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 4
ATTO Fiber Channel Host Adapter Installation
Step 1.
Install ATTO Fiber Channel Host Adapter Windows x64 Driver v2.66 from
C:\UBD_Install_Package\1-ATTO
Step 2.
Install ATTO Configuration Tool 4.01 from C:\UBD_Install_Package\1-ATTO
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 5
LaserVault UBD Installation
Step 1.
Open Device Manager and select Action, Add Legacy Hardware.
Step 2.
Click Next
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 6
Step 3.
Click Radio button to Install the hardware that I manually select from a list
(Advanced) and then click Next.
Step 4.
Select Show All Devices from the Common Hardware Listing and
then click Next
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 7
Step 5.
Select Have Disk button. Explore to C:\UBD_Install_Package\2EmulateTape_Drivers and select the TspiFC Driver. Click Open.
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 8
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 9
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 10
Step 6.
Run C:\UBD_Install_Package\2-EmulateTape_Drivers\UBD_1.ini
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 11
Step 7.
Install C:\UBD_Install_Package\3-DotNet\DotNetFx40_Full_setup.exe
**Requires an internet connection**
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 12
Step 8.
Reboot the Windows server
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 13
Step 9.
Run C:\UBD_Install_Package\4-EmulateTape_Install\ ETDxxx.exe to install the
Tape Emulation Software
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 14
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 15
Step 10.
Run C:\UBD_Install_Package\4-EmulateTape_Install\UBD_2.ini*
Step 11.
Create D:\Tape0 directory*
Step 12.
Reboot UBD Server
*If saving to a NAS, SAN or Deduplication appliance, create the Tape0 directory on that path. Be sure to
update the UBD_2.ini file with the full UNC path. If you already installed the UBD_2.ini file, you can edit the
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\EmulateTape\0\Parameters\WorkingDirector
y key specifying the full UNC path.*
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 16
LaserVault UBD Registry
The number of EmulateTape keys depends on the number of FC connections to the UBD. All
mandatory key options are marked with an asterisk and must be listed in each
EmulateTape\0\Parameters, EmulateTape\1\Parameters, EmulateTape\2\Parameters, etc...
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\EmulateTape\**Port Number**\Parameters
EmulationMode:
(DWORD) Choose this option to select an Emulation Mode based
on device attached.
0 = TSPI generic tape drive
1 = Exabyte 8505
2 = IBM 3592
3 = IBM 3580
4 = IBM 3580-TD2
(TSPI TARGET MODE 1.00)
(IBM-8505 7Y0R)
(IBM-03592E05 0000)
(IBM-ULT3580-TD1 4561)
(IBM-ULT3580-TD2 73V1)
Default=4
WorkingDirectory:
(String) Choose this option to specify the default tape image save
path.
DefaultTapeName:
(String) Choose this option to select the default Tape Image name
and location. Path can be different than the one specified in the
WorkingDirectory key (used when no specific tape file is loaded).
LogLevel:
(DWORD)
Choose this option to select the UBD logging level.
0 = no logs
1 = log errors
2 = log errors and command information
3 = log errors, information, and data bytes
Default=0
LogDir:
(String)
Choose this option to specify the log’s save path.
If it is not specified, logs will be saved to the directory where UBD is
installed.
AESEncryption:
(String)
Encryption phrase for inline AES-256 Encryption.
Options: empty or absent = encryption is Off
Default: empty (no encryption)
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 17
Compression:
(DWORD)
Choose this option to select inline compression
Options:
0=Off
1-9= Compression Level**
**Higher Number = Higher Compression and Slower Backup Speed
DataBlockFile:
(DWORD) Choose this option to use data split and set the number
of .TDP split files created.
Options:
DataBlockSize:
0–8
(DWORD) Choose this option to set data block size (in bytes). This
parameter is useful with ExaGrid. Used when DataBlockFile>0 only.
Options:
Default:
32768 65536 131072
65536 (should not be changed usually)
TDPWriteCacheSizeMB: (DWORD) Choose this option to specify the cache write size for
.TDP files (in MB). Used when DataBlockFile>0 only.
Options:
1 2 4 8 16 32
Default=0
TAPWriteCacheSizeMB: (DWORD) Choose this option to specify the cache write size for the
tape image file (in MB).
Options:
1 2 4 8 16 32
Default=0
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 18
LaserVault UBD Web Installation
Step 1.
Open Server Manager
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 19
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 20
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 21
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 22
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 23
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 24
Step 2.
Open the IIS7 Application Server Manager screen and click on Default Web Site.
Step 3.
Right Click on Application Pools and select Add Application Pool to create a UBD
Application Pool. Set .NET Framework to v4.0.xxx, Set Managed pipeline mode
to Classic. Click OK.
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 25
Step 4.
Click Default Web Site and select Basic Settings in the Actions screen
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 26
Step 5.
Click Select and Set the Application Pool as UBD. Then click Connect As and set
the Specific User as the Local System Administrator.
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 27
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 28
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 29
Step 6.
Click START, open a RUN prompt and type:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i
Step 7.
Click OK
Step 8.
Click on the WIN- server name under START PAGE
Step 9.
Open Default Document
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 30
Step 10.
Move default.aspx to the top of the listing
Step 11.
Click on the WIN- server name under START PAGE.
Step 12.
Click on ISAPI and CGI Restrictions.
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 31
Step 13.
Allow ASP.NET v4.0.319, both 32 and 64bit instances
Step 14.
Copy all files from UBD_Install_Pkg\5-UBD_WebManager to
C:\inetpub\wwwroot
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 32
Step 15.
Grant IIS_USERS full permissions to wwwroot folder.
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 33
Click on the Security Tab
Scroll down, hi-light IIS_IUSRS and click Edit
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 34
Check the Full Control box
Click OK
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 35
Click OK
Step 16.
Explore to C:\inetpub\wwwroot\App_Data
Step 17.
Edit lvudb.ini
Step 18.
Change the system name to your preference (i.e. LPAR1)
port=Production --------> port=LPAR1
Example: If using multi-port:
port=Production
port=Development
Step 19.
Edit lvubd_0.ini
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 36
Step 20.
Set the folder path to the same as on page 16 above.
Folder=D:\Tape0 ------> folder=yourpathhere
**If using multi-port, follow step 18 & 19 for each lvubd_x.ini file listed**
**Enter the full UNC path if saving to a NAS, SAN or Deduplication appliance**
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 37
LaserVault UBD Web Manager
Open a web browser to: http://localhost/default.aspx
Default Password is: qqq
**This password can be changed by adding password= to the lvudb.ini file discussed in step
18 above**
Open a port by clicking on the folder name.
**This descriptions can be changed by editing the lvudb.ini file discussed in step 18 above**
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 38
Step 1.
Select Tape Image
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 39
Step 2.
Create Tape Image
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 40
Step 3.
Select Folder
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 41
Step 4.
Delete Expired
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 42
Step 5.
Logs
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 43
Step 6.
Options
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 44
Step 7.
Registration
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 45
Step 8.
Column Headers
 Tape Image Name – Name of the tape image set by a UBD CL command or by clicking
Create Tape Image in UBD Web Manager
 Volume Name – Name of the Volume set by the initialize command on the iSeries
 Flags – Identifies tape image registry parameters set for the specified backup
C = Compressed
E = Encrypted
P = Protected
Tn = Number of Data Block Files (TDP)
Ex: PCET4 = Protected / Compressed / Encrypted with 4 TDP files







Size –File size on disk. May include deductions for compression and encryption.
Actual Size – Original size of the backup file prior to compression and / or encryption.
Ratio – Compression Ratio
Created – Date created
Last Updated – Date and time the tape image was last updated
Expires – Expiration Date
System – Type of system saved from to create tape image
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 46
LaserVault UBD Library Installation
Step 1.
Copy UBD.TAP from C:\UBD_Install_Package\6-UBD_Library to your default save
path specified in the WorkingDirectory registry key.
Step 2.
Open the LaserVault UBD Web Manager
Step 3.
Click on the port you set up during Step 18 of “LaserVault UBD Web Installation”
Step 4.
Click on UBDLibrary.TAP
Step 5.
Select Load UBDLibrary.TAP
Step 6.
Open an iSeries session
Step 7.
Run RSTLIB command:
RSTLIB SAVLIB(UBD) DEV(TAPxx) ENDOPT(*UNLOAD) MBROPT(*ALL)
ALWOBJDIF(*ALL)
**Note: DEV is the Auto-Configured Tape Device created on your system when
the UBD was connected**
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 47
LaserVault UBD Menu and Commands
1) CRTUBD – Create a new tape image
Ex. CRTUBD DEV(TAPxx) TAPIMG(TAPEIMAGENAME)
2) INZUBD – Create and initialize a new tape image
Ex. INZUBD DEV(TAPxx) TAPIMG(TAPEIMAGENAME) TAPVOL(VOLNAM)
3) WRKUBD – Load an existing tape image
Ex. WRKUBD DEV(TAPxx) TAPIMG(TAPEIMAGENAME)
4) DELUBD – Delete an existing tape image
Ex. DELUBD DEV(TAPxx) TAPIMG(TAPEIMAGENAME)
5) WRKDIRUBD – Change the tape image save path
Ex. WRKDIRUBD DEV(TAPxx) TAPDIR('C:\TAPE1')
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 48
LaserVault UBD Backup Sample CL 1
The sample CL to create a tape image using the iSeries system date and DAILY as the
tape volume identifier via TAP02 is:
/* THIS SOURCE IS PROVIDED ON AN AS IS BASIS */
/* THIS PROGRAM WILL CREATE A TAPE IMAGE ON THE UBD USING ISERIES
SYSTEM DATE */
PGM
DCL VAR(&DATE) TYPE(*CHAR) LEN(6)
RTVSYSVAL SYSVAL(QDATE) RTNVAR(&DATE)
ADDLIBLE UBD
INZUBD
DEV(TAP02) TAPIMG(&DATE) TAPVOL(DAILY)
ENDPGM
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 49
LaserVault UBD Backup Sample CL 2
The sample CL to create a tape image using the iSeries system date/time and DAILY as
the tape volume identifier via TAP02 is:
0001.00 /* THIS SOURCE IS PROVIDED ON AN AS IS BASIS */
0002.00 /* THIS PROGRAM WILL SAVE ONLY SELECTED USER LIBRARIES */
0003.00
0004.00
PGM
0005.00
DCL VAR(&DATE) TYPE(*CHAR) LEN(6)
0006.00
DCL VAR(&TIME) TYPE(*CHAR) LEN(6)
0007.00
DCL VAR(&DATETIME) TYPE(*CHAR) LEN(12)
0008.00
RTVSYSVAL SYSVAL(QTIME) RTNVAR(&TIME)
0009.00
RTVSYSVAL SYSVAL(QDATE) RTNVAR(&DATE)
0010.00
CHGVAR VAR(&DATETIME) VALUE(&DATE *CAT &TIME)
0011.00
ADDLIBLE UBD
0012.00
MONMSG MSGID(CPF2103)
0013.00
INZUBD DEV(TAP02) TAPIMG(&DATETIME) +
0014.00
TAPVOL(DAILY)
0015.00
SAVLIB LIB(TEST) DEV(TAP02) ENDOPT(*UNLOAD) +
0016.00
ENDPGM
****************** End of data**********************************
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 50
LaserVault UBD Backup Sample CL 3
The sample CL to create a tape image using the iSeries system date/time and DAILY as
the tape volume identifier via TAP02 is:
0001.00 /* THIS SOURCE IS PROVIDED ON AN AS IS BASIS */
0002.00 /* THIS PROGRAM WILL SAVE ONLY SELECTED USER LIBRARIES */
0003.00/* create tape image */
0004.00
0005.00
PGM
0006.00
rtvsysval sysval(qdatetime) rtnvar(&datetime)
0007.00
chgvar &imagename value(%substring(&datetime 1 8) +
0008.00
*cat '-' +
0009.00
*cat %substring(&datetime 9 4))
0010.00
inzubd dev(tap02) tapimg(&imagename) tapvol(daily)
0011.00
SAVLIB LIB(TEST) DEV(TAP02) ENDOPT(*UNLOAD) +
0012.00
ENDPGM
****************** End of data**********************************
Copyright 2015 • Electronic Storage Corporation • 918-664-7276 • 800-444-6283 • www.laservault.com • [email protected] Page 51