If you are installing Archive Backup System (ABS)/Media Device and Management System (MDMS) for the first time, read through this installation guide before installing the products. Also, refer to the VSI Archive Backup System for OpenVMS Guide to Operations for information on configuring ABS/MDMS.

If you are updating ABS/MDMS, you should review the release notes provided in the installation kit. You can extract the release notes by using the following command:

@SYS$UPDATE:VMSINSTAL kit_name kit_location OPTIONS N

The upgrade from ABS/MDMS V3.x to V4.0 requires a conversion of the ABS policy database. You can directly upgrade from ABS/MDMS V3.x to any ABS/MDMS V4.x version.

For your storage application to work, the hardware it depends on must be installed, connected, and configured to function with the operating system. To configure your hardware, see the hardware manuals provided with the hardware device. Also, refer to VSI Archive Backup System for OpenVMS Guide to Operations for troubleshooting suggestions.

If you are installing tape jukeboxes for use with ABS/MDMS, you should verify that the hardware is working correctly before installing ABS/MDMS. To verify the hardware installed, you can use the MRU kit that is provided along with the ABS kit.

Consider RDF Configuration

MDMS provides RDF software to facilitate operations that require access to remote, network connected tape drives. This allows you to copy data from a local site to a remote site, or copy data from a remote site to a local site. RDF requires that DECnet is installed and running.

During the installation you will be asked questions on whether you want to install on this node, the software that will allow it to act as a server and/or client for the RDF software. You need to decide if you want the server and/or client installed on the node.

VSI recommends that you perform a backup operation on the system disk before installing any software. For details about performing a backup operation on a system disk, refer to the VSI OpenVMS System Manager's Manual.

To use ABS software, you must register and load the licenses before you begin the installation procedure. This information is supplied in the License PAK document, which is packaged along with the Archive Backup System for OpenVMS Cover Letter.

To register a license under OpenVMS, use the following procedure:

If you plan to use ABS on more than one node in an OpenVMS Cluster, you must load the licenses on other nodes after you install ABS. See Table 2.6, “How to Register Your ABS Licenses Using the LICENSE REGISTER Command” for instructions.

Table 2.6, “How to Register Your ABS Licenses Using the LICENSE REGISTER Command” describes how to register your license using the LICENSE REGISTER command.

Table 2.7, “How to Register Your ABS Licenses Using VMSLICENSE.COM” describes how to register your license using the command procedure.

$ @SYS$UPDATE:VMSLICENSE.COM

Issuer[DEC]
Authorization Number[]:
Authorization Number[]:ALS-NQ-1996JUN10-181
Product Name[]:ABS-SERVER
Producer[DEC]:
Number of Units[]:1050
Version[]:
Product Release Date[]:
Key Termination Date[]:
Availability Table Code[]:H
Activity Table Code[]:
Key Options[]:MOD_UNITS,ALPHA
Product Token[]:
Hardware-Id[]:
Checksum[]:2-PIBA-KIPP=BIGE-DDHC

See Table 3.1, “Stages of Installing ABS Software” for the stages of installing and configuring ABS/MDMS software.

ABS will be installed with the following options:
Device for ABS/MDMS - SYS$COMMON (will use current values if either MDMS or
ABS are already installed)
UIC for the ABS account - [311,311]
Nodes for the database severs - Current node or already existing server nodes
What scheduling option do you want - INTERNAL
Are you using backup-via-shelving - YES (If HSM is present)

MDMS will be installed with the following options:
Device for ABS/MDMS - SYS$COMMON (or current installed location)
UIC for MDMS Account - [312,312] (or will be constructed from ABS UIC)
Node for database servers - Current node or already existing server nodes
Do you want to replace MRD$RTL.EXE - YES

MDMS GUI files will be installed with the following options:
Do you want the MDMS GUI installed on Alpha OpenVMS - YES (if on Alpha)
Do you want files extracted for Microsoft Windows on Intel - YES

Remote Device Facility (RDF) will be installed with the following options:
Do you want MDMS support for RDF Server - YES
Do you want MDMS support for RDF Client - YES

$ @SYS$UPDATE:VMSINSTAL saveset-name drive-name OPTIONS N

ABS044 (for example)

$ @SYS$UPDATE:VMSINSTAL saveset_name MTA0: OPTIONS N

OpenVMS VAX Software Product Installation Procedure V7.2
It is 21-JUL-1996 at 10:00
Enter a question mark (?) at any time for help.

* Node name list for Database Servers : SVNODE

If you are installing ABS as a new installation, database initialization programs may fail to run. To initialize the database with the default storage policies and execution policies, run the following executable:

RUN SYS$SYSTEM:ABS$DB_INIT.EXE

