Media_and_Device_Management_Services_for_OpenVMS____ Installation Guide Order Number: AA-QRAHD-TE Abstract This document contains information for installing the MDMS software. Revision/Update Information: This revised document supersedes the previous release of this document (Order Number AA-QRAHC-TE). Software Version: Media and Device Management Services for OpenVMS Version 2.8A Optional Software Version: DCSC for OpenVMS Version 2.0A or higher Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ January 1997 Possession, use, or copying of the software described in this documentation is authorized only pursuant to a valid written license from Digital, an authorized sublicenser, or the identified licenser. While Digital believes the information included in this publication is correct as of the date of publication, it is subject to change without notice. Digital Equipment Corporation makes no representations that the interconnection of its products in the manner described in this document will not infringe existing or future patent rights, nor do the descriptions contained in this document imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation 1995, 1996, 1997. All Rights Reserved. Printed in the United States of America. Alpha, DCL, DECnet, Digital UNIX, eXcursion, OpenVMS, OpenVMS Cluster, StorageWorks, VAXTPU, VAX, VMS, and the DIGITAL logo are all trademarks of Digital Equipment Corporation. AIX is registered trademark of International Business Machines Corporation. FTP Software is a trademark of FTP SOFTWARE, INC. HP is a registered trademark of Hewlett-Packard Company. Motif is a registered trademark of the Open Software Foundation, Inc. NT is a trademark of Microsoft Corporation. Oracle, Oracle Rdb, and Oracle RMU are all registered trademarks of Oracle Corporation. PostScript is a registered trademark of Adobe Systems, Inc. RDF is a trademark of Touch Technologies, Inc. SGI is a registered trademark of Chemical Bank. Solaris is a registered trademark of Sun Microsystems, Inc. StorageTek is a registered trademark of Storage Technology Corporation. SunOS is a trademark of Sun Microsystems, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd. Windows and Windows NT are both trademarks of Microsoft Corporation. X Window System is a trademark of Massachusetts Institute of Technology. All other trademarks and registered trademarks are the property of their respective holders. This document was prepared using VAX DOCUMENT, Version 2.1. ___________________________________________________________ Contents ................................................... v Installing MDMS Software Common Questions and Answers..................... 1-1 MDMS Client and Server Software Definitions...... 1-2 Server Software ............................... 1-3 Client Software ............................... 1-3 Before Installing MDMS........................... 1-4 Required Quotas ............................... 1-4 Required OpenVMS Operating System Classes ..... 1-4 Hardware Requirements ......................... 1-5 Software Requirements ......................... 1-7 Server Software Requirements................ 1-7 Client Software Requirements................ 1-8 Optional Software........................... 1-8 License Registration .......................... 1-9 MDMS Software Installing MDMS Software Registering an MDMS Client Node.................. 3-1 Verifying the Installation....................... 3-2 Editing the Systemwide Command Files............. 3-3 Making Sure MDMS Starts Up .................... 3-3 Defining Global Symbols for MDMS Users ........ 3-4 Preparing MDMS Server Software................... 3-4 Defining a Network Object on a VMScluster System......................................... 3-4 Customizing TAPESTART.COM ..................... 3-7 Enabling User Access to Volume Pools .......... 3-7 iii MDMS Server Installation Example Log File MDMS Client Installation Example Log File Files and Logical Names C.1 Files............................................ C-1 C.2 Logical Names.................................... C-8 MDMS Account User Authorization Data D.1 Authorization Data............................... D-1 C-1 Sample List of LNM$SLS$VALUES Entries ......... C-11 1-1 Installation Questions and Answers ............ 1-2 1-2 Before Installing MDMS ........................ 1-4 1-3 How to Check Disk Space Requirements .......... 1-6 1-4 How to Start DECnet and OpenVMS Queue Manager........................................ 1-7 1-5 How to Register Your MDMS License ............. 1-10 2-1 How to Install the MDMS Server or Client Software....................................... 2-1 3-1 Postinstallation Activities ................... 3-1 3-2 How to Register the Client Node ............... 3-2 3-3 How to Define the SLS$DBX NCP Object .......... 3-5 C-1 Files Installed ............................... C-1 C-2 Logical Name Table Entries .................... C-9 D-1 MDMS Account User Authorization Data .......... D-1 ______________________________________________________________ Preface This document describes: o Software and hardware requirements for installing Media and Device Management Services for OpenVMS[TM] (MDMS) Version 2.8A software o Installation instructions for MDMS o Sample installation log files o File and logical names installed on your system o Authorization data (quotas) Audience This guide is intended for experienced OpenVMS system managers and should be used with the System Management Subkit of the OpenVMS documentation set. For the MDMS software, the documentation consists of: o Media and Device Management Services for OpenVMS Installation Guide o Media and Device Management Services for OpenVMS Guide to Operations o Online release notes v The following conventions are used in this guide: ___________________________________________________________ Convention__Description____________________________________ { } In format command descriptions, braces indicate required elements. You must include one of the elements. [ ] Square brackets show optional elements in command syntax. You can omit these elements if you wish to use the default response. . . . Horizontal ellipsis points indicate the omission of information from a sentence or paragraph that is not important to the topic being discussed. Vertical ellipsis points indicate the omission . of information from an example or command . format. The information has been omitted . because it is not important to the topic being discussed. boldface Boldface type in text indicates the first type instance of terms defined in the Glossary or in text. italic Italic type emphasizes important information, type indicates variables, indicates complete titles of manuals, and indicates parameters for system information. Starting This type font denotes system response, user test . . . input, and examples. Ctrl/x Hold down the key labeled Ctrl (Control) and the specified key simultaneously (such as Ctrl /Z). PF1 x The key sequence PF1 x indicates that you press and release the PF1 key, and then you press and release another key (indicated here by x). n A lowercase italic n indicates the generic use of a number. For example, 19nn indicates a four-digit number in which the last two digits are unknown. ___________________________________________________________ Convention__Description____________________________________ x A lowercase italic x indicates the generic use of a letter. For example, xxx indicates any ____________combination_of_three_alphabetic_characters.____ Products The following related products are mentioned in this document: ___________________________________________________________ Product_______Description__________________________________ ABS ABS refers to Archive/Backup System for OpenVMS[TM] software. ABS OMT ABS OMT refers to Archive/Backup System for OpenVMS Management Tools[TM] software. HSM HSM refers to HSM for OpenVMS software. MDMS MDMS refers to Media and Device Management Services for OpenVMS software. OpenVMS Refers to the OpenVMS operating system. SMF SMF refers to Sequential Media Filesystem for OpenVMS software. SLS SLS refers to Storage Library System for ______________OpenVMS_software.____________________________ Documents The following documents are associated with Media and Device Management Services for OpenVMS: o Media and Device Management Services for OpenVMS Guide to Operations o Storage Library System for OpenVMS Installation Guide o Storage Library System for OpenVMS Guide to Backup and Restore Operations o Archive/Backup System for OpenVMS Installation Guide o Archive/Backup System for OpenVMS Guide to Operations o HSM for OpenVMS Guide to Operations vii o POLYCENTER Sequential Media Filesystem for OpenVMS Guide to Operations 1 ______________________________________________________________ Before Installing MDMS Software This chapter includes the following information: o Answers to commonly asked questions about the installation procedure o Definitions about the MDMS server and client software o Preparations that you need to make to install the MDMS software _______________________ Caution _______________________ If you currently use Storage Library System for OpenVMS (SLS), do not install MDMS. MDMS does not contain the backup and restore functionality of SLS. If you install MDMS over SLS, you lose the ability to restore data saved through SLS. To continue using SLS backup and restore functionality, you must upgrade your version of SLS. SLS includes the MDMS functionality. ______________________________________________________ Recommendation: Digital recommends that you perform a backup of your system disk before you install MDMS software. Refer to the VMS Backup Utility Manual for more details. Common Questions and Answers Before beginning the installation procedure, you may want to review the questions and answers in Table 1-1. Before Installing MDMS Software 1-1 Table_1-1__Installation_Questions_and_Answers______________ Q: How long will the installation procedure take? A: The installation procedure will take 15-30 minutes on a VAX system and 5-10 minutes on an Alpha system. Q: How can I get help? A: The VMSINSTAL utility provides additional information about the decisions required to respond to the installation prompts. To get help at any installation prompt, enter ? and press . Q: Where can I find an example of the installation procedure? A: Appendix A contains an example of an installation procedure for the server software. Appendix B contains an example of an installation procedure for the client software. Q: How can I abort the installation procedure? A: Enter .[1] [1]If_you_abort_the_VMSINSTAL_procedure,_you_must_restart__ the installation from the beginning. ___________________________________________________________ MDMS Client and Server Software Definitions Before installing MDMS, you need to decide whether to install MDMS server or client software: o You must install the MDMS server software on at least one node or VMScluster. o The server software provides the volume and magazine databases for itself and for use by MDMS clients. The node or VMScluster[TM] system on which you install the server software becomes the MDMS server node. o The client software enables you to use MDMS from nodes other than the MDMS server node. Before Installing MDMS Software Server Software The MDMS server software is installed on a node or VMScluster system and provides media management services for itself and for any MDMS client nodes connected to it. MDMS server software provides the MDMS volume and magazine databases. The volume database is a record management services (RMS) file that describes all removable storage media known to the MDMS software. It contains information about volume locations and volume pool access authorization. The server software updates the volume and magazine databases when any type of transactions are performed against the media. Requirement: To use MDMS, you must install at least one MDMS server in the network. Client Software The client software is installed on any node that can communicate with the MDMS server node or VMScluster. The MDMS client node can communicate using DECnet[TM] software with an MDMS server node. When an MDMS client node needs to perform an MDMS operation, the client node communicates with the server node until the operation has completed. The server node updates the volume and magazine databases, and the client node relinquishes its communications with the server node. MDMS client nodes may have their own tape drives and robotic devices. Device management is determined by the media type. The media type is defined in the file SYS$MANAGER:TAPESTART.COM on the MDMS server node. Requirement: Each MDMS client node must have a DECnet connection to an MDMS server node. Any number of MDMS client nodes may be connected to a single MDMS server node. Before Installing MDMS Software 1-3 Before Installing MDMS Table 1-2 identifies actions you need to take before installing the MDMS server software (that provides all MDMS functionality) or client software (that provides access to the MDMS server node or VMScluster). Table_1-2__Before_Installing_MDMS__________________________ Stage_Action_______________________________________________ 1 Verify required quotas and OpenVMS operating system classes: 1. Log in to the SYSTEM account. 2. Enable all privileges. 3. Verify that the required quotas and OpenVMS system classes are present (see Sections 1.3.1 and 1.3.2). 2 Make sure the system on which you intend to install MDMS meets hardware and software requirements ______(Sections_1.3.3_and_1.3.4).__________________________ Required Quotas If your SYSTEM account quotas are the same as or higher than the default values provided with the OpenVMS operating system, then these values should be sufficient to install MDMS software. More_information: Refer to the OpenVMS Upgrade and Installation Procedures manual for additional information about required quotas. Required OpenVMS Operating System Classes Verify that the following OpenVMS operating system classes are resident on the system disk: o Network support o Programming support o Secure user's environment o System programming environment Before Installing MDMS Software o Utilities o OpenVMS required save set How_to_verify: For information about verifying these classes, refer to the Guide to Setting Up an OpenVMS System. Hardware Requirements The following are the minimum hardware requirements for installing the MDMS software: o A VAX. MicroVAX[TM], VAXstation[TM], or Alpha system. o Four megabytes of memory for VAX, or 16 megabytes of memory for Alpha systems. o One or more tape devices or optical disks, for standalone systems. o One disk, such as a Digital RD-[TM] or RA-[TM] series disk. o Disk space. Use the steps in Table 1-3 to ensure there is enough disk space to install MDMS server or client software. Before Installing MDMS Software 1-5 Table_1-3__How_to_Check_Disk_Space_Requirements____________ Step__Action_______________________________________________ 1 Verify that there are enough free blocks on the disk where you are installing MDMS software. If you are providing remote device support, then you must install the Remote Device Facility (RDF) (by answering yes to the remote device question during the installation procedure) and this requires more free disk space. Enter the following command: $ SHOW DEVICE SYS$SYSDEVICE _____________________________________________________ IF you are in- stalling . . . ______________RDF__THEN_you_need_._._._______________ Server Yes 10,800 peak blocks during software installation 8,400 net blocks after installation (permanent) No 10,200 peak blocks during installation 7,800 net blocks after installation (permanent) Client Yes 10,800 peak blocks during software installation 8,400 net blocks after installation (permanent) No 10,200 peak blocks during installation 7,800 net blocks after ___________________installation_(permanent)__________ (continued on next page) Before Installing MDMS Software Table_1-3_(Cont.)__How_to_Check_Disk_Space_Requirements____ Step__Action_______________________________________________ 2 Make a note of the node and disk name where you are ______going_to_install_MDMS._______________________________ ________________________ Note ________________________ If your system is monitored by the Audit facility, then you must consider the system disk free block requirements. To determine this requirement, enter the following command: $ SHOW AUDIT/ALL ______________________________________________________ Software Requirements The following software is required to install either MDMS server or client software: o A compatible version of the OpenVMS operating system [1] o A compatible version of DECnet[TM] for OpenVMS[1] Server Software Requirements Before installing the server software, check to see that the DECnet software and the OpenVMS Queue Manager are running. If they are not running, follow the steps in Table 1-4 to start them. Table_1-4__How_to_Start_DECnet_and_OpenVMS_Queue_Manager___ Step__Action_______________________________________________ 1 Start the DECnet software. Enter the following command at the DCL prompt: $ @SYS$MANAGER:STARTNET (continued on next page) ____________________ [1] See the SLS SPD (29.67.14) for specific versions. Before Installing MDMS Software 1-7 Table 1-4 (Cont.) How to Start DECnet and OpenVMS Queue ___________________Manager_________________________________ Step__Action_______________________________________________ 2 Start the OpenVMS Queue Manager. Enter the following command at the DCL prompt: ______$_START/QUEUE/MANAGER________________________________ After installing the MDMS server software, see Chapter 3 to configure the MDMS server software. You must do this before installing the MDMS client software. Client Software Requirements Before installing the MDMS client software, you must install and configure the MDMS server software, and you must register the MDMS client node on the MDMS server node. See Table 3-2 for instructions to register the client nodes. Registering the client node allows the node to access the MDMS volume database. If you do not register the MDMS client node on the MDMS server node, the installation verification procedure (IVP) will fail. Optional Software The following software may need to be installed to provide additional specific functionality: o DCSC (Digital Cartridge Server Component)-If you have a StorageTek Automated Cartridge Server (ACS), you must install the DCSC software. o Remote Device Facility (RDF)-MDMS software provides optional installation of RDF software. During installation of the MDMS software, you will be asked if you want to access tape devices on a remote system or if you want to allow remote backups to tape devices on this system. RDF software will be installed automatically if you answer "yes" to either question. See Media and Device Management Services for OpenVMS Guide to Operations for detailed information about RDF. Before Installing MDMS Software License Registration To use the MDMS software, you must register and load the license for MDMS before you start the installation procedure. To register a license under OpenVMS, use the following procedure: 1. Log in to the system manager's account, SYSTEM. Select one of the following methods to perform the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. 2. If you plan to use ABS on more than one node in a OpenVMScluster, you must perform a license load on the other nodes after you complete this installation. 3. Register the MDMS license following the steps listed in Table 1-5. Before Installing MDMS Software 1-9 1-5 How to Register Your MDMS License______________________________________________________________ Action______________________________________________________________ Enter the LICENSE REGISTER command with the product name and a dash: $ LICENSE REGISTER SLS - ! Server software (Alpha System FLAT/VAX System WKGRP, DEPT, ENTER, FLAT) $ LICENSE REGISTER SLS-MGR - ! Server software (Alpha System WKGRP, DEPT, ENTER) $ LICENSE REGISTER SLS-REMOTE - ! Client software (Alpha System FLAT/VAX System WKGRP, DEPT, ENTER, FLAT) $ LICENSE REGISTER SLS-REMOTE-MGR - ! Client software (Alpha System WKGRP, DEPT, ENTER) $ LICENSE REGISTER SLS-ACS - ! Client with ACS support (Alpha System/VAX system FLAT) Important: Enter a dash at the end of each command in Steps 1 through 8. Enter the /ISSUER qualifier information, assigning the value DEC between quotation marks. _$ /ISSUER="DEC" - Enter the /AUTHORIZATION qualifier information, assigning it the value from the AUTHORIZATION NUMBER[1] entry of the PAK: _$ /AUTHORIZATION=xxxxxx - Enter the /PRODUCER qualifier information, assigning the value DEC in quotes: _$ /PRODUCER="DEC" - Enter the /UNITS qualifier information, assigning it the value from the UNITS[1] entry of the PAK _$ /UNITS=nn - ______________________________________________________________ information (continued on next page) Before Installing MDMS Software 1-5 (Cont.) How to Register Your MDMS License______________________________________________________________ Action______________________________________________________________ Enter the /DATE qualifiers information, assigning the product's release date value from the PRODUCT RELEASE DATE[1] entry of the PAK: _$ /DATE=dd-mmm-yyyy - Enter the /AVAILABILITY qualifier information, assigning the value from the AVAILABILITY TABLE CODE[1] entry of the PAK: _$ /AVAILABILITY=x - Enter the /OPTIONS qualifier information, assigning the value from the KEY OPTIONS[1] entry of the PAK: _$ /OPTIONS=xxxxxx - Enter the /CHECKSUM qualifier information, assigning the value from the CH[1] entry of the PAK: _$ /CHECKSUM=1-xxxx-xxxx-xxxx-xxxx Important: Do NOT end the entry with a dash. Invoke the LICENSE LOAD command with the product name: $ LICENSE LOAD SLS-MGR ______________________________________________________________ information ______________________________________________________________ For complete information about using LMF, see the VMS License Management Utility Manual. Before Installing MDMS Software 1-11 2 ______________________________________________________________ Installing MDMS Software This chapter contains instructions for installing the MDMS software, both server and client. For an example of the MDMS server installation, see Appendix A. For an example of the MDMS client installation, see Appendix B. Follow the steps in Table 2-1 to install MDMS Version 2.8A server or client software. Table_2-1__How_to_Install_the_MDMS_Server_or_Client_Software Step_Action________________________________________________ 1 Load and mount the media that contains the software kit. (continued on next page) Installing MDMS Software 2-1 Table 2-1 (Cont.) How to Install the MDMS Server or Client ___________________Software________________________________ Step_Action________________________________________________ 2 Invoke the VMSINSTAL procedure for the type of software that you are installing: o Server software-Enter the VMSINSTAL command in the following format: $@SYS$UPDATE:VMSINSTAL MDMSA028 location: OPTIONS N o Client software-Enter the VMSINSTAL command in the following format: $@SYS$UPDATE:VMSINSTAL MDMSCLIENTA028 location: OPTIONS N Where: o location is the tape device (or directory) that contains the software kit save set. o OPTIONS N is an optional parameter that displays or prints the release notes. The default behavior is to move the release notes to SYS$HELP. 3 If you see the following message: %VMSINSTAL-W- ACTIVE, The following processes are still active * Do you want to continue anyway [NO]? Enter Y and press , else go to step 4. 4 Confirm the state of the system backup. * Are you satisfied with the backup of your system disk [Yes]? Press . (continued on next page) Installing MDMS Software Table 2-1 (Cont.) How to Install the MDMS Server or Client ___________________Software________________________________ Step_Action________________________________________________ 5 If you did not include the location on the VMSINSTAL command line, identify the location for the software to be mounted. * Where will the distribution volumes be mounted: SLS$KITS: You may specify a tape drive, a local disk, or a remote disk. Enter the appropriate information and press . 6 Respond to the installation options: Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 * Enter installation options you wish to use (none): Enter the number of the desired option and press . (continued on next page) Installing MDMS Software 2-3 Table 2-1 (Cont.) How to Install the MDMS Server or Client ___________________Software________________________________ Step_Action________________________________________________ 7 Continue the installation. MDMS displays the following message: ***************************************************************** * WARNING * ***************************************************************** * MDMS should NOT be installed on a system which is currently running * * SLS. The MDMS installation will supersede the existing SLS * * installation. In this situation, there may be old SLS files not * * removed by the MDMS installation such as SLS$SYSBAK.EXE. This could* * lead to unpredictable and unsupported behavior if any SLS backups * * are attempted after the MDMS installation. * ************************************************************************* * Do you want to continue with this installation [No]? Enter Y and press . 8 Select to run the Installation Verification Procedure (IVP). * Do you want to run the IVP after the installation [YES]? Recommendation: Running the IVP procedure is recommended. Press to run the IVP, else enter No and press . (continued on next page) Installing MDMS Software Table 2-1 (Cont.) How to Install the MDMS Server or Client ___________________Software________________________________ Step_Action________________________________________________ 9 Client_software_only: You need to enter the name of the MDMS server node or VMScluster system alias name. * Are you ready to proceed? [YES]? * What is the name or VMScluster system alias of the MDMS/SLS server node: Enter the name or VMScluster system alias name of the MDMS server node. 10 RDF_(Remote_Device_Facility)_software: __________ Rebooting System Nodes __________ If you select to install RDF, you need to reboot your system after installation. Each Alpha server node and each Alpha client node must be rebooted because the device drivers cannot be reloaded on Alpha nodes. ___________________________________________ If you want to use the RDF software, then respond to the following queries: * Do you want to backup disks on this system to a drive on a remote system? Enter Yes to use RDF, else enter No. * Do you want to allow remote backups access to the tape drives on this system? Enter Yes to use RDF, else enter No. (continued on next page) Installing MDMS Software 2-5 Table 2-1 (Cont.) How to Install the MDMS Server or Client ___________________Software________________________________ Step_Action________________________________________________ 11 Specify the disk device name where MDMS software will reside. * Enter the name of the disk device the MDMS/SLS software will use [DUA0:]: Enter the name of the device you noted in Table 1-3 and press . 12 Enter the directory name where MDMS software will reside: * Enter the name of the directory the MDMS/SLS software will use [SLS$FILES]: Enter the directory name and press . 13 Identify the MDMS manager account UIC. If you see the following message: * Enter the UIC for the SLS manager account. [[1,21]] Press , else, go to Step 16. 14 Enter and verify the MDMS account password. Restriction: The password must be at least 15 and no more than 31 characters. * Password: * Verify password: (continued on next page) Installing MDMS Software Table 2-1 (Cont.) How to Install the MDMS Server or Client ___________________Software________________________________ Step_Action________________________________________________ 15 Set quotas and flags for the MDMS account. MDMS automatically sets quotas and flags for the account. (See Appendix D for detailed information about quotas.) * Do you wish to update these flags now [YES]? Press . Updating the MDMS process account quotas and the flags causes the Authorize utility to run. 16 At this point, the installation procedure continues without further operator intervention. Note the following important items about the MDMS installation procedure: o When you install MDMS on a new system (one on which there is no existing TAPESTART.COM file), the MDMS installation procedure generates a default configuration file that contains the media triplets for the known devices on your system. These media triplets are placed in your TAPESTART.COM file. For instructions about this file, media triplets, and configuring MDMS, see Media and Device Management Services for OpenVMS Guide to Operations. o If you chose to run the IVP at Step 8, it runs now. For a complete installation and IVP example, see Appendixes A and B. 17 If you installed the RDF system, you must reboot the _____node_to_install_the_new_deviced_drivers.______________ Installing MDMS Software 2-7 3 ______________________________________________________________ After Installing MDMS Software This chapter describes the tasks required after the MDMS installation procedure has finished. After installing the MDMS server or client software, you must prepare the software for use. Table 3-1 identifies the postinstallation activities you need to perform. Table_3-1__Postinstallation_Activities_____________________ Stage_Action_______________________________________________ 1 Register the MDMS client nodes on the MDMS server node (Section 3.1) 2 Verify the installation (Section 3.2) 3 Edit the systemwide command files (Section 3.3) 4_____Prepare_the_MDMS_server_software_(Section_3.4)_______ For information on configuring MDMS to work with particular media and devices, see Media and Device Management Services for OpenVMS Guide to Operations. Registering an MDMS Client Node After installing the MDMS server software and before installing the MDMS client software, you must register any MDMS client nodes on the MDMS server node. Follow the steps in Table 3-2 to register client nodes on the MDMS server node. After Installing MDMS Software 3-1 Table_3-2__How_to_Register_the_Client_Node_________________ Step_Action________________________________________________ 1 On the MDMS server node from the SYSTEM account, enter the following DCL command: $ RUN SLS$SYSTEM:SLS$SLSMGR Result: MDMS displays the Administrator Menu. 2 Select the Database Access Authorization option from the numeric keypad: Enter 3 and press . 3 Invoke the record insertion feature from the numeric keypad: Press keypad < 8 > or press the key. 4 Enter the name of the MDMS client node(s) in the Node field and press . Result: MDMS displays the list of MDMS client nodes with the new entry or entries. 5 Save the changes to the database: Enter Y and press _____._____________________________________________ Verifying the Installation The installation verification procedure (IVP) may be executed as part of the installation procedure by answering YES to the following question: * Do you want to run the IVP after the installation [YES]? Y If you did not execute the IVP during the installation procedure, you can execute it immediately after installing the MDMS software. Enter the following command at the DCL system prompt: $ @SYS$TEST:MDMS_SLS$IVP Requirements: o The MDMS software must be installed and running on the system where the IVP is executed. After Installing MDMS Software o When executing the IVP on an MDMS client node, the MDMS client node must have been registered on the MDMS server node (see Section 3.1). Editing the Systemwide Command Files To make sure MDMS functions properly, you need to edit the system startup procedure and the system login file. Making Sure MDMS Starts Up To make sure the MDMS software starts up each time the system is booted, edit one of the following system startup procedures: o SYS$MANAGER:SYSTARTUP_V5.COM o SYS$MANAGER:SYSTARTUP_VMS.COM for OpenVMS Version 6.0. Add the following line: $ @SYS$STARTUP:SLS$STARTUP Requirement: Include the startup line after the STARTNET command in the SYSTARTUP_x.COM file. After Installing MDMS Software 3-3 Defining Global Symbols for MDMS Users To define global symbols for MDMS software users, edit the system login file SYS$MANAGER:SYLOGIN.COM, and add the following line: $ @SYS$MANAGER:SLS$TAPSYMBOL Requirement: Include the symbol definitions in a section of the SYLOGIN.COM file that is executed by all accounts, typically before the BATCH command. Preparing MDMS Server Software If you have installed MDMS server software for the first time, you must: o Define a network object on your VMScluster system nodes o Customize the file SYS$MANAGER:TAPESTART.COM to meet your site-specific requirements o Enable user access to volume pools Defining a Network Object on a VMScluster System Follow the steps in Table 3-3 to define the SLS$DBX NCP object. Requirement: If you intend to implement the high-availability features of MDMS software, all nodes that participate in the VMScluster system alias must have the SLS$DBX NCP object defined. After Installing MDMS Software Table_3-3__How_to_Define_the_SLS$DBX_NCP_Object____________ Step_Action________________________________________________ 1 From an account with BYPASS privilege, on the node on which MDMS software was just installed, invoke the Network Control Program (NCP) utility by entering the following command: $ RUN SYS$SYSTEM:NCP 2 Obtain the password for the MDMS account: NCP> SHOW OBJECT SLS$DBX CHARACTERISTICS Result: Object Volatile Characteristics as of 2-DEC-1996 13:08:15 Object = SLS$DBX Number = 0 File id = SYS$SYSTEM:SLS$FIND_DB_NODE.EXE User id = SLS Password = password Note: The password is displayed only when the BYPASS privilege is enabled. 3 Exit the NCP utility: NCP> EXIT 4 Invoke the SYSMAN utility: $RUN SYS$SYSTEM:SYSMAN (continued on next page) After Installing MDMS Software 3-5 Table_3-3_(Cont.)__How_to_Define_the_SLS$DBX_NCP_Object____ Step_Action________________________________________________ 5 Set the SYSMAN environment to include the VMScluster system nodes that participate in the DECnet VMScluster system alias. Participating_nodes: The participating nodes in a VMScluster can be all of the nodes or only some of the nodes. To identify the participating nodes, use one of the following commands: o To identify all nodes in a VMScluster, enter the following SYSMAN command: SYSMAN> SET ENVIRONMENT /CLUSTER o To identify only specific nodes, enter the SYSMAN command in the following format: SYSMAN> SET ENVIRONMENT /NODE=(node_1,node_2,...node_n) 6 Define the SLS$DBX object by entering SYSMAN command in the following format: SYSMAN>DO MCR NCP DEFINE OBJECT SLS$DBX NUMBER 0 USER SLS - _SYSMAN> FILE SYS$SYSTEM:SLS$FIND_DB_NODE.EXE PASSWORD password Requirement: The password entered with this command must be the same as the password used for the MDMS account during installation. 7 Read the SLS$DBX object on the node: SYSMAN> DO MCR NCP SET KNOWN OBJECT ALL 8 Exit the SYSMAN utility: _____SYSMAN>_EXIT__________________________________________ After Installing MDMS Software Customizing TAPESTART.COM There are several things that you need to define in the file SYS$MANAGER:TAPESTART.COM to customize MDMS to meet your site-specific needs. See Media and Device Management Services for OpenVMS Guide to Operations, Chapter 4, for information about this file. Enabling User Access to Volume Pools In addtion to registering any MDMS client nodes on the MDMS server node, you need to authorize user access to volume pools. See Media and Device Management Services for OpenVMS Guide to Operations, Chapter 8, for instructions. After Installing MDMS Software 3-7 A ______________________________________________________________ MDMS Server Installation Example Log File The following example shows an installation of the MDMS server software on a VAX system running OpenVMS Version 7.0. This example also installs server-side support for RDF, asks you about viewing the release notes, and runs an IVP. SYSTEM to OpenVMS VAX version V7.0 on node NODE01 Last interactive login on Monday, 12-DEC-1996 13:43 Last non-interactive login on Monday, 12-DEC-1996 09:59 @sys$update:vmsinstal OpenVMS VAX Software Product Installation Procedure V7.0 It is 12-DEC-1996 at 15:04. Enter a question mark (?) at any time for help. you satisfied with the backup of your system disk [YES]? will the distribution volumes be mounted: sys$sysdevice:[mdmskits] the products to be processed from the first distribution volume set. MDMSA028 installation options you wish to use (none): following products will be processed: V2.8A Beginning installation of MDMS V2.8A at 15:05 Restoring product save set A ... Product's release notes have been moved to SYS$HELP. MDMS Server Installation Example Log File A-1 WARNING * * MDMS V2.8A (client and server) is not compatible with any previous * versions of MDMS prior to V2.5. All nodes running MDMS which interact* with each other should also be upgraded to V2.5 or above. * * you want to continue with this installation [No]? yes you want to run the IVP after the installation [YES]? Product: MDMS Producer: DEC Version: 2.8A Release Date: 8-JAN-1996 this product have an authorization key registered and loaded? yes you want to purge files replaced by this installation [YES]? MDMS provides support for remote backups. This function allows you to backup disks on this system to a tape drive located on some other system with MDMS installed, or to allow other systems to backup their disks to the tape drives on this system. you want to backup disks on this system to a drive on a remote system? yes Remote Device Facility Client support will be provided. you want to allow remote backups access to the tape drives on this system? UYES Remote Device Facility Server support will be provided. the name of the disk device the MDMS/SLS software will use [DSA1:]: the name of the directory the MDMS/SLS software will use [SLS$FILES]: to place summary files from system backups [SLS$ROOT:[SYSBAK.SUMMARY_FILES]]: to place intermediate history files [SLS$ROOT:[SYSBAK.TEMP_HISTORY]]: to place maintenance log files [SLS$ROOT:[DATA]]: to place system backup log files [SLS$ROOT:[SYSBAK.SYSBAK_LOGS]]: you have been using earlier versions of MDMS software, there be log files and summary files resident in SLS$SYSBAK from system backups. This installation procedure has the to automatically distribute these old files into the you have specified. you want to automatically move these old files? [Y]? MDMS Server Installation Example Log File order for the SLS software to perform system management tasks, privileged account called SLS is created. must specify a unique UIC for this account so that it not conflict with other accounts on your system. the identifier SLS already exists with UIC [1,20] procedure will assume the SLS account also exists. enter a password for the SLS account. The password you must contain at least 15 and no more than 31 characters and not refer to the account/product name, or your system or cluster name. characters include A through Z, 0 through 9, $ (dollar sign) and (underscore). with the DCL SET PASSWORD command, your input will not echo on the and you will be asked to verify the password. password: Updating account SLS with specified password This installation updates an ACCOUNT named SLS. user record(s) updated Updating account SLS for client network access This installation updates an ACCOUNT named SLS. user record(s) updated Updating account SLS privileges and login directory This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated The following quotas will be set for the SLS account: Maxjobs: 0 Fillm: 500 Bytlm: 128000 Maxacctjobs: 0 Shrfillm: 0 Pbytlm: 0 Maxdetach: 0 BIOlm: 128 JTquota: 1024 Prclm: 10 DIOlm: 4096 WSdef: 1024 Prio: 4 ASTlm: 4096 WSquo: 16384 Queprio: 4 TQElm: 32 WSextent: 16384 CPU: (none) Enqlm: 2500 Pgflquo: 100000 MDMS Server Installation Example Log File A-3 Updating quotas for account SLS... This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated you wish to update these flags now [YES]? The following fields will be set for the SLS account: /FLAGS= NoAudit DisMail NoDisReport DefCLI DisNewMail NoDisUser NoDisCtlY DisReconnect NoGenPwd /BATCH /NOINTERACTIVE /NOLOCAL /NODIALUP /NOREMOTE /NOEXPIRATION /PWDEXPIRED /NETWORK Updating flags for account SLS... This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated Checking for DISKQUOTAs on the SLS server device ... There will be no further questions asked. The installation of MDMS/SLS will take an average of 30 minutes more to complete. It may take longer if the log files and summary files from previous system backups are going to be automatically distributed into the system backup directories you have specified. MDMS Server Installation Example Log File Restoring product save set B ... Proceeding with saveset B Linking privileged shareable image Creating TAPESTART.COM Creating SLS subdirectories... This product creates system disk directory DSA1:[SLS$FILES]. This product creates system disk directory DSA1:[SLS$FILES.AUDIT]. This product creates system disk directory DSA1:[SLS$FILES.CUSTOM]. This product creates system disk directory DSA1:[SLS$FILES.DATA]. This product creates system disk directory DSA1:[SLS$FILES.HIST]. This product creates system disk directory DSA1:[SLS$FILES.PARAMS]. This product creates system disk directory DSA1:[SLS$FILES.PRIMAST]. This product creates system disk directory DSA1:[SLS$FILES.SYSBAK]. This product creates system disk directory DSA1:[SLS$FILES.SYSTEM]. This product creates system disk directory DSA1:[SLS$FILES.USRBAK]. This product creates system disk directory SLS$ROOT:[SYSBAK.SUMMARY_FILES]. This product creates system disk directory SLS$ROOT:[SYSBAK.TEMP_HISTORY]. This product creates system disk directory SLS$ROOT:[DATA]. SLS$ROOT:[DATA] already exists This product creates system disk directory SLS$ROOT:[SYSBAK.SYSBAK_LOGS]. Since a new TAPESTART.COM was created for this installation, a media triplet template file will be generated for you. This file will be created in SLS$DATAC and called SLS$AUTOCONFIGURE_MEDIA_TRIPLETS.TXT. This file should be included in TAPESTART.COM (see that file for appropriate location) and possibly modified to fit your needs. The devices in this file were found on this system. Generating media triplet template file Defining files that need to be moved Providing Remote Device Facility Support Restoring product save set C ... This product creates system disk directory SLS$ROOT:[TTI_RDEV]. Moving old log files and summary files as requested. Finished moving old log files and summary files. following post-installation steps are necessary. to the Installation Guide for details. MDMS Server Installation Example Log File A-5 Edit the system startup procedure to start the SLS software on this client. Add @SYS$STARTUP:SLS$STARTUP Edit the system wide login file. Add @SYS$MANAGER:SLS$TAPSYMBOL Run SLS$SYSTEM:SLS$SLSMGR.EXE to perform the following functions: Authorize access to the SLS server database for SLS client nodes. Authorize access to SLS pools for SLS users. Customize SYS$MANAGER:TAPESTART.COM to reflect SLS environment parameters. Check that SLS$DBX object is defined on all nodes participating in the VMScluster System alias. For Remote Device Facility client support, you should add one or more media-type triplets (MTYPE_x, DENS_x, DRIVES_x) to your TAPESTART.COM to describe the remote tape drives. Be sure to include the remote nodename in each drive name. For Remote Device Facility server support, you should check the file SLS$ROOT:[TTI_RDEV]CONFIG_TRMBNE.DAT to ensure that the tape devices you wish to serve are included in this RDF configuration file. This file will be created initially when SLS is started after this installation. Files will now be moved to their target directories... Starting SLS identification of created process is 20200247 Waiting for the SLS software to start MDMS Version 2.8A Installation Verification Procedure (IVP) verification begun at 12-DEC-1996 15:18:31.07 for correct version of VMS. for presence of DECnet. for SLS executable images. system-wide logical names. MDMS Server Installation Example Log File for SLS database files. for SLS client process. for SLS server process. for FMS executable images. for correct version of SLS. for subprocess SLS$IVP to complete. Media and Device Management System for OpenVMS, Version 2.8A a STORAGE ADD VOLUME. for subprocess SLS$IVP to complete. for subprocess SLS$IVP to complete. for subprocess SLS$IVP to complete. a STORAGE ALLOCATE. a STORAGE SHOW VOLUME. XYZZY9 Owner: CLSTR1::SLS BACKUP Brand: 12-DEC-1996 15:18 Scratch: 11-DEC-1997 15:18 12-DEC-1996 15:18 Cleaned: 12-DEC-1996 15:18 type: 9TRACK Length: 0 0 UIC: [SLS] HEADQUARTERS Protection: S:RW,O:RW,G:R,W: Onsite: Errors: 0 Flag: ALLOCATED volume: *none* Previous: *none* Rec len: 0 Block factor: 0 12-DEC-1996 15:18 Density: 6250 number: Other side: / slot: / is not in a jukebox. is not in a magazine. MDMS Server Installation Example Log File A-7 a STORAGE DEALLOCATE. a STORAGE REMOVE VOLUME. a STORAGE SHOW VOLUME; there should be no such volume. no such volume(s) * * All tests have completed sucessfully. * * * verification finished at 12-DEC-1996 15:19:06.85 Installation Verification of MDMS Version 2.8A of MDMS V2.8A completed at 15:19 the products to be processed from the next distribution volume set. procedure done at 15:19 MDMS Server Installation Example Log File B ______________________________________________________________ MDMS Client Installation Example Log File The following example shows an installation of the MDMS client software on a VAX system running OpenVMS Version 7.0. This example also installs support for the RDF client and does not run an IVP. SYSTEM Welcome to OpenVMS VAX version V7.0 on node NODE10 Last interactive login on Monday, 12-DEC-1996 13:43 Last non-interactive login on Monday, 12-DEC-1996 09:59 OpenVMS VAX Software Product Installation Procedure V6.2 It is 14-DEC-1996 at 13:37. Enter a question mark (?) at any time for help. you satisfied with the backup of your system disk [YES]? will the distribution volumes be mounted: sys$sysdevice:[mdmskits] the products to be processed from the first distribution volume set. MDMSCLIENTA028 installation options you wish to use (none): following products will be processed: MDMSCLIENT V2.8A Beginning installation of SLSCLIENT V2.8A at 13:38 Restoring product save set A ... Product's release notes have been moved to SYS$HELP. MDMS Client Installation Example Log File B-1 WARNING * * MDMS V2.8A (client and server) is not compatible with any previous * versions of MDMS prior to V2.5. All nodes running MDMS which interact* with each other should also be upgraded to V2.5 or above. * * you want to continue with this installation [No]? you want to run the IVP after the installation [YES]? Product: MDMSCLIENT Producer: DEC Version: 2.8A Release Date: 24-JUL-1996 this product have an authorization key registered and loaded? yes you want to purge files replaced by this installation [YES]? proceeding with the installation of the MDMS software, should have read the MDMS Installation Guide discussion about use of the MDMS server node or VMScluster System alias. will need the name of the MDMS server node or VMScluster alias. you ready to proceed [YES]? yes is the name or VMScluster System alias of the MDMS server node: CLSTR1 MDMS provides support for remote backups. This function allows you to backup disks on this system to a tape drive located on some other system with MDMS installed, or to allow other systems to backup their disks to the tape drives on this system. you want to backup disks on this system to a drive on a remote system? y Remote Device Facility Client support will be provided. you want to allow remote backups access to the tape drives on this system? y Remote Device Facility Server support will be provided. the name of the disk device the MDMS software will use [DSA0:]: the name of the directory the SLS software will use [SLS$FILES]: to place summary files from system backups [SLS$ROOT:[SYSBAK.SUMMARY_FILES]]: to place intermediate history files [SLS$ROOT:[SYSBAK.TEMP_HISTORY]]: to place maintenance log files [SLS$ROOT:[DATA]]: to place system backup log files [SLS$ROOT:[SYSBAK.SYSBAK_LOGS]]: MDMS Client Installation Example Log File you have been using earlier versions of MDMS software, there be log files and summary files resident in SLS$SYSBAK from system backups. This installation procedure has the to automatically distribute these old files into the you have specified. you want to automatically move these old files? [Y]? order for the SLS software to perform system management tasks, privileged account called SLS is created. must specify a unique UIC for this account so that it not conflict with other accounts on your system. the identifier SLS already exists with UIC [1,20] procedure will assume the SLS account also exists. enter a password for the SLS account. The password you must contain at least 15 and no more than 31 characters and not refer to the account/product name, or your system or cluster name. characters include A through Z, 0 through 9, $ (dollar sign) and (underscore). with the DCL SET PASSWORD command, your input will not echo on the and you will be asked to verify the password. password: Updating account SLS with specified password This installation updates an ACCOUNT named SLS. user record(s) updated Updating account SLS privileges and login directory This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated SLS account is used to establish quotas for the processes which Backups are run. The quota values should be updated in with the recommendations set forth in the `VMS Backup Reference Manual'. If you wish, this installation will automatically update these quotas now. you wish to update these quotas now [YES]? MDMS Client Installation Example Log File B-3 The following quotas will be set for the SLS account: Maxjobs: 0 Fillm: 500 Bytlm: 128000 Maxacctjobs: 0 Shrfillm: 0 Pbytlm: 0 Maxdetach: 0 BIOlm: 128 JTquota: 1024 Prclm: 10 DIOlm: 4096 WSdef: 1024 Prio: 4 ASTlm: 4096 WSquo: 16384 Queprio: 4 TQElm: 32 WSextent: 16384 CPU: (none) Enqlm: 2500 Pgflquo: 100000 Updating quotas for account SLS... This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated recommends that the SLS account be used only by the software and not as an interactive account. It is that the Storage Administrator and Operators use accounts to perform SLS functions. If you wish, this procedure will automatically set the appropriate to disallow interactive access to this account. you wish to update these flags now [YES]? The following fields will be set for the SLS account: /FLAGS= NoAudit DisMail NoDisReport DefCLI DisNewMail NoDisUser NoDisCtlY DisReconnect NoGenPwd /BATCH /NOINTERACTIVE /NOLOCAL /NODIALUP /NOREMOTE /NOEXPIRATION /PWDEXPIRED /NONETWORK Updating flags for account SLS... This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated This installation updates an ACCOUNT named SLS. user record(s) updated Checking for DISKQUOTAs on the SLS device ... MDMS Client Installation Example Log File will be no further questions asked. The installation of will take an average of 30 minutes more to It may take longer if the log files and files from previous system backups are going to be distributed into the system backup directories have specified. Restoring product save set B ... Proceeding with saveset B Linking privileged shareable image Creating TAPESTART.COM Creating SLS subdirectories... This product creates system disk directory DSA0:[SLS$FILES]. This product creates system disk directory DSA0:[SLS$FILES.AUDIT]. This product creates system disk directory DSA0:[SLS$FILES.CUSTOM]. This product creates system disk directory DSA0:[SLS$FILES.DATA]. This product creates system disk directory DSA0:[SLS$FILES.HIST]. This product creates system disk directory DSA0:[SLS$FILES.PARAMS]. This product creates system disk directory DSA0:[SLS$FILES.SYSBAK]. This product creates system disk directory DSA0:[SLS$FILES.SYSTEM]. This product creates system disk directory DSA0:[SLS$FILES.USRBAK]. This product creates system disk directory SLS$ROOT:[SYSBAK.SUMMARY_FILES]. This product creates system disk directory SLS$ROOT:[SYSBAK.TEMP_HISTORY]. This product creates system disk directory SLS$ROOT:[DATA]. SLS$ROOT:[DATA] already exists This product creates system disk directory SLS$ROOT:[SYSBAK.SYSBAK_LOGS]. Since a new TAPESTART.COM was created for this installation, a media triplet template file will be generated for you. This file will be created in SLS$DATAC and called SLS$AUTOCONFIGURE_MEDIA_TRIPLETS.TXT. This file should be included in TAPESTART.COM (see that file for appropriate location) and possibly modified to fit your needs. The devices in this file were found on this system. Generating media triplet template file Defining files that need to be moved Providing Remote Device Facility Support Restoring product save set C ... This product creates system disk directory SLS$ROOT:[TTI_RDEV]. Moving old log files and summary files as requested. Finished moving old log files and summary files. MDMS Client Installation Example Log File B-5 following post-installation steps are necessary. to the Installation Guide for details. Edit the system startup procedure to start the SLS software on this client. Add @SYS$STARTUP:SLS$STARTUP Edit the system wide login file. Add @SYS$MANAGER:SLS$TAPSYMBOL Customize SYS$MANAGER:TAPESTART.COM to reflect SLS environment parameters. For Remote Device Facility client support, you should add one or more media-type triplets (MTYPE_x, DENS_x, DRIVES_x) to your TAPESTART.COM to describe the remote tape drives. Be sure to include the remote nodename in each drive name. For Remote Device Facility server support, you should check the file SLS$ROOT:[TTI_RDEV]CONFIG_SNRDRM.DAT to ensure that the tape devices you wish to serve are included in this RDF configuration file. This file will be created initially when SLS is started after this installation. Files will now be moved to their target directories... Starting MDMS identification of created process is 20400738 Waiting for the MDMS software to start MDMS Version 2.8A Installation Verification Procedure (IVP) verification begun at 14-DEC-1996 13:58:44.77 for correct version of VMS. for presence of DECnet. for SLS executable images. system-wide logical names. for SLS client process. for FMS executable images. MDMS Client Installation Example Log File for correct version of SLS. for subprocess SLS$IVP to complete. Media and Device Management System for OpenVMS, Version 2.8A a STORAGE ADD VOLUME. for subprocess SLS$IVP to complete. for subprocess SLS$IVP to complete. for subprocess SLS$IVP to complete. a STORAGE ALLOCATE. a STORAGE SHOW VOLUME. XYZZY9 Owner: CLSTR1::SLS BACKUP Brand: 12-DEC-1996 15:18 Scratch: 11-DEC-1997 15:18 12-DEC-1996 15:18 Cleaned: 12-DEC-1996 15:18 type: 9TRACK Length: 0 0 UIC: [SLS] HEADQUARTERS Protection: S:RW,O:RW,G:R,W: Onsite: Errors: 0 Flag: ALLOCATED volume: *none* Previous: *none* Rec len: 0 Block factor: 0 12-DEC-1996 15:18 Density: 6250 number: Other side: / slot: / is not in a jukebox. is not in a magazine. a STORAGE DEALLOCATE. a STORAGE REMOVE VOLUME. a STORAGE SHOW VOLUME; there should be no such volume. no such volume(s) * * All tests have completed sucessfully. * * * MDMS Client Installation Example Log File B-7 of MDMSCLIENT V2.8A completed at 13:59 MDMS Client Installation Example Log File C ______________________________________________________________ Files and Logical Names Files The MDMS installation procedure creates a number of files on your system and defines logical names: o Table C-1 lists and describes the files installed on server and client nodes. File names with an asterisk (*) preceding them are installed only on server nodes. o Table C-2 lists logical name table entries. C-1 Files Installed______________________________________________________________ Name Description______________________________________________________________ directory______________________________________________________________ MDMS shareable image; contains application interface routines for history file access ______________________________________________________________ directory______________________________________________________________ Normal user login symbol definitions ______________________________________________________________ directory______________________________________________________________ Contains text of MDMS messages (continued on next page) Files and Logical Names C-1 C-1 (Cont.) Files Installed______________________________________________________________ ______________________________________________________________ directory______________________________________________________________ Verifies the MDMS database node Startup command file ______________________________________________________________ directory______________________________________________________________ Installation verification procedure ______________________________________________________________ directory______________________________________________________________ Pool authorization file definition ______________________________________________________________ directory______________________________________________________________ Slot master file definition FDL for TAPEMAST.DAT ______________________________________________________________ directory______________________________________________________________ Accesses LNM$SLS logical name table Announces processing location Allocated Tapes report definition file Allocation Order report definition file Early morning cleanup batch job Cleanable tapes report definition file Coming onsite report definition file Creates a symbol definition file (in [.DATA]) Creates a SYSBAK history FILES file Installs DATATRIEVE information (continued on next page) Files and Logical Names C-1 (Cont.) Files Installed______________________________________________________________ Name Description______________________________________________________________ directory______________________________________________________________ Prints a list of down tapes control file Defines a LNM$SLS_VALUE logical name Finds a file in SYS$SYSTEM Free tapes report definition file Going offsite report definition file Operator initialize tapes utility MDMS system bootstrap loader SLS manager account login file Procedure to run MAIL_ADVANCE Displays scratchable tape Master report batch job Master report template definition file Operator login symbol definitions Template file for printed labels Template file for printed labels Quantity report batch job System startup command file Releases several tapes that are in transition RMS definition file to convert a system history file to a sequential file Sets up onsite and offsite dates Screens for SLSMGR.EXE Utility to abort a process (continued on next page) Files and Logical Names C-3 C-1 (Cont.) Files Installed______________________________________________________________ Name Description______________________________________________________________ directory______________________________________________________________ Searches system to create system- specific default media triplets on new MDMS systems to use in TAPESTART.COM Checks tape drives for data compaction capability Accounting period data collector Creates the LNM$JOB table with W:RE protection (continued on next page) Files and Logical Names C-1 (Cont.) Files Installed______________________________________________________________ Name Description______________________________________________________________ directory______________________________________________________________ Creates a permanent mailbox for DCL use Operator Export Volume function for the ACS Operator Import Volume function for the ACS Operator Initialize Volume Series function for the ACS Operator Inventory Range of Volumes function for the ACS Operator Load Volume Onto Drive function for the ACS Operator SLS-ACS Management Menu Operator Unload Drive function for the ACS Operator Unload Volume function for the ACS Executable to release a drive allocated to DCSC Deallocates a local or remote tape device Deletes a permanent mailbox that CREMBX made Executes a FORCEX system service call Reads from a permanent mailbox from DCL Gets information from SYSUAF.DAT DCL STORAGE command help file IBM [TM] nonlabeled tape reading utility (continued on next page) Files and Logical Names C-5 C-1 (Cont.) Files Installed______________________________________________________________ Name Description______________________________________________________________ directory______________________________________________________________ IBM [TM] nonlabeled tape writing utility For SLS-ACS support, determines whether DCSC (Digital Cartridge Server Component) software accesses a device Finds tapes that need to have advance mail sent Maintenance screen executable Master report executable Image for SLS$OPCOM process; sends and receives remote OPCOM messages and device control requests Writes to a permanent mailbox from DCL Quantity report executable Command procedure to determine version of RMU software DCL request that can define a symbol Sets process username Shuts down MDMS software SLS manager's authorization menu Prints a slot report Starts SLS$OPCOM process DCL STORAGE command definition DCL TAPE command executable Command procedure to initialize a volume series in a jukebox Purges scratchable tape's executable Generate tape usage report executable DB manager executable (continued on next page) Files and Logical Names C-1 (Cont.) Files Installed______________________________________________________________ Name Description______________________________________________________________ directory______________________________________________________________ RQ manager executable Moves volumes to vault Vault profile report executable Command procedure to verify your OpenVMS software version against the versions of BACKUPCMD.CLD and VMSBUXX.EXE; you use this procedure if you upgrade OpenVMS after you have installed MDMS Maintenance program for volumes in StorageTek ACS robots File library for MDMS Allocates tapes for a standalone backup MDMS startup command file Used in label printing Help file for TUSERMENU.COM Purges scratchable tape's subprocess Purges scratchable tape's mail message Tapes offsite report definition file Generates tape usage report batch job DB manager shutdown command file DB manager startup command file DB manager detached process command file RQ manager startup command file RQ manager detached process command file Starts TAPMGRDB and TAPMGRRQ command files (continued on next page) Files and Logical Names C-7 C-1 (Cont.) Files Installed______________________________________________________________ Name Description______________________________________________________________ directory______________________________________________________________ Utility manager detached process command file Free tape utility processor Midnight utility processor TOPER menu command file Defines volume report for volumes in transition Another user menu Sets location of volumes in or out of vault Vault menu command file Onsite and offsite dates for SET_ VAULT_DATES Vault profile report batch job______________________________________________________________ Logical Names Table C-2 lists the logical names entered into the logical name tables LNM$SYSTEM_TABLE and LNM$SLS$TABLE when MDMS software is installed. These names are defined by the product's startup file. They are automatically entered into these logical name tables whenever the system reboots or whenever the software is invoked. The LNM$JOB table also contains logical names that are defined when a user logs in to a system running MDMS software. Files and Logical Names C-2 Logical Name Table Entries______________________________________________________________ Name Definition and Description______________________________________________________________ ______________________________________________________________ SLS$ROOT:[CUSTOM] This directory contains customized MDMS files for your site. SLS$ROOT:[DATA.nodename] This directory stores all the log files for your current MDMS system. SLS$ROOT:[DATA] This is the top level directory for log file storage. filespec or _NL: or device: This logical points to the current label file or printer where labels are printed. fullfilespec This logical points to the current label file template. mbx_id The mailbox used for communication to the SLS$TAPMGRRQ process. SLS$ROOT:[PRIMAST] This directory points to the node's database, whether this is your current node or a node remote to you. SLS$ROOT:[PARAMS] This directory contains the system dependent parameter files for MDMS software. device:[SLS$FILES.] (continued on next page) Files and Logical Names C-9 C-2 (Cont.) Logical Name Table Entries______________________________________________________________ Name Definition and Description______________________________________________________________ ______________________________________________________________ This directory points to the top level directory for MDMS files. REBOOT Used internally during startup. SLS$ROOT:[CUSTOM] SLS$ROOT:[SYSTEM] This directory contains all the files for running MDMS software. DPS The location for volumes sent offsite. ______________________________________________________________ Entries______________________________________________________________ nodename Name of node where primary volume database resides. nodename Name of node(s) defined as MDMS server nodes. This logical only appears on MDMS client nodes. ? Defined as a "?". proc_id Points to the process ID of the database manager process. This logical only appears on MDMS serveer nodes. proc_id Points to the process ID of the request manager process.______________________________________________________________ More logical names for MDMS software can be found in the logical name table LNM$SLS$VALUES. These logicals are defined whenever TAPESTART.COM executes. Sample output Files and Logical Names from the DCL command SHOW LOGICAL/TABLE=LNM$SLS$VALUES is shown in Example C-1. Example C-1 Sample List of LNM$SLS$VALUES Entries $ SHOW LOGICAL/TABLE=LNM$SLS$VALUES (LNM$SLS$VALUES) "BACKUP_DEFAULT_REEL" = " " "DEFAULT_ALLDEV" = " " "DEFAULT_ALLOCSCRATCH" = "365 0:0:0" "DEFAULT_ALLOCSIZE" = "2400" "DEFAULT_ALLTIM" = "0 0:0:30" "DEFAULT_BACKUPSCRATCH" = "365 0:0:0" "DEFAULT_BACKUPSIZE" = "0" "DEFAULT_BAKFMT" = "BACKUP" "DEFAULT_BAKOPT" = "DUMMY" "DEFAULT_BAKUIC" = "0" "DEFAULT_BATCHQUEUE" = "SLS$ILDUCE" "DEFAULT_DCSC_DRIVES" = " " "DEFAULT_DCSC_EXPORT_MTYPE" = "DCSC_EXPORT_MTYPE" "DEFAULT_DENS_1" = "6250" "DEFAULT_DENS_10" = " " "DEFAULT_DENS_11" = " " "DEFAULT_DENS_12" = " " "DEFAULT_DENS_13" = " " "DEFAULT_DENS_14" = " " "DEFAULT_DENS_15" = " " "DEFAULT_DENS_16" = " " "DEFAULT_DENS_17" = " " "DEFAULT_DENS_18" = " " "DEFAULT_DENS_19" = " " "DEFAULT_DENS_2" = " " "DEFAULT_DENS_20" = " " (continued on next page) Files and Logical Names C-11 Example C-1 (Cont.) Sample List of LNM$SLS$VALUES Entries "DEFAULT_DENS_21" = " " "DEFAULT_DENS_22" = " " "DEFAULT_DENS_23" = " " "DEFAULT_DENS_24" = " " "DEFAULT_DENS_25" = " " "DEFAULT_DENS_26" = " " "DEFAULT_DENS_27" = " " "DEFAULT_DENS_28" = " " "DEFAULT_DENS_29" = " " "DEFAULT_DENS_3" = " " "DEFAULT_DENS_30" = " " "DEFAULT_DENS_31" = " " "DEFAULT_DENS_32" = " " "DEFAULT_DENS_4" = " " "DEFAULT_DENS_5" = " " "DEFAULT_DENS_6" = " " "DEFAULT_DENS_7" = " " "DEFAULT_DENS_8" = " " "DEFAULT_DENS_9" = " " "DEFAULT_DRIVES_1" = " " "DEFAULT_DRIVES_10" = " " "DEFAULT_DRIVES_11" = " " "DEFAULT_DRIVES_12" = " " "DEFAULT_DRIVES_13" = " " "DEFAULT_DRIVES_14" = " " "DEFAULT_DRIVES_15" = " " "DEFAULT_DRIVES_16" = " " "DEFAULT_DRIVES_17" = " " "DEFAULT_DRIVES_18" = " " "DEFAULT_DRIVES_19" = " " (continued on next page) Files and Logical Names Example C-1 (Cont.) Sample List of LNM$SLS$VALUES Entries "DEFAULT_DRIVES_2" = " " "DEFAULT_DRIVES_20" = " " "DEFAULT_DRIVES_21" = " " "DEFAULT_DRIVES_22" = " " "DEFAULT_DRIVES_23" = " " "DEFAULT_DRIVES_24" = " " "DEFAULT_DRIVES_25" = " " "DEFAULT_DRIVES_26" = " " "DEFAULT_DRIVES_27" = " " "DEFAULT_DRIVES_28" = " " "DEFAULT_DRIVES_29" = " " "DEFAULT_DRIVES_3" = " " "DEFAULT_DRIVES_30" = " " "DEFAULT_DRIVES_31" = " " "DEFAULT_DRIVES_32" = " " "DEFAULT_DRIVES_4" = " " "DEFAULT_DRIVES_5" = " " "DEFAULT_DRIVES_6" = " " "DEFAULT_DRIVES_7" = " " "DEFAULT_DRIVES_8" = " " "DEFAULT_DRIVES_9" = " " "DEFAULT_FRESTA" = "2" "DEFAULT_MAXSCRATCH" = "31-DEC-9999 23:59:59.99" "DEFAULT_MTYPE_1" = "9TRACK" "DEFAULT_MTYPE_10" = " " "DEFAULT_MTYPE_11" = " " "DEFAULT_MTYPE_12" = " " "DEFAULT_MTYPE_13" = " " "DEFAULT_MTYPE_14" = " " "DEFAULT_MTYPE_15" = " " (continued on next page) Files and Logical Names C-13 Example C-1 (Cont.) Sample List of LNM$SLS$VALUES Entries "DEFAULT_MTYPE_16" = " " "DEFAULT_MTYPE_17" = " " "DEFAULT_MTYPE_18" = " " "DEFAULT_MTYPE_19" = " " "DEFAULT_MTYPE_2" = " " "DEFAULT_MTYPE_20" = " " "DEFAULT_MTYPE_21" = " " "DEFAULT_MTYPE_22" = " " "DEFAULT_MTYPE_23" = " " "DEFAULT_MTYPE_24" = " " "DEFAULT_MTYPE_25" = " " "DEFAULT_MTYPE_26" = " " "DEFAULT_MTYPE_27" = " " "DEFAULT_MTYPE_28" = " " "DEFAULT_MTYPE_29" = " " "DEFAULT_MTYPE_3" = " " "DEFAULT_MTYPE_30" = " " "DEFAULT_MTYPE_31" = " " "DEFAULT_MTYPE_32" = " " "DEFAULT_MTYPE_4" = " " "DEFAULT_MTYPE_5" = " " "DEFAULT_MTYPE_6" = " " "DEFAULT_MTYPE_7" = " " "DEFAULT_MTYPE_8" = " " "DEFAULT_MTYPE_9" = " " "DEFAULT_PROTECTION" = "307" "DEFAULT_RESOPT" = "DUMMY" "DEFAULT_SELDEV" = " " "DEFAULT_USRRSS" = "128" "DEFAULT_VERBOSE" = "0" (continued on next page) Files and Logical Names Example C-1 (Cont.) Sample List of LNM$SLS$VALUES Entries "ESC_ALLOC_BOLD" = ". .[1m" "ESC_ALLOC_NORM" = ". .[m" "ESC_LOAD_BLNK" = ".[5m.[7w" "ESC_LOAD_BOLD" = ".[1m.[7w" "ESC_LOAD_NORM" = ".[m.[w" "ESC_MOUNT_BOLD" = ". .[1m" "ESC_MOUNT_NORM" = ". .[m" "ESC_MOUNT_OPER" = "...[1m.#6 OPERATOR:" "LOCATION" = "HEADQUARTERS" "MGRPRI" = "8" "NET_REQUEST_TIMEOUT" = "120" "NODENAME" = "ILDUCE" "PRIV_CLEAN" = "OPER" "PRIV_LABEL" = "OPER" "PRIV_MAXSCR" = "OPER" "PRIV_MODANY" = "OPER" "PRIV_MODOWN" = "TMPMBX" "PRIV_SEEANY" = "OPER" "PRIV_V_CLEAN" = "18" "PRIV_V_LABEL" = "18" "PRIV_V_MAXSCR" = "18" "PRIV_V_MODANY" = "18" "PRIV_V_MODOWN" = "15" "PRIV_V_SEEANY" = "18" "QUICKLOAD" = "0" "QUICKLOAD_RETRIES" = "80" "REMOTE_RETRIES" = "5" "TAPEPURGE_MAIL" = "SYSTEM " "TAPEPURGE_WORK" = "MAIL " "TOPERMASK" = "1024" "TOPERSTRING" = "TAPES" "TRANS_AGE" = "14 0:0:0" "USERBACK_FIRSTLINE" = "$!" "USERNAME" = "SLS" "VERSION" = "T25" "VMSV5" = "1" "XREQ_LEN" = "241" "XREQ_REPL_LEN" = "232" Files and Logical Names C-15 D ______________________________________________________________ MDMS Account User Authorization Data Authorization Data Table D-1 lists AUTHORIZE qualifiers used to update the MDMS account with values recommended for the MDMS software. They are also used when the account is being created. Table_D-1__MDMS_Account_User_Authorization_Data____________ Authorization field and_value_____________Description__________________________ /MAXJOBS=0 Maximum number of interactive, batch, and detached processes that can be active at one time with this user name is unlimited. /MAXACCTJOBS=0 Maximum number of interactive, batch, and detached processes on the same account that can be active at one time is unlimited. /MAXDETACH=0 Maximum number of detached processes with this user name that may be active at one time is unlimited. /PRCLM=10 Total number of subprocesses that may be active at one time. /PRIORITY=4 Default base priority. /QUEPRIO=4 Default queue priority. /CPU=(none) Maximum amount of CPU time is unlimited. (continued on next page) MDMS Account User Authorization Data D-1 Table_D-1_(Cont.)__MDMS_Account_User_Authorization_Data____ Authorization field and_value_____________Description__________________________ /FILLM=500 Total number of files and network logical links that may be active at one time. /SHRFILLM=0 Maximum number of shared files that may be open at one time is unlimited. /BIOLM=128 Maximum number of buffered I/O operations that may be active at one time. /DIOLM=4096 Maximum number of direct I/O operations that may be active at one time. /ASTLM=4096 Maximum number of pending AST requests that may be queued for the user 0. /ENQLM=1000 Total number of lock requests that may be outstanding at the same time. /BYTLM=128000 Total number of bytes that may be specified for a buffered I/O operation. /PBYTLM=0 Paged pool byte count limit (unlimited). /JTQUOTA=1024 Byte count quota of the job-wide logical name table. /WSDEF=1024 Initial limit of a working set for the user process. /WSQUO=16384 Maximum to which the user's process may raise the working set limit when system memory is in demand. /WSEXTENT=16384 Maximum to which the user's process may raise its working set limit when there is free memory available. (continued on next page) MDMS Account User Authorization Data Table_D-1_(Cont.)__MDMS_Account_User_Authorization_Data____ Authorization field and_value_____________Description__________________________ /PGFLQUO=100000 Total pages that this process can use in the system paging file. /BATCH Allows unrestricted access hours for batch jobs for this user name. /NOINTER Disallows interactive logins for this user name. /NOLOCAL Disallows interactive logins for this user name through a local terminal. /NODIAL Disallows interactive logins for this user name through dialup terminals. /NOREM Disallows interactive logins for this user name through network remote terminals. /NOEXPIRATION Account is not expired. /PWDEXPIRED Password is expired. (continued on next page) MDMS Account User Authorization Data D-3 Table_D-1_(Cont.)__MDMS_Account_User_Authorization_Data____ Authorization field and_value_____________Description__________________________ /FLAGS= NODISUSER-Does not disable account completely. NOAUDIT-Does not audit all security relevant actions. DEFCLI-Prevents user from changing default CLI or CLI tables. NODISCTLY-Allows Ctrl/Y interrupts. DISMAIL-Prevents mail delivery to this user. DISNEWMAIL-Suppresses "New Mail..." announcements. DISRECONNECT-Disables automated reconnections. NODISREPORT-Disables time of last login and other security reports. NOGENPWD-Does not require user to use generated passwords. Note: These should be enclosed in parentheses and, if more than one is specified, separated by commas. /UIC= UIC as specified by the installer. /OWNER="SLS_MANAGER"__Name_of_the_account_owner.___________ MDMS Account User Authorization Data