TeMIP_ASCII_Management_Toolkit_________________ Installation Guide Order Number: AA-QFZ4D-TE This guide describes how to install the TeMIP ASCII Management Toolkit on your Digital UNIX AXP RISC system. Revision/Update Information: V3.1.0 This edition supersedes the V3.0 edition Operating System and Version: Digital UNIX Version 3.2 Software Version: TeMIP ASCII Management Toolkit V3.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. TeMIP and TeMIP Framework are trademarks of Equipment Corporation. UNIX - UNIX is a registered trademark in the United and other countries licensed exclusively through Company Ltd. UNIX V3.2C is an X/Open UNIX 93 branded product. document is available on CDROM. document was prepared using VAX DOCUMENT, Version 2.1. _____________________________________________________ Contents .............................................. v to Install the TeMIP ASCII 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-3 Registration............................. 1-4 the Installation and Recovering from ........................................... 1-5 the TeMIP ASCII Management Toolkit the Installation Procedure.............. 2-1 Installation of the TeMIP ASCII AM Toolkit ........................................ 2-2 Installation of the TeMIP ASCII AM .......................................... 2-4 Server Update................................ 2-5 the TeMIP ASCII Management Toolkit your System for the ASCII AM......... 3-1 the TeMIP ASCII Management Toolkit from System...................................... 3-1 Checklist Installation............................... A-1 on a RIS Server..................... A-2 from a RIS Server................... A-2 iii Installed on your System TeMIP ASCII AM Toolkit Documents Subset.......... B-1 TeMIP ASCII AM Toolkit........................... B-1 from Errors Failures During Product Installation ............ C-1 Failures During Product Use...................... C-2 TeMIP ASCII Management Toolkit Distribution Kits for Digital UNIX.......................... 1-2 Disk Space Requirements ....................... 1-3 Directory /usr/kits/TAT310/temip_ascii/doc .... B-1 Directory /usr/kits/TAT310/temip_ascii ........ B-1 Directory /usr/kits/TAT310/temip_ascii/dist ... B-2 Directory /usr/kits/TAT310/temip_ascii/dist/data......... B-2 Directory /usr/kits/TAT310/temip_ascii/dist/master....... B-2 Directory /usr/kits/TAT310/temip_ascii/dist/master/etc... B-2 Directory /usr/kits/TAT310/temip_ascii/dist/master/usr... B-2 Directory /usr/kits/TAT310/temip_ascii/dist/master/usr/bin . B-3 Directory /usr/kits/TAT310/temip_ascii/dist/master/usr/mcc . B-3 Directory /usr/kits/TAT310/temip_ascii/dist/master/usr/ucb . B-3 Directory /usr/kits/TAT310/temip_ascii/include........... B-3 Directory /usr/kits/TAT310/temip_ascii/src .... B-3 Directory /usr/kits/TAT310/temip_ascii/src/am............ B-5 Directory /usr/kits/TAT310/temip_ascii/src/class......... B-6 Directory /usr/kits/TAT310/temip_ascii/src/parser........ B-6 Directory /usr/kits/TAT310/temip_ascii/src/parser/ex..... B-6 Directory /usr/kits/TAT310/temip_ascii/src/sink.......... B-7 ____________________________________________________________ Preface This guide describes how to install the TeMIP ASCII Management Toolkit software on a Digital UNIX [R] + AXP RISC system. Audience This guide is intended for personnel who are responsible for installing the TeMIP ASCII Management Toolkit on a Digital UNIX AXP RISC system, for example: o A system manager installing the TeMIP ASCII Management Toolkit on a local system. o A system manager installing the TeMIP ASCII Management Toolkit from the Remote Installation Services (RIS) server area of a remote system. o A RIS manager installing the TeMIP ASCII Management Toolkit onto 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 ASCII Management Toolkit software. o Chapter 2 describes the installation of the TeMIP ASCII Management Toolkit files 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 ASCII 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) TeMIP OSI Management Toolkit OSI Access Module Run-Time Kit Installation Guide (AA-QEMRD-TE) TeMIP ASCII Management Toolkit, Installation Guide (AA- QFZ4D-TE) (This Document) 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 ASCII Management Toolkit This chapter describes the requirements and preparation necessary for installing the TeMIP ASCII Management Toolkit. The installation procedures described in this guide apply only to the TeMIP ASCII Management Toolkit V3.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, see Section 1.1 o Installation Requirements, see Section 1.2 o License Registration, see Section 1.3 o Aborting the Installation and Recovering from Errors, see 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 ASCII Management Toolkit can be installed directly on your local system. RIS Installation The TeMIP ASCII Management Toolkit can be installed from a RIS server area of a remote system. If you intend to install the TeMIP ASCII Management Toolkit on your system in this way, ensure the following: o A TeMIP ASCII Management Toolkit kit 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 ASCII Management Toolkit are described in Section 1.2.1 to Section 1.2.7 and a checklist is provided in Appendix A. Preparing to Install the TeMIP ASCII Management Toolkit 1-1 and Software minimum hardware and software requirements for of the TeMIP ASCII Management Toolkit are follows: TeMIP ASCII Management Toolkit can be installed on any UNIX Alpha AXP machine. install the TeMIP ASCII Management Toolkit you require Digital UNIX Version 3.2 operating system running on a machine, along with its Software Development Utilities Internationalisation Development Environment. The TeMIP V3.1 and TeMIP Developer's Toolkit V3.1 should 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 ASCII Management Toolkit can be installed on a UNIX AXP RISC system from the types of media shown Table 1-1: 1-1 TeMIP ASCII Management Toolkit Distribution Kits for Digital UNIX__________________________________________________________ Label__________________________________________________________ ROM TeMIP ASCII Management Toolkit__________________________________________________________ distribution kit contains the following TeMIP ASCII Toolkit software subsets: TeMIP ASCII AM Toolkit (TATBASEV310) TeMIP ASCII AM Toolkit Documents (TATDOCV310). Required to Install installation of the TeMIP ASCII Management Toolkit approximately 3 minutes, depending on the media and system configuration. 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 Management Toolkit software and to register the PAK. can set the current working directory to the top level root) directory using the following command: cd / to Install the TeMIP ASCII Management Toolkit Backing Up the System Disk Digital strongly recommends that you back up your complete system disk or at least the /usr partition. Intallation of the TeMIP ASCII Management Toolkit involves writing to this partition. Checking the Required Software Subsets You require the following Digital UNIX and TeMIP Framework software subsets: o OSFBASE3xx, Base System o OSFPGMR3xx, Software Development Environment o TFRBASEV3xx, TeMIP Framework Basic Management System o TFRTKV3xx, TeMIP Framework Developer's Toolkit. o CXXSHRDA3xx, DEC C++ class library Run-Time Support. To check that these subsets are present enter the following commands: # /etc/setld -i | grep OSF # /etc/setld -i | grep TFR # /etc/setld -i | grep CXX The subsets installed are displayed along with any related patch names as shown below: OSFBASE310 installed Base System OSFPGMR310 installed Software Development Environment TFRBASEV310 installed TeMIP Framework Basic Management System (patch x) TFRTKV310 installed TeMIP Framework Developer's Toolkit (patch x) CXXSHRDA31x installed DEC C++ class library Run-Time Support If a subset is not present, the word installed is not displayed. Disk Space Requirements The different TeMIP ASCII Management Toolkit software subsets require different amounts of disk space, as shown in Table 1-2. 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. Table_1-2_Disk_Space_Requirements__________________________ Disk Space in Software_Subset___________________Disk_Space__/usr/kits____ ASCII AM for Digital UNIX RISC 1799 KB 3695 KB ASCII AM Documents for Digital 320 KB 620 KB UNIX_RISC__________________________________________________ The installation procedure creates the following directory if it does not already exist: o /usr/kits/TAT310 Preparing to Install the TeMIP ASCII Management Toolkit 1-3 the amount of free disk space on your system as Using the column in Table 1-2 that applies to your system, total the values for the subsets you intend to load. Determine the current amount of free space in the directory /usr/kits using the following command: # df -k /usr/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 indicates that there are 1515 KB free in the rz0a on which the /usr file system is mounted. In this there is not enough free disk space to install TeMIP ASCII Management Toolkit. You would have to the disk space available for installation or mount file system on the /usr/kits directory. Refer to Digital UNIX System Administration documentation for of how to increase free disk space. 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 ASCII 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 ASCII Management unless 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 ASCII 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-ASCII-AM-DK-OSF1 active unlimited to Install the TeMIP ASCII Management Toolkit For further details of how to use the License Management Utility, refer to the Digital UNIX License Management Utility Reference Manual. 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 ASCII 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 has been 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 ASCII Management Toolkit 1-5 2 ____________________________________________________________ Installing the TeMIP ASCII Management Toolkit This chapter describes how to install the TeMIP ASCII 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 ASCII Management Toolkit. ________________________ Note ________________________ If a subset is already installed, you must deinstall it before installing a new version, see Section 3.2. ______________________________________________________ You can find more information in: o Starting the Installation Procedure, see Section 2.1 o Local Installation of the TeMIP ASCII AM Toolkit Documents, see Section 2.2 o Local Installation of the TeMIP ASCII AM Toolkit, see Section 2.3 o RIS Server Update, see Section 2.4. 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 ASCII Management Toolkit subsets. You can start the installation procedure in the following ways: From a System Directory If you are installing the TeMIP ASCII Management Toolkit from a system directory, issue the following command from the directory in which the files are located: # setld -l . From a CDROM If you are installing the TeMIP ASCII Management Toolkit from a CDROM, include the device special name of the CDROM driver where the media is mounted. Enter the following command, replacing N with the actual logical unit number of the CDROM driver you are using: # mount -r /dev/rzNc /mnt Now issue the load command as follows: # setld -l /mnt/kit Installing the TeMIP ASCII Management Toolkit 2-1 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 ASCII bookshelf (ascii_am_tkinst.decw_bookshelf) - A TAT310 directory containing the book. Now add the following command in the Bookreader library file on one line: SHELF\/usr/lib/dxbook/ascii_am_tkinst.decw_bookshelf\TeMIP ASCII Management Toolkit V310 ________________________ Note ________________________ You cannot use the Bookreader files on a VMS system. ______________________________________________________ installation is complete you must unmount the media the following command: umount /mnt a RIS Server install the TeMIP ASCII Management Toolkit subsets that in a /var/adm/ris distribution area of a remote include the name of the RIS server system where TeMIP ASCII Management Toolkit subsets are located. example, if you are loading the TeMIP ASCII Management subsets from a RIS distribution area on the node , enter the following command: setld -l bigsys: Installation of the TeMIP ASCII AM Toolkit Documents TeMIP ASCII AM Toolkit Documents subset contains following documents as MS-Word files (the last documents are templates to be modified during the process): TeMIP ASCII Management Toolkit, Customization Manual TeMIP ASCII Management Toolkit ASCII AM, System Manager's Manual TeMIP ASCII Management Toolkit ASCII AM, Module Reference Manual TeMIP ASCII Management Toolkit ASCII AM, User's Manual. the TeMIP ASCII Management Toolkit Install the TeMIP ASCII AM Toolkit Documents as follows: o Start the installation procedure and choose the TeMIP ASCII AM Toolkit Documents option from the menu: *** Enter Subset Selections *** 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 ASCII AM Toolkit Documents 2) TeMIP ASCII AM Toolkit 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): 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 optional subsets: TeMIP ASCII AM Toolkit Documents Is this correct? (y/n): o 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 selected subsets: File system space checked OK. Starting installation of TeMIP ASCII AM Toolkit Documents V310. ...Software Copyright declaration.... The installation will complete in 2 to 3 minutes depending on processor type. TeMIP ASCII AM Toolkit Documents Copying from . (disk) Verifying TeMIP ASCII AM Toolkit Documents V310 installation complete. Configuring "TeMIP ASCII AM Toolkit Documents" (TATDOCV310) o The documents are installed in the directory: /usr/kits/TAT310/temip_ascii/doc. The names of the files are: o tat_cust.doc o tat_mrm.doc o tat_sys.doc Installing the TeMIP ASCII Management Toolkit 2-3 o tat_use.doc. Installation of the TeMIP ASCII AM Toolkit the TeMIP ASCII AM Toolkit locally as follows: Start the installation procedure and choose the TeMIP ASCII AM 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 ASCII AM Toolkit 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): 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 ASCII AM Toolkit 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: Checking file system space required to install selected subsets: File system space checked OK. Starting installation of TeMIP ASCII AM Toolkit V310. ...Software Copyright declaration.... The installation will complete in 2 to 3 minutes depending on processor type. TeMIP ASCII AM Toolkit Copying from . (disk) Verifying TeMIP ASCII AM Toolkit V310 installation complete. Configuring "TeMIP ASCII AM Toolkit" (TATBASEV310) the TeMIP ASCII Management Toolkit Server Update You can install the TeMIP ASCII Management Toolkit 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 ASCII Management Toolkit, complete the following tasks: o Mount the media on the distribution device. o 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: 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): /usr/users/asciiam /kit/install o Enter the directory name and press . An options menu is displayed. Choose one of the following options: 1) Extract software from /usr/users/asciiam/kit/install 2) Create symbolic link to /usr/users/asciiam/kit/install Enter your choice: Installing the TeMIP ASCII Management Toolkit 2-5 Enter 2 and press . TeMIP ASCII 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: If you have nothing more to install, enter e and press . the TeMIP ASCII Management Toolkit 3 ____________________________________________________________ After Installing the TeMIP ASCII Management Toolkit This chapter tells you how to configure your system. You can find more information in: o Configuring your System for the ASCII AM, see Section 3.1 o Deleting the TeMIP ASCII Management Toolkit from your System, see Section 3.2. your System for the ASCII AM After installation, the source files of the toolkit are in the directory /usr/kits/TAT310/temip_ascii. In order to perform the customization, you must copy this directory to the $HOME directory of the user performing the customization. Issue the following command where specifies the login name of the user: 1. Log in as 2. Enter the following commands: umask 22 cp -r /usr/kits/TAT310/temip_ascii $HOME the TeMIP ASCII Management Toolkit from your System If you must remove a version of the TeMIP ASCII 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 "TAT" 3. Look for the word "installed" in the listing produced, and then delete the installed subsets. For example: setld -d TATBASEV310 setld -d TATDOCV310 ________________________ Note ________________________ Some files located under /usr/kits/TAT310 will not be removed by the setld -d command. This has to be done manually. ______________________________________________________ After Installing the TeMIP ASCII Management Toolkit 3-1 A ____________________________________________________________ Pre-Installation Checklist This appendix summarizes the various operations required before installation of the TeMIP ASCII 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, see Section A.1 o Installation on a RIS Server, see Section A.2 o Installation from a RIS Server, see 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. < 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 TAT 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 ASCII AM Toolkit V3.1. For each subset the list gives the permissions, the owner and the file names. You can find more information in: o TeMIP ASCII AM Toolkit Documents Subset, see Section B.1 o TeMIP ASCII AM Toolkit, see Section B.2. ASCII AM Toolkit Documents Subset Table B-1 shows the /usr/kits/TAT310/temip_ascii/doc directory in which the Document files are placed: Table_B-1_Directory_/usr/kits/TAT310/temip_ascii/doc_______ Permissions__Owner____Files________________________________ -rw-r-r- root tat_cust.doc -rw-r-r- root tat_mrm.doc -rw-r-r- root tat_sys.doc -rw-r-r-_____root_____tat_use.doc__________________________ ASCII AM Toolkit Table B-2 shows the files placed in the /usr/kits/TAT310/temip_ascii directory: Table_B-2_Directory_/usr/kits/TAT310/temip_ascii___________ Permissions__Owner____Files________________________________ -rw-r-r- root Makefile drwxr-xr-x root dist drwxr-xr-x root doc drwxr-xr-x root include drwxr-xr-x___root_____src__________________________________ Table B-3 shows the files placed in the /usr/kits/TAT310/temip_ascii/dist directory: Files Installed on your System B-1 B-3 Directory /usr/kits/TAT310/temip_ascii/dist__________________________________________________________ Owner Files__________________________________________________________ root data root master root output__________________________________________________________ B-4 shows the files placed in the directory: B-4 Directory /usr/kits/TAT310/temip_ascii/dist/data__________________________________________________________ Owner Files__________________________________________________________ root scps__________________________________________________________ B-5 shows the files placed in the directory: B-5 Directory /usr/kits/TAT310/temip_ ascii/dist/master__________________________________________________________ Owner Files__________________________________________________________ root etc root usr__________________________________________________________ B-6 shows the files placed in the directory: B-6 Directory /usr/kits/TAT310/temip_ ascii/dist/master/etc__________________________________________________________ Owner Files__________________________________________________________ root temip_ascii_profiles.def root temip_ascii_start_fe__________________________________________________________ B-7 shows the files placed in the directory: B-7 Directory /usr/kits/TAT310/temip_ ascii/dist/master/usr__________________________________________________________ Owner Files__________________________________________________________ root bin root mcc root ucb__________________________________________________________ B-8 shows the files placed in the directory: Installed on your System Table B-8 Directory /usr/kits/TAT310/temip_ __________ascii/dist/master/usr/bin________________________ Permissions__Owner____Files________________________________ -rwxr-xr-x root temip_ascii_comms -rwxr-xr-x___root_____temip_ascii_passthrough______________ Table B-9 shows the files placed in the /usr/kits/TAT310/temip_ascii/dist/master/usr/mcc directory: Table B-9 Directory /usr/kits/TAT310/temip_ __________ascii/dist/master/usr/mcc________________________ Permissions__Owner____Files________________________________ drwxr-xr-x root en_US.ISO8859-1 drwxr-xr-x root install drwxr-xr-x___root_____mmexe________________________________ Table B-10 shows the files placed in the /usr/kits/TAT310/temip_ascii/dist/master/usr/ucb directory: Table B-10 Directory /usr/kits/TAT310/temip_ ___________ascii/dist/master/usr/ucb_______________________ Permissions__Owner____Files________________________________ -r-xr-xr-x___root_____temip_ascii_setup____________________ Table B-11 shows the files placed in the /usr/kits/TAT310/temip_ascii/include directory: Table_B-11_Directory_/usr/kits/TAT310/temip_ascii/include__ Permissions__Owner____Files________________________________ -rw-r-r- root desc_macros.h -rw-r-r- root inet_io_def.h -rw-r-r- root pack_util.h -rw-r-r- root temip_ascii.h -rw-r-r-_____root_____temip_ascii_putilv.h_________________ Table B-12 shows the files placed in the /usr/kits/TAT310/temip_ascii/src directory: Table_B-12_Directory_/usr/kits/TAT310/temip_ascii/src______ Permissions__Owner____Files________________________________ drwxr-xr-x root am drwxr-xr-x root class (continued on next page) Files Installed on your System B-3 B-12 (Cont.) Directory /usr/kits/TAT310/temip_ ascii/src__________________________________________________________ Owner Files__________________________________________________________ root parser root sink__________________________________________________________ Installed on your System Table B-13 shows the files placed in the /usr/kits/TAT310/temip_ascii/src/am directory: Table_B-13_Directory_/usr/kits/TAT310/temip_ascii/src/am___ Permissions__Owner____Files________________________________ -rw-r-r- root Makefile -rw-r-r- root chklmf -rw-r-r- root mcc_ascii_icon.dat -rw-r-r- root mcc_lock.c -rw-r-r- root ops_evc_common_services.c -rw-r-r- root temip_ascam_mom.c -rw-r-r- root temip_ascii__create.c -rw-r-r- root temip_ascii__create.h -rw-r-r- root temip_ascii__delete.c -rw-r-r- root temip_ascii__delete.h -rw-r-r- root temip_ascii__getevent.c -rw-r-r- root temip_ascii__getevent.h -rw-r-r- root temip_ascii__set.c -rw-r-r- root temip_ascii__set.h -rw-r-r- root temip_ascii__show.c -rw-r-r- root temip_ascii__show.h -rw-r-r- root temip_ascii_am.c -rw-r-r- root temip_ascii_am_be.scp -rw-r-r- root temip_ascii_am_fe.scp -rw-r-r- root temip_ascii_co_lmf.c -rw-r-r- root temip_ascii_co_lmf_private.h -rw-r-r- root temip_ascii_hash.c -rw-r-r- root temip_ascii_hash.h -rw-r-r- root temip_ascii_co_lmf_public.h -rw-r-r- root temip_ascii_ops_def.h -rw-r-r-_____root_____temip_ascii_trace.h__________________ Files Installed on your System B-5 B-14 shows the files placed in the directory: B-14 Directory /usr/kits/TAT310/temip_ascii/src/class__________________________________________________________ Owner Files__________________________________________________________ root Makefile root make_com.sh root mcc_appl_passthrough.tpl root temip_ascii_am_mgt_if.ms root temip_ascii_am_srvc_if.tpl root temip_ascii_am_vector.tpl root temip_ascii_class_hierarchy root temip_ascii_compclass.c root temip_ascii_osi_alarms.ms root temip_ascii_osi_types.ms__________________________________________________________ B-15 shows the files placed in the directory: B-15 Directory /usr/kits/TAT310/temip_ ascii/src/parser__________________________________________________________ Owner Files__________________________________________________________ root ex root generic.c root generic.h root genericcommon.h root main.c root osi_types_defs_complements.h root temip_ascii_api.c root temip_ascii_api_def.h root temip_ascii_udpip.c__________________________________________________________ B-16 shows the files placed in the directory: B-16 Directory /usr/kits/TAT310/temip_ ascii/src/parser/ex__________________________________________________________ Owner Files__________________________________________________________ root Makefile root mapper.c root mapper.h root parser.l root parser.y root sizes.h__________________________________________________________ Installed on your System Table B-17 shows the files placed in the /usr/kits/TAT310/temip_ascii/src/sink directory: Table_B-17_Directory_/usr/kits/TAT310/temip_ascii/src/sink_ Permissions__Owner____Files________________________________ -rw-r-r- root Makefile -rw-r-r- root mcc_evcam_include.h -rw-r-r- root mcc_evcam_trace.h -rw-r-r- root ops_evc_util.c -rw-r-r- root ssdef.h -rw-r-r- root temip_ascii_event_sink.c -rw-r-r- root temip_ascii_udpip.c -rw-r-r-_____root_____temip_ascii_xlate_event.c____________ Files Installed on your System B-7 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, see Section C.1 o Failures During Product Use, see 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: 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 ASCII AM Toolkit 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 /: write failed, file system is full 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 ASCII AM Toolkit 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): Recovering from Errors C-1 can occur during the installation if any of the conditions exist: The operating system version is incorrect. The prerequisite software version is incorrect. There is insufficient disk space. descriptions of error messages generated by these refer to the Digital UNIX Documentation on messages, recovery procedures, and Digital UNIX installation. During Product Use an error occurs while the TeMIP ASCII 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 ASCII 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 TeMIP ASCII 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 ASCII 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. from Errors If the problem is related to the TeMIP ASCII Management Toolkit documentation you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe). Recovering from Errors C-3 ________________________________________________________ Index Installation (cont'd) ______________________ on a RIS, 2-5 the installation, 1-5 recovering from errors, 1-5 TeMIP ASCII Installation types Toolkit, 3-1 local, 1-1 RIS, 1-1 Installing______________________ See Installation (BOM), Invoking files, from a CDROM, 2-1 from a RIS server, 2-2 from a system directory, 2-1______________________ the RIS Utility, 2-5 checklist L______________________________ the system, 3-1 License Management Facility, 1-4______________________ License registration, 1-4 TeMIP List of files installed, B-1 Toolkit subsets, LMF See License Management 1-3 Facility kit, Local installation, 2-4 Logging on, 1-2 2-4 2-4 M the, 2-2 _______________________________ Menu RIS Utility, 2-5______________________ RIS Utility Software B-1 Installation, 2-5 AM Subset, B-1 P AM Toolkit Subset _______________________________ PAK See Product Authorization Key Preparing to install TeMIP______________________ ASCII Management Toolkit, requirements, 1-1 to 1-5 Product Authorization Key______________________ registering the, 1-4 the, 1-5 R _______________________________ for, Recovering from installation the, errors, 1-5 2-4 Requirements files, disk space, 1-3 2-2 hardware, 1-2 ASCII license registration, 1-4 2-1 Index-1 Utility Software Installation (cont'd) Menu, 2-5 types, system, 1-2 S_______________________1-2____ subsets, 1-2, 1-3 Software requirements, 1-2 backup, 1-3 Software subsets Framework, 1-2 checking the, 1-3 1-2 choosing the, 2-4 System backup, 1-3 2-5 System configuration, 3-1 invocation, Menu, 2-5 T _______________________________ Time requirements, 1-2