DSM for OpenVMS Version 7.2 January 1999 Dear DSM for OpenVMS Customer : Enclosed is your DSM for OpenVMS kit. Version 7.2 of DSM for Open- VMS is compatible with DSM applications written under previous versions of DSM for OpenVMS. Information on DSM maintenance releases is available on the In- terSystems Web site. We strongly recommend that you visit the Web site (http://www.intersys.com/dsm7) for the latest kits and information. ___________________________________________________________________ You_need_to_be_using...______To_install_and_run..._________________ OpenVMS VAX Versions 6.2, 7.2 of DSM for OpenVMS VAX 7.0, or 7.1 OpenVMS Alpha Versions 6.2, 7.2 of DSM for OpenVMS Alpha 7.0,_or_7.1________________________________________________________ You should keep the following points in mind: o Because of certain internal changes, you will need to recompile all of your DSM routines after you upgrade to DSM 7.2 from any previous DSM release (including 7.0.x and 7.1.x). o InterSystems changed the licensing procedure for DSM 7.x to conform with other InterSystems products. Read the sections about licensing in Chapter 2 of the DSM for OpenVMS Release Notes for more information about how to install or edit your license(s). If you are using a clustered environment, be sure to see the notes regarding clusters. You will need to obtain a license from InterSystems Corpo- ration in order to run DSM 7.x in a production environment. InterSystems may be contacted at InterSystems Corporation Order Processing Group One Memorial Drive Cambridge MA 02142 United States Tel. (617)577-3600 Fax:(617)494-1631 This document describes the distribution kits for the following software: o Version 7.2 of DSM for OpenVMS VAX[TM] o Version 7.2 of DSM for OpenVMS Alpha[TM] Distribution DSM is distributed by both InterSystems Corporation and Digi- tal Equipment Corporation. InterSystems distributes DSM software on the following media for both DSM for OpenVMS VAX and DSM for OpenVMS Alpha: o 9-track magnetic tape o TLZ06[TM] o TK50[TM] tape cartridge Digital Equipment Corporation distributes DSM software on the following media: o DSM for OpenVMS VAX: - 9-track magnetic tape - TLZ06[TM] - TK50[TM] tape cartridge - CD-ROM o DSM for OpenVMS Alpha: - CD-ROM Installation Information If you are installing DSM software for the first time, read Chap- ter 1 of the DSM for OpenVMS Installation and Management Guide . This chapter describes the installation procedure in detail. If you are upgrading from a previous release of DSM, you must upgrade your existing configurations and volume sets. After you complete your software installation, the upgrade procedure loads Version 7.2 manager utilities and globals. A copy of the DSM for OpenVMS Release Notes is distributed in printed form and on line as a file with the DSM distribution kit. You can obtain a copy of these release notes when you install DSM by using the "OPTIONS N" parameter with the VMSINSTAL procedure. For example: $ @SYS$UPDATE:VMSINSTAL DSM DSMVAX072 OPTIONS N or $ @SYS$UPDATE:VMSINSTAL DSM DSMAXP072 OPTIONS N The release notes can be obtained in SYS$HELP during the DSM in- stallation or extracted from the .B saveset. Thank you for purchasing DSM for OpenVMS. The DSM Product Group 2 © InterSystems Corporation. 1999 3 Attachment A - Installing the DSM Version 7.2 Kit The following sections contain information about installing the DSM kit. Installing DSM for the First Time If you are installing DSM software for the first time, read Chap- ter 1 of the DSM for OpenVMS Installation and Management Guide . That chapter describes the installation procedure in detail. Take the following steps to install the DSM Version 7.2 kit: 1. Back up your system. 2. Install the kit. Run the SYS$UPDATE:VMSINSTAL procedure. On an OpenVMS VAX system, specify DSMVAX072 as the product name. On an OpenVMS Alpha system, specify DSMAXP072 as the product name. 3. If you do not run the IVP during VMSINSTAL, install the DSM for OpenVMS images as shared using the SYS$STARTUP:DSM$INSTALL.COM procedure. Post-Installation Activities: After Installing, take the following steps: 1. Use the SYS$MANAGER:DSM$INIT.COM procedure to create a DSM for OpenVMS environment manager's account. 2. Edit the OpenVMS system files to provide for automatic startup and shutdown of DSM for OpenVMS configurations when your system is rebooted. 3. Log in to the DSM for OpenVMS environment manager's account and run the SYS$MANAGER:DSM$CONFIGURE.COM procedure to initialize DSM for OpenVMS database volume sets and configurations. Upgrading From a Previous Version of DSM If you are upgrading from a previous release of DSM you must up- grade your existing configurations and volume sets. Read the DSM for OpenVMS Release Notes in addition to the following informa- tion. Take the following steps to upgrade from a previous version of DSM to DSM for OpenVMS Version 7.2: 1. Shut down all running DSM for OpenVMS configurations. 2. Back up your system. 3. Install the kit. Run the SYS$UPDATE:VMSINSTAL procedure. On an OpenVMS VAX system, specify DSMVAX072 as the product name. On an OpenVMS Alpha system, specify DSMAXP072 as the product name. 4 4. If you do not run the IVP during VMSINSTAL, install the DSM for OpenVMS images as shared using the SYS$STARTUP:DSM$INSTALL.COM procedure. Post-Installation Activities: 1. Use the SYS$MANAGER:DSM$INIT.COM procedure from a privileged OpenVMS system account to upgrade DSM for OpenVMS manager accounts to DSM for OpenVMS Version 7.2 environment manager accounts. 2. If you have user-written external routine packages, upgrade the external call package table image to include those packages. 3. Log in to the DSM for OpenVMS environment manager's account and run the SYS$MANAGER:DSM$UPGRADE.COM procedure. You must recompile your application routines when upgrading from any previous DSM re- lease. DSM$UPGRADE optionally reinitializes before-image and after-image journal files and optionally upgrades mapped rou- tine sets. You can also use ^BIJINIT, ^JRNINIT, and ^RMBLD to reinitialize your journal files and rebuild your mapped routines at a later time. 4. Edit the OpenVMS system files to provide for automatic startup and shutdown of DSM for OpenVMS configurations when your system is rebooted. 5. If you are using DDP, reboot your OpenVMS system to reload the DDP driver. 6. Start up the upgraded configurations. Alternate Root Installation If you are installing DSM in an alternate root, read Appendix A of the DSM Installation and Management Guide . It describes the alternate root installation in detail. Do the following to install the DSM Version 7.2 kit: 1. Log in to the system account. 2. Shut down all running DSM configurations. In a VMScluster envi- ronment, shut down configurations running on each node. 3. Extract the DSM$ALTROOT_INSTALL.COM procedure from the kit saveset. On an OpenVMS VAX system, use the following command: $ BACKUP/LOG kit_device:DSMVAX072.B/SAVE/SELECT=DSM$ALTROOT_INSTALL.COM; * On an OpenVMS Alpha system, use the following command: $ BACKUP/LOG kit_device:DSMAXP072.B/SAVE/SELECT=DSM$ALTROOT_INSTALL.COM; * Where kit_device is the distribution tape, CD-ROM, or disk where the DSM kit is located. 5 4. Use the DSM$ALTROOT_INSTALL.COM procedure to create the alter- nate root directories and install the DSM software distribution kit. 5. Use the DSM$ALTROOT.COM procedure to create and initialize a DSM environment manager's account for the new alternate root. 6. Use the DSM$ALTROOT.COM procedure to initialize the group logi- cal name search lists for all users within the GROUP. 7. Log in to the new manager account and use the SYS$MANAGER:DSM$CONFIGURE.COM procedure to create volume sets and to define new configura- tions. 8. Edit system startup files to initialize alternate root instal- lation on system reboot. 6