If this is the initial installation of MDMS, you may need to create the node object in the MDMS node database for this node. Use the MDMS CREATE NODE command to create this initial database node. Refer to the command reference guide for the qualifiers for this command. The following is an example:

$ MDMS CREATE NODE NABORS -
! NABORS is the DECnet Phase IV node name or a
! name you make up if you do not use DECnet
! Phase IV in your network
/DATABASE_SERVER -
! a potential database node
! must also be defined in
! in SYS$STARTUP:MDMS$SYSTARTUP.COM
/TCPIP_FULLNAME=NABORS.SITE.INC.COM -
! the TCP/IP full node name if you
! are using TCP/IP you need this if
! you are using the GUI
/DECNET_FULLNAME=INC:.SITE.NABORS -
! this is the full DECnet Phase V node name
! do not define if you do not have DECnet Phase V on this node
! be sure to define if you have DECnet Phase V installed on this node
/TRANSPORT=(DECNET,TCPIP)
! describes the transports that listeners are
! started up on

If you did not execute the IVP during the installation procedure, you can execute it immediately after installing ABS/MDMS software. Enter the following command at the DCL system prompt:

$ @SYS$TEST:ABS$IVP.COM
$ @SYS$TEST:MDMS$IVP.COM

If an error occurs during the IVP, the following message is displayed:

ABS Version V4.4 Installation Verification Procedure failed.
%VMSINSTAL-E-IVPFAIL, The IVP for ABS Version V4.4 has failed.

Errors can occur during the installation if any of the following conditions exist:

For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, you should take the appropriate action as described in the message.

You must edit the startup and shutdown files to provide automatic startup and shutdown of ABS/MDMS software. To make sure that ABS/MDMS automatically starts up and shuts down, follow these steps:

ABS$STARTUP uses the ABS$<node> queue to start the ABS processes. This queue will always exist after an ABS installation.

MDMS$STARTUP uses one of several queues to startup the MDMS$SERVER process. There is a logical name, MDMS$STARTUP_QUEUE, which may be defined in MDMS$SYSTARTUP. COM. This logical points to the queue which MDMS$STARTUP.COM will use. If you do not have this defined, it will attempt to use the ABS$<node> queue, then SYS$BATCH. If the logical is not defined and neither ABS$node or SYS$BATCH exist, the MDMS startup will fail.

If you are updating ABS/MDMS and you have made customizations to any of the ABS/MDMS command procedures, you may need to modify those procedures to work with ABS/MDMS V4.4. There are four procedures for which we provide template files. If the template files have changed, you should include your customizations in the new template files and then rename them to the command procedure name. The four procedures and the templates are:

SYS$STARTUP:ABS$SYSTARTUP.COM - SYS$STARTUP:ABS$SYSTARTUP.TEMPLATE
SYS$STARTUP:MDMS$SYSTARTUP.COM - SYS$STARTUP:MDMS$SYSTARTUP.TEMPLATE
MDMS$SYSTEM:MDMS$EXT_QUEUE_MANAGER.COM - MDMS$SYSTEM:
MDMS$EXT_QUEUE_MANAGER.TEMPLATE
MDMS$SYSTEM:MDMS$EXT_SCHEDULER.COM - MDMS$SYSTEM:MDMS$EXT_SCHEDULER.TEMPLATE

If you installed ABS server software on an OpenVMS Cluster system, perform the steps in Table 4.1, “Updating the DCL Tables” on each node in the OpenVMS Cluster (excluding the installing node) where you want to use ABS.

$ @SYS$STARTUP:ABS$STARTUP.COM

$ INSTALL REPLACE SYSLIBRARY:DCLTABLES.EXE

Now that you have installed MDMS you need to configure the MDMS database. MDMS provides a command procedure that you can use to configure the MDMS database in a new installation. The procedure is completely self-documenting with a help facility, and all key object attributes are defined. The procedure guides you through the following configuration objects:

The procedure is activated using the following command:

$ @ MDMS$SYSTEM:MDMS$CONFIGURE.COM

Refer to VSI Archive Backup System for OpenVMS Guide to Operations for an example of using this procedure. If you are upgrading from SLS or ABS V2.9x, you must use the MDMS$CONVERT_V2_TO_V4 command procedure.

Once MDMS is installed, and any conversions are performed, you may wish to adjust your configuration prior to performing MDMS operations.

In addition to configuring MDMS, you might also have to configure robots for jukeboxes you are planning to use. For MRD-controlled jukeboxes, the robot name is the OpenVMS device name of the robot device, and they normally fall into one of several formats:

If the jukebox is controlled by direct-connect SCSI (first option), the robot device must first be loaded on the system with one of the following DCL commands:

