____________________________________________________ COM for HP OpenVMS Installation Guide July 2004 This document contains instructions for installing COM Version 1.4 for OpenVMS Alpha. Revision/Update Information: This document supersedes the COM for OpenVMS Installation Guide, Version 1.3. Software Version: COM Version 1.4 for HP OpenVMS Operating System: OpenVMS Alpha Version 7.3-1 or higher Microsoft Windows NT 4.0 SP5 or higher OR Microsoft Windows 2000 SP4 or higher Hewlett-Packard Company Palo Alto, California ________________________________________________________________ © Copyright 2004 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Microsoft, MS-DOS, Visual C++, Windows, and Windows NT are trademarks of Microsoft Corporation in the U.S. and/or other countries. Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Motif, OSF/1, and UNIX are trademarks of The Open Group in the U.S. and/or other countries. Sample COM code that appears in this document is from Dale Rogerson's book, Inside COM (Microsoft Press, 1997), and is used with the publisher's permission. This product includes software licensed from Microsoft Corporation. Copyright © Microsoft Corporation, 1991-1998. All rights reserved. Printed in the U.S. ZK6539 This document was prepared using DECdocument, Version 3.3- 1b. _________________________________________________________________ Contents Preface................................................... v 1 Installing the COM for OpenVMS Kit 1.1 Contents of the COM Version 1.4 for OpenVMS Kit........................................... 1-1 1.2 Prerequisites................................. 1-1 1.3 Supported COM for OpenVMS Installations....... 1-3 1.4 Installing COM for OpenVMS on an OpenVMS Standalone System............................. 1-3 1.5 Upgrading COM for OpenVMS on an OpenVMS Standalone System............................. 1-5 1.6 Installing COM for OpenVMS on an OpenVMS Cluster....................................... 1-8 1.7 Upgrading COM for OpenVMS in an OpenVMS Cluster....................................... 1-11 1.8 Defining Shortcut Commands for COM for OpenVMS....................................... 1-14 1.9 Checking the COM for OpenVMS Version.......... 1-15 1.10 Understanding the COM for OpenVMS Environment................................... 1-15 1.10.1 COM for OpenVMS Service Control Manager (SCM)..................................... 1-16 1.10.2 OpenVMS Registry Server................... 1-16 1.10.3 HP Advanced Server for OpenVMS Server..... 1-16 1.10.4 ACME Server............................... 1-17 1.10.5 RPC Endpoint Mapper....................... 1-17 1.10.6 RPC and SSPI/NTLM Layers.................. 1-18 1.10.7 OpenVMS Events............................ 1-18 1.11 Installing COM for OpenVMS.................... 1-18 1.12 COM for OpenVMS Postinstallation Procedures... 1-20 1.13 Starting COM for OpenVMS (COM for OpenVMS Service Control Manager)...................... 1-21 iii 1.13.1 Starting COM for OpenVMS Automatically after a Reboot............................ 1-22 1.14 Shutting Down COM for OpenVMS (COM for OpenVMS Service Control Manager)...................... 1-22 1.14.1 Suppressing the DCOM$SHUTDOWN Confirmation Request................................... 1-24 Examples 1-1 Sample COM for OpenVMS Installation....... 1-19 Tables 1-1 Process Name to Server Name Mapping....... 1-15 iv _________________________________________________________________ Preface Related Documents This document contains instructions on installing COM Version 1.4 for OpenVMS Alpha. See the COM, Registry, and Events for HP OpenVMS Developer's Guide for information about using COM after you have installed the kit. The COM, Registry, and Events for HP OpenVMS Developer's Guide is included in HTML, PDF, and PostScript format in the COM for OpenVMS kit in the [SYSHLP] directory, and is also available from the COM for OpenVMS website at the following location: http://h71000.www7.hp.com/openvms/products/dcom/ For additional information about HP OpenVMS products and services, visit the following World Wide Web address: http://www.hp.com/go/openvms Reader's Comments HP welcomes your comments on this manual. Please send comments to either of the following addresses: Internet openvmsdoc@hp.com Postal Hewlett-Packard Company Mail OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 v How to Order Additional Documentation For information about how to order additional documentation, visit the following World Wide Web address: http://www.hp.com/go/openvms/doc/order vi 1 _________________________________________________________________ Installing the COM for OpenVMS Kit This chapter provides a list of the contents of the COM for OpenVMS kit, a list of prerequisite software, and preinstallation requirements. It also describes how to install COM for OpenVMS and includes postinstallation instructions. 1.1 Contents of the COM Version 1.4 for OpenVMS Kit COM Version 1.4 for OpenVMS contains the following: o Software - COM for OpenVMS run-time libraries - COM for OpenVMS MIDL compiler and header files - COM for OpenVMS configuration utilities - Active Template Library Version 3.0 - Sample applications o Documentation - COM, Registry, and Events for HP OpenVMS Developer's Guide (in PostScript, HTML, and PDF formats) 1.2 Prerequisites The following software is required: o For OpenVMS systems - OpenVMS Version 7.3-1 or higher - For Windows 2000 Interoperability: The most recent DCE$LIB_SHR.EXE (available from your support center). Installing the COM for OpenVMS Kit 1-1 Installing the COM for OpenVMS Kit 1.2 Prerequisites - For COM for OpenVMS application development: Recommended: HP C++ Version 6.5 or higher Minimum requirement: Compaq C++ Version 6.0 or higher To build ATL applications on OpenVMS: Compaq C++ Version 6.2-016 or higher - HP TCP/IP Services for OpenVMS Version 5.0 or equivalent - HP Advanced Server for OpenVMS Version 7.3 or higher (HP Advanced Server for OpenVMS is not required if you are running COM for OpenVMS in unauthenticated mode.) - Before installing COM for OpenVMS check that you have the required free global pages, global sections, and disk blocks. The following table lists the requirements. _____________________________________________________ Global Global Software_________pages_______sections____Disk_blocks_ COM for OpenVMS 11,000 27 34000 RPC_Runtime______3,300_______14__________N/A_________ For Advanced Server requirements: See the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. For TCP/IP requirements: See the HP TCP/IP Services for OpenVMS Installation and Configuration document. o For Windows systems - Windows NT 4.0 with Service Pack 5 or higher installed OR - Windows 2000 with Service Pack 4 or higher installed - Microsoft Visual C++ or Visual Basic (for Windows client development and information about MIDL compiler). See the Microsoft website for compiler version requirements. - TCP/IP enabled (needed for OpenVMS connectivity) 1-2 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.3 Supported COM for OpenVMS Installations 1.3 Supported COM for OpenVMS Installations The following sections describe COM Version 1.4 for OpenVMS installation and upgrade options. ________________________ Note ________________________ If you want to run COM Version 1.4 for OpenVMS in unauthenticated mode, see Appendix E in the COM, Registry, and Events for HP OpenVMS Developer's Guide. ______________________________________________________ ___________________________________________________________ If_you_want_to_do_this__________Read_this_section__________ Install COM for OpenVMS on an Section 1.4 OpenVMS standalone system for the first time. Install COM for OpenVMS on an Section 1.6 OpenVMS Cluster system for the first time. Upgrade from earlier versions Section 1.5 of COM for OpenVMS on an OpenVMS standalone system. Upgrade from earlier versions Section 1.7 of COM for OpenVMS on an OpenVMS_Cluster_system.____________________________________ 1.4 Installing COM for OpenVMS on an OpenVMS Standalone System Use the following procedure: 1. Install OpenVMS Version 7.3-1 or higher. For this procedure, see the OpenVMS Alpha Version 7.x Upgrade and Installation Manual. 2. Install TCP/IP Services. For this procedure, see the HP TCP/IP Services for OpenVMS Installation and Configuration manual or your TCP/IP supplier's documentation. 3. Boot the installed system from the system disk. 4. Install COM Version 1.4 for OpenVMS. For this procedure, see Section 1.11. Installing the COM for OpenVMS Kit 1-3 Installing the COM for OpenVMS Kit 1.4 Installing COM for OpenVMS on an OpenVMS Standalone System 5. Install HP Advanced Server for OpenVMS. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. 6. Configure TCP/IP Services (set up for startup and reboot); then start TCP/IP. You must configure the PWIP driver for HP Advanced Server for OpenVMS to use TCP/IP Services. For information about configuring TCP/IP, see the HP TCP/IP Services for OpenVMS Installation and Configuration manual or your TCP/IP supplier's documentation. 7. Configure the OpenVMS Registry as follows: o Run REG$CONFIG.COM to configure the OpenVMS Registry. o Edit the SYLOGICALS.COM file to define the SYS$REGISTRY logical as follows: $ DEFINE/SYSTEM SYS$REGISTRY directory-specification 8. Start OpenVMS Registry by running the REG$STARTUP.COM file. 9. If you want to run DCE, start DCE now. ________________________ Note ________________________ You do not need DCE to run COM for OpenVMS, but if your environment uses DCE, HP recommends that you start DCE now. ______________________________________________________ For this procedure, see the Compaq DCE Installation and Configuration Guide. For more information about OpenVMS external authentication, see Section 5.1 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 10. Configure HP Advanced Server for OpenVMS. You may need to reboot, depending on your system configuration. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. 11. Start HP Advanced Server for OpenVMS (set up for startup on reboot). For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. 1-4 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.4 Installing COM for OpenVMS on an OpenVMS Standalone System 12. Start the ACME server. Use the following command: $ @SYS$STARTUP:NTA$STARTUP_NT_ACME 13. Start RPC. Use the following command: $ @SYS$STARTUP:DCE$RPC_STARTUP.COM 14. Configure COM for OpenVMS. For this procedure, see Section 1.12 and Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. o Populate the OpenVMS Registry. For this procedure, see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Use option 3 to populate the OpenVMS Registry database. o Create any OpenVMS and HP Advanced Server for OpenVMS accounts needed by the COM for OpenVMS Service Control Manager. For more information, see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Use option 8 to create the accounts. 15. Edit the SYS$MANAGER:SYLOGICALS.COM file and add the following line: $ DEFINE DCOM$TO_BE_STARTED TRUE 16. Start COM for OpenVMS. For this procedure, see Section 1.13. 1.5 Upgrading COM for OpenVMS on an OpenVMS Standalone System ________________________ Note ________________________ Before you start, HP recommends that you disable any HP Advanced Server for OpenVMS, OpenVMS Registry, and layered product automatic startups so that these products do not start until you have upgraded COM for OpenVMS and its associated components. Use the following procedure: 1. Edit the SYLOGICALS.COM file to stop the following products from starting: o OpenVMS Registry (comment the line DEFINE/SYSTEM REG$TO_BE_STARTED TRUE) Installing the COM for OpenVMS Kit 1-5 Installing the COM for OpenVMS Kit 1.5 Upgrading COM for OpenVMS on an OpenVMS Standalone System o COM for OpenVMS (comment the line DEFINE DCOM$TO_BE_STARTED TRUE) 2. Edit the SYS$STARTUP:SYSTARTUP_VMS.COM file to stop the following products from starting: o HP Advanced Server for OpenVMS (comment the line @SYS$STARTUP:PWRK$STARTUP.COM). If COM for OpenVMS is currently running, shut down COM for OpenVMS first, HP Advanced Server for OpenVMS (if running), and then the OpenVMS Registry. ______________________________________________________ Use the following procedure: 1. Upgrade to OpenVMS Version 7.3-1 or higher. For this procedure, see the OpenVMS Alpha Version 7.x Upgrade and Installation Manual. 2. If you need to upgrade TCP/IP, upgrade TCP/IP now. For this procedure, see the HP TCP/IP Services for OpenVMS Installation and Configuration manual or your TCP/IP supplier's documentation. 3. Boot the upgraded system from the system disk. 4. Upgrade COM for OpenVMS. For this procedure, see Section 1.11. 5. Install or upgrade HP Advanced Server for OpenVMS. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. 6. Start TCP/IP unless you have enabled TCP/IP to start on a reboot. For this procedure, see the HP TCP/IP Services for OpenVMS Installation and Configuration manual or your TCP/IP supplier's documentation. 7. Start the OpenVMS Registry unless you have enabled the OpenVMS Registry to start on a reboot. 8. If you want to run DCE, start DCE now. ________________________ Note ________________________ You do not need DCE to run COM for OpenVMS, but if your environment uses DCE, HP recommends that you 1-6 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.5 Upgrading COM for OpenVMS on an OpenVMS Standalone System start DCE now. ______________________________________________________ For this procedure, see the Compaq DCE Installation and Configuration Guide. For more information about OpenVMS external authentication, see Section 5.1 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 9. Configure HP Advanced Server for OpenVMS. You may need to reboot, depending on your system configuration. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. 10. Start HP Advanced Server for OpenVMS (set up for startup on reboot). For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. 11. Start the ACME server. Use the following command: $ @SYS$STARTUP:NTA$STARTUP_NT_ACME 12. Start RPC. Use the following command: $ @SYS$STARTUP:DCE$RPC_STARTUP.COM 13. See Appendix D in the COM, Registry, and Events for HP OpenVMS Developer's Guide for detailed information about upgrading from COM Version 1.0 for OpenVMS to COM Version 1.4 for OpenVMS. 14. Configure COM for OpenVMS. For this procedure, see Section 1.12 and Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. o Populate the OpenVMS Registry. For this procedure, see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Use option 3 to populate the OpenVMS Registry database. o Create any OpenVMS and HP Advanced Server for OpenVMS accounts needed by the COM for OpenVMS Service Control Manager. For more information, see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Use option 8 to create the accounts. Installing the COM for OpenVMS Kit 1-7 Installing the COM for OpenVMS Kit 1.5 Upgrading COM for OpenVMS on an OpenVMS Standalone System 15. Edit the SYLOGICALS.COM file and add the following line: $ DEFINE DCOM$TO_BE_STARTED TRUE 16. Start COM for OpenVMS. For this procedure, see Section 1.13. 1.6 Installing COM for OpenVMS on an OpenVMS Cluster ________________________ Note ________________________ This cluster installation procedure assumes you are installing COM for OpenVMS on a single system disk. ______________________________________________________ Use the following procedure: 1. Install OpenVMS Version 7.3-1 or higher on all system disks as required. For this procedure, see the OpenVMS Alpha Version 7.x Upgrade and Installation Manual. 2. Install TCP/IP. For this procedure, see the HP TCP/IP Services for OpenVMS Installation and Configuration manual or your TCP/IP supplier's documentation. 3. Boot the installed system from the system disk. 4. Install COM Version 1.4 for OpenVMS. For this procedure, see Section 1.11. 5. Install HP Advanced Server for OpenVMS on this node in the cluster. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. ________________________ Note ________________________ You must install HP Advanced Server for OpenVMS on at least one Alpha node in the cluster. On the other nodes, you can either install HP Advanced Server for OpenVMS or select External Authentication images (only). ______________________________________________________ 1-8 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.6 Installing COM for OpenVMS on an OpenVMS Cluster 6. Configure TCP/IP (set up for startup on reboot on each node) and start TCP/IP. You must configure the PWIP driver for HP Advanced Server for OpenVMS to use TCP/IP. For information about configuring TCP/IP, see the HP TCP/IP Services for OpenVMS Installation and Configuration manual or your TCP/IP supplier's documentation. 7. Configure the OpenVMS Registry: o Run REG$CONFIG.COM to configure the OpenVMS Registry. You need to configure the OpenVMS Registry only once for the cluster. o Set the SYS$REGISTRY logical to DEFINE/SYSTEM on every Alpha node in the cluster that will run the OpenVMS Registry server. o Edit the SYLOGICALS.COM file on every node in the cluster as follows: - If the cluster uses a single, cluster-common SYLOGICALS.COM file that is called by each node's SYLOGICALS.COM file, you do not need to make any changes. - On those nodes where you do not want the OpenVMS Registry server to run, add the following line to the SYLOGICALS.COM file: $ DEFINE/SYSTEM REG$TO_BE_STARTED FALSE HP Advanced Server for OpenVMS requires that the OpenVMS Registry be running on a node in the cluster. 8. Configure DCE. ________________________ Note ________________________ You do not need DCE to run COM for OpenVMS, but if your environment uses DCE, HP recommends that you start DCE now. ______________________________________________________ For this procedure, see the Compaq DCE Installation and Configuration Guide. Installing the COM for OpenVMS Kit 1-9 Installing the COM for OpenVMS Kit 1.6 Installing COM for OpenVMS on an OpenVMS Cluster 9. If you want to run DCE, start DCE now. You must configure DCE on each node on which you want to run DCE. For more information about OpenVMS external authentication, see Section 5.1 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 10. Configure and start HP Advanced Server for OpenVMS. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. If this node is running HP Advanced Server for OpenVMS, set up HP Advanced Server for OpenVMS for startup on reboot (edit the SYS$MANAGER:SYSTARTUP_VMS.COM file as necessary). If this node is not running HP Advanced Server for OpenVMS, edit the SYLOGICALS.COM file and define the PWRK$ACME_SERVER logical. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. For more information about the PWRK$ACME_SERVER logical, see Table 8-2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 11. Start the ACME server. Use the following command: $ @SYS$STARTUP:NTA$STARTUP_NT_ACME 12. Start RPC. Use the following command: $ @SYS$STARTUP:DCE$RPC_STARTUP.COM 13. Configure COM for OpenVMS. For this procedure, see Section 1.12 and Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. o Populate the OpenVMS Registry. For this procedure, see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Use option 3 to populate the OpenVMS Registry database. You need to populate the OpenVMS Registry only once in a cluster. o Create any OpenVMS and HP Advanced Server for OpenVMS accounts needed by the COM for OpenVMS Service Control Manager. For more information, see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Use option 8 to create the 1-10 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.6 Installing COM for OpenVMS on an OpenVMS Cluster accounts. You need to create these accounts only once in a cluster. 14. Edit the SYLOGICALS.COM file and add the following line: $ DEFINE DCOM$TO_BE_STARTED TRUE 15. Start COM for OpenVMS. For this procedure, see Section 1.13. 1.7 Upgrading COM for OpenVMS in an OpenVMS Cluster ________________________ Note ________________________ This cluster upgrade procedure assumes you are installing COM for OpenVMS on a single system disk. ______________________________________________________ ________________________ Note ________________________ Before you start, HP recommends that you disable any HP Advanced Server for OpenVMS and layered products automatic startups so these products do not start until you have upgraded COM for OpenVMS and its associated components. Use the following procedure: 1. Edit the SYLOGICALS.COM file to stop the following products from starting: o OpenVMS Registry (comment the line DEFINE/SYSTEM REG$TO_BE_STARTED TRUE) o COM for OpenVMS (comment the line DEFINE DCOM$TO_BE_STARTED TRUE) 2. Edit the SYS$STARTUP:SYSTARTUP_VMS.COM file to stop the following products from starting: - HP Advanced Server for OpenVMS (comment the line @SYS$STARTUP:PWRK$STARTUP.COM) If COM for OpenVMS is currently running, shut down COM for OpenVMS first, HP Advanced Server for OpenVMS (if running), and then the OpenVMS Registry on all nodes in the cluster. ______________________________________________________ Installing the COM for OpenVMS Kit 1-11 Installing the COM for OpenVMS Kit 1.7 Upgrading COM for OpenVMS in an OpenVMS Cluster Use the following procedure: 1. Upgrade to OpenVMS Version 7.3-1 or higher on all required system disks. For this procedure, see the OpenVMS Alpha Version 7.x Upgrade and Installation Manual. 2. Upgrade TCP/IP. For this procedure, see the HP TCP/IP Services for OpenVMS Installation and Configuration manual or your TCP/IP supplier's documentation. 3. Boot the upgraded system from the system disk. 4. Upgrade to COM Version 1.4 for OpenVMS. For this procedure, see Section 1.11. 5. Upgrade HP Advanced Server for OpenVMS on this node in the cluster. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. ________________________ Note ________________________ You must install HP Advanced Server for OpenVMS on at least one Alpha node in the cluster. On the other nodes, you can either install HP Advanced Server for OpenVMS or select External Authentication images (only). ______________________________________________________ 6. Configure TCP/IP (set up for startup on reboot on each node). You must configure the PWIP driver for HP Advanced Server for OpenVMS to use TCP/IP. For information about configuring TCP/IP, see the HP TCP/IP Services for OpenVMS Installation and Configuration manual or your TCP/IP supplier's documentation. 7. Configure the OpenVMS Registry as follows: o Run REG$CONFIG.COM to configure the OpenVMS Registry. You need to configure the OpenVMS Registry only once for the cluster. o Edit the SYLOGICALS.COM file on every node that will run the OpenVMS Registry server to define the SYS$REGISTRY logical. For example: $ DEFINE/SYSTEM SYS$REGISTRY cluster-visible-directory-specification 1-12 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.7 Upgrading COM for OpenVMS in an OpenVMS Cluster Edit the SYLOGICALS.COM file on every node in the cluster as follows: - If the cluster uses a single, cluster-common SYLOGICALS.COM file that is called by each node's SYLOGICALS.COM file, you do not need to make any changes. - On those nodes where you do not want the OpenVMS Registry server to run, add the following line to the SYLOGICALS.COM file: $ DEFINE/SYSTEM REG$TO_BE_STARTED FALSE 8. Configure and start HP Advanced Server for OpenVMS. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. If this node is running HP Advanced Server for OpenVMS, set up HP Advanced Server for OpenVMS for startup on reboot (edit the SYS$STARTUP file as necessary). If this node is not running HP Advanced Server for OpenVMS, edit the SYLOGICALS.COM file and define the PWRK$ACME_SERVER logical. For this procedure, see the HP Advanced Server for OpenVMS Server Installation and Configuration Guide. For more information about the PWRK$ACME_SERVER logical, see Table 8-2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 9. Start the ACME server. Use the following command: $ @SYS$STARTUP:NTA$STARTUP_NT_ACME 10. Start RPC. Use the following command: $ @SYS$STARTUP:DCE$RPC_STARTUP.COM 11. See Appendix D in the COM, Registry, and Events for HP OpenVMS Developer's Guide for detailed information about upgrading from COM Version 1.0 for OpenVMS to COM Version 1.4 for OpenVMS. 12. Configure COM for OpenVMS. For this procedure, see Section 1.12 and Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. o Populate the OpenVMS Registry. For this procedure, see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Use option 3 to Installing the COM for OpenVMS Kit 1-13 Installing the COM for OpenVMS Kit 1.7 Upgrading COM for OpenVMS in an OpenVMS Cluster populate the OpenVMS Registry database. You need to populate the OpenVMS Registry only once in a cluster. o Create any OpenVMS and HP Advanced Server for OpenVMS accounts needed by the COM for OpenVMS Service Control Manager. For more information, see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Use option 8 to create the accounts. You need to create these accounts only once in a cluster. 13. Edit the SYLOGICALS.COM file and add the following line: $ DEFINE DCOM$TO_BE_STARTED TRUE 14. Start COM for OpenVMS on a particular node. For this procedure, see Section 1.13. 1.8 Defining Shortcut Commands for COM for OpenVMS COM for OpenVMS provides a command procedure that defines shortcut commands for many regular COM commands. Add the following command to your login command procedure, or execute the command line after logging in: $ @SYS$STARTUP:DCOM$DEFINE_COMMANDS.COM SYS$STARTUP:DCOM$DEFINE_COMMANDS.COM defines the following commands: $ DCOMSTA*RT :== @SYS$STARTUP:DCOM$STARTUP.COM $ DCOMSTO*P :== @SYS$STARTUP:DCOM$SHUTDOWN.COM $ DCOMSTOPN*O :== @SYS$STARTUP:DCOM$SHUTDOWN.COM NOCONFIRM $ DCOMSE*TUP :== @SYS$STARTUP:DCOM$SETUP.COM $ DCOMC*NFG :== $SYS$SYSTEM:DCOM$CNFG.EXE $ DCOMT*OOL :== $SYS$SYSTEM:DCOM$TOOL.EXE $ NTLOG*ON :== $SYS$SYSTEM:NTA$LOGON.EXE $ DCOMOUT :== TYPE/PAGE SYS$MANAGER:DCOM$RPCSS.OUT $ DCOMEV*ENTS :== TYPE/PAGE SYS$MANAGER:DCOM$EVENTLOG.RPT $ DCOMVER :== $SYS$SYSTEM:DCOM$TOOL.EXE SHOW VERSION $ DCOMER*ROR :== $SYS$SYSTEM:DCOM$TOOL.EXE SHOW ERROR 1-14 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.9 Checking the COM for OpenVMS Version 1.9 Checking the COM for OpenVMS Version With COM Version 1.3 or higher for OpenVMS, you can view the currently installed version of COM. To do so, invoke the following command: $ DCOM$TOOL == "$DCOM$TOOL" $ DCOM$TOOL SHOW VERSION For more ways to use to the DCOM$TOOL Utility, see Section 7.6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 1.10 Understanding the COM for OpenVMS Environment COM for OpenVMS relies on a number of interrelated servers (processes) and operating system images. In most cases, the servers start automatically when you restart the system. (Automatic startup requires that you have installed and configured each component and have made appropriate changes to the SYLOGICALS.COM file.) For more information about starting and configuring the servers, see Section 1.3. Figure 1-1 shows the relationships and dependencies of the processes and operating system layers. Table 1-1 lists the process names and maps each name to its corresponding server. Table_1-1_Process_Name_to_Server_Name_Mapping______________ Process_name__Server_name___________For_more_information___ DCOM$RPCSS COM for OpenVMS Section 1.10.1 Service Control Manager (SCM) REGISTRY_ OpenVMS Registry Section 1.10.2 SERVER server PWRKxxx HP Advanced Server Section 1.10.3 for OpenVMS server (multiple processes) ACME_SERVER ACME server Section 1.10.4 DCE$DCED______RPC_endpoint_mapper___Section_1.10.5_________ The following sections list and describe the servers and the layers. Installing the COM for OpenVMS Kit 1-15 Installing the COM for OpenVMS Kit 1.10 Understanding the COM for OpenVMS Environment 1.10.1 COM for OpenVMS Service Control Manager (SCM) The COM for OpenVMS Service Control Manager enables COM for OpenVMS. Process name: DCOM$RPCSS Requires: OpenVMS Registry, OpenVMS (RPC and SSPI/NTLM layers) Required by: COM applications Configured by: DCOM$SETUP. See Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Started by: DCOM$SETUP, option 4. See Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Shutdown procedure: DCOM$SETUP, option 5. See Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 1.10.2 OpenVMS Registry Server The OpenVMS Registry server manages the OpenVMS Registry database. Process name: REGISTRY_SERVER Requires: None. Required by: COM for OpenVMS, HP Advanced Server for OpenVMS Configured by: REG$CONFIG. Started by: REG$STARTUP. See Section 13.3.1 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. Shutdown procedure: SET SERVER REGISTRY_SERVER/EXIT. For more information, see Section 13.4 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 1.10.3 HP Advanced Server for OpenVMS Server The HP Advanced Server for OpenVMS server enables OpenVMS to act as a Windows NTLM domain controller. The ACME server requires the PWRK$MSV1_0_ACMESHR ACME agent image to talk with the local or remote PWRK$LMSRV process. Requires: OpenVMS Registry 1-16 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.10 Understanding the COM for OpenVMS Environment Required by: ACME server Configured by: PWRK$CONFIG Started by: PWRK$STARTUP Shutdown procedure: PWRK$SHUTDOWN For more information, see the HP PATHWORKS for OpenVMS (Advanced Server) Server Migration Guide. 1.10.4 ACME Server The ACME server controls the granting of credentials. Process name: ACME_SERVER Requires: HP Advanced Server for OpenVMS Required by: OpenVMS (RPC and SSPI/NTLM layers) and OpenVMS Events Started: o Automatically when COM for OpenVMS is started o You can also start the ACME server manually by entering the following command: $ @SYS$STARTUP:NTA$STARTUP_NT_ACME Shutdown procedures (both are valid): $ SET SERVER ACME /CANCEL /EXIT $ SET SERVER ACME /DISABLE /CANCEL $ SET SERVER ACME /ENABLE=(NAME=VMS) For more information, see Section 8.3.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 1.10.5 RPC Endpoint Mapper The RPC endpoint mapper controls authentication and security. Process name: DCE$DCED Requires: RPC image Required by: COM for OpenVMS Service Control Manager, RPC image Started by: OpenVMS Installing the COM for OpenVMS Kit 1-17 Installing the COM for OpenVMS Kit 1.10 Understanding the COM for OpenVMS Environment Shutdown procedure: Use the following command procedure: $ @SYS$STARTUP:DCE$RPC_SHUTDOWN.COM For more information, see the Compaq DCE Installation and Configuration Guide. 1.10.6 RPC and SSPI/NTLM Layers The RPC and SSPI/NTLM layers provides remote procedure call and Windows-style authentication on OpenVMS. Process name: n/a (part of OpenVMS operating system) Requires: OpenVMS, ACME server Required by: COM for OpenVMS Started by: OpenVMS Shutdown procedure: n/a 1.10.7 OpenVMS Events The Events layer provides Windows-style event logging on OpenVMS. Process name: n/a (part of OpenVMS operating system) Requires: ACME server Required by: COM for OpenVMS Started by: OpenVMS Shutdown procedure: n/a For more information, see Chapter 15 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 1.11 Installing COM for OpenVMS The COM for OpenVMS installation kit contains a single POLYCENTER Software Installation utility file. The name of the kit is DEC-AXPVMS-DCOM-V0104--1.PCSI. You must install the COM for OpenVMS files on an OpenVMS Alpha system. Please check the prerequisites before installing the kit. See Section 1.2. 1-18 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.11 Installing COM for OpenVMS To install COM for OpenVMS, invoke the POLYCENTER Software Installation utility using the following command: $ PRODUCT INSTALL DCOM /SOURCE=device:[directory] For device:[directory], specify the device name and directory location of the kit, respectively. ______ MIDL compiler license no longer required ______ The COM for OpenVMS MIDL compiler no longer requires the DCOM-MIDL license. ______________________________________________________ Example 1-1 shows a sample installation. Example 1-1 Sample COM for OpenVMS Installation $ product install dcom/source=disk:[directory] The following product has been selected: DEC AXPVMS DCOM V1.4 Layered Product Do you want to continue? [YES] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. DEC AXPVMS DCOM V1.4 Copyright © 2004 Hewlett-Packard Development Company, L.P. All rights reserved. Do you want the defaults for all options? [YES] The following software is required to run COM for HP OpenVMS - HP OpenVMS Alpha V7.3-1 or later * Includes DCE RPC and OpenVMS Registry (The most recent DCE$LIB_SHR.EXE available is required for interoperating with Windows 2000.) - HP TCP/IP Services V5.0 or later for HP OpenVMS (or equivalent product) - HP Advanced Server V7.3 or later for HP OpenVMS Do you want to continue? [YES] Do you want to review the options? [NO] (continued on next page) Installing the COM for OpenVMS Kit 1-19 Installing the COM for OpenVMS Kit 1.11 Installing COM for OpenVMS Example 1-1 (Cont.) Sample COM for OpenVMS Installation Execution phase starting ... The following product will be installed to destination: DEC AXPVMS DCOM V1.4 DISK$FINALKES:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been installed: 1.12 COM for OpenVMS Postinstallation Procedures After you install the COM for OpenVMS kit, do the following: 1. Verify that the OpenVMS Registry is running. (See Chapter 13 in the COM, Registry, and Events for HP OpenVMS Developer's Guide.) 2. Verify that the HP Advanced Server for OpenVMS is running. (See Section 1.10.3 for the HP Advanced Server for OpenVMS process names.) 3. Verify that the ACME server is running. (See Section 1.10.4 for the name of this process.) 4. Verify that the RPC daemon is running. (See Section 1.10.5 for the name of the process.) 5. Populate the OpenVMS Registry with the required COM for OpenVMS keys and values using the DCOM$SETUP utility, option 3. (See Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide.) You must do this only once in an OpenVMS Cluster. 6. Configure the DCOM$RPCSS account using the DCOM$SETUP utility, option 8. (See Section 6.2.1 in the COM, Registry, and Events for HP OpenVMS Developer's Guide.) You must do this only once in an OpenVMS Cluster. 7. Start COM for OpenVMS using the DCOM$SETUP utility, option 4. (See Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide.) You must do this on every node in an OpenVMS Cluster. 1-20 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit 1.12 COM for OpenVMS Postinstallation Procedures 8. If you want COM for OpenVMS to start automatically when the system reboots, modify the DEFINE DCOM$TO_BE_STARTED line in the SYLOGICALS.COM file. (See Section 1.13.1.) You must do this on every node in an OpenVMS Cluster. 9. Configure COM for OpenVMS security. See Chapter 5 in the COM, Registry, and Events for HP OpenVMS Developer's Guide. 1.13 Starting COM for OpenVMS (COM for OpenVMS Service Control Manager) Use the following command to start COM for OpenVMS: $ @SYS$STARTUP:DCOM$STARTUP Alternately, you can run DCOM$SETUP and choose option 4. (See Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide.) The COM for OpenVMS Service Control Manager can be in one of the following states: initializing/running or not started. Depending on the COM for OpenVMS Service Control Manager state, you will see one of the following messages: o If the COM for OpenVMS Service Control Manager is running on this node, the system reports that the process is already active: DCOM Service Control Manager daemon (DCOM$RPCSS) is active [pid=xxxxxxxx] If the COM for OpenVMS Service Control Manager is initializing on this node, the system reports that the process is already active: DCOM Service Control Manager daemon (DCOM$STARTUP-**) is active [pid=xxxxxxxx] o If the COM for OpenVMS Service Control Manager is not started on this node, the system starts COM for OpenVMS as follows: The OpenVMS Registry server is already started on this node. *** DCOM system startup procedure *** Starting DCOM Service Control Manager daemon ( "DCOM$STARTUP-**" ) . . . After initialization, the daemon will use process name "DCOM$RPCSS" . . . %RUN-S-PROC_ID, identification of created process is xxxxxxxx Installing the COM for OpenVMS Kit 1-21 Installing the COM for OpenVMS Kit 1.13 Starting COM for OpenVMS (COM for OpenVMS Service Control Manager) *** DCOM startup successful *** *** DCOM Startup Procedure Complete *** 1.13.1 Starting COM for OpenVMS Automatically after a Reboot HP recommends that you modify the SYS$MANAGER:SYLOGICALS.COM command file to control COM for OpenVMS startup. OpenVMS includes a revised SYLOGICALS.TEMPLATE file that includes new startup commands for COM for OpenVMS and related components. Review the "Coordinated Startup" section of this template file and add the appropriate information to your existing startup files. To have COM for OpenVMS start automatically when the system boots, copy the following line to your SYLOGICALS.COM file, uncomment the line, and make sure it is set to TRUE: $ DEFINE DCOM$TO_BE_STARTED TRUE If you do not set COM for OpenVMS to start automatically when the system boots, you can start COM for OpenVMS using the DCOM$SETUP OpenVMS COM Tools menu, option 4 (see Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide). 1.14 Shutting Down COM for OpenVMS (COM for OpenVMS Service Control Manager) Use the following command to shut down COM for OpenVMS: $ @SYS$STARTUP:DCOM$SHUTDOWN Alternately, you can run DCOM$SETUP and choose option 5. (See Section 6.2 in the COM, Registry, and Events for HP OpenVMS Developer's Guide.) The COM for OpenVMS Service Control Manager can be in one of the following states: stopped, running, or initializing. Depending on the COM for OpenVMS Service Control Manager state, you will see one of the following messages: o If the COM for OpenVMS Service Control Manager is stopped on this node, the system reports that there is nothing to shut down: 1-22 Installing the COM for OpenVMS Kit Installing the COM for OpenVMS Kit Shutting Down COM for OpenVMS (COM for OpenVMS Service Control Manager) *** DCOM system shutdown procedure *** There is no active DCOM$RPCSS daemon on this system. *** DCOM Shutdown Procedure Complete *** o If the COM for OpenVMS Service Control Manager is running on this node, the system shuts down the process as follows: *** DCOM system shutdown procedure *** *************************** Warning ******************************** *** Stopping the DCOM Service Control Manager daemon (DCOM$RPCSS) *** Active DCOM applications will no longer be operational. Do you want to proceed with this operation (YES/NO/?) [N]? Enter Y to continue with the shutdown procedure. ________________________ Note ________________________ For information about suppressing this confirmation step, see Section 1.14.1. ______________________________________________________ The system displays the following messages: Terminating DCOM Service Control Manager daemon (DCOM$RPCSS) . . . *** DCOM shutdown successful *** *** DCOM Shutdown Procedure Complete *** o If the COM for OpenVMS Service Control Manager is initializing on this node, the system shuts down the process as follows: *** DCOM system shutdown procedure *** *************************** Warning ******************************** *** Stopping the DCOM Service Control Manager daemon (DCOM$RPCSS) *** Active DCOM applications will no longer be operational. Do you want to proceed with this operation (YES/NO/?) [N]? Enter Y to continue with the shutdown procedure. The system displays the following messages: Installing the COM for OpenVMS Kit 1-23 Installing the COM for OpenVMS Kit 1.14 Shutting Down COM for OpenVMS (COM for OpenVMS Service Control Manager) Terminating DCOM Service Control Manager daemon (DCOM$STARTUP-**) . . . *** DCOM shutdown successful *** *** DCOM Shutdown Procedure Complete *** 1.14.1 Suppressing the DCOM$SHUTDOWN Confirmation Request You can suppress the DCOM$SHUTDOWN command confirmation request by specifying the NOCONFIRM parameter. Use the following command: $ @SYS$STARTUP:DCOM$SHUTDOWN NOCONFIRM The system displays the following shutdown messages without prompting you to confirm the shutdown: *** DCOM system shutdown procedure *** Terminating DCOM Service Control Manager daemon (DCOM$RPCSS) . . . *** DCOM shutdown successful *** *** DCOM Shutdown Procedure Complete *** 1-24 Installing the COM for OpenVMS Kit