TeMIP_for_DIGITAL_UNIX Expert System Access _________________________ Installation Guide Order Number: AA-RDM1A-TE This guide describes how to install the TeMIP Expert System Access on your DIGITAL UNIX system. Revision/Update Information: V1.0.0 This is a new manual. Operating System: DIGITAL UNIX Software Version: TeMIP V3.2, ESA V1.0 ________________________________________________________________ July 1998 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used and copied only in accordance with the terms of such license. Digital Equipment Corporation assumes no responsibility for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. This document defines the management and service interfaces provided by this Management Module and, if applicable, the services that this module requires of other TeMIP Framework Management Modules. It is provided to ensure that new Management Modules developed for the TeMIP Framework system will work in concert with this TeMIP Framework module or module package. It is not intended to be used as an aid in cloning or duplicating the functionality or service interfaces described and such use is expressly forbidden. Except as may be expressly agreed upon by Digital in writing, the purchase, receipt, or any use of this document or its contents does not in any way create, by implication or otherwise, any express or implied license under any of Digital Equipment Corporation's patent, trademark, copyright or trade secret rights for the ideas, techniques, or concepts herein. © Digital Equipment Corporation 1997, 1998. All rights reserved. Printed in Europe. Trademarks: Alpha AXP, AXP, AlphaServer, AlphaStation, AlphaGeneration and the AlphaGeneration design mark, TeMIP, TeMIP Framework, DECcmi, DECnet, DECnet-Plus, DECsafe, DECterm, DECwindows, TruCluster, ULTRIX and the DIGITAL Logo are trademarks of Digital Equipment Corporation. C-ISAM is a registered trademark of Informix Software, Inc. INGRES is a registered trademark of Ingres Corporation. Motif is a registered trademark of Open Software Foundation, Inc. ORACLE, SQL*Net and SQL*Plus are registered trademarks of Oracle corporation. OSF/1 is a registered trademark of Open Software Foundation, Inc. OSIAM is a trademark of MARBEN Produit. Rogue Wave and h++ are registered trademarks and Tools.h++ is a trademark of Rogue Wave Software, Inc. Solaris is a registered trademark of Sun Microsystems, Inc. SQL Server is a trademark of Sybase, Inc. Sun is a registered trademark of Sun Microsystems, Inc. SunLink is a registered trademark of Sun Microsystems, Inc. SunOS is a registered trademark of Sun Microsystems, Inc. SYBASE is a registered trademark of Sybase, Inc. Transact-SQL is a registered trademark of Sybase, Inc. X/Open is a trademark of X/Open Company, Ltd. UNIX[R] - UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. DIGITAL UNIX V3.2 is an X/Open UNIX 93 branded product. DIGITAL UNIX V4.0 is a UNIX 95 branded product. This document is available on CD-ROM. This document was prepared using VAX DOCUMENT, Version 2.1. ________________________________________________________________ Contents ................................................... v Preparing to Install the TeMIP Expert System Access 1.1 Types of Installation............................ 1-1 1.1.1 Local Installation ............................ 1-1 1.1.2 RIS Installation .............................. 1-1 1.2 Installation Requirements........................ 1-1 1.2.1 Hardware and Software ......................... 1-2 1.2.2 Distribution Kit .............................. 1-2 1.2.3 Time Required to Install ...................... 1-2 1.2.4 Logging On .................................... 1-2 1.2.5 Backing Up the System Disk .................... 1-3 1.2.6 Checking the Required Software Subsets ........ 1-3 1.2.7 Disk Space Requirements ....................... 1-3 1.2.8 Using the Director User Account ............... 1-5 1.3 Aborting Installation and Recovering from Errors........................................... 1-5 License Management Using FLEXlm 2.1 FLEXlm Policies.................................. 2-1 2.1.1 Floating Licenses as Opposed to Locked Licenses....................................... 2-1 2.1.2 Redundant Servers as Opposed to a Single Server......................................... 2-1 2.2 Registering Your License......................... 2-2 2.3 TeMIP License Files.............................. 2-2 2.3.1 The SERVER Line in the TeMIP License File ..... 2-2 2.3.2 The DAEMON Line in the TeMIP License File ..... 2-2 2.3.3 The INCREMENT Lines in the TeMIP License File........................................... 2-2 2.4 Updating the License File Information............ 2-3 2.5 Prerequisites for TeMIP Installation............. 2-3 2.6 FLEXlm Server Daemon Start-up and Shutdown....... 2-3 2.7 Checking Your License File....................... 2-4 Installing the TeMIP Expert System Access 3.1 Starting the Installation Procedure Locally...... 3-2 3.2 Starting the Installation Procedure from a RIS Server........................................... 3-2 3.3 System Configuration............................. 3-2 3.4 Installation Verification Procedure.............. 3-2 3.5 Local Installation of the ESA Runtime System..... 3-2 3.6 Local Installation of the ESA Developer's Toolkit.......................................... 3-4 iii 3.7 Local Installation of the ESA HTML Documentation.................................... 3-7 3.8 RIS Server Update................................ 3-8 4 Post-Installation of the TeMIP Expert System Access 4.1 Verifying the ESA Runtime System Installation.... 4-1 4.2 Verifying the ESA Developer's Toolkit Installation..................................... 4-1 4.3 Verifying the ESA HTML Documentation Installation..................................... 4-2 4.4 Deleting the TeMIP Expert System Access from your System........................................... 4-2 A Pre-Installation Checklist A.1 Local Installation............................... A-1 A.2 Installation on a RIS Server..................... A-2 A.3 Installation from a RIS Server................... A-2 B Files Installed on your System B.1 ESA Runtime System Installation Directories...... B-1 B.2 ESA Developer's Toolkit Installation Directories...................................... B-1 B.3 ESA HTML Documentation Installation Directories.. B-3 C Recovering from Errors C.1 Failures During Product Installation ............ C-1 C.2 Failures During Product Use...................... C-2 Index Tables 1-1 Disk Space Requirements ....................... 1-4 B-1 Directory /usr/mcc/esa/lib .................... B-1 B-2 Directory /usr/mcc/esa/include ................ B-1 B-3 Directory /usr/mcc/esa/cust ................... B-2 B-4 Directory /usr/mcc/esa/example ................ B-3 B-5 Directory /usr/mcc/temip_doc_html/esadoc ...... B-4 B-6 Directory /usr/mcc/temip_doc_html/esadoc/esadvt.......... B-4 B-7 Directory /usr/mcc/temip_doc_html/esadoc/esaref.......... B-5 B-8 Directory /usr/mcc/temip_doc_html/esadoc/esaig........... B-5 iv _________________________________________________________________ Preface This guide describes how to install the TeMIP Expert System Access software on a DIGITAL UNIX[R] system. + Intended Audience This guide is intended for personnel who are responsible for installing the TeMIP Expert System Access(ESA), for example: o A system manager installing TeMIP Expert System Access on a local system o A system manager installing TeMIP Expert System Access from the Remote Installation Services (RIS) server area of a remote system o A RIS manager installing the TeMIP Expert System Access on a RIS server area. It is assumed that the reader has an understanding of the shell concept of UNIX and is familiar with the use of peripheral devices. Structure of This Guide The guide is structured as follows: o Chapter 1 describes the requirements for installing the TeMIP Expert System Access software. o Chapter 2 discusses license management and tells you how to install your license file. o Chapter 3 describes the installation of the TeMIP Expert System Access software locally, and on a RIS server area. o Chapter 4 describes how to configure the system, verify the installation, and delete installed subsets. o Appendix A provides a check list of pre-installation requirements. o Appendix B provides a list of the TeMIP Expert System Access files installed. o Appendix C provides information to help deal with failure or errors that might occur during installation. ____________________ + UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. v Document Conventions The following conventions are used in this guide: ___________________________________________________________ Convention_______Meaning___________________________________ # The UNIX superuser default prompt. Ctrl/x Indicates that you must hold down the key labelled Ctrl while you press another key or a pointing device button. In examples and procedures, a key combination is enclosed in a box. Indicates that you press the Return key to execute a command line. Boldface Indicates the first use of a term, and user input in examples. Italics Italic text is used to indicate the following: o The title of a document to which reference is made. o The directory paths and file names in text. ___________________________________________________________ Associated Documents o TeMIP Planning Guide o TeMIP Director Configuration and Management Guide o TeMIP for DIGITAL UNIX Installation Guide o DIGITAL UNIX Guide to Remote Installation Services vi 1 _________________________________________________________________ Preparing to Install the TeMIP Expert System Access This chapter describes the requirements and preparation necessary for installing the TeMIP Expert System Access. The installation procedures described in this guide apply only to TeMIP Expert System Access V1.0.0. Release Notes are provided with the installation kit and DIGITAL strongly recommends that you read these notes before proceeding with the installation. You can find more information in: o Types of Installation, Section 1.1 o Installation Requirements, Section 1.2 o Aborting Installation and Recovering from Errors, Section 1.3 1.1 Types of Installation Installation can be performed locally, or on a Remote Installation Services (RIS) server. The procedure for each type of installation is fully described in Chapter 3. 1.1.1 Local Installation The TeMIP Expert System Access can be installed directly on your local system. 1.1.2 RIS Installation The TeMIP Expert System Access can also be installed from a RIS server area of a remote system. If you intend to install the TeMIP Expert System Access on your system in this way, ensure the following: o A TeMIP Expert System Access is installed on the RIS server. o You know the name of the RIS server. o Your system is registered as a RIS client. For further details, refer to the DIGITAL UNIX Guide to Remote Installation Services. 1.2 Installation Requirements The installation requirements for the TeMIP Expert System Access are described in Section 1.2.1 to Section 1.2.8 and a checklist is provided in Appendix A. Preparing to Install the TeMIP Expert System Access 1-1 1.2.1 Hardware and Software The minimum hardware and software requirements for the installation of the TeMIP Expert System Access are as follows: Hardware The TeMIP Expert System Access can be installed on any AlphaGeneration machine running DIGITAL UNIX. Software To install the TeMIP Expert System Access you require the DIGITAL UNIX V4.0 operating system, along with its Software Development Utilities and Internationalization Development Environment. TeMIP Version 3.2 and, if the ESA Developer's Toolkit subset is to be installed, the Visual TeMIP C++ Developer's Toolkit should also be installed. 1.2.2 Distribution Kit Make sure that you have the correct distribution kit and check the contents against the Bill Of Materials (BOM). If any part of the kit is missing, contact your DIGITAL representative. The TeMIP Expert System Access can be installed from the CD-ROM bearing the label TeMIP Expert System Access supplied in the kit. Your distribution kit contains the following software subsets: o ESA Runtime System (ESARTV100) o ESA Developer's Toolkit (ESADKV100) o ESA HTML Documentation (ESADOCV100) 1.2.3 Time Required to Install Local installation of TeMIP Expert System Access takes approximately 5 minutes, depending on the system configuration. The Installation Verification Procedure (IVP) takes only an additional few seconds. Installation from a RIS server should take about the same time as a local installation, depending on the amount of traffic in the network. 1.2.4 Logging On You must have superuser privileges to install the TeMIP Expert System Access software and to register the license. You can set the current working directory to the top level (or root) directory using the following command: # cd / 1-2 Preparing to Install the TeMIP Expert System Access 1.2.5 Backing Up the System Disk DIGITAL strongly recommends that you back up your complete system disk or at least the /var and /usr partitions. Installation of the TeMIP Expert System Access involves writing to these partitions. ________________________ Note ________________________ On DIGITAL UNIX, the /var partition is located at /usr/var. ______________________________________________________ 1.2.6 Checking the Required Software Subsets You require at least the following DIGITAL UNIX V4.0 and TeMIP Framework software subsets: o OSFBASE425, DIGITAL UNIX Base System Software o OSFX11425, Basic X Environment (Windowing Environment) o TFRBASEV320, TeMIP Framework Basic Management System o TFRTFCV320, Visual TeMIP C++ Developer's Toolkit (if you intend installing ESADKV100). To find the following information: o The additional required DIGITAL UNIX subsets and patches o The required DECnet-Plus+ subsets. refer to the TeMIP for DIGITAL UNIX Installation Guide, TeMIP Director Configuration and Management Guide and DECcmi for DIGITAL UNIX Installation and Configuration Guide. To check that these subsets are present enter the following commands: # /etc/setld -i | grep OSF # /etc/setld -i | grep TFR The subsets installed are displayed along with any related patch names as shown in the example below: TFRBASEV320 installed TeMIP Framework Basic Management System (patch x) If a subset is not present, the word installed is not displayed. 1.2.7 Disk Space Requirements The different TeMIP Expert System Access software subsets require different amounts of disk space as shown in Table 1-1. The values shown are approximate and may vary from kit to kit. The first set of values represents the disk space required if you copy the subsets to a directory on your disk before installing them, and the second set of values represents the disk space required for direct installation. ____________________ + Formerly known as DECnet/OSI Preparing to Install the TeMIP Expert System Access 1-3 Table_1-1__Disk_Space_Requirements_________________________ Software_Subset___________________Disk_Space_______________ ESA Runtime System for 3,480 KB DIGITAL UNIX ESA Developer's Toolkit for 10,400 KB DIGITAL UNIX ESA HTML Documentation for 560 KB DIGITAL_UNIX_______________________________________________ The installation procedure creates the following directories if they do not already exist: o /usr/mcc/esa o /usr/mcc/esa/cust o /usr/mcc/esa/include o /usr/mcc/esa/lib o /usr/mcc/esa/ivp If an initial installation of the ESA has already been completed and the directory /usr/mcc/esa/cust already exists, its contents are backed up as /usr/mcc/esa/cust.save as part of the next installation. Any subsequent installations of ESA require that you perform the necessary backup procedures. Determine the amount of free disk space on your system as follows: o Using the column in Table 1-1 that applies to your system, total the values for the subsets you intend to load. o Determine the current amount of free space in the directory /usr/kits and /var/kits using the following command: # df -k /usr/kits /var/kits This displays the total space and total free space on the disk partitions in use. An example of the output with AdvFS and a separate fileset mounted on /usr/var is shown below. Filesystem 1024-blocks Used Avail Capacity Mounted on usr_domain#usr 1025424 948458 55344 94% /usr usr_domain#usr1 271848 246704 25144 91% /usr/var ________________________ Note ________________________ The usr_domain#usr fileset is mounted on the /usr directory mount point and the usr_domain#usr1 fileset is mounted on the /usr/var directory mount point with the link /var defined to /usr/var. ______________________________________________________ 1-4 Preparing to Install the TeMIP Expert System Access If there is not enough free disk space to install the TeMIP Expert System Access, you have to increase the disk space available for installation or change the operating system configuration to mount another file system on the /usr/kits or /var/kits directory mount point. Refer to the DIGITAL UNIX System Administration documentation for details of how to increase free disk space and mount file systems. 1.2.8 Using the Director User Account Before installing the TeMIP Expert System Access, TeMIP Framework must be configured using the temip_setup script. This script allows you to specify a Director User Account, which will be used at TeMIP Expert System Access installation time. The Director User Account can have any user_id you want, but it must be a member of the same group as all other users of the TeMIP Expert System Access software. For example, if all users of the TeMIP Expert System Access belong to the group users, then the Director User Account must also be created as a member of the group users. For details of how to create a user account, refer to the DIGITAL UNIX System Administration documentation. ________________________ Note ________________________ If a version of TeMIP is already installed, the Director User Account has already been created. ______________________________________________________ 1.3 Aborting Installation and Recovering from Errors To abort installation at any time press Ctrl/c. If you abort installation, files created up to that point are not deleted. The directories and files created during the TeMIP Expert System Access installation are listed in Appendix B. You can use the following command to delete a partially installed subset: # setld -d Subset_Name where Subset_Name represents the software subset you were installing. If an error occurs during the installation, the system displays an error message. The following list gives possible reasons for errors that can occur during the installation: o The operating system version is incorrect o The prerequisite software version is incorrect o The amount of available disk space is insufficient o No software license was registered. Preparing to Install the TeMIP Expert System Access 1-5 For a description of error messages generated by these conditions and a description of corrective actions, refer to the DIGITAL UNIX Documentation on system messages, recovery procedures, and DIGITAL UNIX software installation. See also Appendix C. 1-6 Preparing to Install the TeMIP Expert System Access 2 _________________________________________________________________ License Management Using FLEXlm This chapter describes license management for TeMIP using FLEXlm. The topics discussed in this chapter include: o Section 2.1, FLEXlm Policies o Section 2.2, Registering Your License o Section 2.3, TeMIP License Files o Section 2.4, Updating the License File Information o Section 2.5, Prerequisites for TeMIP Installation o Section 2.6, FLEXlm Server Daemon Start-up and Shutdown o Section 2.7, Checking Your License File 2.1 FLEXlm Policies The license management for TeMIP uses FLEXlm V5.0, with the following policies: o Floating licenses o Any license server strategy 2.1.1 Floating Licenses as Opposed to Locked Licenses With floating licenses, neither licenses nor license servers are tied to particular systems, that is, they are not locked. The license server(s) can be changed without updating the license keys. Your license keys will be different from those for any other customer because a unique company name is used to generate the key. 2.1.2 Redundant Servers as Opposed to a Single Server You may wish to make use of redundant servers to help ensure the availability of your licenses in the event of a system crash. For example, you could set up three redundant servers to operate as a single logical license server. Then if any two of the three license server machines are up and running, your licenses are available. If you set up redundant servers, you must start the server daemon on each redundant server, see Section 2.6. After you have chosen a set of redundant servers, they must remain as a set. If you add a new license to any one of the set, you must add it to all. License Management Using FLEXlm 2-1 2.2 Registering Your License You can register your TeMIP license either before you install TeMIP or after installation and before you start to use TeMIP, as no license checks are performed during the installation procedure. To register your license, proceed as follows: 1. Fill in the License File Request Form that comes with the kit, to specify the list of TeMIP subsets for which you want a license. 2. License keys are different if generated for redundant servers, and so you must choose the type of server configuration you require and indicate this on the License File Request Form. 3. Send the form back to DIGITAL as directed in the Cover Letter. Digital will send you a license file containing a license key for each subset required. On each machine where TeMIP will be installed, you must copy the license file into the directory /usr/mcc/licenses. 2.3 TeMIP License Files License files for TeMIP have the following template: SERVER system1 ANY 1727 . . . DAEMON temipdec /usr/mcc/licenses/temipdec INCREMENT TEMIP-TFR-CS temipdec 3.000 01-jan-0 5 FFBACD456FFBCD908765 "DEC" where system1 is the host name of the license server. If there are redundant servers, there must be one SERVER line per redundant server. 2.3.1 The SERVER Line in the TeMIP License File You will need to change the server name, shown as system1. The server hostid "ANY" means the server is not tied to a particular system. The port number (shown as 1727) must not be the same as any port number used by another daemon. 2.3.2 The DAEMON Line in the TeMIP License File The DAEMON line must be as shown. The vendor daemon name is "temipdec". The vendor daemon path is /usr/mcc/licenses/temipdec. 2.3.3 The INCREMENT Lines in the TeMIP License File Each INCREMENT line describes a licensed feature, as follows: o The feature name in the template is "TEMIP-TFR-CS"; this depends on the feature. o The vendor daemon is always temipdec. o The feature version is always "3.000". 2-2 License Management Using FLEXlm o The expiration date is usually "01-jan-0", meaning no expiration date. o The license count shown in the template file is 5. This value must correspond to the number of licenses that you have purchased for the feature. The template shows five licenses for the TEMIP-TFR-CS feature. You must not exceed this number when you use TeMIP. If you need additional licenses, contact your DIGITAL representative. o The license key is shown as "FFBA..."; this depends on the company name in the comment field. o The field shown in the template file as "DEC" is the comment field containing your company name. Your license key is dependent on this value. 2.4 Updating the License File Information You may change the license file supplied by DIGITAL, in order to: o Change license server locations (license name in the SERVER line) o Change server port numbers in the SERVER line o Add or remove features (INCREMENT lines) The file must be changed on client systems and on the license server system(s). After changing all license files, advise the vendor daemon on the server system(s) only by entering the command: $ /usr/mcc/licenses/lmreread -c /usr/mcc/licenses/licenses.dat 2.5 Prerequisites for TeMIP Installation To install TeMIP, the directory /usr/mcc/licenses must be present. It contains the following files: o The server daemon o The vendor daemon o A license file ________________________ Note ________________________ The daemons are present on all machines but only activated on the license server system(s). ______________________________________________________ 2.6 FLEXlm Server Daemon Start-up and Shutdown On the license server(s), start the server daemon using the following command: $ /usr/mcc/licenses/lmgrd -c /usr/mcc/licenses/licenses.dat 1>>/dev/null 2>>/dev /null License Management Using FLEXlm 2-3 If you shut a license server down, enter the following command: $ /usr/mcc/licenses/lmdown -c /usr/mcc/licenses/licenses.dat 2.7 Checking Your License File To check a TeMIP license file, use the FLEXlm tool lmstat, as follows: $ /usr/mcc/licenses/lmstat -a -c /usr/mcc/licenses/licenses.dat An example of the output is as follows: $ ./lmstat -a -c licenses.dat lmstat - Copyright (C) 1989-1994 Globetrotter Software, Inc. Flexible License Manager status on Tue 1/20/98 17:36 License server status (License file: licenses.dat): system1: license server UP (MASTER) Vendor daemon status (on system1): temipdec: UP Feature usage info: Users of TEMIP-TFR-CS: (Total of 5 licenses available) Users of TEMIP-NMS-CS: (Total of 5 licenses available) Users of TEMIP-DVT-CS: (Total of 5 licenses available) Users of TEMIP-VISUAL-DVT: (Total of 5 licenses available) Users of TEMIP-ESA-RT-USER: (Total of 5 licenses available) 2-4 License Management Using FLEXlm 3 _________________________________________________________________ Installing the TeMIP Expert System Access This chapter describes how to install the TeMIP Expert System Access software subsets on your local system, or on a RIS server. The RIS installation procedure assumes that you have created a server environment and are ready to install the TeMIP Expert System Access. ________________________ Note ________________________ If a subset is already installed, you must deinstall it before installing a new version, see Section 4.4. ______________________________________________________ You can find more information in: o Starting the Installation Procedure Locally, Section 3.1 o Starting the Installation Procedure from a RIS Server, Section 3.2 o System Configuration, Section 3.3 o Installation Verification Procedure, Section 3.4 o Local Installation of the ESA Runtime System, Section 3.5 o Local Installation of the ESA Developer's Toolkit, Section 3.6 o Local Installation of the ESA HTML Documentation, Section 3.7 o RIS Server Update, Section 3.8. ___________________ Important Note ___________________ Install the subsets either all in one pass, or respecting the following rule: "The ESA Runtime System subset must be installed before the ESA Developer's Toolkit." Notice that installed subsets no longer appear on the installation menu. In this chapter, the installation traces reflect installation of one subset at a time, in the order shown on the menu. ______________________________________________________ Installing the TeMIP Expert System Access 3-1 3.1 Starting the Installation Procedure Locally The way the installation procedure is started depends on the type of installation and the type of media, but in all cases you must load the TeMIP Expert System Access subsets while logged in as superuser. You can start the installation procedure in the following ways: From a System Directory If you are installing the TeMIP Expert System Access from a system directory, enter the following command from the directory in which the files are located: # setld -l . From a CD-ROM If you are installing TeMIP Expert System Access from a CD-ROM, include the device special name of the distribution device where the media is mounted. Enter the following command, replacing N with the logical unit number of the distribution device you are using: # mount -r /dev/rzNc /mnt 3.2 Starting the Installation Procedure from a RIS Server To install the TeMIP Expert System Access subsets that reside in the /var/adm/ris distribution area of a remote system, include the name of the RIS server system where the TeMIP Expert System Access subsets are located. For example, if you are loading the TeMIP Expert System Access subsets from a RIS distribution area on the node bigsys, enter the following command: # setld -l bigsys: 3.3 System Configuration During the installation you are asked if you want to configure your system as part of the procedure, or after the installation is complete. If you choose to configure your system after installation, a message is displayed that tells you how to do this. 3.4 Installation Verification Procedure You are asked if you want to run Installation Verification Procedures (IVPs) as part of the installation procedure or after installation is complete. You are asked this question for each of the ESA subsets. If you choose to run an IVP after installation, a message is displayed that tells you how to do this. For further details refer to Section 4.1. 3.5 Local Installation of the ESA Runtime System The ESA Runtime System contains the ESA include files (.hxx) and the shared library files (.so). Install the ESA Runtime System as follows: 1. Start the installation procedure and select the ESA Runtime System option from the menu: 3-2 Installing the TeMIP Expert System Access The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) TeMIP ESA Developer Toolkit (level 1 rev A) 2) TeMIP ESA HTML Documentation (level 1 rev A) 3) TeMIP ESA Runtime system (level 1 rev A) Or you may choose one of the following options: 4) ALL of the above 5) CANCEL selections and redisplay menus 6) EXIT without installing any subsets Press RETURN to display the next screen: 3 Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 3 2. Enter 3 and press . The installation procedure displays the subset(s) you have chosen and asks you to confirm your choice: You are installing the following optional subsets: TeMIP ESA Runtime system (level 1 rev A) Is this correct? (y/n): y 3. If the information is correct, enter y and press , otherwise enter n, press and re- enter your choice. The procedure displays the result of a file system space check and copyright information before proceeding to install the subset. Checking file system space required to install selected subsets: File system space checked OK. 1 subset(s) will be installed. Loading 1 of 1 subset(s).... Copyright (c) Digital Equipment Corporation, 1998. All Rights Reserved. Unpublished rights reserved under the copyright laws of the United States. The software contained on this media is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of the software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation. RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, as applicable. TeMIP Expert System Access will use the acloc user account with the following characteristics: acloc user id : 413 acloc group : users Installing the TeMIP Expert System Access 3-3 Note that TeMIP Expert System Access users should belong to the users group in order to use the product. Refer to the TeMIP Installation Guide for more information. TeMIP ESA Runtime system (level 1 rev A) Copying from . (disk) Verifying 1 of 1 subset(s) installed successfully. Configuring "TeMIP ESA Runtime system (level 1 rev A)" (ESARTV100) Removing old definition of ESA_PM Loading new definition of ESA_PM Building parse table Enrolling temip_esa_pm application name esa_pm Creating application esa_pm ... Would you like to run the ESARTV100 IVP? (y/n) y The procedure above installs: o the ieg_adapter.hxx and ieg_provider.hxx header files in the /usr/mcc/esa/include directory, which includes links to the /usr/include software. o the libieg.so files in the /usr/mcc/esa/lib directory, which includes software links to the /usr/shlib directory. 3.6 Local Installation of the ESA Developer's Toolkit The ESA Developer's Toolkit subset contains the code stubs that are required for customizing the ESA PM and the associated Makefile. Install the ESA Developer's Toolkit as follows: 1. Start the installation procedure and choose the ESA Developer's Toolkit option from the menu: The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) TeMIP ESA Developer Toolkit (level 1 rev A) 2) TeMIP ESA HTML Documentation (level 1 rev A) Or you may choose one of the following options: 3) ALL of the above 4) CANCEL selections and redisplay menus 5) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 1 2. Enter 1 and press . The installation procedure displays the subsets you have chosen and asks you to confirm your choice: 3-4 Installing the TeMIP Expert System Access You are installing the following optional subsets: TeMIP ESA Developer Toolkit (level 1 rev A) Is this correct? (y/n): y 3. If the information is correct, enter y and press , otherwise enter n, press and re- enter your choice. The procedure displays the result of a file system space check and copyright information before proceeding to install the subset. Checking file system space required to install selected subsets: File system space checked OK. 1 subset(s) will be installed. Loading 1 of 1 subset(s).... Copyright (c) Digital Equipment Corporation, 1998. All Rights Reserved. Unpublished rights reserved under the copyright laws of the United States. The software contained on this media is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of the software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation. RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, as applicable. TeMIP Expert System Access will use the acloc user account with the following characteristics : acloc user id : 1104 acloc group : users Note that TeMIP Expert System Access users should belong to the users group in order to use the product. Refer to the TeMIP Installation Guide for more information. TeMIP ESA Developer Toolkit (level 1 rev A) Copying from . (disk) Verifying 1 of 1 subset(s) installed successfully. Configuring "TeMIP ESA Developer Toolkit (level 1 rev A)" (ESADKV100) Would you like to run the ESADKV100 IVP? (y/n) [y] The code stubs and the associated Makefile are installed in the directory /usr/mcc/esa/cust: o temip_esa_pm o ieg_pm_descrip.make o ieg_stub_alarm.cxx o ieg_stub_alarm.hxx o ieg_stub_alarm_object.cxx Installing the TeMIP Expert System Access 3-5 o ieg_stub_alarm_object.hxx o ieg_stub_alarm_object_change.cxx o ieg_stub_alarm_object_change.hxx o ieg_stub_builder.cxx o ieg_stub_builder.hxx o ieg_stub_clutch.cxx o ieg_stub_clutch.hxx o ieg_stub_cold_restart.cxx o ieg_stub_cold_restart.hxx o ieg_stub_communication.cxx o ieg_stub_communication.hxx o ieg_stub_end_of_population.cxx o ieg_stub_end_of_population.hxx o ieg_stub_event.cxx o ieg_stub_event.hxx o ieg_stub_non_osi_event.cxx o ieg_stub_non_osi_event.hxx o ieg_stub_reply.cxx o ieg_stub_reply.hxx o ieg_stub_watchdog.cxx o ieg_stub_watchdog.hxx In addition, the /usr/mcc/esa/examples directory contains files resulting from an integration of the TeMIP Expert System Access with the ILOGRules Expert System: o ieg_pm_descrip.make o ieg_stub_alarm_object.cxx o ieg_stub_alarm_object.hxx o ieg_stub_alarm_object_change.cxx o ieg_stub_alarm_object_change.hxx o ieg_stub_builder.cxx o ieg_stub_builder.hxx o ieg_stub_clutch.cxx o ieg_stub_clutch.hxx o ieg_stub_communication.cxx o ieg_stub_communication.hxx o ieg_stub_event.cxx o ieg_stub_event.hxx o ieg_stub_reply.cxx o ieg_stub_reply.hxx o objects.cpp 3-6 Installing the TeMIP Expert System Access o objects.h o pcontrol.cpp o pcontrol.h o pdiagno.cpp o pdiagno.h o pinfo.cpp o pinfo.h o pstep.cpp o pstep.h o rules.ilr o rules.int o sdh_am_mgt_if.ms o sdh_am_pipe_srvc_if.ms o sdh_am_sdhne_srvc_if.ms 3.7 Local Installation of the ESA HTML Documentation Install the ESA HTML Documentation as follows: 1. Start the installation procedure and choose the ESA HTML Documentation option from the menu: The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) TeMIP ESA HTML Documentation (level 1 rev A) Or you may choose one of the following options: 2) ALL of the above 3) CANCEL selections and redisplay menus 4) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 1 2. Enter 1 and press . The installation procedure displays the subsets you have chosen and asks you to confirm your choice: You are installing the following optional subsets: TeMIP ESA HTML Documentation (level 1 rev A) Is this correct? (y/n): y 3. If the information is correct, enter y and press , otherwise enter n, press and re- enter your choice. The procedure displays the result of a file system space check and copyright information before proceeding to install the subset. Installing the TeMIP Expert System Access 3-7 Checking file system space required to install selected subsets: File system space checked OK. 1 subset(s) will be installed. Loading 1 of 1 subset(s).... Copyright (c) Digital Equipment Corporation, 1998. All Rights Reserved. Unpublished rights reserved under the copyright laws of the United States. The software contained on this media is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, duplication or dissemination of the software and media is authorized only pursuant to a valid written license from Digital Equipment Corporation. RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in Subparagraph (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, as applicable. TeMIP ESA HTML Documentation (level 1 rev A) Copying from . (disk) Verifying 1 of 1 subset(s) installed successfully. Configuring "TeMIP ESA HTML Documentation (level 1 rev A)" (ESADOCV100) Would you like to run the ESADOCV100 IVP? (y/n) [y] 3.8 RIS Server Update You can install the TeMIP Expert System Access subsets in an environment controlled by Remote Installation Services by using the DIGITAL UNIX RIS Utility. The installation procedure described in this section uses an existing area named ris0.mips as an example. Before starting the installation, note the device special name of the distribution device. To install the TeMIP Expert System Access, complete the following tasks: o Mount the media on the distribution device. o Start theRIS Utility by entering the following command: # /usr/sbin/ris The RIS Utility Menu is displayed: Choices without key letters are not available. a) ADD a client d) DELETE software products i) INSTALL software products ) LIST registered clients ) MODIFY a client ) REMOVE a client s) SHOW software products in remote installation environments x) EXIT 3-8 Installing the TeMIP Expert System Access Enter your choice: o Enter i and press . The RIS Utility Software Installation Menu is displayed: RIS Software Installation Menu: 1) Install software into a new area 2) Add software into an existing area 3) Return to previous menu Enter your choice: o Enter 2 and press . If you select option 1, the RIS Utility creates the new area automatically: You have chosen to add a product to an existing environment. The existing environment is /usr/var/adm/ris/ris0.alpha. Enter the device special file name or the path of the directory where the software is located (for example, /dev/rmt0h): o Enter the directory name and press . An options menu is displayed: Choose one of the following options: 1) Extract software from /usr/users/esa/kit/install 2) Create symbolic link to /usr/users/esa/kit/install Enter your choice: o Enter 2 and press . The TeMIP ESA is now added as an installation choice for RIS clients. The RIS Utility menu reappears and asks you to enter your choice ** RIS Utility Main Menu *** Choices without key letters are not available. a) ADD a client d) DELETE software products i) INSTALL software products ) LIST registered clients ) MODIFY a client ) REMOVE a client s) SHOW software products in remote installation environments x) EXIT Enter your choice: o If you have nothing more to install, enter x and press . Installing the TeMIP Expert System Access 3-9 4 _________________________________________________________________ Post-Installation of the TeMIP Expert System Access This chapter explains how to configure your system, run the Installation Verification Procedure (IVP), delete installed subsets. You can find more information in: o Verifying the ESA Runtime System Installation, Section 4.1 o Verifying the ESA Developer's Toolkit Installation, Section 4.2 o Verifying the ESA HTML Documentation, Section 4.3 o Deleting the TeMIP Expert System Access from your System, Section 4.4. 4.1 Verifying the ESA Runtime System Installation The Installation Verification Program (IVP) for the ESA Runtime System can be run before ESA is first used, or at any time that problems are suspected. The IVP verifies that the installed ESA include files and shared library actually correspond to the same files provided in the kit. o Start the IVP by entering the following command: setld -v ESARTV100 The IVP procedure displays: TeMIP ESA Runtime System (level 1 rev A)(ESARTV100) Verifying installed files... 0 verification errors encountered. Note that the IVP's output is not logged. 4.2 Verifying the ESA Developer's Toolkit Installation To verify that the ESA Developer's Toolkit has been correctly installed and configured it is necessary to run the TeMIP ESADK IVP. The IVP program performs a comprehensive verification of the ESA Developer's Toolkit installation. In particular, it checks the stub files located in usr/mcc/esa/cust, and the files associated with the ILOG Rules integration example located in usr/mcc/esa/examples. TeMIP ESA Developer Toolkit (level 1 rev A) (ESADKV100) Verifying installed files... 0 verification errors encountered. Note that the IVP's output is not logged. Post-Installation of the TeMIP Expert System Access 4-1 4.3 Verifying the ESA HTML Documentation Installation To verify that the ESA HTML Documentation has been correctly installed and configured, it is necessary to run the TeMIP ESADK IVP (Installation Verification Program). The IVP program consists of a check on the existence and accessibility of the ESADK by launching the Netscape Navigator browser. Start the IVP by entering the following command: # setld -v ESADKV100 The IVP displays: TeMIP ESA HTML Documentation (level 1 rev A) (ESADOCV100) Launching netscape, please wait... Note that the output of the IVP is not logged. 4.4 Deleting the TeMIP Expert System Access from your System If you need to remove a version of the TeMIP Expert System Access from the system, delete each subset that has been previously installed. To delete subsets: 1. Log in as superuser 2. Enter the following form of the setld command: setld -i | grep "ESA" 3. Look for the word "installed" in the listing produced, and then delete the installed subsets. For example: setld -d ESARTV100 setld -d ESADKV100 4-2 Post-Installation of the TeMIP Expert System Access A _________________________________________________________________ Pre-Installation Checklist This appendix summarizes the various operations required before installation of the TeMIP Expert System Access. After you have completed each task, use the box at the left of the page to check it off the list. You can find more information in: o Local Installation, Section A.1 o Installation on a RIS Server, Section A.2 o Installation from a RIS Server, Section A.3. A.1 Local Installation Before starting a local installation, do the following: < Check that the distribution kit is complete. < Ensure that you have an AlphaGeneration machine with the correct version of the DIGITAL UNIX operating system installed and running. < Back up the system disk. < Ensure that TeMIP is installed and running. < Ensure that you have sufficient disk space. < Create the temip user account if it does not already exist. < Load the distribution media. < Register the license for the product. < Read the online Release Notes. Pre-Installation Checklist A-1 A.2 Installation on a RIS Server Before starting installation on a RIS server, do the following in addition to the local installation checks: < Note the device special name of the distribution device. A.3 Installation from a RIS Server Before starting installation from a RIS server, do the following: < Ensure that TeMIP ESA is installed and running on the RIS server. < Determine the name of the RIS server. < Ensure that your system is registered as a RIS client. A-2 Pre-Installation Checklist B _________________________________________________________________ Files Installed on your System The following is a complete list of the files installed when you install the TeMIP ESA V1.0.0. For each subset the list gives the permissions, the owner and the file names. You can find more information in: o ESA Runtime System, Section B.1 o ESA Developer's Toolkit, Section B.2 o ESA HTML Documentation, Section B.3. B.1 ESA Runtime System Installation Directories Table B-1 shows the directories created in the /usr/mcc/esa/lib directory. Table_B-1_Directory_/usr/mcc/esa/lib_______________________ Permissions__Owner____Files________________________________ -rw-r-r-_____root_____libieg.so____________________________ Table 3-2 shows the directories created and files in the common /usr/mcc/esa/include subdirectory. Table_B-2_Directory_/usr/mcc/esa/include___________________ Permissions__Owner____Files________________________________ -rwxr-r- root ieg_adapter.hxx -rwxr-r- root ieg_pm_mgt_if.ms -rwxr-r-_____root_____ieg_provider.hxx_____________________ B.2 ESA Developer's Toolkit Installation Directories Table B-3 shows the code stubs placed in the /usr/mcc/esa/cust directory when the ESA Developer's Toolkit is installed. Files Installed on your System B-1 Table_B-3__Directory_/usr/mcc/esa/cust_____________________ Permissions__Owner____Files________________________________ -rwsr-sr-x acloc temip_esa_pm -rwxrw-rw- root ieg_pm_descrip.make -rwxrw-rw- root ieg_stub_alarm.cxx -rwxrw-rw- root ieg_stub_alarm.hxx -rwxrw-rw- root ieg_stub_alarm_object.cxx -rwxrw-rw- root ieg_stub_alarm_object.hxx -rwxrw-rw- root ieg_stub_alarm_object_change.cxx -rwxrw-rw- root ieg_stub_alarm_object_change.hxx -rwxrw-rw- root ieg_stub_builder.cxx -rwxrw-rw- root ieg_stub_builder.hxx -rwxrw-rw- root ieg_stub_clutch.cxx -rwxrw-rw- root ieg_stub_clutch.hxx -rwxrw-rw- root ieg_stub_cold_restart.cxx -rwxrw-rw- root ieg_stub_cold_restart.hxx -rwxrw-rw- root ieg_stub_communication.cxx -rwxrw-rw- root ieg_stub_communication.hxx -rwxrw-rw- root ieg_stub_end_of_population.cxx -rwxrw-rw- root ieg_stub_end_of_population.hxx -rwxrw-rw- root ieg_stub_event.cxx -rwxrw-rw- root ieg_stub_event.hxx -rwxrw-rw- root ieg_stub_non_osi_event.cxx -rwxrw-rw- root ieg_stub_non_osi_event.hxx -rwxrw-rw- root ieg_stub_reply.cxx -rwxrw-rw- root ieg_stub_reply.hxx -rwxrw-rw- root ieg_stub_watchdog.cxx -rwxrw-rw-___root_____ieg_stub_watchdog.hxx________________ The /usr/mcc/esa/example directory contains an example of an integration of the TeMIP Expert System Access with the ILOGRules Expert System. The examples perform a correlation on an SDH Network example, the object model for which is described in the .ms files. The contents of the /usr/mcc/esa/example directory are shown in Table B-4: B-2 Files Installed on your System Table_B-4_Directory_/usr/mcc/esa/example___________________ Permissions__Owner____Files________________________________ -rwxrw-rw root ieg_pm_descrip.make -rwxrw-rw- root ieg_stub_alarm_object.cxx -rwxrw-rw- root ieg_stub_alarm_object.hxx -rwxrw-rw- root ieg_stub_alarm_object_change.cxx -rwxrw-rw- root ieg_stub_alarm_object_change.hxx -rwxrw-rw- root ieg_stub_builder.cxx -rwxrw-rw- root ieg_stub_builder.hxx -rwxrw-rw- root ieg_stub_clutch.cxx -rwxrw-rw- root ieg_stub_clutch.hxx -rwxrw-rw- root ieg_stub_communication.cxx -rwxrw-rw- root ieg_stub_communication.hxx -rwxrw-rw- root ieg_stub_event.cxx -rwxrw-rw- root ieg_stub_event.hxx -rwxrw-rw- root ieg_stub_reply.cxx -rwxrw-rw- root ieg_stub_reply.hxx -rwxrw-rw- root objects.cpp -rwxrw-rw- root objects.h -rwxrw-rw- root pcontrol.cpp -rwxrw-rw- root pcontrol.h -rwxrw-rw- root pdiagno.cpp -rwxrw-rw- root pdiagno.h -rwxrw-rw- root pinfo.cpp -rwxrw-rw- root pinfo.h -rwxrw-rw- root pstep.cpp -rwxrw-rw- root pstep.h -rwxrw-rw- root rules.ilr -rwxrw-rw- root rules.int -rwxrw-rw- root sdh_am_mgt_if.ms -rwxrw-rw- root sdh_am_pipe_srvc_if.ms -rwxrw-rw-___root_____sdh_am_sdhne_srvc_if.ms______________ B.3 ESA HTML Documentation Installation Directories Table B-5 shows the files placed in the /usr/mcc/temip_doc_ html/esadoc directory: Files Installed on your System B-3 Table_B-5__Directory_/usr/mcc/temip_doc_html/esadoc________ Permissions__Owner____Files________________________________ -rw-r-r- root digital-logo.gif drwxr-xr-x root esadvt drwxr-xr-x root esaig drwxr-xr-x root esaref -rw-r-r- root start_here_esadoc.html -rw-r-r- root temip_logo.gif -rw-r-r-_____root_____temip_new_logo.gif___________________ Table B-6 shows the files placed in the /usr/mcc/temip_doc_ html/esadoc/esadvt directory: Table_B-6__Directory_/usr/mcc/temip_doc_html/esadoc/esadvt_ Permissions__Owner____Files________________________________ -rw-r-r- root MINIMIDX.gif -rw-r-r- root MINIMLOT.gif -rw-r-r- root MINIMPNX.gif -rw-r-r- root MINIMTOC.gif -rw-r-r- root MINIMTOP.gif -rw-r-r- root DIGITAL-LOGO.gif -rw-r-r- root ESA_DVT_GUIDE-1.gif -rw-r-r- root ESA_DVT_GUIDE-2.gif -rw-r-r- root ESA_DVT_GUIDE-3.gif -rw-r-r- root ESA_DVT_GUIDE-4.gif -rw-r-r- root ESA_DVT_GUIDE-5.gif -rw-r-r- root ESA_DVT_GUIDE-6.gif -rw-r-r- root ESA_DVT_GUIDE-7.gif -rw-r-r- root ESA_DVT_GUIDE.html -rw-r-r- root table_of_contents.gif -rw-r-r-_____root_____BLUBVSPM.gif_________________________ Table B-7 shows the files placed in the /usr/mcc/temip_doc_ html/esadoc/esaref directory: B-4 Files Installed on your System Table_B-7_Directory_/usr/mcc/temip_doc_html/esadoc/esaref__ Permissions__Owner____Files________________________________ -rw-r-r- root MINIMIDX.gif -rw-r-r- root MINIMLOT.gif -rw-r-r- root MINIMPNX.gif -rw-r-r- root MINIMTOC.gif -rw-r-r- root MINIMTOP.gif -rw-r-r- root DIGITAL-LOGO.gif -rw-r-r- root ESA_REF_GUIDE-1.gif -rw-r-r- root ESA_REF_GUIDE-2.gif -rw-r-r- root ESA_REF_GUIDE-3.gif -rw-r-r- root ESA_REF_GUIDE-4.gif -rw-r-r- root ESA_REF_GUIDE.html -rw-r-r- root table_of_contents.gif -rw-r-r-_____root_____BLUBVSPM.gif_________________________ Table B-8 shows the files placed in the /usr/mcc/temip_doc_ html/esadoc/esaig directory: Table_B-8_Directory_/usr/mcc/temip_doc_html/esadoc/esaig___ Permissions__Owner____Files________________________________ -rw-r-r- root digital-logo.gif -rw-r-r- root esa_inst_guide.html -rw-r-r- root esa_inst_guide_001.html -rw-r-r- root esa_inst_guide_002.html -rw-r-r- root esa_inst_guide_003.html -rw-r-r- root esa_inst_guide_contents.html -rw-r-r-_____root_____esa_inst_guide_index.html____________ Files Installed on your System B-5 C _________________________________________________________________ Recovering from Errors This appendix provides information to help you deal with failures or errors that might occur during product installation or product use. You can find more information in: o Failures During Product Installation, Section C.1 o Failures During Product Use, Section C.2. C.1 Failures During Product Installation If errors occur during the installation, the system displays failure messages. For example, if the installation fails due to insufficient disk space, the following message appears: The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) TeMIP ESA Developer Toolkit (level 1 rev A) 2) TeMIP ESA HTML Documentation (level 1 rev A) 3) TeMIP ESA Runtime system (level 1 rev A) Or you may choose one of the following options: 4) ALL of the above 5) CANCEL selections and redisplay menus 6) EXIT without installing any subsets Press RETURN to display the next screen: 3 Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 3: 2 /usr: write failed, file system is full Errors can occur during the installation, if any of the following conditions exist: o The operating system version is incorrect. o The prerequisite software version is incorrect. o There is insufficient disk space. For descriptions of error messages generated by these conditions, refer to the DIGITAL UNIX Documentation on system messages, recovery procedures, and DIGITAL UNIX software installation. Recovering from Errors C-1 C.2 Failures During Product Use If an error occurs while the TeMIP Expert System Access is in use and you believe the error is caused by a problem with the product, take one of the following actions: o If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following: - The name and version number of the operating system you are using - The version number of the TeMIP Expert System Access you are using - The hardware system you are using (such as a model number) - A brief description of the problem (one sentence if possible) - How critical the problem is. - If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). - If you do not have any type of software services support agreement and you purchased the TeMIP Expert System Access within the past year, you can submit an SPR if you think the problem is caused by a software error. When you submit an SPR, take the following steps: 1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the TeMIP Expert System Access being used. Demonstrate the problem with specific examples. 2. Reduce the problem to as small a size as possible. 3. Remember to include listings of any command files, INCLUDE files, or relevant data files, and so on. 4. Report only one problem per SPR. This will facilitate a faster response. 5. Mail the SPR package to DIGITAL. If the problem is related to TeMIP Expert System Access documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe). C-2 Recovering from Errors _________________________________________________________________ Index A Installation types _______________________________ local, 1-1 Aborting installation, 1-5 RIS, 1-1 After installing TeMIP Expert Installation Verification System Access, 4-1 to 4-2 Procedure, 3-2, 4-1 OSI PM, 4-2 B______________________________ Installing Bill Of Materials (BOM), 1-2 See Installation from a CD-ROM, 3-2 C from a RIS server, 3-2 _______________________________ from a system directory, 3-2 Checklist the RIS Utility, 3-8 See Installation checklist IVP Configuring the system, 3-2 See Installation Verification D Procedure _______________________________ Deleting TeMIP Expert System L______________________________ Access subsets, 4-2 License Disk space, 1-3 file, 2-2 Distribution kit, 1-2 key, 2-2 management, 2-1 to 2-4 E______________________________ servers, 2-2 ESA Developer's Toolkit Licensed features, 2-2 installing the, 3-4 List of files installed, B-1 Logging on, 1-2 F______________________________ Files installed, B-1 M______________________________ ESA Developer's Toolkit, B-1 Menu ESA Examples Directory, B-2 RIS Utility, 3-8 ESA HTML Documentation, B-3 RIS Utility Software FLEXlm, 2-1 Installation, 3-9 _______________________________ P______________________________ Hardware requirements, 1-2 Preparing to install TeMIP Expert System Access, 1-1 I______________________________ to 1-6 Installation aborting, 1-5 R______________________________ checklist for, A-1 Recovering from installation directories, B-1 errors, 1-5 of Release Notes, 3-4 Redundant servers, 2-2 of TeMIP Expert System Access Requirements , 3-1 to 3-9 disk space, 1-3 on a RIS server area, 3-8 hardware, 1-2 recovering from errors, 1-5 media types, 1-2 starting the, 3-2 operating system, 1-2 verification, 3-2, 4-1 software, 1-2 Index-1 Requirements (cont'd) choosing ESA Developer's software subsets, 1-2 Toolkit, 3-4, 3-7 subsets, 1-3 choosing ESA Runtime System, system backup, 1-3 3-2 TeMIP Framework, 1-2 System backup, 1-3 time, 1-2 System configuration, 3-2 RIS installation, 3-8 T______________________________ Utility, 3-8 temip user account, 1-5 Utility Menu, 3-8 Time requirements, 1-2 Utility Software Installation Menu, 3-9 U _______________________________ S______________________________ User account, 1-5 Software requirements, 1-2 Using the Director User Starting Account, 1-5 the RIS Utility, 3-8 V subsets _______________________________ checking the, 1-3 Vendor daemon, 2-2 Subsets Index-2