Alpha - $ MCR SYSMAN IO CONNECT GKxxx/NOADAPTER/DRIVER=SYS$GKDRIVER.EXE
VAX - $ MCR SYSGEN CONNECT GKxxx/NOADAPTER/DRIVER=GKDRIVER
I64 - $ MCR SYSMAN IO CONNECT GKxxx/NOADAPTER/DRIVER=SYS$GKDRIVER.EXE

and the device name must begin with GK. It is suggested that these commands be included in a system startup file so that they are automatically configured at boot time.

If you installed the RDF software, you need to configure the remote tape drives. RDF is not available if you are installing MDMS with the ABS-OMT license.

RDF is supported on OpenVMS Alpha V8.3 but not supported on OpenVMS I64 V8.2-1 and later versions.

For each tape drive served with RDF Server software, make sure there is a drive object record in the MDMS database that describes it. Refer to the chapters on MDMS configuration in the VSI Archive Backup System for OpenVMS Guide to Operations and the MDMS CREATE DRIVE command in the VSI OpenVMS ABS/HSM Command Reference Guide.

For each node connected to the tape drive, edit the file TTI_RDEV:CONFIG_node.DAT and make sure that all tape drives are represented in the file. Refer to VSI Archive Backup System for OpenVMS Guide to Operations for more information on remote drive setup.

During startup of MDMS, the RDF client and server are also started. The RDF images are linked on your system. If you see the following link errors on Alpha V6.2, this is not an RDF bug. The problem is caused by installed VMS patches ALPCOMPAT_062 and ALPCLUSIO01_062.

%LINK-I-DATMISMCH, creation date of 11-FEB-1997 15:16 in
shareable image SYS$COMMON:[SYSLIB]DISMNTSHR.EXE;3
differs from date of 4-MAY-1995 22:33 in shareable image library
SYS$COMMON:[SYSLIB]IMAGELIB.OLB;1
.
.
.

This is a known problem and is documented in TIMA. To correct the problem, issue the following DCL commands:

$ LIBRARY/REPLACE/SHARE SYS$LIBRARY:IMAGELIB.OLB SYS$SHARE:DISMNTSHR.EXE
$ LIBRARY/REPLACE/SHARE SYS$LIBRARY:IMAGELIB.OLB SYS$SHARE:INIT$SHR.EXE
$ LIBRARY/REPLACE/SHARE SYS$LIBRARY:IMAGELIB.OLB SYS$SHARE:MOUNTSHR.EXE

When ABS Server installation procedure is complete, the user account that performed the installation (typically the SYSTEM account) is granted the following ABS access rights identifiers. These identifiers are only needed if you use ABS DCL commands, or if you have the ABS_RIGHTS option turned on in the MDMS domain. For details on MDMS rights identifiers, refer to VSI Archive Backup System for OpenVMS Guide to Operations.

Requirement:

To grant an access rights identifier to a user’s account, run the AUTHORIZE utility.

Example:

$ SET DEFAULT SYS$SYSTEM
$ RUN AUTHORIZE
UAF>GRANT/IDENTIFIER ABS_LOOKUP_ALL USER1
%UAF-I-GRANTMSG, identifier ABS_LOOKUP_All granted to USER1
UAF>EXIT

$ SET DEFAULT SYS$SYSTEM
$ RUN AUTHORIZE
UAF>REVOKE/IDENTIFIER ABS_BYPASS USER1
%UAF-I-REVOKEMSG, identifier ABS_BYPASS revoked from USER1

This section describes how to install and run the Graphical User Interface (GUI).

As the GUI is based on Java, you must have the Java Runtime Environment (JRE) installed on the system where you are running the GUI. If you do not have the JRE installed on your system, see the information below for the kit location.

The ABS/MDMS installation procedure extracts files from the kit and places them in MDMS$ROOT:[GUI...].

The GUI requires the following in order to run:

Java Runtime Environment V1.2 or above - Since the ABS/MDMS GUI is a Java application, it requires the platform specific JRE. You can download the correct kit from the given URL. You may alternatively install the Standard Edition kit instead of the JRE kit. This is packaged as a PCSI kit, which is simpler to install. Issues concerning availability and installation can be directed to:

http://www.hp.com/java

Do you want the MDMS GUI installed on OpenVMS Alpha/I64 [YES]?

SYS$COMMON:[SYSMGR]SYLOGIN.COM

MDMS$SYSTEM:MDMS$START_GUI.COM

$ SET DISPLAY/CREATE/NODE=node_name/TRANSPORT=transport
$ MDMS/INTERFACE=GUI

If you are configuring ABS/MDMS for System Backup to Tape for Oracle Databases, refer to the System Backup to Tape for Oracle Databases section in VSI Archive Backup System for OpenVMS Guide to Operations.