TeMIP_OSI_Management_Toolkit___________________ Installation Guide Order Number: AA-QEMQD-TE This guide describes how to install the TeMIP OSI Management Toolkit on your Digital UNIX system. Revision/Update Information: V2.1.0 This edition supersedes the V2.0 edition Operating System and Version: Digital UNIX V3.2 Software Version: TeMIP OSI Management Toolkit V2.1 Digital Equipment Corporation Maynard, Massachusetts _______________________________________________________________ Printing November 1996 information in this document is subject to change notice and should not be construed as a commitment Digital Equipment Corporation. Equipment Corporation assumes no responsibility for errors that may appear in this document. software described in this document is furnished under license and may be used and copied only in accordance the terms of such license. No responsibility is for the use or reliability of software on equipment is not supplied by Digital Equipment Corporation or affiliated companies. Rights: Use, duplication, or disclosure by the Government is subject to restrictions as set forth in (c)(1)(ii) of the Rights in Technical Data and Software clause at DFARS 252.227-7013. Digital Equipment Corporation 1996. rights reserved. Printed in Europe. DECcmi, DECnet, TeMIP, TeMIP Framework and are trademarks of Digital Equipment Corporation. UNIX [R] - UNIX is a registered trademark in the States and other countries licensed exclusively X/Open Company Ltd. UNIX V3.2C is an X/Open UNIX 93 branded product. document is available on CD ROM. document was prepared using VAX DOCUMENT, Version 2.1. _____________________________________________________ Contents .............................................. v to Install the TeMIP OSI Management Toolkit of Installation............................ 1-1 Local Installation ............................ 1-1 RIS Installation .............................. 1-1 Requirements........................ 1-1 Hardware and Software ......................... 1-2 Distribution Kit .............................. 1-2 Time Required to Install ...................... 1-2 Logging On .................................... 1-2 Backing Up the System Disk .................... 1-3 Checking the Required Software Subsets ........ 1-3 Disk Space Requirements ....................... 1-4 Using the Director User Account ............... 1-5 Registration............................. 1-6 the Installation and Recovering from ........................................... 1-7 the TeMIP OSI Management Toolkit the Installation Procedure.............. 2-1 Configuration............................. 2-2 Verification Procedure.............. 2-3 Installation of the OSI Protocol Stack..... 2-3 Installation of the OSI AM Release Notes... 2-3 Installation of the GDMO Translator........ 2-5 Installation of the OSI AM................. 2-6 Server Update................................ 2-8 the TeMIP OSI Management Toolkit your System for the OSI AM........... 3-1 your System for the GDMOXLAT......... 3-1 the Toolkit Installation............... 3-1 IVP Overview .................................. 3-2 Symbols and Files Used by the IVP Names Reserved for the IVP .................... 3-3 Example Log of a Successful IVP ............... the Installation of GDMOXLAT........... 3-6 the TeMIP OSI Management Toolkit from System...................................... 3-7 iii Checklist Local Installation............................... A-1 Installation on a RIS Server..................... A-2 Installation from a RIS Server................... A-2 Installed on your System OSI AM Release Notes Subset...................... B-1 OSI Access Module Subset......................... B-1 OSI AM Subset Links ........................... B-5 GDMO Subset...................................... B-5 GDMO Translator Subset Links .................. B-9 from Errors Failures During Product Installation ............ C-1 Failures During Product Use...................... C-2 Disk Space Requirements ....................... 1-4 Directory /usr/kits/NOE210/help ............... B-1 Directory /usr/kits/NOE210 .................... B-1 Directory /usr/kits/NOE210/temip_osi_am ....... B-2 Directory /usr/kits/NOE210/temip_osi_am/bin ... B-2 Directory /usr/kits/NOE210/temip_osi_am/build............ B-2 Directory /usr/kits/NOE210/temip_osi_am/demo .. B-2 Directory /usr/kits/NOE210/temip_osi_am/demo/CLIENT...... B-3 Directory /usr/kits/NOE210/temip_osi_am/demo/MODEL....... B-3 Directory /usr/kits/NOE210/temip_osi_am/demo/SELF_MGMT... B-3 Directory /usr/kits/NOE210/temip_osi_am/examples......... B-3 Directory /usr/kits/NOE210/temip_osi_am/files............ B-4 Directory /usr/kits/NOE210/temip_osi_am/kit ... B-4 Directory /usr/kits/NOE210/temip_osi_am/lib ... B-4 Directory /var/kits/temip_osi_am .............. B-4 Directory /usr/kits/NOE210 .................... B-5 Directory /usr/kits/NOE210/gdmo ............... B-5 Directory /usr/kits/NOE210/gdmo/bin ........... B-5 Directory /usr/kits/NOE210/gdmo/files ......... B-5 Directory /usr/kits/NOE210/gdmo/ivp ........... B-6 Directory /usr/kits/NOE210/gdmo/lib ........... B-7 Directory /usr/kits/NOE210/gdmo/msl ........... B-7 Directory /usr/kits/NOE210/gdmo/tools ......... B-9 Directory /usr/lib/X11/help/temip_gbrowser .... B-9 ____________________________________________________________ Preface This guide describes how to install the TeMIP OSI Management Toolkit software on a Digital UNIX[R] + Reduced Instruction Set Computer (RISC) system. Audience This guide is intended for personnel who are responsible for installing the TeMIP OSI Management Toolkit on a Digital UNIX RISC system, for example: o A system manager installing the TeMIP OSI Management Toolkit on a local system o A system manager installing the TeMIP OSI Management Toolkit from the Remote Installation Services (RIS) server area of a remote system o A RIS manager installing the TeMIP OSI Management Toolkit on a RIS server area. It is assumed that the reader has an understanding of the shell concept of Digital UNIX and is familiar with the use of peripheral devices. of This Guide The guide is structured as follows: o Chapter 1 describes the requirements for installing the TeMIP OSI Management Toolkit software. o Chapter 2 describes the installation of the TeMIP OSI Management Toolkit software locally, and on a RIS server area. o Chapter 3 describes how to configure the system and verify the installation. o Appendix A provides a check list of pre-installation requirements. o Appendix B provides a list of the TeMIP OSI Management Toolkit 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 Documents guide is part of the TeMIP documentation set. The documents in the set are: Manual TeMIP Introduction (AA-Q9J1C-TE) Manuals TeMIP Installation Guide (AA-Q9J2D-TE) TeMIP OSI Management Toolkit Installation Guide (AA- QEMQD-TE) (This Document) TeMIP OSI Management Toolkit OSI Access Module Run-Time Kit Installation Guide (AA-QEMRD-TE) TeMIP ASCII Management Toolkit, Installation Guide (AA- QFZ4D-TE) DECcmi for Digital UNIX Installation and Configuration Guide (AA-QENTD-TE) Manuals TeMIP Utilities (AA-Q9JBC-TE) TeMIP Planning Guide (AA-QXSPA-TE) TeMIP Director Configuration and Management Guide (AA- QN8NB-TE) TeMIP Name Service Administration Guide (AA-QXSQA-TE) TeMIP Customization and Troubleshooting Guide (AA-QXSRA- TE) TeMIP ASCII Management Toolkit, ASCII Access Module System Manager's Manual (AA-QDXSD-TE) TeMIP ASCII Management Toolkit, Customization Manual (AA-QDXTD-TE) TeMIP Framework Security Administration Guide (AA-QD9GC- TE) Manuals TeMIP Fault and Trouble Management Alarm Handling User's Guide (AA-Q9J4C-TE) TeMIP Fault and Trouble Management Trouble Ticketing User's Guide (AA-Q9J8C-TE) TeMIP Fault and Trouble Management Event Logging User's Guide (AA-Q9J6C-TE) TeMIP Framework Iconic Map and FCL User's Guide (AA- Q9HMC-TE) TeMIP Framework DECnet Phase IV Access Module Use (AA- Q9HAC-TE) o TeMIP Framework DECnet/OSI Access Module Use (AA-Q9HBC- TE) o TeMIP Framework TCP/IP SNMP Access Module Use (AA-Q9HCC- TE) o TeMIP Framework Script Access Module Use (AA-Q9HDC-TE) o TeMIP Framework Circuit Access Module Use (AA-Q9HHC-TE) o TeMIP Framework Autoconfiguration Use (AA-Q9HLC-TE) o TeMIP Framework Alarms and Notification Services Use (AA-Q9HEC-TE) o TeMIP Framework Security Operator's Guide (AA-QD9FC-TE) o TeMIP OSI Management Toolkit OSI Access Module GDMO Browser User's Guide (AA-QDYPD-TE) o TeMIP OSI Management Toolkit OSI Access Module GDMO Translator User's Guide (AA-QDYND-TE) o TeMIP OSI Management Toolkit OSI Access Module User's Guide (AA-QDYMD-TE) o TeMIP ASCII Management Toolkit, ASCII Access Module User's Guide (AA-QDXRD-TE) o DECcmi for Digital UNIX Operator's Guide (AA-QDYQD-TE) Programming and Software Reference Manuals o TeMIP Framework Management Module Programming (AA-Q9H8C- TE) o TeMIP Framework Security Software Reference Manual (AA- QD9EC-TE) o TeMIP Framework System Reference Manual Volume 1 & Volume 2 (AA-Q9HGC-TE) and (AA-PD5LG-TE) o Visual TeMIP Reference Guide (AA-QV89B-TE) o Visual TeMIP Development Guide (AA-QV8BB-TE) o TeMIP Fault and Trouble Management Reference Guide (AA- Q9J3C-TE) o TeMIP Fault and Trouble Management OSI System AM Module Reference Manual (AA-Q9JAC-TE) o TeMIP Fault and Trouble Management Alarm Handling FM Module Reference Manual (AA-Q9J5C-TE) o TeMIP Fault and Trouble Management Event Log FM Module Reference Manual (AA-Q9J7C-TE) o TeMIP Fault and Trouble Management Trouble Ticketing FM Module Reference Manual (AA-Q9J9C-TE) o TeMIP Fault and Trouble Management Event Filtering and Correlation FM Module Reference Manual (AA-QK7HB-TE) o TeMIP Fault and Trouble Management Event Filtering and Correlation Software Reference Manual (AA-QMWKB-TE) vii TeMIP ASCII Management Toolkit, ASCII AM Module Reference Manual (AA-QDXUD-TE) of Interest following documents contain additional related DECnet/OSI Planning Guide (AA-QBTHC-TE) Describes how to migrate a network from DECnet Phase IV to DECnet/OSI, including configuration guidelines and task planning. Digital UNIX Documentation Set Describes how to use and manage the Digital UNIX operating system. Digital UNIX Guide to Remote Installation Services Describes how to install and maintain your remote installation environment using the RIS utility. INGRES Installation and Operations Guide Describes how to install, configure and maintain an INGRES database. INGRES Database Administrator's Guide Describes how to manage an INGRES database. INGRES/SQL Reference Manual Provides a detailed description of how to issue SQL queries and develop applications. Examples of the correct use of SQL statements and INGRES features are also given. o INGRES/Net User's Guide Describes how to install, use and maintain INGRES/Net. o ORACLE Installation and Configuration Guide Provides installation and configuration information for ORACLE databases and tools. o ORACLE Server Administrator's Guide Describes how to manage ORACLE databases. o ORACLE Server SQL Language Reference Manual Gives a complete description of the SQL language used to create, store, modify, retrieve and manage information in an ORACLE database. o ORACLE SQL*Plus User's Guide and Reference Describes the SQL*Plus program and gives a detailed description of each command. o ORACLE SQL*Net Administrator's Guide. Describes how to use ORACLE tools and applications to access, manipulate, share and store data in ORACLE databases residing on remote servers. o DECsafe Available Server Installation Guide. Describes how to install the DECsafe Available Server hardware and software to give access to applications in a network environment. o Guide to the DECsafe Available Server. Describes how to set up and manage the systems and services in the DECsafe Available Server environment. Conventions The following conventions are used in this guide: ___________________________________________________________ Convention_______Meaning___________________________________ # The Digital 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. ___________________________________________________________ ix 1 ____________________________________________________________ Preparing to Install the TeMIP OSI Management Toolkit This chapter describes the requirements and preparation necessary for installing the TeMIP OSI Management Toolkit. The installation procedures described in this guide apply only to TeMIP OSI Management Toolkit V2.1. 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 License Registration, Section 1.3 o Aborting the Installation and Recovering from Errors, Section 1.4. 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 2. Local Installation The TeMIP OSI Management Toolkit can be installed directly on your local system. RIS Installation The TeMIP OSI Management Toolkit can also be installed from a RIS server area of a remote system. If you intend to install the TeMIP OSI Management Toolkit on your system in this way, ensure the following: o A TeMIP OSI Management Toolkit 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. Requirements The installation requirements for the TeMIP OSI Management Toolkit 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 OSI Management Toolkit 1-1 and Software minimum hardware and software requirements for the of the TeMIP OSI Management Toolkit are as TeMIP OSI Management Toolkit can be installed on any Instruction Set Computer (RISC) machine. install the TeMIP OSI Management Toolkit you require Digital UNIX V3.2 operating system running on a RISC along with its Software Development Utilities and Development Environment. The TeMIP Version 3.1 and TeMIP Framework Developer's should also be installed. Kit sure that you have the correct distribution kit and the contents against the Bill Of Materials (BOM). any part of the kit is missing, contact your Digital TeMIP OSI Management Toolkit can be installed on a UNIX RISC system from the CDROM bearing the label OSI Management Toolkit supplied in the kit. distribution kit contains the following software OSI AM V2.1 for Digital UNIX RISC (NOEOSIAMV210) OSI AM V2.1 Release Notes for Digital UNIX RISC (NOEOSIAMRELV210) GDMO Translator V2.1 for Digital UNIX RISC (NOEGXLATV210) OSI Protocol Stack V2.15 for Digital UNIX RISC (CMACMV215). Required to Install installation of TeMIP OSI Management Toolkit approximately 15 minutes, depending on the system The Installation Verification Procedure takes only an additional few seconds. from a RIS server should take about the same as a local installation, depending on the amount of in the network. On must have superuser privileges to install the TeMIP OSI Toolkit software and to register the license PAK Authorization Key). can set the current working directory to the top level root) directory using the following command: cd / to Install the TeMIP OSI Management Toolkit 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 OSI Management Toolkit involves writing to these partitions. Checking the Required Software Subsets You require at least the following Digital UNIX V3.2 (Rev. 214) and TeMIP Framework software subsets: o OSFBASE350, Digital UNIX Base System Software o OSFX11350, Basic X Environment (Windowing Environment) o TFRBASEV310, TeMIP Framework Basic Management System o TFRTKV310, TeMIP Framework Developer's Toolkit Preparing to Install the TeMIP OSI Management Toolkit 1-3 find the following information: The additional required Digital UNIX subsets The required DECnet/OSI subsets. to the TeMIP Installation and TeMIP Director and Management Guides with respect to TeMIP and the DECcmi for Digital UNIX Installation and Guide. check that these subsets are present enter the following /etc/setld -i | grep OSF /etc/setld -i | grep TFR subsets installed are displayed along with any related names as shown in the example below: installed Base System (- Required -) installed Basic X Environment (Windowing Environment) installed TeMIP Framework Basic Management System (patch x) installed TeMIP Framework Developer Toolkit (patch x) a subset is not present, the word installed is not Space Requirements different TeMIP OSI Management Toolkit software require different amounts of disk space as shown Table 1-1. The values shown are approximate and may vary kit to kit. The first set of values represents the space required if you copy the subsets to a directory your disk before installing them, and the second set values represents the disk space required for direct 1-1 Disk Space Requirements__________________________________________________________ Disk Space in Subset Disk Space /usr/kits__________________________________________________________ AM for Digital UNIX RISC 7100 KB 17000 KB AM Release Notes for Digital 50 KB 100 KB RISC Translator for Digital UNIX 800 KB 2000 KB Protocol Stack (see note __________________________________________________________ ________________________ Note ________________________ For values concerning the OSI Protocol Stack see the DECcmi for Digital UNIX Installation and Configuration Guide. ______________________________________________________ installation procedure creates the following if they do not already exist: /usr/kits/NOE210 to Install the TeMIP OSI Management Toolkit o /usr/var/kits/temip_osi_am The TeMIP OSI Management Toolkit executable files must be in the /usr/kits/NOE210 directory tree. However, you can mount a separate file system on /usr/kits/NOE210 if you want to keep the TeMIP OSI Management Toolkit executable files separate from the rest of the /usr file system. It is recommended that you have at least 10 MB of additional disk space available in the /usr/var/kits/temip_ osi_am partition for collecting data and reports. ___________________ Recommendation ___________________ To avoid problems with disk full situations, it is strongly recommended that /usr/var/kits/temip_osi_am be installed on a separate partition. ______________________________________________________ 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 /usr/var/kits using the following command: # df -k /usr/kits /usr/var/kits This displays the total space and total free space on the disk partitions in use. An example of the output is shown below: Filesystem 1024-blocks Used Avail Capacity Mounted on /dev/rz0a 15551 12481 1515 89% /usr /dev/rz0g 271848 246704 25144 91% /var This example indicates that there are 1515 KB free in the rz0a partition on which the /usr file system is mounted. In this example there is not enough free disk space to install the TeMIP OSI Management Toolkit. You would have to increase the disk space available for installation or mount another file system on the /usr/kits directory. Refer to the Digital UNIX System Administration documentation for details of how to increase free disk space. Using the Director User Account Before installing the TeMIP OSI Management Toolkit, 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 OSI Management Toolkit 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 OSI Management Toolkit software. Preparing to Install the TeMIP OSI Management Toolkit 1-5 example, if all users of the TeMIP OSI Management belong to the group users, then the Director Account must also be created as a member of the group . Director User Account will be the owner of directories /usr/var/kits/temip_osi_am and . details of how to create a user account, refer to the UNIX System Administration documentation. ________________________ Note ________________________ If a version of TeMIP is already installed, the Director User Account has already been created. ______________________________________________________ Registration license registration information is contained in the Authorization Key (PAK) shipped with the TeMIP Management Toolkit. The PAK is identified by the name Before installing the TeMIP OSI Toolkit, you must register your software license load the PAK using the Digital UNIX License Management (LMF). The installation procedure checks to verify the license information is registered and the PAK You cannot install the TeMIP OSI Management Toolkit you have first run the LMF procedure. your license and load the PAK as follows: Start LMF by entering the following command: # lmf register The LMF utility displays a blank template for registering your license. Use your standard editor to insert the information from the TeMIP OSI Management Toolkit PAK into the template. The LMF utility puts you into vi by default. Load the license by entering the following command: # lmf reset Check that the license is correctly loaded by entering the following command: # lmf list The following information is displayed: Product Status Users: Total Active TEMIP-OSI-AM-DK-OSF1 active unlimited further details of how to use the License Management refer to the Digital UNIX License Management Reference Manual. to Install the TeMIP OSI Management Toolkit the Installation and Recovering from Errors To abort the installation at any time press Ctrl/c. If you abort the installation, files created up to that point are not deleted. The directories and files created during the TeMIP OSI Management Toolkit 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. 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. Preparing to Install the TeMIP OSI Management Toolkit 1-7 2 ____________________________________________________________ Installing the TeMIP OSI Management Toolkit This chapter describes how to install the TeMIP OSI Management Toolkit 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 OSI Management Toolkit. ________________________ Note ________________________ If a subset is already installed, you must deinstall it before installing a new version, see Section 3.5. ______________________________________________________ You can find more information in: o Invoking the Installation Procedure, Section 2.1 o System Configuration, Section 2.2 o Installation Verification Procedure, Section 2.3 o Local Installation of the OSI Protocol Stack, Section 2.4 o Local Installation of the OSI AM Release Notes, Section 2.5 o Local Installation of the GDMO Translator, Section 2.6 o Local Installation of the OSI AM, Section 2.7 o RIS Server Update, Section 2.8. the Installation Procedure The way the installation procedure is started depends on the type of installation and the type of media, but in all cases you must enter the load command at the superuser prompt to install the TeMIP OSI Management Toolkit subsets. You can start the installation procedure in the following ways: From a System Directory If you are installing the TeMIP OSI Management Toolkit from a system directory, issue the following command from the directory in which the files are located: # setld -l . Installing the TeMIP OSI Management Toolkit 2-1 a CDROM you are installing TeMIP OSI Management Toolkit from a include the device special name of the distribution where the media is mounted. Enter the following replacing N with the actual logical unit number of distribution device you are using: mount -r /dev/rzNc /mnt install the Bookreader documentation perform the steps: Change to the Bookreader directory using the following command: cd /mnt/bookreader Copy the whole directory structure to /usr/lib/dxbook using the following command: cp -r * /usr/lib/dxbook This creates the following entries in the directory /usr/lib/dxbook: - An OSI AM bookshelf (osi_am.decw_bookshelf) - A NOE210 directory containing all the books. Now add the following line in the Bookreader library file: SHELF\/usr/lib/dxbook/osi_am.decw_bookshelf\ TeMIP OSI Management Toolkit V2.1 ________________________ Note ________________________ You cannot use the Bookreader files on a VMS system. ______________________________________________________ issue the load command as follows: setld -l /mnt/kit installation is complete you must unmount the media the following command: umount /mnt a RIS Server install the TeMIP OSI Management Toolkit subsets that in the /var/adm/ris distribution area of a remote include the name of the RIS server system where TeMIP OSI Management Toolkit subsets are located. example, if you are loading the TeMIP OSI Management subsets from a RIS distribution area on the node , enter the following command: setld -l bigsys: Configuration the installation you are asked if you want to your system as part of the procedure, or after installation is complete. You are asked this question for the OSI Access Module subset (NOEOSIAMV210). If choose to configure your system after installation, the TeMIP OSI Management Toolkit a message is displayed that tells you how to do this. For further details refer to Section 3.1. Verification Procedure You are also asked if you want to run the Installation Verification Procedure (IVP) as part of the procedure, or after the installation is complete. You are asked this question only for the GDMO Translator subset (NOEGXLATV210). If you choose to run the IVP after installation, a message is displayed that tells you how to do this. For further details refer to Section 3.4. Installation of the OSI Protocol Stack Install the OSI Protocol stack as follows: o Invoke the installation procedure and select the OSI Protocol Stack option from the menu: *** Enter Subset Selections *** The Subsets listed below are optional: 1) OSI AM Release Notes 2) OSI Access Module 3) GDMO Translator 4) OSI Protocol Stack 5) All of the Above 6) None of the Above 7) Exit without installing subsets Enter your choice(s): o Enter 4 and press . The installation procedure displays the subsets you have chosen and asks you to confirm your choice: You are installing the following subsets: OSI Protocol Stack Is this correct? (y/n): Answer Y, then refer to the DECcmi for Digital UNIX Installation and Configuration Guide. ___________________ Important Note ___________________ Install the remaining subsets in the order described in this Installation Guide, that is: o OSI AM Release Notes, see Section 2.5 o GDMO Translator, see Section 2.6 o OSI Access Module, see Section 2.7. ______________________________________________________ Installation of the OSI AM Release Notes The Release Notes contain the latest information about the product, plus any changes to the installation procedure that may have been made too late for inclusion in the Installation Guide. The Release Notes must be installed before the TeMIP OSI Management Toolkit. You can read the Release Notes online or print out a hardcopy. Installing the TeMIP OSI Management Toolkit 2-3 the OSI AM Release Notes as follows: Start the installation procedure and choose the OSI AM Release Notes option from the menu: *** Enter Subset Selections *** The subsets listed below are optional: 1) OSI AM Release Notes 2) OSI Access Module 3) GDMO Translator 4) All of the Above 5) None of the Above 6) Exit without installing subsets Enter your choice(s): 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 subsets: OSI AM Release Notes Is this correct? (y/n): If the information is correct, enter y and press , otherwise enter n, press and re- enter your choice. The procedure displays the following information and asks if you want to continue: Checking file system space required to install specified subsets: File system space checked OK Starting installation of NOE OSI AM Release Notes V210. ...Software Copyright declaration... Do you want to continue [y/n]? If you want to continue enter y and press , otherwise enter n and press : There will be no more pre-installation questions. OSI AM Release Notes (NOEOSIAMRELV210) Copying from . (disk) Verifying NOE OSI AM Release Notes V210 installation complete. No particular configuration needed on your system to run NOE OSI AM Release Notes V210 at this time. The Release Notes are installed in the directory: /usr/kits/NOE210/help. The names of the files are: o temip_osi_rel_notes.txt (Text version). o temip_osi_rel_notes.ps (Postscript version). the TeMIP OSI Management Toolkit Installation of the GDMO Translator Install the GDMO Translator locally as follows: o Start the installation procedure and choose the subset options you wish to install: *** Enter Subset Selections *** The subsets listed below are optional: 1) GDMO Translator 2) All of the Above 3) None of the Above 4) Exit without installing subsets Enter your choice(s): o 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 subsets: GDMO Translator Is this correct? (y/n): o If the information is correct, enter y and press , otherwise enter n, press , then re- enter your choice. The procedure displays the following information and asks you if you want to continue: Checking file system space required to install specified subsets: File system space checked OK Starting installation of NOE GDMO Translator V210. ...Software Copyright declaration... Do you want to continue [y/n]? o Enter y and press to continue, or enter n and press to abort the installation. The installation procedure displays: There will be no more pre-installation questions. GDMO Translator (NOEGXLATV210) Copying from . (disk) Verifying NOE GDMO Translator V210 installation complete. o You are now requested for confirmation that you are ready to run the IVP: NO particular configuration is necessary on your system to run NOE GDMO Translator V210 at this time. The next question asks you to confirm that you are ready to run the IVP for NOE GDMO Translator V210 at this time. If you answer 'no' to this question, you will be told how you can run the IVP for NOE GDMO Translator V210 at a later time. Installing the TeMIP OSI Management Toolkit 2-5 Would you like to run the IVP (y/n) [y]: Press to accept the default (y), or enter n and press to run the IVP later. The installation procedure displays: There will be no more configuration questions. NOE GDMO Translator V210 Configuration Procedure complete. A NOE V210 license has been registered. If any errors appear, please reinstall the product. Verification will take between 1 and 5 seconds depending on CPU type. *********************************************************************** Beginning Installation Verification Procedure for NOE GDMO Translator V210. *********************************************************************** ...Software Copyright declaration... Passed *********************************************************************** Installation Verification Procedure for NOE GDMO Translator V210 successfully completed. *********************************************************************** Installation of the OSI AM the OSI AM locally as follows (in this example is the Director User Account): Start the installation procedure and choose OSI Access Module from the menu: *** Enter Subset Selections *** The subsets listed below are optional: 1) OSI Access Module 2) GDMO Translator 3) All of the Above 4) None of the Above 5) Exit without installing subsets Enter your choice(s):1 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 subsets: OSI Access Module Is this correct? (y/n): If the information is correct, enter y and press , otherwise enter n, press , then re- enter your choice. The procedure displays the following information and asks you if you want to continue: the TeMIP OSI Management Toolkit Checking file system space required to install specified subsets: File system space checked OK Starting installation of NOE OSI Access Module V210. ...Software Copyright declaration... Get the Director User account ... NOEOSIAMV210 will use the 'temip' user account with the following characteristics : 'temip' user id: 357 'temip' group: users Note that NOE users should belong to the 'users' group in order to access the NOE files. Note also that all Digital UNIX users belonging to the 'users' group will have read and write access to the NOE files. See NOE Installation Guide for more information. Do you want to continue [y/n]? o Enter y and press to continue, or enter n and press to abort the installation. The installation procedure displays: There will be no more pre-installation questions. OSI Access Module (NOEOSIAMV210) Copying from . (disk) Working.... (Date/Time) Verifying NOE OSI Access Module V210 installation complete. o You are now requested for confirmation that you are ready to configure your system: The next question asks you to confirm that you are ready to configure your system to run NOE OSI Access Module V210 at this time. If you answer 'no' to this question, you will be told how you can configure NOE OSI Access Module V210 at a later time. Do you want to configure your system to run NOE OSI Access Module [y/n]? o Enter y and press to continue, or enter n and press if you want to configure your system later: Starting NOE OSI Access Module V210 configuration. There will be no more configuration questions. NOE OSI Access Module V210 Configuration Procedure complete. Installing the TeMIP OSI Management Toolkit 2-7 Server Update can install the TeMIP OSI Management Toolkit subsets in environment controlled by Remote Installation Services using the Digital UNIX RIS Utility. The installation described in this section uses an existing named ris0.mips as an example. Before starting installation, note the device special name of the device. install the TeMIP OSI Management Toolkit, complete the tasks: Mount the media on the distribution device. Start the RIS 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 Enter your choice: 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: 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): Enter the directory name and press . An options menu is displayed: Choose one of the following options: 1) Extract software from /usr/users/osiam/kit/install 2) Create symbolic link to /usr/users/osiam/kit/install Enter your choice: the TeMIP OSI Management Toolkit o Enter 2 and press . The TeMIP OSI AM 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 OSI Management Toolkit 2-9 3 ____________________________________________________________ After Installing the TeMIP OSI Management Toolkit This chapter tells you how to configure your system and run the Installation Verification Procedure (IVP). You can find more information in: o Configuring your System for the OSI AM, Section 3.1 o Configuring your System for the GDMOXLAT, Section 3.2 o Verifying the Toolkit Installation, Section 3.3 o Verifying the Installation of GDMOXLAT, Section 3.4 o Deleting the TeMIP OSI Management Toolkit from your System, Section 3.5. your System for the OSI AM If you did not configure your system during installation, you can carry out this operation as follows: o Start the configuration by entering the following command: # setld -c NOEOSIAMV210 config The configuration procedure displays the following: Configuring NOEOSIAMV210 The next question asks you to confirm that you are ready to configure your system to run NOE OSI Access Module V210 at this time. If you answer 'no' to this question, you will be told how you can configure NOE OSI Access Module V210 at a later time. Do you want to configure your system to run NOE OSI Access Module [y/n]? o Enter y and press to continue. Starting NOE OSI Access Module V210 configuration. There will be no more configuration questions. NOE OSI Access Module V210 Configuration Procedure complete. your System for the GDMOXLAT No configuration procedure is needed to run the GDMO Translator. the Toolkit Installation To verify that the OSI AM has been correctly installed and configured it is necessary to run the TeMIP OSI AM IVP (Installation Verification Program). After Installing the TeMIP OSI Management Toolkit 3-1 Overview IVP program performs a comprehensive verification the OSI AM installation. Not only does it verify license authorization and installed files, but also the full configuration of the system used by the AM. extent of verification carried out by the IVP makes tool extremely useful to system support personnel, who use it to locate configuration errors. Software TeMIP OSI AM relies on the services provided by number of standard Digital communication products, ULTRIX or Digital UNIX TeMIP Framework DECnet/OSI DECcmi (the OSI protocol stack provided with the TeMIP OSI AM). order to use the support software products the TeMIP OSI requires that: Licenses are active Symbols, initialisation files, and paths are correctly set The lower layer processes are started (DECnet/OSI, DECcmi) and usable. verification fails due to any of the prerequisites above not being correct, the IVP gives the maximum information about the problem found. In practice, the performs a real "usage" of each product to ensure that system is correctly configured. Procedure IVP will try to start an IVP TeMIP OSI AM Client and an agent IVP, using the following procedure: Setting the necessary symbols if not done Getting and using default configuration files if not present Creating the OSI AM application if not already done (by calling temip_osi_setup) Starting the support processes if not already active Sending management requests through the Framework Command Line interface. Installing the TeMIP OSI Management Toolkit Symbols and Files Used by the IVP The following symbols and file names are used by the IVP: o Symbols needed by DECcmi: - UPLROOT - XDSROOT - CMISE_INBOUND. o Path needed: - /usr/kits/NOE210/temip_osi_am/bin (to start the TeMIP OSI AM) - /usr/bin (to call cmi_srv) - /usr/etc (to call cmi_startup). o Files needed by DECcmi: - /var/cmip/conf/cmi_profile.txt - /var/cmip/conf/xom.ini - /var/cmip/conf/xom.oid - /etc/nsaps. ________________________ Note ________________________ xmp.ini is used by the DECcmi stack, but only for the agent IVP. ______________________________________________________ o Files that may be modified during the execution of the IVP: - /var/kits/temip_osi_am/dOSIAM_d.dat - /var/kits/temip_osi_am/dOSIAM_d.idx - /var/kits/temip_osi_am/dOSIAM_d.lck - /var/kits/temip_osi_am/iOSIAM_i.dat - /var/kits/temip_osi_am/iOSIAM_i.idx - /var/kits/temip_osi_am/iOSIAM_i.lck - /var/kits/temip_osi_am/temip_osi_am_ configuration.dat. Names Reserved for the IVP Certain names are reserved for the TeMIP OSI AM IVP, and if used for other purposes may cause the IVP to fail. o DECnet/OSI template name: - osiamivp o Nsap name (/etc/nsaps): - NOEIVP o TeMIP Framework agent names: - agentivp1 - agentivp2. After Installing the TeMIP OSI Management Toolkit 3-3 Process file names: - temip_osi_am_agent_ivp (process name for the agent) - temip_osi_am_ivp (process name for the client) - temip_osi_am_ivp.dat (file name for the TeMIP OSI AM Dictionary). Log files created during the IVP: - /tmp/temip_osi_am_ivp.result - /tmp/temip_osi_am_ivp.remove - /tmp/temip_osi_am_ivp_cmi.log - /tmp/temip_osi_am_ivp_dap.log. Log of a Successful IVP following is an example log of the successful execution a TeMIP OSI AM IVP. ________________________ Note ________________________ Before running the IVP, the configuration must first be set using the following command: setld -c NOEOSIAMV210 CONFIG ______________________________________________________ two warnings shown in this example appear because the account has not set the DECcmi environment variables. IVP uses the default values and sets them. is also important to note that the user root owns the TeMIP Framework environment as the user temip. This is normal default case; otherwise the TeMIP Framework may be different and the installation even if the IVP is successful. setld -v NOEOSIAMV210 Access Module (NOEOSIAMV210) Copyright (c) Digital Equipment Corporation, 1995,1996. 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. Verifying the prerequisite files -------------------------------- Files verified. Installing the TeMIP OSI Management Toolkit Verifying the prerequisite Symbols ---------------------------------- Include /usr/kits/NOE210/temip_osi_am/bin in PATH Include /usr/bin in PATH, to call cmi_srv Include /usr/etc in PATH, to call cmi_startup Verifying the running processes ------------------------------- DECnet is started DECcmi server is not running (cmi_srv) TeMIP OSIAM Client is not running (temip_osi_am) Director is not running (Framework_Watchdog) TeMIP OSIAM Server is not running (temip_osi_server) Verifying values used by DECnet/OSI ----------------------------------- OSI Transport state = On osiamivp OSI Transport template exists Enable DECnet OSI transport Verifying the values used by DECcmi ----------------------------------- Network addess NOEIVP re-defined ... Starting DECcmi server .... Initializing shared memory ... Loading cmi_srv process ... DECcmi - Control and Management Utility [V2.15] ----------------------------------------------- CMU [0079] 1) Process cmi_srv started CMU [0083] 2) MBX cmi_srv opened CMU [0061] 3) Sending ADM_REQ to cmi_srv CMU [0016] Command mode is DEFAULT Prefix CMU [0001] *** Received ADM_CNF from TASK cmi_srv CMU [0065] Sending ADM_CAU to cmi_srv CMU [0035] waiting for ADM_CAUCF from process cmi_srv CMU [0004] *** Received ADM_CAUCF from TASK cmi_srv CMU [0042] Command mode is EXPLICIT Prefix Starting cmi_srv process ... ********************** Bind OK **************************** Set cmi_srv with I125,I126,CI127,CI128 presentation address ... Verifying values used by TeMIP OSIAM server ------------------------------------------- temip_osi_am_configuration.dat is OK Verifying the TeMIP Framework dictionary ---------------------------------------- TeMIP Framework dictionary will be verified later. Start the necessary processes ----------------------------- Executing /usr/kits/NOE210/temip_osi_am/bin/temip_osi_setup Director is not running Start Director executing temip_start ... After Installing the TeMIP OSI Management Toolkit 3-5 Director is running Remove OSI AM application from Dispatch Table ... OSI AM application successfully removed Enroll the OSI AM Client ... OSI AM Client /usr/mcc/mmexe/temip_osi_am successfully enrolled Application osi_am already exists Application osi_am already started OSI AM Set Up has been successfully executed completion of temip_osi_setup /usr/mcc/mmexe/temip_osi_am Client is now running ... Starting temip_osi_server ... TeMIP OSIAM Server started ... Get the Director User account ... Starting the agents ... Testing OSIAM server ... Stopping temip_osi_am_agent_ivp ... Stopping temip_osi_server ... Stopping DECcmi server ... Stopping temip_osi_am client ... The TeMIP Framework OSI_AM application is not removed, but only stopped Stopping TeMIP Framework Director (temip_stop) ... +-------------------------------------------------+ | TeMIP OSIAM IVP has been successfully executed! | +-------------------------------------------------+ the Installation of GDMOXLAT IVP for the GDMO Translator can be run before the Translator is first used, or at any time problems suspected. IVP first checks that a license has been registered and for the GDMO Translator. You cannot run the IVP if have not registered and loaded your license. Start the IVP by entering the following command: # setld -v NOEGXLATV210 The IVP procedure displays: GDMO Translator (NOEGXLATV210) A NOE V210 license has been registered. If any errors appear, please reinstall the product. Verification will take between 1 and 5 minutes depending on CPU type. *********************************************************************** Installing the TeMIP OSI Management Toolkit Beginning Installation Verification Procedure for NOE GDMO Translator V210. *********************************************************************** ...Software Copyright Declaration... Passed *********************************************************************** Installation Verification Procedure for NOE GDMO Translator V210 successfully completed. *********************************************************************** In both cases, success or failure, the IVP places a log of the output in the directory: /usr/var/kits/temip_osi_am/ivp The name of the log file is: noevuuSubset_Nameivp.log where v represents the major software version, uu represents the software version update and Subset_Name represents the software subset you are verifying. the TeMIP OSI Management Toolkit from your System If you need to remove a version of the TeMIP OSI Management Toolkit 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 "NOE" 3. Look for the word "installed" in the listing produced, and then delete the installed subsets. For example: setld -d NOEOSIAMRELV210 setld -d NOEOSIAMV210 _______________________ Warning _______________________ The temip_osi_am_configuration.dat file is saved in /tmp with the .save extension before being removed from the /var/kits/temip_osi_am directory. Remember that the directory /tmp will be removed in the event of a reboot. ______________________________________________________ After Installing the TeMIP OSI Management Toolkit 3-7 A ____________________________________________________________ Pre-Installation Checklist This appendix summarizes the various operations required before installation of the TeMIP OSI Management Toolkit. 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. Installation Before starting a local installation, do the following: < Check that the distribution kit is complete. < Ensure that you have a RISC machine with the correct version of the Digital UNIX operating system installed and running. < Back up the system disk. < Ensure that TeMIP Framework 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 PAK for the product. < Read the online Release Notes. Pre-Installation Checklist A-1 on a RIS Server starting installation on a RIS server, do the in addition to the local installation checks: Note the device special name of the distribution device. from a RIS Server starting installation from a RIS server, do the Ensure that TeMIP NOE 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. Checklist B ____________________________________________________________ Files Installed on your System The following is a complete list of the files installed when you install the TeMIP OSI AM Toolkit V2.1. For each subset the list gives the permissions, the owner and the file names. You can find more information in: o OSI AM Release Notes Subset, Section B.1 o OSI Access Module Subset, Section B.2 o GDMO Subset, Section B.3. AM Release Notes Subset Table B-1 shows the /usr/kits/NOE210/help directory in which the Release Notes files are placed: Table_B-1_Directory_/usr/kits/NOE210/help__________________ Permissions__Owner____Files________________________________ -rw-r-r- root temip_osi_rel_notes.ps -rw-r-r-_____root_____temip_osi_rel_notes.txt______________ Access Module Subset Note that in Table B-4 and Table B-14, it is assumed that temip is the name of the Director User Account. Table B-2 shows the files placed in the /usr/kits/NOE210 directory: Table_B-2_Directory_/usr/kits/NOE210_______________________ Permissions__Owner____Files________________________________ drwxr-xr-x root gdmo drwxr-xr-x root help drwxr-xr-x___root_____temip_osi_am_________________________ Files Installed on your System B-1 B-3 shows the files placed in the directory: B-3 Directory /usr/kits/NOE210/temip_osi_am__________________________________________________________ Owner Files__________________________________________________________ root bin root build root demo root examples root files root kit root lib__________________________________________________________ B-4 shows the files placed in the directory: B-4 Directory /usr/kits/NOE210/temip_osi_am/bin__________________________________________________________ Owner Files__________________________________________________________ temip temip_osi_server temip temip_osi_shutdown temip temip_osi_startup temip temip_osi_setup__________________________________________________________ B-5 shows the files placed in the directory: B-5 Directory /usr/kits/NOE210/temip_osi_am/build__________________________________________________________ Owner Files__________________________________________________________ root temip_osi_am.make root temip_osi_am_agent_mgmt.ms root temip_osi_am_mgmt_if.h root temip_osi_am_mgmt_if.ms root temip_osi_am_register_directives.ms root temip_osi_am_resp_exc_agent.ms root temip_osi_am_vector.mar root types_temip_osi_am_agent_mgmt.ms__________________________________________________________ B-6 shows the files placed in the directory: B-6 Directory /usr/kits/NOE210/temip_osi_am/demo__________________________________________________________ Owner Files__________________________________________________________ root CLIENT root MODEL (continued on next page) Installed on your System Table B-6 (Cont.) Directory /usr/kits/NOE210/temip_osi_ __________________am/demo__________________________________ Permissions__Owner____Files________________________________ -r-r-r- root README.osi_demo drwxr-xr-x___root_____SELF_MGMT____________________________ Table B-7 shows the files placed in the /usr/kits/NOE210/temip_osi_am/demo/CLIENT directory: Table B-7 Directory /usr/kits/NOE210/temip_osi_ __________am/demo/CLIENT___________________________________ Permissions__Owner____Files________________________________ -r-xr-xr-x___root_____osi_demo_build_client.csh____________ Table B-8 shows the files placed in the /usr/kits/NOE210/temip_osi_am/demo/MODEL directory: Table B-8 Directory /usr/kits/NOE210/temip_osi_ __________am/demo/MODEL____________________________________ Permissions__Owner____Files________________________________ -r-xr-xr-x root osi_demo_compile_model.csh -r-xr-xr-x root osi_demo_update_dico.csh -r-r-r- root temip_osi_am_ivp.dg -r-r-r-______root_____temip_osi_am_ivp.g___________________ Table B-9 shows the files placed in the /usr/kits/NOE210/temip_osi_am/demo/SELF_MGMT directory: Table B-9 Directory /usr/kits/NOE210/temip_osi_ __________am/demo/SELF_MGMT________________________________ Permissions__Owner____Files________________________________ -r-xr-xr-x root osi_demo_agent_record.cmd -r-xr-xr-x___root_____osi_demo_entity_record.cmd___________ Table B-10 shows the files placed in the /usr/kits/NOE210/temip_osi_am/examples directory: Table_B-10_Directory_/usr/kits/NOE210/temip_osi_am/examples Permissions__Owner____Files________________________________ -rw-r-r- root cmi_profile.txt -rw-r-r- root temip_osi_am_configuration.dat -rw-r-r- root xom.ini -rw-r-r-_____root_____xom.oid______________________________ Files Installed on your System B-3 B-11 shows the files placed in the directory: B-11 Directory /usr/kits/NOE210/temip_osi_am/files__________________________________________________________ Owner Files__________________________________________________________ root mcc_osiamivp_icon.dat root temip_osi_am_catalog.cat__________________________________________________________ B-12 shows the files placed in the directory: B-12 Directory /usr/kits/NOE210/temip_osi_am/kit__________________________________________________________ Owner Files__________________________________________________________ root CMACMV215.tar root NOEOSIAMRELV210.scp root NOEOSIAMV210.scp root NOEV210.k root NOEV210.mi root runtime_kit_create.csh root temip_osi_am_make_client.csh __________________________________________________________ B-13 shows the files placed in the directory: B-13 Directory /usr/kits/NOE210/temip_osi_am/lib__________________________________________________________ Owner Files__________________________________________________________ root libosiam.a__________________________________________________________ B-14 shows the files placed in the /var/kits/temip_ directory: B-14 Directory /var/kits/temip_osi_am__________________________________________________________ Owner Files__________________________________________________________ temip error temip install.NOEOSIAMRELV210 temip install.NOEOSIAMV210 temip ivp temip temip_osi_am_configuration.dat temip trace__________________________________________________________ Installed on your System OSI AM Subset Links No links are provided. Subset Table B-15 shows the files placed in the /usr/kits/NOE210 directory: Table_B-15_Directory_/usr/kits/NOE210______________________ Permissions__Owner____Files________________________________ drwxr-xr-x root gdmo drwxr-xr-x root help drwxr-xr-x___root_____temip_osi_am_________________________ Table B-16 shows the files placed in the /usr/kits/NOE210/gdmo directory: Table_B-16_Directory_/usr/kits/NOE210/gdmo_________________ Permissions__Owner____Files________________________________ drwxr-xr-x root bin drwxr-xr-x root files drwxr-xr-x root ivp drwxr-xr-x root lib drwxr-xr-x root msl drwxr-xr-x___root_____tools________________________________ Table B-17 shows the files placed in the /usr/kits/NOE210/gdmo/bin directory: Table_B-17_Directory_/usr/kits/NOE210/gdmo/bin_____________ Permissions__Owner____Files________________________________ -rwxr-xr-x root temip_gdmo_browser -rwxr-xr-x___root_____temip_gdmoxlat_______________________ Table B-18 shows the files placed in the /usr/kits/NOE210/gdmo/files directory: Table_B-18_Directory_/usr/kits/NOE210/gdmo/files___________ Permissions__Owner____Files________________________________ -rw-r-r- root temip_gdmo_browser_variables.cfg -rw-r-r-_____root_____temip_gdmoxlat.cfg___________________ Table B-19 shows the files placed in the /usr/kits/NOE210/gdmo/ivp directory: Files Installed on your System B-5 B-19 Directory /usr/kits/NOE210/gdmo/ivp__________________________________________________________ Owner Files__________________________________________________________ root noeV210gxlativp__________________________________________________________ Installed on your System Table B-20 shows the files placed in the /usr/kits/NOE210/gdmo/lib directory: Table_B-20_Directory_/usr/kits/NOE210/gdmo/lib_____________ Permissions__Owner____Files________________________________ -rw-r-r- root temip_ACSE-1.a -rw-r-r- root temip_CMIP-1.a -rw-r-r- root temip_DMI.dg -rw-r-r- root temip_DMI.g -rw-r-r- root temip_G774.g -rw-r-r- root temip_GMI.g -rw-r-r- root temip_IS10589.g -rw-r-r- root temip_IS10733.g -rw-r-r- root temip_IS10737.g -rw-r-r- root temip_M3100.g -rw-r-r- root temip_NMFVOL4.g -rw-r-r- root temip_OIWLIB.g -rw-r-r- root temip_Q821.g -rw-r-r- root temip_SATF.g -rw-r-r- root temip_T1-227.g -rw-r-r- root temip_X501.a -rw-r-r- root temip_mcc_vea_def.h -rw-r-r- root temip_system-log-logrecord.dg -rw-r-r-_____root_____temip_test.g_________________________ Table B-21 shows the files placed in the /usr/kits/NOE210/gdmo/msl directory: Table_B-21_Directory_/usr/kits/NOE210/gdmo/msl_____________ Permissions__Owner____Files________________________________ -rw-r-r- root temip_add_directive.ms -rw-r-r- root temip_cmip_exceptions.ms -rw-r-r- root temip_delete_directive.ms -rw-r-r- root temip_get_directive.ms -rw-r-r- root temip_getevent_directive.ms -rw-r-r- root temip_mcc_managing_director.ms -rw-r-r- root temip_mcc_register_directive.ms -rw-r-r- root temip_mcc_registration_directives.ms -rw-r-r- root temip_mcc_routing_attributes.ms -rw-r-r- root temip_msl_event_args.ms -rw-r-r- root temip_pseudo_built_in_types.ms -rw-r-r- root temip_remove_directive.ms -rw-r-r- root temip_resp_exc_create_directive.ms -rw-r-r- root temip_set_directive.ms (continued on next page) Files Installed on your System B-7 B-21 (Cont.) Directory /usr/kits/NOE210/gdmo/msl__________________________________________________________ Owner Files__________________________________________________________ root temip_show_directive.ms__________________________________________________________ Installed on your System Table B-22 shows the files placed in the /usr/kits/NOE210/gdmo/tools directory: Table_B-22_Directory_/usr/kits/NOE210/gdmo/tools___________ Permissions__Owner____Files________________________________ -rw-r-r- root temip_action_template -rw-r-r- root temip_asn1_template -rw-r-r- root temip_attribute_group_template -rw-r-r- root temip_attribute_template -rw-r-r- root temip_behaviour_template -rw-r-r- root temip_class_template -rw-r-r- root temip_gbrows_browser_window.uid -rw-r-r- root temip_gbrows_dialog_box.uid -rw-r-r- root temip_gbrows_editor_window.uid -rw-r-r- root temip_gbrows_mit_window.uid -rw-r-r- root temip_gbrows_name_binding_window.uid -rw-r-r- root temip_gbrows_translator_window.uid -rw-r-r- root temip_gbrows_view_window.uid -rw-r-r- root temip_mcc_argument_template -rw-r-r- root temip_mcc_attribute_group_template -rw-r-r- root temip_mcc_attribute_template -rw-r-r- root temip_mcc_directive_template -rw-r-r- root temip_mcc_entity_template -rw-r-r- root temip_mcc_event_template -rw-r-r- root temip_mcc_exception_template -rw-r-r- root temip_mcc_response_template -rw-r-r- root temip_mit_template -rw-r-r- root temip_name_binding_template -rw-r-r- root temip_notification_template -rw-r-r- root temip_package_template -rw-r-r-_____root_____temip_parameter_template_____________ Table B-23 shows the files placed in the /usr/lib/X11/help/temip_gbrowser directory: Table_B-23_Directory_/usr/lib/X11/help/temip_gbrowser______ Permissions__Owner____Files________________________________ -rw-r-r- root About -rw-r-r-_____root_____Overview_____________________________ GDMO Translator Subset Links No links are provided. Files Installed on your System B-9 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. 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: *** Enter Subset Selections *** The subsets listed below are optional: 1) OSI AM Release Notes 2) TeMIP OSI Access Module 3) GDMO Translator 4) All of the Above 5) None of the Above 6) Exit without installing subsets Enter your choice(s): 1 /usr: write failed, file system is full *** Enter Subset Selections *** The subsets listed below are optional: 1) TeMIP OSI Access Module 2) GDMO Translator 3) OSI AM Release Notes 4) All of the Above 5) None of the Above 6) Exit without installing subsets Enter your choice(s): 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 During Product Use an error occurs while the TeMIP OSI Management Toolkit in use and you believe the error is caused by a problem the product, take one of the following actions: 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 OSI Management Toolkit 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 OSI Management Toolkit 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 OSI Management Toolkit 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. the problem is related to TeMIP OSI Management Toolkit you can report the problem to the CSC (if have a Software Product Services Support Agreement and problem is severe). from Errors ________________________________________________________ Index Installation Verification ______________________ Procedure, 2-3, 3-1, 3-6 the installation, 1-7 Installing TeMIP OSI See Installation Toolkit, 3-1 to Invoking from a CDROM, 2-2 from a RIS server, 2-2 from a system directory, 2-1______________________ the RIS Utility, 2-8 (BOM), IVP See Installation Verification______________________ Procedure checklist L _______________________________ GDMO, License the system, Management Facility, 1-6 registration, 1-6 List of files installed, B-1______________________ LMF TeMIP OSI See License Management subsets, Facility 1-4 Local installation, 2-6 kit, Logging on, 1-2 ______________________ M______________________________ B-1 Menu Notes Subset, B-1 RIS Utility, 2-8 Subset, B-5 RIS Utility Software AM Subset, B-1 Installation, 2-8 ______________________ P _______________________________ requirements, PAK See Product Authorization Key______________________ Preparing to install TeMIP OSI Management Toolkit, 1-1 to the, 1-7 for, A-1 Product Authorization Key the, registering the, 1-6 2-6 Notes, 2-3 R_________________________OSI__ Management 2-1 to 2-9 Recovering from installation server area, 2-8 errors, 1-7 from errors, 1-7 Release Notes 2-3, 3-6 directory, 2-4 types files installed, 2-4 1-1 installing the, 2-3 Index-1 S_____________________1-4______ 1-2 Software requirements, 1-2 registration, 1-6 Software subsets, 3-1 types, 1-2 checking the, 1-3 system, 1-2 choosing the, 2-5, 2-6 1-2 System backup, 1-3 subsets, 1-2, 1-3 System configuration, 2-2, 3-1 backup, 1-3 Framework, 1-2 T _______________________________ 1-2 temip user account, 1-5 Time requirements, 1-2 2-8 invocation, 2-8 U_________________________Menu, 2-8 Software Installation User account, 1-5 2-8 Using the Director User Account, 1-5