LaserVault
Universal Backup
Device (UBD)
Reference Manual
Version 1.01.000.178
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
2
Introduction
This document is intended for users who manage LaserVault UBD on IBM i (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.
3
Software Maintenance
You should ensure you 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.
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
5
LaserVault UBD Installation
Step 1:
Open Device Manager and select “Action, Add Legacy Hardware”
Step 2:
Click Next.
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.
7
Step 5:
Click the Have Disk button. Explore to C:\UBD_Install_Package\2EmulateTape_Drivers and select the TspiFC Driver. Click Open.
8
9
10
Step 6:
Run C:\UBD_Install_Package\2-EmulateTape_Drivers\UBD_1.ini
11
Step 7:
Install
C:\UBD_Install_Package\3-DotNet\DotNetFx40_Full_setup.exe
**Requires an internet connection**
12
Step 8:
Reboot the Windows server
13
Step 9:
Run C:\UBD_Install_Package\4-EmulateTape_Install\ ETDxxx.exe
to install the Tape Emulation Software
14
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\WorkingDirectory key
specifying the full UNC path.*
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)
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
18
LaserVault UBD Web Installation
Step 1:
Open Server Manager
19
20
21
22
23
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, and set Managed pipeline
mode to Classic. Click OK.
25
Step 4:
Click Default Web Site and select Basic Settings in the Actions screen
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.
27
28
29
Step 6:
Click START, open a RUN prompt and type:
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regii
s.exe -i
Step 7:
Click OK
Step 8:
Click on the WIN- server name under START PAGE
Step 9:
Open Default Document
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
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
32
Step 15:
Grant IIS_USERS full permissions to the wwwroot folder
33
Click on the Security tab
Scroll down, hi-light IIS_IUSRS and click Edit
34
Check the “Full control” box
Click OK
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
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**
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.
**These descriptions can be changed by editing the lvudb.ini file discussed in step 18
above**
38
Select Tape Image
39
Create Tape Image:
40
Select Folder:
41
Delete Expired:
42
Logs:
43
Options:
44
Registration:
45
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 IBM i
(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
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 IBM i (iSeries) session
Step 7:
Run the 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**
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')
48
LaserVault UBD Backup Sample CL 1
The sample CL to create a tape image using the IBM i (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
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**********************************
50
LaserVault UBD Backup Sample CL 3
The sample CL to create a tape image using the IBM i (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**********************************
51