DECvoiceBuilder[TM] Production_Environment_for_OpenVMS[TM]_VAX[TM] Installation Guide Order Number: AA-PNTWB-TE November 1993 This guide describes how to install the DECvoiceBuilder Production Environment product on the OpenVMS VAX operating system. Revision/Update Information: This is a revised guide. Operating System and Version: OpenVMS VAX Version 5.5-1 or higher Software Version: DECvoiceBuilder Software for OpenVMS VAX Version 1.1 Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ First Printing, June 1992 Revised, November 1993 Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation 1992, 1993. All Rights Reserved. The postpaid Reader's Comments forms at the end of this document request your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: Bookreader, DECnet, DECvoice, DECvoiceBuilder, DECwindows, OpenVMS, VAX, VAX C, and the DIGITAL logo. The following are third-party trademarks: Motif is a registered trademark of Open Software Foundation, Inc. PostScript is a registered trademark of Adobe Systems, Inc. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing to Install DECvoiceBuilder Production Environment 1.1 Required Operating System Components............ 1-1 1.2 Prerequisite Software........................... 1-1 1.3 Optional Software............................... 1-2 1.4 Prerequisite Hardware........................... 1-2 1.5 OpenVMS License Management Facility............. 1-2 1.6 Installation Procedure Requirements............. 1-3 1.6.1 Installation Time ............................ 1-4 1.6.2 System Privileges ............................ 1-4 1.6.3 Disk Space ................................... 1-5 1.6.4 System Parameters ............................ 1-5 1.6.5 VMSINSTAL Requirements ....................... 1-7 1.6.6 System Disk Backup ........................... 1-7 2 Installing DECvoiceBuilder Production Environment 2.1 Accessing the Online Release Notes.............. 2-1 2.2 Determining the Files Added to the System....... 2-2 2.3 Running the Installation Verification Procedure....................................... 2-2 2.4 Aborting the Installation....................... 2-2 2.5 Installing DECvoiceBuilder Production Environment..................................... 2-3 2.5.1 Invoking VMSINSTAL ........................... 2-3 2.5.2 Answering Installation Questions ............. 2-5 2.5.3 Reading Informational Messages ............... 2-10 2.5.4 Running the IVP ............................. 2-11 2.5.5 Completing the Installation Procedure ........ 2-12 iii 2.6 Recovering from Errors.......................... 2-12 3 After Installing DECvoiceBuilder Production Environment 3.1 Running the IVP After Installation.............. 3-1 3.2 Setting User Account Requirements............... 3-1 3.3 Determining and Reporting Problems.............. 3-3 A Sample Installation B Files and Directories Installed on Your System Tables 1-1 Disk Space Requirements ...................... 1-5 iv ________________________________________________________________ Preface This guide describes how to install the DECvoiceBuilder Production Environment product on the OpenVMS VAX operating system. The guide includes information on preparations and requirements prior to installation, steps for installing the software, information on the Installation Verification Procedure, a sample installation, and a list of the installed files and directories. Purpose of this Guide This guide describes all the steps necessary for installing the DECvoiceBuilder Production Environment product. The information also includes preinstallation procedures needed before installation takes place. A sample installation is included in Appendix A. Keep this guide with your distribution kit. You will need to refer to it again if you reinstall the DECvoiceBuilder Production Environment product for any reason. Intended Audience This guide is for OpenVMS system managers who have experience with installing layered products on OpenVMS systems. In addition, system managers must have experience with the following OpenVMS utilities: o VMSINSTAL o SYSGEN o AUTHORIZE v Document Structure This guide contains the following chapters and appendixes: Chapter 1 Describes the required operating system components, prerequisite software, prerequisite hardware, and installation procedure requirements. Chapter 2 Describes general information for installing the DECvoiceBuilder Production Environment product, the installation procedure, and error recovery. Chapter 3 Describes running the IVP after instal- lation, setting user account quotas, and determining and reporting problems. Appendix A Contains a sample installation of the DECvoiceBuilder Production Environment. Appendix B Contains a list of the directories and files created or modified by the installation procedure. DECvoiceBuilder Software for OpenVMS VAX Information Set The DECvoiceBuilder Production Environment information set contains the following items: o DECvoiceBuilder Software for OpenVMS VAX Administrator Guide o Introduction to DECvoiceBuilder Software for OpenVMS VAX o DECvoiceBuilder Software for OpenVMS VAX Application Editor Guide o DECvoiceBuilder Software for OpenVMS VAX Recording Studio Guide o DECvoiceBuilder Production Environment for OpenVMS VAX Installation Guide o DECvoiceBuilder Production Environment Release Notes vi The DECvoiceBuilder Run-Time Environment information set contains the following items: o DECvoiceBuilder Software for OpenVMS VAX Administrator Guide o DECvoiceBuilder Run-Time Environment for OpenVMS VAX Installation Guide o DECvoiceBuilder Run-Time Environment Release Notes Related Documents For more information on installing OpenVMS layered products, see the OpenVMS installation guide for your processor. For more information on OpenVMS system management, see the OpenVMS System Manager's Manual. For more information on OpenVMS system disk backup, see the OpenVMS Sytem Management Utilities Reference Manual. For more information on using the License Management Facility, see the OpenVMS License Management Utility Manual. For more information on Motif see the OpenVMS DECwindows Motif Installation Guide. For more information on DECvoice see the DECvoice Software for OpenVMS Installation Guide. Conventions The following conventions are used throughout this manual: __________________________________________________________ Convention____Meaning_____________________________________ italicized Indicates title of manuals and emphasis of text words. boldface Indicates information that you must enter. type . Means that not all the information is shown. . ._________________________________________________________ vii 1 ________________________________________________________________ Preparing to Install DECvoiceBuilder Production Environment This chapter describes the preparations and requirements necessary for installing DECvoiceBuilder Production Environment for OpenVMS VAX systems. Your bill of materials (BOM) and indented bills report (BIL) specify the contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Digital representative. DECvoiceBuilder Production Environment provides online release notes. Digital recommends that you read the release notes before proceeding with the installation. See Chapter 2 for information about accessing online release notes. 1.1 Required Operating System Components The DECvoiceBuilder Production Environment product requires the OpenVMS VAX operating system, Version 5.5-1 or higher. 1.2 Prerequisite Software The DECvoiceBuilder Production Environment product requires the following OpenVMS layered products: o OpenVMS DECwindows[TM] Motif[TM] Version 1.1 or higher o DECvoice[TM] Software for OpenVMS Version 2.2 o VAX C[TM] Version 3.2 or higher Preparing to Install DECvoiceBuilder Production Environment 1-1 ________________________Note ________________________ DECvoiceBuilder will not run on Open VMS VAX Version 6.0. _____________________________________________________ To use DECvoiceBuilder Production Environment, you must have access to the C compiler. 1.3 Optional Software The DECvoiceBuilder Run-Time Environment product can also be used with the following optional software: o DECfax Version 1.1 or higher o Rdb/SQL Version 4.1 or higher (must be installed before DECvoiceBuilder) 1.4 Prerequisite Hardware The DECvoiceBuilder Production Environment product requires the following hardware: o A supported OpenVMS VAX processor For a list of supported VAX processors, see the System Support Addendum. o A workstation or X-terminal running OpenVMS DECwindows Motif Version 1.1 or higher. o A DTC05 voice module and a DTCN5 telephony module or a DTCN5-UG. 1.5 OpenVMS License Management Facility The OpenVMS License Management Facility (LMF) is available with Version 5.3 of the OpenVMS operating system. You must register the four licenses associated with the components of the DECvoiceBuilder Production Environment through LMF in accordance with the license agreement signed by your site. The license registration information you need is contained in the Product Authorization Keys (PAKs) shipped with DECvoiceBuilder Production Environment. A PAK is a paper certificate that contains 1-2 Preparing to Install DECvoiceBuilder Production Environment information about the licenses you need to run a particular piece of software. During the installation, the system asks whether you have registered each of the four licenses for the DECvoiceBuilder Production Environment and loaded the appropriate authorization keys. To run the Installation Verification Procedure (IVP) and use the software, register and load your licenses for DECvoiceBuilder Production Environment before you start the installation. To register a license, first log in to the system manager's account, SYSTEM. Then choose one of the following ways to perform the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your PAK. o At the DCL prompt, issue the LICENSE REGISTER command with the appropriate qualifiers that correspond to the PAK information. For complete information on using LMF, see the OpenVMS License Management Utility Manual. 1.6 Installation Procedure Requirements This section describes the following requirements for installing DECvoiceBuilder Production Environment: o Installation time o System privileges o Disk space o System parameters o VMSINSTAL requirements o System disk backup requirements Preparing to Install DECvoiceBuilder Production Environment 1-3 1.6.1 Installation Time The installation takes approximately 25 to 40 minutes, depending on your type of media and your system configura- tion. 1.6.2 System Privileges To install DECvoiceBuilder Production Environment, you must be logged in to the SYSTEM account or an account that has SETPRV or at least the following privileges: o CMKRNL o WORLD o SYSPRV VMSINSTAL turns off the BYPASS privilege at the start of the installation. 1-4 Preparing to Install DECvoiceBuilder Production Environment 1.6.3 Disk Space Installing DECvoiceBuilder Production Environment requires a certain amount of free storage disk space during the installation. Once DECvoiceBuilder Production Environment is installed, less storage space is required. Table 1-1 summarizes the disk space requirements for DECvoiceBuilder Production Environment. Table_1-1_Disk_Space_Requirements_________________________ Blocks Blocks During After Required on Kit_____________________InstallationInstallatioSystem_Disk DECvoiceBuilder 65000 30500 30000 Production Environment with examples DECvoiceBuilder 19000 10000 9500 Production Environment without_examples__________________________________________ To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt ($): $ SHOW DEVICE SYS$SYSDEVICE 1.6.4 System Parameters When installing DECvoiceBuilder Production Environment, certain system parameter settings are recommended. These system parameters are the same as for OpenVMS DECwindows Motif Version 1.1 or higher with DECvoice Software for OpenVMS Version 2.2 residing as a layered product. ________________________Note ________________________ Motif must be installed before DECvoice software is installed. See the OpenVMS DECwindows Motif Installation Guide and the DECvoice Software for OpenVMS Installation Guide for more information. Preparing to Install DECvoiceBuilder Production Environment 1-5 If optional software is installed, please verify that the system parameters are properly set. _____________________________________________________ 1-6 Preparing to Install DECvoiceBuilder Production Environment 1.6.5 VMSINSTAL Requirements When you invoke VMSINSTAL, it checks the following: o Whether you have set your default device and directory to SYS$UPDATE o Whether you are logged in to a privileged account o Whether the DECnet[TM] software is running o Whether any users are logged in to the system o Whether you have adequate quotas for installation If VMSINSTAL detects any problems during the installation, it notifies you and asks if you want to continue the installation. You can enter Y for Yes to continue. To stop the installation process and correct the situation, enter N for No, or press the Return key. Then correct the problem and restart the installation. 1.6.6 System Disk Backup At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Digital recommends that you do a system disk backup before installing any software. Use the backup procedures that have been established at your site. For details on performing a system disk backup, see the OpenVMS System Management Utilities Reference Manual in the OpenVMS System Management subkit. Preparing to Install DECvoiceBuilder Production Environment 1-7 2 ________________________________________________________________ Installing DECvoiceBuilder Production Environment This chapter describes the tasks required to install DECvoiceBuilder Production Environment. These tasks include the following: o Accessing online release notes o Determining the files added to your system o Running the Installation Verification Procedure (IVP) o Aborting the installation This chapter also contains a step-by-step description of the installation procedure, and explains error recovery procedures. 2.1 Accessing the Online Release Notes DECvoiceBuilder Production Environment provides online release notes. You must specify OPTIONS N when you invoke VMSINSTAL to see the question about online release notes. This option is displayed near the beginning of the installation. Review the release notes in case they contain any information about changes in the installation procedure. If you are starting the installation over and have already reviewed the release notes, you do not need to specify OPTIONS N. Once DECvoiceBuilder Production Environment has been installed, the release notes are located in the following file: SYS$HELP:VAE011.RELEASE_NOTES Installing DECvoiceBuilder Production Environment 2-1 2.2 Determining the Files Added to the System The DECvoiceBuilder Production Environment installation procedure installs a number of files. For a complete list of these files, see Appendix B. 2.3 Running the Installation Verification Procedure The Installation Verification Procedure (IVP) verifies the installation. During the installation, you are asked if you want to run the IVP as part of the installation. If you respond Yes, VMSINSTAL runs the IVP. Digital recommends that you run the IVP to be sure that DECvoiceBuilder Production Environment is installed correctly. After DECvoiceBuilder Production Environment is installed, you can run the IVP independently to verify that the software is available on your system. You can also run the IVP after a system failure to be sure that users can access DECvoiceBuilder Production Environment. To run the IVP after installation, enter the following command at the DCL prompt: $ SET DEFAULT SYS$SYSROOT:[SYSTEST] $ @VAE$IVP 2.4 Aborting the Installation To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y the installation procedure does not delete files created up to that point. You must delete these files interactively. (See Appendix B for a list of files and directories created during the installation procedure.) 2-2 Installing DECvoiceBuilder Production Environment 2.5 Installing DECvoiceBuilder Production Environment The DECvoiceBuilder Production Environment installa- tion process consists of a series of questions and informational messages. The following sections explain how to respond to these questions and messages. These sections also describe how to run the IVP and complete the installation procedure. See Appendix A for a sample installation. 2.5.1 Invoking VMSINSTAL To start the installation, invoke the VMSINSTAL command procedure from a privileged account, such as the SYSTEM account. VMSINSTAL is in the SYS$UPDATE directory. Use the following syntax to invoke VMSINSTAL: @SYS$UPDATE:VMSINSTAL saveset-name device-name OPTIONS N The following information defines the elements of the VMSINSTAL command procedure. saveset-name The installation name for the component. For DECvoiceBuilder Production Environment, use the following installation name: VAE011 device-name The name of the device on which you plan to mount the media. For example, MUA0: is the device name for a TK50 tape drive. It is not necessary to use the console drive for this installation. However, if you do use the console drive, replace any media you removed once the installation is complete. OPTIONS N An optional parameter that indicates you want to see the release notes question. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. You can review the release notes before proceeding with the installation in case they contain additional information about the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N. Installing DECvoiceBuilder Production Environment 2-3 There are several other options you can select when you invoke VMSINSTAL: o Auto answer option (A): Creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (usually after upgrading your system). o Get save set option (G): Lets you store product save sets temporarily on a magnetic tape or in a disk directory. o File log option (L): Logs all activity to the terminal during installation. o Alternate root option (R): Lets you install the product to a system root other than that of the running system. See the OpenVMS documentation on software installation for information on these options. If you specify more than one option, separate the options with commas (OPTIONS A,N). The following example displays the command to in- voke VMSINSTAL to install DECvoiceBuilder Production Environment from tape drive MUA0: and shows the system response. This example uses the OPTIONS N release notes parameter. $ @SYS$UPDATE:VMSINSTAL VAE011 MUA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.5-1 It is 19-NOV-1993 at 08:51 Enter a question mark (?) at any time for help. If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. Since VMSINSTAL does not prompt you for any options, be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation. 2-4 Installing DECvoiceBuilder Production Environment 2.5.2 Answering Installation Questions This section describes the questions that appear during the installation. Each question in the installation is marked with an asterisk (*) at the beginning of the line. Some questions show the default response in brackets, for example [YES]. If you want to use the default response, press the Return key. For an example of how to answer these questions, see the sample installation procedure in Appendix A. 1. Verifying DECnet status VMSINSTAL notifies you if the DECnet software is running and displays a list of all active processes. It then asks if you want to continue the installation. You should install DECvoiceBuilder Production Environment on a standalone system or cluster with DECnet shut down. The default response to the question is No. %VMSINSTAL-W-DECNET, Your DECnet network is up and running. . . . * Do you want to continue anyway [NO]? 2. Backing up the system VMSINSTAL asks if you are satisfied with your system backup: * Are you satisfied with the backup of your system disk [YES]? You should always back up your system disk before performing an installation. If you are satisfied with the backup of your system disk, press the Return key. Otherwise, enter N to discontinue the installation. After you back up your system disk, you can restart the installation. 3. Mounting the media OpenVMS asks you for the intended location for the distribution volumes: Installing DECvoiceBuilder Production Environment 2-5 * Where will the distribution volumes be mounted: MUA0: Enter the products to be processed from the first distribution volume set. * Products: VAE011 Enter installation options you wish to use [NONE]: You should now mount the first distribution volume on the device you specified when you invoked VMSINSTAL. The device name appears in the line preceding the question. VMSINSTAL then asks you if you are ready to continue with the installation, as shown in the following example: Please mount the first volume of the set on MUA0:. * Are you ready? YES %MOUNT-I-MOUNTED, VAE011 MOUNTED ON _$$MUA0: The following products will be processed: VAE011 Beginning installation of VAE011 at 08:51 %VMSINSTAL-I-RESTORE, Restoring product saveset A... If you enter Y to indicate that you are ready, VMSINSTAL displays a message that the media containing DECvoiceBuilder Production Environment has been mounted on the specified device and that the installation has begun. If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter N in response to the question, "Are you ready?" To abort the installation for other reasons, press Ctrl/Y. 2-6 Installing DECvoiceBuilder Production Environment 4. Mounting additional media volumes If your installation kit contains more than one volume, VMSINSTAL prompts you to insert the additional volumes and then asks you to indicate that you are ready for the installation to proceed, for example: %BACKUP-I-READYREAD, mount volume 2 on _MUA0: for reading Enter "YES" when ready: 5. Selecting the release notes option If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the four options for reviewing the release notes. Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: (4) If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C. If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use, for example: * Queue name [SYS$PRINT]: You can press the Return key to send the file to the default output print device or you can enter another queue name. If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. Select option 4 if you have already reviewed the release notes and are restarting the installation. Installing DECvoiceBuilder Production Environment 2-7 6. Continuing the installation The installation procedure now asks if you want to continue the installation. To continue, enter Y. Otherwise, press the Return key. In either case, the release notes are copied to a file in the SYS$HELP directory. For example: * Do you want to continue the installation [N]?:YES %VMSINSTAL-I-RELMOVED, The product's release notes have been successfully moved to SYS$HELP. 7. Determining if the system is run-time only The installation procedure now asks you if you are installing a run-time only system. * Is this a runtime only system? [NO]:NO If you enter Y then the run-time only system is installed. The run-time only system does not contain the Application Editor or Recording Studio components of DECvoiceBuilder Software for OpenVMS VAX. The run-time only system contains Administrator and DECvoiceBuilder Software for OpenVMS VAX run-time routines. 8. Loading the DECvoiceBuilder Software for OpenVMS VAX files The installation procedure now asks you where you want to load the DECvoiceBuilder Software for OpenVMS VAX files. * Where do you wish to load the DECvoiceBuilder files? [DUA0:[vae]]: ________________________Note ________________________ The device and directory root specified will be the exact location for these files. For this example DUA0 is listed as the device and vae is listed as the directory. Specify your desired device and directory. _____________________________________________________ 2-8 Installing DECvoiceBuilder Production Environment The installation procedure will notify you if the chosen directory contains files. There are already files in that directory * Do you wish to continue? If you enter N then the installation procedure will again ask you where you want to load the DECvoiceBuilder files. If you answer Y then the installation will continue to the following question on purging files. 9. Choosing to purge files You have the option to purge files from previous versions of DECvoiceBuilder Production Environment that are superseded by this installation. If you have existing DECvoiceBuilder Software for OpenVMS VAX files, the installation asks if you want to purge them. Purging is recommended; however, if you need to keep files from the previous version, enter N in response to the question. * Do you want to purge files replaced by this installation [YES]? 10.Choosing file ownership The installation procedure asks you for the User Identification Code (UIC) that will own the DECvoiceBuilder Software for OpenVMS VAX files. The default is the recommended SYSTEM account. * What UIC should own the VAE files [[SYSTEM]]: 11.Installing example programs The installation procedure asks you if you want to install the example program files. The default is yes. * Do you wish to install the example program files? [YES]? ________________________Note ________________________ The example programs contain recorded voice prompts that use 25000 blocks of disk space. _____________________________________________________ Installing DECvoiceBuilder Production Environment 2-9 12.Running the IVP The installation procedure now asks if you want to run the IVP. The IVP checks to be sure that the installation is successful. Digital recommends that you run the IVP. * Do you want to run the IVP after the installation [YES]? 13.Responding to license registration queries The installation procedure displays license information about your product and then asks if you have registered and loaded your authorization keys for DECvoiceBuilder Production Environment. For example: Product: DVBUILDER-ADMIN Producer: DEC Version: V1.1 Release Date: 15-DEC-1993 * Does this product have authorization keys registered and loaded? If you have not registered and loaded your authoriza- tion keys, you must answer No to this question. (A No answer continues the installation, but does not run the IVP.) You have to register and load your Product Authorization Keys (PAKs) to run the IVP. If you have not done so and you answered Yes to running the IVP, then you should stop the installation with Ctrl/Y. Next, you must register and load your PAKs, and then restart the installation. 2.5.3 Reading Informational Messages At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. (See the sample installation in Appendix A.) There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL begins moving files to their target directories. VMSINSTAL continues to move files to their target directories, updates the help files, and updates DCL tables, if necessary. If you chose to purge files, that work is done now. The following message is displayed: 2-10 Installing DECvoiceBuilder Production Environment %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... DECvoiceBuilder Production Environment creates the following logical names: o VAE$DEPLOYMENT_DATA o VAE$DEPLOYMENT_DIRECTORY o VAE$DEPLOYMENT_ROOT o VAE$DEVELOP_ROOT o VAE$DEVELOPMENT_DATA o VAE$DEVELOPMENT_DIRECTORY o VAE$DEVELOPMENT_ROOT o VAE$DIRECTORY o VAE$ROOT The installation also creates the VAE$LOGICALS logical name table along with several other logical tables within VAE$LOGICALS. Any modifications or changes to these logical names are not supported. Any modifications and changes may cause problems. 2.5.4 Running the IVP If you chose to run the IVP, VMSINSTAL runs it now. The IVP will check all logical names and installed images. The IVP will also ask you if you would like it to verify that the Application Editor, Recording Studio, and Resource Manager images can be invoked. The following message is displayed for each component before the IVP that component: * Would you like to run this section [no]? If you enter Y, the component will be invoked and you must exit that component to continue the IVP. The IVP cannot exit the component. If you enter something other than Y or press the Carriage Return key, the IVP will skip that component and continue. When the IVP runs successfully, the following message is displayed: VAE011 Installation Verification Procedure completed successfully Installing DECvoiceBuilder Production Environment 2-11 2.5.5 Completing the Installation Procedure The following message indicates that the entire installa- tion procedure is complete: Installation of VAE011 completed at 9:11 VMSINSTAL procedure done at 9:11 You can now log out of the privileged account: $ LOGOUT SYSTEM logged out at 19-NOV-1993 9:11:22.01 VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again. 2.6 Recovering from Errors If errors occur during the installation itself or when the IVP is running, VMSINSTAL displays failure messages. If the installation fails, you see the following message: %VMSINSTAL-E-INSFAIL, The Installation of VAE011 has failed. If the IVP fails, you see these messages: The VAE011 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for VAE011 has failed. Errors can occur during the installation if any of the following conditions exist: o Operating system version is incorrect. o Prerequisite software version is incorrect. o Quotas necessary for successful installation are insufficient. For descriptions of the error messages generated by these conditions, see the OpenVMS documentation on system messages, recovery procedures, and OpenVMS software installation. If you are notified that any of these conditions exist, take the appropriate action as described in the message (to change a system parameter or 2-12 Installing DECvoiceBuilder Production Environment increase an authorized quota value). For information on installation requirements, see Chapter 1. Installing DECvoiceBuilder Production Environment 2-13 3 ________________________________________________________________ After Installing DECvoiceBuilder Production Environment This chapter explains the tasks you must perform after installing DECvoiceBuilder Production Environment. These tasks include the following: o Running the IVP after the installation o Setting user account requirements o Reporting problems 3.1 Running the IVP After Installation The IVP verifies the installation. After DECvoiceBuilder Production Environment is installed, you can run the IVP independently to verify that the software is available on your system. You also run the IVP after a system failure to be sure that users can access DECvoiceBuilder Production Environment. To run the IVP after installation, enter the following command at the DCL prompt: $ @SYSTEST:VAE$IVP 3.2 Setting User Account Requirements To work with DECvoiceBuilder Production Environment, user accounts on your system must have certain privileges and quotas. The Resource Manager component of the DECvoiceBuilder Administrator must have access privileges to the files created during installation. The Resource Manager or Application Manager must run from the same User Identification Code (UIC) or the same group as the owner After Installing DECvoiceBuilder Production Environment 3-1 of the files created during the installation or run from an account with either the BYPASS or SYSPRV privilege. The Resource Manager is used to generate the site- specific DECvoice startup and shutdown procedures. While the DECvoiceBuilder Resource Manager does not require privileges, the site-specific startup must be executed from a privileged account and requires the following privileges: o ALTPRI o CMEXEC o CMKRNL o DETACH o PHY_IO o SHARE o SYSNAM o SYSPRV Additional privileges such as PRMGBL and SYSGBL are required by startup to load DECvoice messages into global memory. The Application Manager component requires the following privileges: o DETACH o GROUP o GRPPRV o TMPMBX o PRMMBX o SYSNAM (If not run from the same UIC) o SYSPRV (If not run from the same UIC) o WORLD PRCLM must be at least 10. See the DECvoice Software for VMS Installation Guide for information on other process account quotas. 3-2 After Installing DECvoiceBuilder Production Environment 3.3 Determining and Reporting Problems If an error occurs while DECvoiceBuilder Production Environment is being used and you believe the error is caused by a problem with DECvoiceBuilder Production Environment, do one of the following: o Call Digital if your software contract or warranty agreement entitles you to telephone support. o Contact your account representative. o If you purchased DECvoiceBuilder Production Environment within the past 90 days and you think the problem is caused by a software error, contact your account representative. o If you find an error in the DECvoiceBuilder Production Environment documentation, fill out and submit the Reader's Comments form. The forms are at the back of each manual. Be sure to use the form from the manual in which you found the error. Also, please include the section and page number. After Installing DECvoiceBuilder Production Environment 3-3 A ________________________________________________________________ Sample Installation This appendix contains a sample installation of DECvoiceBuilder Production Environment. The sample installation assumes that DECnet software has been shut down, that no users are logged in to your system, and that OPTIONS N is specified. The Installation Verification Procedure (IVP) runs at the end of the installation. Username:SYSTEM Password: Last interactive login on Friday, 19-Nov-1993 17:30 Last non-interactive login on Thursday, 19-NOV-1993 17:09 $ @sys$update:vmsinstal VAX/VMS Software Product Installation Procedure V5.5-1 It is 19-NOV-1993 at 17:36. Enter a question mark (?) at any time for help. * Do you want to continue anyway [NO]? Yes * Are you satisfied with the backup of your system disk [YES]?Yes * Where will the distribution volumes be mounted:MUA0: Enter the products to be processed from the first distribution volume set. Products:VAE011 * Enter installation options you wish to use (none):N The following products will be processed: VAE V1.1 Beginning installation of VAE V1.1 at 22:14 Sample Installation A-1 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. ***************************************************** * <<<<<<<<<<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>>>>>>>>>>> * ***************************************************** * * * DECvoiceBuilder Application Production * * Environment for OpenVMS, Version 1.1 * * * * Installation Procedure * * * * * * Copyright (C) 1993, Digital Equipment Corporation * * * ***************************************************** * <<<<<<<<<<<<<<<<<<<<<<<<>>>>>>>>>>>>>>>>>>>>>>>>> * ***************************************************** * Is this a runtime only system [NO]?NO * Where do you wish to load the DECvoiceBuilder files? [D0$DIA0:[VAE]]: * What UIC should own the VAE files [[SYSTEM]]: * Do you wish to install the example program files? [YES] * Do you want to run the IVP after the installation [YES]? * Checking authorization keys ... Product: DVBUILDER-RT Producer: DEC Version: 1.1 Release Date: 15-DEC-1993 * Does this product have an authorization key registered and loaded?YES Product: DVBUILDER-ADMIN Producer: DEC Version: 1.1 Release Date: 15-DEC-1993 * Does this product have an authorization key registered and loaded?YES Product: DVBUILDER-STUDIO Producer: DEC Version: 1.1 Release Date: 15-DEC-1993 A-2 Sample Installation * Does this product have an authorization key registered and loaded?YES Product: DVBUILDER-EDITOR Producer: DEC Version: 1.1 Release Date: 15-DEC-1993 * Does this product have an authorization key registered and loaded?YES ********************************************************** All questions regarding the installation have now been asked. The amount of time to complete the installation differs depending on the type of hardware used during the installation. The installation will continue for 25 to 40 minutes. *********************************************************** Checking pre-requisite software... This product requires the following ... DECvoice Software (Minimum Version V2.2) for VMS VAXC (Minimum Version V3.2) DECwindows/Motif (Minimum Version V1.1) Checking optional software ... This product may use the following optional software: Rdb/SQL (Minimum Version V4.1) DECfax (Minimum Version V1.1) RDB software must be installed before this installation. DECfax software may be installed at any time. Checking disk space on system disk ... Checking disk space on target disk ... %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... Creating directories ... Linking DECvoiceBuilder's images ... Runtime images... Resource manager images... Application manager image... Sample Installation A-3 Statistics images... Application Editor image... Recording Studio images... Updating the startup file ... During this installation, a file will be copied to the SYS$STARTUP: directory. The following line should be added to your site specific startup: @SYS$STARTUP:VAE$STARTUP.COM Setting protections on files ... Preparing to move files to their target directories ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... %DCL-I-TABEXIST, VAE$LOGICALS already exists - not superseded %RUN-S-PROC_ID, identification of created process is 00000535 VAE V1.1 IVP Copyright (C) 1993, Digital Equipment Corporation Running VAE V1.1 IVP ... Checking logical names Checking installed images SYS$COMMON:[SYSLIB]VAE$RTL.EXE;79 VAE V1.1-001 SYS$COMMON:[SYSMSG]VAE$MSG.EXE;13 VAE V1.1-001 SYS$COMMON:[SYSLIB]VAE$RTL_TEXT.EXE;107 VAE V1.1-001 SYS$COMMON:[SYSLIB]VAE$DIVA$LIB_SHR.EXE; VAE V1.1-001 SYS$COMMON:[SYSLIB]VAE$DGIT$LIBSHR.EXE;1 DW V1.1-920519 SYS$COMMON:[SYSLIB]VAE$DIVA$WGT_SHR.EXE; VAE V1.1-001 SYS$COMMON:[SYSMSG]VAE$DIVA$LIB_MSG.EXE; DIVA V1.00 SYS$COMMON:[SYSLIB]VAE$DGIT$LIBSHR.EXE;1 DW V1.1-920519 Checking required files SYS$COMMON:[SYSEXE]VAE$RM.EXE;10 VAE V1.1-001 SYS$COMMON:[SYSEXE]VAE$AM.EXE;10 VAE V1.1-001 SYS$COMMON:[SYSEXE]VAE$STAT.EXE;10 VAE V1.1-001 SYS$COMMON:[SYSEXE]VAE$EDITOR.EXE;11 VAE V1.1-001 SYS$COMMON:[SYSEXE]VAE$STUDIO.EXE;10 VAE V1.1-001 A-4 Sample Installation --------------------------------------------------------------------------- This section of the DECvoiceBuilder IVP will verify that the Resource Manager, Application Editor, and Recording Studio images can be invoked. --------------------------------------------------------------------------- * Would you like to run this section [no]?Y --------------------------------------------------------------------------- DECvoiceBuilder IVP will now invoke the Resource Manager. The IVP will continue once the Resource Manager has exited. Please use the EXIT item in the FILE menu when you are ready to continue. --------------------------------------------------------------------------- Press Return to continue: $ run sys$system:vae$rm DECvoiceBuilder [TM] Adminstrator Resource Manager COPYRIGHT (C) DIGITAL EQUIPMENT CORPORATION, 1993 DECvoiceBuilder ADMINISTRATOR RESOURCE MANAGER File Configure Databases Tables Utilities Exit ????????????????????????????????????????????????????????????????????????? A display device must be defined (using the SET DISPLAY command) to test the Application Editor and the Recording Studio. Please enter the node name of the workstation on which to display this portion of IVP. The workstation DECnet address must be known by NCP on this node, and you must have used the security options to allow this system to create windows on the workstation. Press carriage return without entering a name to skip the Application Editor and Recording Studio tests. The entire IVP may be rerun later (once requirements are met) by running "@SYS$TEST:VAE$IVP". ????????????????????????????????????????????????????????????????????????? Sample Installation A-5 * Enter node name (return to skip): ACCELL DECvoiceBuilder IVP will now invoke the Application Editor. The IVP will continue once the Editor has exited. Please use the EXIT item in the FILE menu when you are ready to continue. --------------------------------------------------------------------------- Press Return to continue: $ run sys$system:vae$editor --------------------------------------------------------------------------- DECvoiceBuilder IVP will now invoke the Recording Studio. The IVP will continue once the Studio has exited. Please use the QUIT item in the FILE menu when you are ready to continue. --------------------------------------------------------------------------- Press Return to continue: $ @vae$development_directory:vae$studio What's your telephone number?1234567 Phone number defined in job logical VAE$DEFAULT_PHONE_NUM --------------------------------------------------------------------------- VAE V1.1 Installation Verification Procedure Completed Installation of VAE V1.1 completed at 17:48 Enter the products to be processed from the next distribution volume set. * Products: exit VMSINSTAL procedure done at 17:48 $LOGOUT SYSTEM logged out at 19-NOV-1993 17:52:15.16 A-6 Sample Installation B ________________________________________________________________ Files and Directories Installed on Your System The DECvoiceBuilder Production Environment installation procedure installs a number of files and directories on your system. The following list contains the names of all files and directories installed on your system when DECvoiceBuilder Production Environment is installed. Files DECW$BOOK:DECVOICEBUILDER_ADMIN_BOOK.DECW$BOOK DECW$BOOK:VAE$LIBRARY.DECW$BOOKSHELF DECW$BOOK:DECVOICEBUILDER_EDITOR_HELP.DECW$BOOK DECW$BOOK:DECVOICEBUILDER_STUDIO_HELP.DECW$BOOK DECW$SYSTEM_DEFAULTS:VAE$EDITOR_TOP.UID DECW$SYSTEM_DEFAULTS:VAE$EDITOR_ICONS.UID DECW$SYSTEM_DEFAULTS:VAE$EDITOR_POPUPS.UID DECW$SYSTEM_DEFAULTS:VAE$STUDIO_UI.UID DECW$SYSTEM_DEFAULTS:VAE$DIVA$WGT_UI.UID DECW$SYSTEM_DEFAULTS:VAE$EDITOR_ICONS_BW.UID DECW$SYSTEM_DEFAULTS:VAE$EDITOR_ICONS_GRAY.UID DECW$SYSTEM_DEFAULTS:VAE$STUDIO.DAT DECW$SYSTEM_DEFAULTS:VAE$STUDIO_ICONS.UID DECW$SYSTEM_DEFAULTS:VAE$STUDIO_ICONS_BW.UID The following files, which are prefaced with SYS$EXAMPLES, are installed only if the example applications are installed. SYS$EXAMPLES:VAE$APPLICATION_DEMO.BCK SYS$EXAMPLES:VAE$NORTH_THEATRE_SCHEDULE.BCK SYS$EXAMPLES:VAE$SOUTH_THEATRE_SCHEDULE.BCK SYS$EXAMPLES:VAE$THEATRE_INFORMATION_LINE.BCK SYS$EXAMPLES:VAE$MOTOR_VEHICLES.BCK SYS$EXAMPLES:VAE$FINANCE_AND_BANKING.BCK Files and Directories Installed on Your System B-1 SYS$EXAMPLES:VAE$EDUCATION.BCK SYS$EXAMPLES:VAE$DIRECTORY_SERVICES.BCK SYS$EXAMPLES:VAE$DNIS.BCK SYS$HELP:VAE$STUDIO_CONN_HELP.HLB SYS$HELP:VAE011.RELEASE_NOTES SYS$LIBRARY:VAE$MSG.H SYS$LIBRARY:VAE$DEF.H SYS$LOADABLE_IMAGES:VAE$SODRIVER.EXE SYS$TEST:VAE$IVP.COM SYS$MESSAGE:VAE$MSG.EXE SYS$MESSAGE:VAE$DIVA$LIB_MSG.EXE SYS$SHARE:VAE$RTL.EXE SYS$SHARE:VAE$RTL_TEXT.EXE SYS$SHARE:VAE$DIVA$LIB_SHR.EXE SYS$SHARE:VAE$DIVA$WGT_SHR.EXE SYS$SHARE:VAE$RDB_SHR.EXE SYS$SHARE:VAE$DGIT$LIBSHR.EXE SYS$SYSTEM:VAE$RM.EXE SYS$SYSTEM:VAE$RM_CONFIG.EXE SYS$SYSTEM:VAE$AM.EXE SYS$SYSTEM:VAE$STAT.EXE SYS$SYSTEM:VAE$STAT_REPORT.EXE SYS$SYSTEM:VAE$STUDIO.EXE SYS$SYSTEM:VAE$EDITOR.EXE SYS$SYSTEM:VAE$STUDIO_CONN.EXE SYS$SYSTEM:VAE$LOAD_RECOGNIZER.EXE SYS$SYSTEM:VAE$RM_VERIFY.EXE VAE$DEVELOPMENT_DIRECTORY:VAE$STUDIO.COM VAE$DEVELOPMENT_DIRECTORY:VAE$DELETE_APPLICATION.COM VAE$DEPLOYMENT_DIRECTORY:VAE$BACKUP_APPLICATIONS.COM VAE$DEPLOYMENT_DIRECTORY:VAE$BACKUP_DEPLOYMENT.COM VAE$DEPLOYMENT_DIRECTORY:VAE$COPY_APP_PROMPT.COM VAE$DEPLOYMENT_DIRECTORY:VAE$COPY_CONFIG.COM VAE$DEPLOYMENT_DIRECTORY:VAE$COPY_PROMPT_ONLY.COM VAE$DEPLOYMENT_DIRECTORY:VAE$RESTORE_APPLICATIONS.COM B-2 Files and Directories Installed on Your System VAE$DEPLOYMENT_DIRECTORY:VAE$RESTORE_DEPLOYMENT.COM VAE$DEPLOYMENT_DIRECTORY:VAE$RESTORE_EXAMPLES.COM VAE$DEPLOYMENT_DIRECTORY:VAE$RM_PROCEDURES.DAT VAE$DEPLOYMENT_DIRECTORY:VAE$BUILD_STARTUP.COM VAE$DEPLOYMENT_DIRECTORY:VAE$INSTALL_STARTUP.COM VAE$DEPLOYMENT_DIRECTORY:VAE$REPORT.COM VAE$DEPLOYMENT_DIRECTORY:VAE$START_APPL.COM VAE$DEPLOYMENT_DIRECTORY:VAE$STOP_APPL.COM VAE$DEPLOYMENT_DIRECTORY:VAE$VERIFY_CONFIG.COM VAE$DEPLOYMENT_DIRECTORY:VAE$BACKUP_APP_FUNC.COM VAE$DEPLOYMENT_DIRECTORY:VAE$KILL_DECVOICE_APPLICATIONS.COM VAE$DEPLOYMENT_DIRECTORY:VAE$COPY_APP_FUNC.COM VUE$LIBRARY:VAE$EDITOR$VUE.COM VUE$LIBRARY:VAE$STUDIO$VUE.COM VUE$LIBRARY:VAE$ADMIN$VUE.COM VUE$LIBRARY:VAESMS$PROFILE.VUE$DAT VUE$LIBRARY:VAE$AM$VUE.COM VUE$LIBRARY:VAE$RM$VUE.COM SYS$STARTUP:VAE$STARTUP.COM SYS$STARTUP:VAE$SHUTDOWN.COM Directories The following directories are created by the installation. The device (dev) and directory root (dir_root) is user- specified during the installation. dev:[dir_root] dev:[dir_root.DEPLOYMENT] dev:[dir_root.DEVELOPMENT] The subdirectories created are subdirectories of either the [dir_root.DEPLOYMENT] or [dir_root.DEVELOPMENT] subdirectories. The following list contains subdirectories of [dir_ root.DEPLOYMENT]. For example, dev:[$GLOBAL] is dev:[dir_ root.DEPLOYMENT.$GLOBAL]. dev:[$GLOBAL] dev:[$GLOBAL.DATA] dev:[$GLOBAL.DATA.VAE$CAB0] Files and Directories Installed on Your System B-3 dev:[$GLOBAL.DATA.VAE$CAB1] dev:[$GLOBAL.DATA.VAE$CAB2] dev:[$GLOBAL.DATA.VAE$CAB3] dev:[$GLOBAL.DATA.VAE$CAB4] dev:[$GLOBAL.DATA.VAE$CAB5] dev:[$GLOBAL.DATA.VAE$CAB6] dev:[$GLOBAL.DATA.VAE$CAB7] dev:[$GLOBAL.DATA.VAE$CAB8] dev:[$GLOBAL.DATA.VAE$CAB9] dev:[$GLOBAL.DATA.VAE$DEFAULT] dev:[$GLOBAL.DATA.VAE$DEFAULT.VAE$DEFAULT] dev:[$GLOBAL.DATA.VAE$DEFAULT.VAE$READ] dev:[$GLOBAL.DATA.VAE$DEFAULT.VAE$UNREAD] dev:[$GLOBAL.EXE] dev:[$GLOBAL.PROMPTS] dev:[$GLOBAL.STATISTICS] dev:[$GLOBAL.STATISTICS]VAE$STAT$SYSERR.LOG dev:[$GLOBAL.STATISTICS]VAE$STAT$SYSOUT.LOG The following list contains subdirectories of [dir_ root.DEVELOPMENT]. For example, dev:[$GLOBAL] is dev:[dir_ root.DEVELOPMENT.$GLOBAL]. dev:[$GLOBAL] dev:[$GLOBAL.DATA] dev:[$GLOBAL.DATA.VAE$CAB0] dev:[$GLOBAL.DATA.VAE$CAB1] dev:[$GLOBAL.DATA.VAE$CAB2] dev:[$GLOBAL.DATA.VAE$CAB3] dev:[$GLOBAL.DATA.VAE$CAB4] dev:[$GLOBAL.DATA.VAE$CAB5] dev:[$GLOBAL.DATA.VAE$CAB6] dev:[$GLOBAL.DATA.VAE$CAB7] dev:[$GLOBAL.DATA.VAE$CAB8] dev:[$GLOBAL.DATA.VAE$CAB9] dev:[$GLOBAL.DATA.VAE$DEFAULT] dev:[$GLOBAL.DATA.VAE$DEFAULT.VAE$DEFAULT] dev:[$GLOBAL.DATA.VAE$DEFAULT.VAE$READ] dev:[$GLOBAL.DATA.VAE$DEFAULT.VAE$UNREAD] dev:[$GLOBAL.EXE] dev:[$GLOBAL.PROMPTS] dev:[$GLOBAL.STATISTICS] Global Prompt Files B-4 Files and Directories Installed on Your System The following directories and prompt files are created by the installation. dev:[dir_root.DEPLOYMENT.$GLOBAL.PROMPTS]$global.tlb dev:[dir_root.DEVELOPMENT.$GLOBAL.PROMPTS]$global.tlb Files and Directories Installed on Your System B-5