laservault universal backup device...

LaserVault

Universal Backup

Device (UBD)

Reference Manual Version 1.01.000.178

2

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



3

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.

4

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.

5

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

6

LaserVault UBD Installation Step 1: Open Device Manager and select “Action, Add Legacy Hardware”

Step 2: Click Next.

7

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.

8

Step 5: Click the Have Disk button. Explore to C:\UBD_Install_Package\2-EmulateTape_Drivers and select the TspiFC Driver. Click Open.

11

Step 6: Run C:\UBD_Install_Package\2-EmulateTape_Drivers\UBD_1.ini

12

Step 7: Install C:\UBD_Install_Package\3-DotNet\DotNetFx40_Full_setup.exe

**Requires an internet connection**

13

Step 8: Reboot the Windows server

14

Step 9: Run C:\UBD_Install_Package\4-EmulateTape_Install\ ETDxxx.exe to install the Tape Emulation Software

16

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.*

17

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 (TSPI TARGET MODE 1.00) 1 = Exabyte 8505 (IBM-8505 7Y0R) 2 = IBM 3592 (IBM-03592E05 0000) 3 = IBM 3580 (IBM-ULT3580-TD1 4561) 4 = IBM 3580-TD2 (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)

18

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: 0 – 8

DataBlockSize: (DWORD) Choose this option to set data block size (in bytes). This parameter is useful with ExaGrid. Used when DataBlockFile>0 only. Options: 32768 65536 131072 Default: 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

19

LaserVault UBD Web Installation Step 1: Open Server Manager

25

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.

26

Step 4: Click Default Web Site and select Basic Settings in the Actions screen

27

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.

30

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

31

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

32

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

33

Step 15: Grant IIS_USERS full permissions to the wwwroot folder

34

Click on the Security tab

Scroll down, hi-light IIS_IUSRS and click Edit

35

Check the “Full control” box

Click OK

36

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

37

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**

38

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**

http://localhost/

39

Select Tape Image

40

Create Tape Image:

41

Select Folder:

42

Delete Expired:

43

Logs:

44

Options:

45

Registration:

46

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

47

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**

48

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')

49

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

50


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**********************************

51


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**********************************

laservault universal backup device...

Documents