CDA Converter Library Installation Guide Order Number: AA-PD7VA-TE November 1990 This document contains instructions for installing the CDA Converter Library on the VMS and ULTRIX operating systems. It also explains how to read the online release notes before or after installing the product. This document applies to the CDA Converter Library Version 1.1. Revision/Update Information: This manual supersedes the CDA Converter Library Installation Guide (Order Number: AA-NG87B- TE). Operating System and Version: VMS Version 5.3 or higher ULTRIX Version 3.1 or higher UWS Version 2.2 or higher Future maintenance releases of the CDA Converter Library may require higher versions. Software Version: CDA Converter Library Version 1.1 digital equipment corporation maynard, massachusetts ___________________________________________________ First Printing, November 1990 © 1990. The following are trademarks of Digital Equipment Corporation: CDA DECwindows UNIBUS DDIF DECwrite VAX DDIS DIGITAL VAXcluster DEC DTIF VAX RMS DECalc LN03 VAXstation DECalc-PLUS PrintServer 40 VMS DECchart Q-bus XUI DECdecision ReGIS Xway DECnet TEAMDATA DECUS ULTRIX DIGITAL ZK5479 This document was prepared using VAX DOCUMENT, Version 1.2 -3 Contents ________________________________________________________________ Preface ......................................................... v ________________________________________________________________ Chapter 1 Installing the CDA Converter Library for VMS 1.1 Before You Install the CDA Converter Library on VMS............................................... 1-1 1.1.1 Prerequisite Software..................... 1-1 1.1.2 Optional Software.......................... 1-1 1.1.3 Accessing the Online Release Notes...... 1-2 1.1.4 Installation Procedure Requirements..... 1-2 1.1.5 User Account Quotas and Privileges...... 1-2 1.1.6 VMS License Management Facility ......... 1-3 1.1.7 Special Requirements ...................... 1-4 1.1.8 Using VMSINSTAL............................ 1-4 1.2 Installing the CDA Converter Library on VMS ... 1-6 1.3 Running the Installation Verification Procedure Separately on VMS...................... 1-14 1.4 Error Conditions on VMS........................... 1-15 1.5 Sample Installation on VMS ....................... 1-16 iii ________________________________________________________________ Chapter 2 Installing the CDA Converter Library for ULTRIX (VAX) 2.1 Before You Install the CDA Converter Library on ULTRIX (VAX).................................... 2-1 2.1.1 Installation Prerequisites ............... 2-1 2.1.2 Distribution Media......................... 2-2 2.1.3 Accessing the Online Release Notes and Command Files .............................. 2-10 2.2 Installing the CDA Converter Library on ULTRIX (VAX)................................................ 2-10 2.3 Performing the Installation on ULTRIX (VAX) ... 2-11 2.3.1 9-Track Magnetic Tape and TK50 Tape Cartridge Users............................ 2-12 2.4 After the Installation on ULTRIX (VAX) ......... 2-12 2.5 Sample Installation on ULTRIX (VAX)............. 2-13 ________________________________________________________________ Chapter 3 Installing the CDA Converter Library for ULTRIX (RISC) 3.1 Before You Install the CDA Converter Library on ULTRIX (RISC)................................... 3-1 3.1.1 Installation Prerequisites ............... 3-1 3.1.2 Distribution Media......................... 3-2 3.1.3 Accessing the Online Release Notes and Command Files .............................. 3-10 3.2 Installing the CDA Converter Library on ULTRIX (RISC)............................................... 3-11 3.3 Performing the Installation on ULTRIX (RISC) .. 3-11 iv 3.3.1 9-Track Magnetic Tape and TK50 Tape Cartridge Users............................ 3-12 3.4 After the Installation on ULTRIX (RISC)........ 3-13 3.5 Sample Installation on ULTRIX (RISC)............ 3-13 ________________________________________________________________ Index v Preface ________________________________________________________________ This document describes how to install the CDA Converter Library on the VMS, ULTRIX (VAX), and ULTRIX (RISC) operating systems. It is intended for system managers. Keep this docu- ment with your distribution kit. You will need it to install maintenance updates or to reinstall the CDA Converter Library for any other reason. Maintenance Updates This document applies to the CDA Converter Library Version 1.1. A major version number is represented by the digits to the left of the decimal point, and a maintenance update version number is indicated by the digits to the right of the decimal point. Digital may periodically issue maintenance updates of the CDA Converter Library. Each update consists of an instal- lation kit. You should install this kit as described in this document or in any documentation that may accompany the maintenance update. Each time a maintenance update is released, the version num- ber changes. For example, if the current version is 1.0, the version number of the first maintenance update will be 1.1. In addition, each maintenance update includes new release v notes. The release notes describe the changes that have been made to the CDA Converter Library since the previous release. The updated release notes are provided on line. You should read the release notes when you first install the CDA Converter Library; they are also accessible at any time after the product is installed. For information on reading the re- lease notes when you are installing the CDA Converter Library on VMS systems, follow the installation procedure through step 4 in Section 1.2. To locate the release notes after the CDA Converter Library is installed on VMS, display or print the file SYS$HELP:CDACVTLIB011.RELEASE_NOTES. To locate the re- lease notes after the CDA Converter Library is installed on ULTRIX (VAX) display or print the file /usr/kits/CDA110 /release.notes To locate the release notes after the CDA Converter Library is installed on ULTRIX (RISC) display or print the file /usr/kits/CDR110/release.notes Determining and Reporting Problems If an error occurs while you are using the CDA Converter Library and you believe that the error is caused by a problem with the CDA Converter Library, take one of the following actions: o If you purchased the CDA Converter Library within the past 90 days and you think the problem is caused by a software error, you can submit a Software Performance Report (SPR). o If you have a Basic or DECsupport Software Agreement, you should call your Customer Support Center. With these services, you receive telephone support that provides high-level advisory and remedial assistance. For more information, contact your local Digital representative. o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). vi If you find an error in the CDA Converter Library documen- tation, you should fill out and submit a Reader's Comments form from the back of the document in which the error was found. Include the section and page number where the error was found. Preparing to Install the CDA Converter Library Your bill of materials (BOM) and indented bills report (BIL) specify the number and contents of your media. Be sure to check the contents of your kit against this information. If your kit is damaged or if you find that parts of it are missing, call your Digital representative. Distribution media must be mounted in numerical order. The installation procedure prompts you to mount the volumes. For more information on how to mount distribution media, see your processor-specific installation/operations guide, which also details several options to the installation procedure. The installation procedure is described step-by-step and is, for the most part, self-explanatory. The system prompts you to answer questions and to change volumes, and waits for you to tell it to continue. Conventions Defaults appear in brackets ([]) throughout the installation procedure. Text you type is shown in bold. For more information about installing the CDA Converter Library on VMS or ULTRIX systems, see your processor-specific installation/operations guide. vii Chapter 1 Installing the CDA Converter Library for VMS ________________________________________________________________ This chapter describes how to install the CDA Converter Library on VMS systems. ____________________________________________________________ 1.1 Before You Install the CDA Converter Library on VMS This section describes the prerequisites for installing the CDA Converter Library on VMS systems. ____________________________________________________________ 1.1.1 Prerequisite Software The CDA Converter Library Version 1.1 requires VMS Version 5.3 or higher and DECwindows with the application files option. ____________________________________________________________ 1.1.2 Optional Software The Graphics back end that is installed with the CDA Converter Library Version 1.1 requires the DEC GKS Run-Time Library (RTL) Version 4.0. The installation procedure in- stalls the Graphics back end, but does not check whether the DEC GKS Run-Time Library is installed on your system. Installing the CDA Converter Library for VMS 1-1 If the DEC GKS RTL is not installed on your system at the time of the CDA Converter Library installation, the IVP dis- plays an informational message and does not attempt to test the Graphics back end. Users who need to use the Graphics back end can install the DEC GKS Run-Time Library later. To determine which version of DEC GKS is currently installed on your system, use the following command: $ ANALYZE/IMAGE SYS$LIBRARY:GKSRTLIB Look at the version number field that is displayed. ____________________________________________________________ 1.1.3 Accessing the Online Release Notes The CDA Converter Library provides online release notes. The prompt to display or print the release notes during the installation appears in step 4 of the installation procedure when you invoke VMSINSTAL with the OPTIONS N parameter. To obtain the release notes after the installation, type or print the file SYS$HELP:CDACVTLIB011.RELEASE_NOTES. ____________________________________________________________ 1.1.4 Installation Procedure Requirements The installation takes approximately 12 to 20 minutes, de- pending on the type of media and your system configuration. Before installing the CDA Converter Library, you must have the following privileges and resources: o SETPRV privileges, or CMKRNL, WORLD, and SYSPRV privileges o A minimum of 5000 blocks of free disk space during instal- lation; 4200 blocks are used after installation ____________________________________________________________ 1.1.5 User Account Quotas and Privileges To use the CDA Converter Library, each account must have TMPMBX and NETMBX privileges and the following requirements: o AST limit (ASTLM) 24 (minimum) o Buffered I/O quota (BIOLM) 18 (minimum) o Buffered I/O byte count quota (BYTLM) 18000 (minimum) 1-2 Installing the CDA Converter Library for VMS o Direct I/O quota (DIOLM) 18 (minimum) o Enqueue quota (ENQLM) 30 (minimum) o Open file limit (FILLM) 20 (minimum) o Paging file quota (PGFLQUOTA) 10240 pages (minimum) o Subprocess creation quota (PRCLM) 0 (minimum) o Working set size (WSDEF) 256 pages (minimum) 256 pages (optimum) Use the VMS Authorize Utility (AUTHORIZE) to compare the current values of these quotas with the requirements for the CDA Converter Library. For example, the account used in the following example is the SYSTEM account: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> SHOW SYSTEM To change the values of these quotas, use the VMS Authorize Utility's MODIFY command. For more information, see the VMS Authorize Utility Manual. ____________________________________________________________ 1.1.6 VMS License Management Facility You must register the CDA Converter Library license through the VMS License Management Facility (LMF) in accordance with the license agreement signed by your site. The li- cense registration information you need is contained in the Product Authorization Key (PAK) that is shipped with the CDA Converter Library. The PAK is a paper certificate that contains information about the license you have to run a particular piece of software. During the installation, the system asks whether you have registered the CDA Converter Library license and loaded the appropriate authorization key. You must register and load your license for the CDA Converter Library before you start the installation in order to use the software. Installing the CDA Converter Library for VMS 1-3 To register a license under VMS, first log in to the system manager's account, SYSTEM. You then have a choice of two ways to perform the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your Product Authorization Pak (PAK). o At the DCL prompt, issue the LICENSE REGISTER command with the appropriate qualifiers that correspond to PAK information. If you plan to use the CDA Converter Library on more than one node in a VAXcluster, you will need to perform a license load on the other nodes after you complete this installation. For complete information on using LMF, see the manual on the License Management Utility in the VMS documentation set. ____________________________________________________________ 1.1.7 Special Requirements For a list of VMS classes that are required to enable full functionality of the CDA Converter Library, see the System Software Addendum (SSA). The SSA accompanies the Software Product Description (SPD). The CDA Converter Library commences version checking to ensure that the most recent version of the CDA Converter Library is always in use and is not overwritten by an earlier version. ____________________________________________________________ 1.1.8 Using VMSINSTAL After you log in to a privileged account to install the CDA Converter Library, invoke VMSINSTAL. VMSINSTAL is the command procedure that installs this product. An example of invoking VMSINSTAL is shown in steps 1 and 2 of Section 1.2. The VMSINSTAL command procedure has the following syntax: $ @SYS$UPDATE:VMSINSTAL CDACVTLIB011 ddcu: [OPTIONS N] 1-4 Installing the CDA Converter Library for VMS You can also type an asterisk (*) in place of CDACVTLIB011. If you are installing from magnetic tape, you can use the asterisk to save installation time; the asterisk causes the CDA Converter Library to be installed with a minimum of tape passes. ddcu: Represents a device name where the distribution volumes will be mounted for the CDA Converter Library installation media, where dd is the device code, c is the controller code, and u is the unit number. It is not necessary to use the console drive to install the CDA Converter Library. If you do use the console drive, you should replace any media you removed from the drive. SYS$UPDATE: is the device name used in examples in this document. OPTIONS N Is an optional parameter you should provide if you want to be prompted to display or print the release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not prompt you to display or print the release notes. VMSINSTAL permits the use of several other options. For more information on the other options, see your processor-specific installation /operations guide. If you do not supply the first two parameters, VMSINSTAL prompts you for the product and device names. If you wish to be prompted for the product and device names and to display or print the release notes, type the following: $ @SYS$UPDATE:VMSINSTAL When you invoke VMSINSTAL, it checks the following: o Whether you logged in to a privileged account. Digital recommends that you install software from the system manager's account with your default device and directory set to SYS$UPDATE. o Whether you have adequate quotas for installation. VMSINSTAL checks for the following quota values: _ ASTLM = 24 _ BIOLM = 18 _ BYTLM = 18000 Installing the CDA Converter Library for VMS 1-5 _ DIOLM = 18 _ ENQLM = 30 _ FILLM = 20 VMSINSTAL then checks whether the following conditions ex- ist. If so, discontinue the conditions before resuming the installation procedure. o Whether any users are logged in to the system If VMSINSTAL detects either of these conditions, you will be asked whether you want to continue the installation. If you want to continue, type YES. If you want to stop the installation, press RETURN. Before you begin the installation, register the information contained in the Product Authorization Key (PAK) that is shipped with the CDA Converter Library by using either the VMS License command procedure (VMSLICENSE) or the LICENSE REGISTER and LICENSE LOAD commands, as described in the VMS License Management Utility Manual. ____________________________________________________________ 1.2 Installing the CDA Converter Library on VMS This section contains excerpts from the installation pro- cedure and explains each step. Defaults appear in brackets throughout the installation procedure. To abort the installation procedure at any time, press CTRL/Y. When you press CTRL/Y, the installation procedure deletes all files it has created up to that point and then returns you to DCL level. If you want to retry the installa- tion procedure after pressing CTRL/Y, you must proceed from step 2. Step 1: Log in to a privileged account and set your default device and directory to SYS$UPDATE. Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE 1-6 Installing the CDA Converter Library for VMS Step 2: Invoke VMSINSTAL. $ @VMSINSTAL CDACVTLIB011 SYS$UPDATE: OPTIONS N VAX/VMS Software Product Installation Procedure V5.3 It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? If you are satisfied with the backup of your system disk, press RETURN. Otherwise, type NO and press RETURN to discon- tinue the installation. Step 3: Insert the first installation kit volume. Please mount the first volume of the set on SYS$UPDATE:. * Are you ready? Y %MOUNT-I-MOUNTED, CDACVT mounted on _FOO$SYS$UPDATE: The following products will be processed: CDA Converter Library V1.1 Beginning installation of CDACVTLIB V1.1 at hh:mm %VMSINSTAL-I-RESTORE, Restoring product save set A... To indicate that you want to continue the installation, mount volume 1, type YES, and press RETURN. Step 4: Select a release notes option. This step applies only if you specified OPTIONS N in step 2. Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: Installing the CDA Converter Library for VMS 1-7 If you select option 1, VMSINSTAL displays the release notes on line immediately. You can terminate the display at any time by pressing CTRL/C. If you select option 2, VMSINSTAL prompts you for a queue name. Either type a queue name or press RETURN to send the file to the default output print device. * Queue name [SYS$PRINT]: If you select option 3, VMSINSTAL displays the release notes on line immediately. You can terminate the display at any time by pressing CTRL/C. VMSINSTAL then prompts you for a queue name. Either type a queue name or press RETURN to send the file to the default output print device. The CDA Converter Library release notes are then copied to SYS$HELP:CDACVTLIB011.RELEASE_NOTES. If you select option 4, VMSINSTAL neither displays nor prints the release notes. NOTE This version of the release notes file installed by VMSINSTAL is labeled with the current product name and version number. Take care not to delete release notes for previous versions of the CDA Converter Library. Next, VMSINSTAL displays the following message: * Do you want to continue the installation [N]?: Y If you want to continue the installation, type YES and press RETURN. If you type NO or press RETURN, VMSINSTAL discon- tinues the installation. In either case, VMSINSTAL moves the release notes to SYS$HELP. %VMSINSTAL-I-RELMOVED, The product release notes have been successfully moved to SYS$HELP. 1-8 Installing the CDA Converter Library for VMS Step 5: Respond to license registration queries. CDA Converter Library supports the VMS License Management Facility (LMF). The installation procedure displays license information about your product and then asks if you have reg- istered and loaded your authorization key for CDA Converter Library. The following is an example of such information: Product: CDA-CONVERTER-LIBRARY Producer: DEC Version: 1.1 Release Date: 31-JUL-89 * Does this product have an authorization key registered and loaded? If you have not registered and loaded your authorization key, you must answer "NO" to this question. You have to register and load your product authorization key to successfully complete the installation. If you have not done so, you should stop the installation, register and load your product authorization key, and then restart the installation. Step 6: Select installation options. * Do you want to purge files replaced by this installation [YES]? The directories SYS$LIBRARY, SYS$SYSTEM, and CDA$LIBRARY may contain earlier versions of the CDA Converter Library files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press RETURN to purge the files or type NO to keep them. * Do you want to run the IVP after the installation [YES]? The Installation Verification Procedure (IVP) runs tests to check whether the installation procedure was successful. Press RETURN to run the IVP after the installation. If you do not want to run the IVP, type NO in response to the prompt. Step 7: Read informational messages. The CDA Converter Library installation procedure produces a number of informational messages that report on the progress of the installation. These messages can be similar to the following: Installing the CDA Converter Library for VMS 1-9 To complete the installation on a standalone VAX 11/780 will take approximately: 15 minutes to install 4 minutes to run the IVP All required questions have been asked. You can terminate the installation procedure at this time. Next, VMSINSTAL displays the following message: * Do you want to continue the installation [YES]? Y If you type NO and press RETURN, VMSINSTAL discontinues the installation. If you want to continue the installation, type YES and press RETURN, or simply press RETURN. If you type YES, VMSINSTAL continues with informational messages which can be similar to the following: %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.CDACVTLIB]. If you have previously installed the CDA Converter Library on your system, you will receive the following message: %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.CDACVTLIB] already exists The success of the installation is indicated by the following message: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... If the installation procedure is successful, the new or modified files are moved to their target directories. The kit checks each additional converter's image and replaces it as needed. NOTE The installation requires that CDA$LIBRARY: be de- fined in the DECW$LOGICAL_NAMES table (defined by DECwindows). The default style guides will be placed in CDA$LIBRARY:. The procedure creates the directory SYS$COMMON:[SYSTEST.CDACVTLIB], where the IVP procedures and files are installed. 1-10 Installing the CDA Converter Library for VMS The following files are created or modified by the installa- tion procedure: ________________________________________________________________ Directory________File_Name_______________Description____________ SYS$COMMON: CDACVTLIB$IVP.CDA$OPTIONIVP procedures and [SYSTEST.CDACVTLIB] files TCV$IVP_INPUT.CALC$GRD TCV$IVP_INPUT.DIF TCV$IVP_INPUT.TAB TCV$IVP_INPUT.WK1 TCV$IVP_INPUT.DTIF ACCEPT.DX Example files AUTUMN.TIFF EXAMPLE_DDIF.DDIF STD_TEST.CGM CHART_1.DDIF CHAMPAGNE.MACPAINT SYS$TEST: CDACVTLIB$IVP.COM ________________________________________________________________ SYS$HELP: CDACVTLIB011.RELEASE_ Release notes NOTES HELPLIB.HLB Modified ________________________________________________________________ Installing the CDA Converter Library for VMS 1-11 ________________________________________________________________ Directory________File_Name_______________Description____________ SYS$LIBRARY: DDIF$READ_CGM_ CGM message file MESSAGES.EXE SGML$PARSE.EXE SGML parse file DDIF$READ_AFS.EXE AFS front end DDIF$WRITE_AFS.EXE AFS back end DDIF$READ_DCA.EXE DCA front end DDIF$WRITE_DCA.EXE DCA back end DDIF$READ_DX.EXE DX front end DDIF$WRITE_DX.EXE DX back end DDIF$READ_CGM.EXE CGM front end DDIF$READ_SGML.EXE SGML front end DDIF$WRITE_SGML.EXE SGML back end DDIF$READ_TIFF.EXE TIFF front end DDIF$WRITE_TIFF.EXE TIFF back end DDIF$WRITE_GRAPHICS.EXE Graphics back end DDIF$READ_MACPAINT.EXE Macpaint front end DDIF$WRITE_MACPAINT.EXE Macpaint back end DTIF$READ_ASCII_ ASCII tabular front end TABULAR.EXE DTIF$WRITE_ASCII_ ASCII tabular back end TABULAR.EXE 1-12 Installing the CDA Converter Library for VMS ________________________________________________________________ Directory________File_Name_______________Description____________ DTIF$READ_CALCGRD.EXE CALCGRD front end DTIF$READ_DIF.EXE DIF front end DTIF$READ_WK1.EXE WK1 front end DTIF$WRITE_WK1.EXE WK1 back end ________________________________________________________________ CDA$LIBRARY: DX_COUR.DOC_STYLE DX style guide DX_HELV.DOC_STYLE DX style guide DX_TIMES.DOC_STYLE DX style guide ________________________________________________________________ SYS$EXAMPLES: SDC$SAMPLE.DOC_STYLE Sample SGML style guide _________________SDC$SAMPLE.SGML_________Sample_SGML_document___ If you typed YES in response to the prompt that requests a file purge at step 6, previous versions of the CDA Converter Library files are now purged. Step 8: Observe the Installation Verification Procedure (IVP). If you chose to run the IVP in step 6, VMSINSTAL now calls the IVP to verify that the CDA Converter Library was in- stalled successfully. The IVP gives you messages which can be similar to the following: Beginning the CDA Converter Library V1.1 Installation Verification Procedure Starting verification of the AFS front and back ends Starting verification of the CGM front end Starting verification of the DCA front and back ends Starting verification of the DX front and back ends Installing the CDA Converter Library for VMS 1-13 Starting verification of the Graphics back end Starting verification of the MACPAINT front and back ends Starting verification of the SGML front and back ends Starting verification of the TIFF front and back ends Starting verification of the ASCII Tabular front and back ends Starting verification of the CALCGRD front end Starting verification of the DIF front end Starting verification of the WK1 front and back ends When the IVP has completed, you receive the following mes- sage: CDA Converter Library V1.1 IVP completed successfully. Installation of CDACVTLIB V1.1 completed at 15:11 VMSINSTAL procedure done at 15:12 Step 9: Log out or install more products. $ LOGOUT SYSTEM logged out at dd-mmm-yyyy hh:mm:ss.ss When the product installation procedure and the IVP are complete, you can choose to install more products or to log out (as shown above). If you removed any media from the console drive before beginning the installation, you should replace it now. VMSINSTAL deletes or changes entries in the process symbol tables during the installation. Therefore, if you are going to continue using the system manager's account and you want to restore these symbols, you should log out and log in again. ____________________________________________________________ 1.3 Running the Installation Verification Procedure Separately on VMS The Installation Verification Procedure (IVP) is usually run at installation. If you want to run the IVP separately to ensure the integrity of installed files if system problems occur, execute the following command procedure: 1-14 Installing the CDA Converter Library for VMS $ @SYS$TEST:CDACVTLIB$IVP.COM If the IVP fails for any reason, messages such as the follow- ing are displayed: "Verification failed - CGM front end" Normally, a failed IVP does not indicate a failed installa- tion, but any converters that did fail should be reported to a Digital field service representative. ____________________________________________________________ 1.4 Error Conditions on VMS If the installation procedure fails for any reason, a message like the following is displayed: %VMSINSTAL-E-INSFAIL, The installation of the CDA Converter Library V1.1 has failed. An error during the installation can occur if one or more of the following conditions exist: o Operating system version is incorrect. o Prerequisite software version is incorrect. o Quotas necessary for successful installation are insuffi- cient (see Section 1.1.4). o Process quotas required by VMSINSTAL are incorrect (see Section 1.1.8). o The product was registered incorrectly or not registered. For descriptions of the error messages generated by these conditions, see the VMS System Messages and Recovery Procedures Reference Volume, Part I and Part II, your processor-specific installation/operations guide, or the VMS License Management Utility Manual. If you are notified that any of these conditions exist, you should take the appropriate action as described in the mes- sage. You may need to change a system parameter or increase an authorized quota value. If the installation fails, you must restart the installation procedure from step 2. If the installation fails due to an IVP failure, contact a Digital field service representative. Installing the CDA Converter Library for VMS 1-15 ____________________________________________________________ 1.5 Sample Installation on VMS This section contains a sample installation of the CDA Converter Library. Note that this is only a sample. Sometimes the installation procedure is modified in maintenance up- dates of this product. Because this installation guide is not usually revised for maintenance updates, be sure to read the Read Before Installing or Using the CDA Converter Library letter before you install this product. This letter notes any significant changes in the installation that vary from this sample. Sample CDA Converter Library Installation Procedure $ @VMSINSTAL CDACVTLIB011 MUA0: OPTIONS N VAX/VMS Software Product Installation Procedure V5.3 It is 6-SEP-1990 at 14:54. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? Y Please mount the first volume of the set on MUA0:. * Are you ready? Y %MOUNT-I-MOUNTED, CDACVT mounted on _FOO$MUA0: The following products will be processed: CDACVTLIB V1.1 Beginning installation of CDACVTLIB V1.1 at 14:55 %VMSINSTAL-I-RESTORE, Restoring product save set A ... Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: 4 * Do you want to continue the installation [NO]? Y %VMSINSTAL-I-RELMOVED , The product's release notes have been successfully moved to SYS$HELP. 1-16 Installing the CDA Converter Library for VMS Product: CDA-CONVERTER-LIBRARY Producer: DEC Version: 1.1 Release Date: MM-DD-YYYY * Does this product have an authorization key registered and loaded? Y * Do you want to purge files replaced by this installation [YES]? Y * Do you want to run the IVP after the installation [YES]?Y To complete the installation on a standalone VAX 11/780 will take approximately: 15 minutes to install 4 minutes to run the IVP All required questions have been asked. You can terminate the installation procedure at this time. * Do you want to continue the installation [YES]? Y %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.CDACVTLIB]. %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.CDACVTLIB] already exists %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Beginning the CDA Converter Library V1.1 Installation Verification Procedure Starting verification of the AFS front and back ends Starting verification of the CGM front end Starting verification of the DCA front and back ends Starting verification of the DX front and back ends Starting verification of the Graphics back end Starting verification of the MACPAINT front and back ends Starting verification of the SGML front and back ends Starting verification of the TIFF front and back ends Starting verification of the ASCII Tabular front and back ends Starting verification of the CALCGRD front end Starting verification of the DIF front end Starting verification of the WK1 front and back ends CDA Converter Library V1.1 IVP completed successfully. Installation of CDACVTLIB V1.1 completed at 15:11 VMSINSTAL procedure done at 15:12 Installing the CDA Converter Library for VMS 1-17 Chapter 2 Installing the CDA Converter Library for ULTRIX (VAX) ________________________________________________________________ This chapter describes how to install the CDA Converter Library on ULTRIX [TM] (VAX) systems. ____________________________________________________________ 2.1 Before You Install the CDA Converter Library on ULTRIX (VAX) This section describes the prerequisites for installing the CDA Converter Library on ULTRIX (VAX) systems. ____________________________________________________________ 2.1.1 Installation Prerequisites Before you begin, you should perform a system disk(s) backup and make sure that your system meets the following prerequi- sites: o Access to the root or super_user account. o A valid ULTRIX operating system image with ULTRIX Version 3.1 or higher or ULTRIX Worksystem Software Version 2.2 or higher. o The required hardware, as detailed in the CDA Converter Library Software Product Description (SPD). o Adequate system disk space. The CDA Converter Library installation requires approximately 10.5 megabytes in the /usr/kits structure, depending on the converters you choose to install. ___________________ [TM] ULTRIX is a trademark of Digital Equipment Corporation. Installing the CDA Converter Library for ULTRIX (VAX) 2-1 The installation requires approximately 5 to 30 minutes, depending on the type of media and your system configuration. ____________________________________________________________ 2.1.2 Distribution Media Your distribution kit contains one of the following sets of media: o One 9-track magnetic tape o One TK50 cartridge tape This media contains the CDA Converter Library files. The following table lists these files and their location on your system after you install them: ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ /usr/bin CDABASE110 cda_read_cda Symbolic link to ../kits/CDA110 /cda_read_cda cda_write_ Symbolic link to ../kits/CDA110 analysis /cda_write_analysis cdoc Symbolic link to ../kits/CDA110 /cdoc ddif_read_text Symbolic link to ../kits/CDA110 /ddif_read_text ddif_write_ps Symbolic link to ../kits/CDA110 /ddif_write_ps ddif_write_ Symbolic link to ../kits/CDA110 text /ddif_write_text 2-2 Installing the CDA Converter Library for ULTRIX (VAX) ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ vdoc Symbolic link to ../kits/CDA110 /vdoc Version 3.1 defstyle.ddif Symbolic link to ../kits/CDA110 only /defstyle.ddif CDACVTDOC110 ddif_read_dca Symbolic link to ../kits/CDA110 /ddif_read_dca ddif_read_sgml Symbolic link to ../kits/CDA110 /ddif_read_sgml ddif_write_afs Symbolic link to ../kits/CDA110 /ddif_write_afs ddif_write_dca Symbolic link to ../kits/CDA110 /ddif_write_dca ddif_write_ Symbolic link to ../kits/CDA110 sgml /ddif_write_sgml CDACVTDX110 ddif_read_dx Symbolic link to /kits/CDA110 /ddif_read_dx ddif_write_dx Symbolic link to ../kits/CDA110 /ddif_write_dx CDACVTGRA110 ddif_read_cgm Symbolic link to /kits/CDA110 /ddif_read_cgm ddif_read_ Symbolic link to ../kits/CDA110 macpaint /ddif_read_macpaint Installing the CDA Converter Library for ULTRIX (VAX) 2-3 ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ ddif_read_tiff Symbolic link to ../kits/CDA110 /ddif_read_tiff ddif_write_ Symbolic link to ../kits/CDA110 graphics /ddif_write_graphics ddif_write_ Symbolic link to ../kits/CDA110 macpaint /ddif_write_macpaint ddif_write_ Symbolic link to ../kits/CDA110 tiff /ddif_write_tiff CDACVTTBL110 dtif_read_ Symbolic link to ../kits/CDA110 ascii_tabular /dtif_read_ascii_tabular dtif_read_ Symbolic link to ../kits/CDA110 calcgrd /dtif_read_calcgrd dtif_read_dif Symbolic link to ../kits/CDA110 /dtif_read_dif dtif_read_wk1 Symbolic link to ../kits/CDA110 /dtif_read_wk1 dtif_write_ Symbolic link to ../kits/CDA110 ascii_tabular /dtif_write_ascii_tabular dtif_write_wk1 Symbolic link to ../kits/CDA110 /dtif_write_wk1 ________________________________________________________________ /usr/lib 2-4 Installing the CDA Converter Library for ULTRIX (VAX) ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ Version 4.0 libddif.a Symbolic link to ../kits/CDA110 only /libddif.a Version 4.0 libddif_fe.a Symbolic link to ../kits/CDA110 only /libddif_fe.a ________________________________________________________________ /usr/lib/cda / CDACVTDX110 dx_cour.doc_ Symbolic link to .../kits/CDA110 style /dx_cour.doc_style dx_guide.doc_ Symbolic link to .../kits/CDA110 style /dx_guide.doc_style dx_helv.doc_ Symbolic link to .../kits/CDA110 style /dx_helv.doc_style dx_times.doc_ Symbolic link to .../kits/CDA110 style /dx_times.doc_style ________________________________________________________________ /usr/doc/ CDABASE110 convert_ Symbolic link to ../kits/CDA110 messages.mem /convert_messages.mem ________________________________________________________________ Installing the CDA Converter Library for ULTRIX (VAX) 2-5 ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ /usr/kits /CDA110/ CDABASE110 cda_read_cda DTIF to DDIF domain converter cda_write_ Analysis back end analysis cdoc Converters invocation command convert_ Table and Document Conversion messages.mem Messages ddif_read_text Text front end ddif_write_ps PostScript back end ddif_write_ Text back end text release.notes release notes saved Directory for saving CDABASE110 files vdoc CDA Viewer character cell command libddif.a CDA toolkit library libddif_fe.a CDA front-end converter library defstyle.ddif Default style guide for text back end 2-6 Installing the CDA Converter Library for ULTRIX (VAX) ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ CDACVTDOC110 ddif_read_afs AFS front end ddif_read_dca DCA front end ddif_read_sgml SGML front end ddif_write_afs AFS front end ddif_write_dca DCA front end ddif_write_ SGMS front end sgml CDACVTDX110 ddif_read_dx DX front end ddif_write_dx DX back end dx_guide.doc_ DX style guide style CDACVTGRA110 ddif_read_cgm CGM front end ddif_read_ Macpaint front end macpaint ddif_read_tiff TIFF front end ddif_write_ Graphic back end graphics ddif_write_ Macpaint back end macpaint Installing the CDA Converter Library for ULTRIX (VAX) 2-7 ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ ddif_write_ TIFF back end tiff ghc_font1 Font file used by ddif_write_ graphics CDACVTTBL110 dtif_read_ ASCII tabular front end ascii_tabular dtif_read_ CALCGRD front end calcgrd dtif_read_dif DIF front end dtif_read_wk1 WK1 front end dtif_write_ ASCII tabular back end ascii_tabular dtif_write_wk1 WK1 back end ________________________________________________________________ /usr/kits /CDA110/ivp/ CDABASE110 CDABASE110.IVP Base system IVP base.ddif example file base.options options file 2-8 Installing the CDA Converter Library for ULTRIX (VAX) ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ CDACVTDOC110 CDACVTDOC110.IVPDocument subset IVP doc.ddif DDIF example file doc.options Document options file latin.dca DCA example file CDACVTDX110 CDACVTDX110.IVP DX subset IVP accept.dx DX example file CDACVTGRA110 CDACVTGRA110.IVPGraphics subset IVP autumn.tiff TIFF example file champagne.macpaiMacpaint example file gra.ddif Graphics DDIF file gra.options Graphics options file std_test.cgm CGM example file CDACVTTBL110 CDACVTTBL110.IVPTable subset IVP input.calc_grd CALCGRD example file input.dif DIF example file input.dtif DTIF example file Installing the CDA Converter Library for ULTRIX (VAX) 2-9 ________________________________________________________________ Directory and_Subset____File_Name_______Description_______________________ input.tab ASCII tabular example file input.wk1 WK1 example file ______________tbl.options_____Table_options_file________________ ____________________________________________________________ 2.1.3 Accessing the Online Release Notes and Command Files The CDA Converter Library provides online release notes in the directory /usr/kits/CDA110/release.notes ____________________________________________________________ 2.2 Installing the CDA Converter Library on ULTRIX (VAX) This section tells you how to install the CDA Converter Library files on an ULTRIX system. It also tells you how to restore normal operation, if necessary. During installation, the system prompts you for a response to several questions. Some prompts have accompanying default responses that appear in brackets ([]). To choose a default response, press the RETURN key. You can request help at any step by typing help in response to a prompt. If the prompt requests a YES or NO answer, you can also type anything that does not begin with a y or n to get help. When you invoke the installation procedure at step 4, the process is the same if you are using either 9-track magnetic tape or TK50 tape cartridge media, and you should proceed to Section 2.3.1. At any point during the procedure, you can return to the beginning of step 4 by pressing CTRL/C. 2-10 Installing the CDA Converter Library for ULTRIX (VAX) ____________________________________________________________ 2.3 Performing the Installation on ULTRIX (VAX) When you have met the prerequisites listed in Section 2.1.1, you are ready to install the CDA Converter Library product. Perform the installation at your system console, in the following order: Step 1: Log in to the root account with the root user name and its password. login: root password: # If you are currently logged into another account, you can switch to the root account by issuing the su command: % su - password: # Step 2: Ensure that no one attempts to use the CDA Converter Library during installation. If necessary, place your system into single-user mode by issuing the following shutdown command: # /etc/shutdown +5 "Installing CDA Converter Library" This command notifies other users that the system will shut down in 5 minutes (as specified by the +5). Then, in five minutes, it logs them out and enters single-user mode. You should note that, in single user mode, the only valid input device is the console. Step 3: Invoke the installation procedure as appropriate for your particular media. If you use 9-track magnetic tape or TK50 tape cartridges, proceed to Section 2.3.1. Installing the CDA Converter Library for ULTRIX (VAX) 2-11 ____________________________________________________________ 2.3.1 9-Track Magnetic Tape and TK50 Tape Cartridge Users Step 1: Invoke the ULTRIX installation procedure with the following command, substituting your device file unit number for the question mark. # setld -l /dev/rmt0h When you invoke the installation procedure, the following message and prompt appears, identifying your specific media: Please make sure your installation media is mounted and on-line. Are you ready (y/n)?: y Step 2: Respond to the ready prompt. If you type NO, the system repeats the prompt. If you type YES, the following messages appear, identifying your specific media: The subsets listed below are optional: *** Enter Subset Selections *** 1 CDA Base System 2) CDA DX Converters) 3 CDA Document Converters 4) CDA Graphics Converters) 5 CDA Table Converters) 6 All of the Above) 7 None of the Above) Enter your choice(s): 6 You are installing the following subsets: CDA Base System CDA DX Converters CDA Document Converters CDA Graphics Converters CDA Table Converters Is this correct? (y/n): y The system proceeds to display a list of verification mes- sages for the base system and for each subset you installed. ____________________________________________________________ 2.4 After the Installation on ULTRIX (VAX) The CDA Converter Library is now installed and can be invoked by all users with the cdoc command. 2-12 Installing the CDA Converter Library for ULTRIX (VAX) ____________________________________________________________ 2.5 Sample Installation on ULTRIX (VAX) This section contains a sample installation of the CDA Converter Library. Note that this is only a sample. The in- stallation procedure is sometimes modified in maintenance updates of this product. Because this installation guide is not usually revised for maintenance updates, be sure to read the Read Before Installing or Using the CDA Converter Library letter before you install this product. This letter notes any significant changes in the installation that vary from this sample. Sample CDA Converter Library Installation Procedure # setld -l /dev/rmt0h Please make sure your installation tape is mounted and on-line. Are you ready? (y/n):Y Positioning tape...done. The subsets listed below are optional: *** Enter Subset Selections *** 1 CDA Base System 2) CDA DX Converters) 3 CDA Document Converters 4) CDA Graphics Converters) 5 CDA Table Converters) 6 All of the Above) 7 None of the Above) Enter your choice(s):6 You are installing the following subsets: CDA Base System CDA DX Converters CDA Document Converters CDA Graphics Converters CDA Table Converters Is this correct? (y/n):y Copying CDA Base System (CDABASE110) from tape Verifying CDA Base System (CDABASE110) Copying CDA DX Converters (CDACVTDX110) from tape Verifying CDA DX Converters (CDACVTDX110) Copying CDA Document Converters (CDACVTDOC110) from tape Verifying CDA Document Converters (CDACVTDOC110) Installing the CDA Converter Library for ULTRIX (VAX) 2-13 Copying CDA Graphics Converters (CDACVTGRA110) from tape Verifying CDA Graphics Converters (CDACVTGRA110) Copying CDA Table Converters (CDACVTTBL110) from tape Verifying CDA Table Converters (CDACVTTBL110) # setld -v CDACVTDOC110 CDACVTTBL110 CDACVTGRA110 CDACVTDX110 CDABASE110 Checking setld data files. Verifying the installation of CDACVTDOC110 Checking afs back-end and front-end converters Checking dca front-end and back-end converters Checking sgml back-end and front-end converters The CDACVTDOC110 IVP has completed successfully Verifying the installation of CDACVTTBL110 Checking ascii_tabular front-end and back-end converters Checking calcgrd front-end converter Checking dif front-end converter Checking wk1 front-end and back-end converters The CDACVTTBL110 IVP has completed successfully Verifying the installation of CDACVTGRA110 Checking cgm front-end converter Checking macpaint front-end and back-end converters Checking tiff front-end and back-end converters Checking graphics back-end converter The CDACVTGRA110 IVP has completed successfully Verifying the installation of CDACVTDX110 Checking dx front-end and back-end converters The CDACVTDX110 IVP has completed successfully Verifying the installation of CDABASE110 Checking text back-end and front-end converters Checking analysis back-end converter Checking ps back-end converter The CDABASE110 IVP has completed successfully # 2-14 Installing the CDA Converter Library for ULTRIX (VAX) Chapter 3 Installing the CDA Converter Library for ULTRIX (RISC) ________________________________________________________________ This chapter describes how to install the CDA Converter Library on ULTRIX (RISC) systems. ____________________________________________________________ 3.1 Before You Install the CDA Converter Library on ULTRIX (RISC) This section describes the prerequisites for installing the CDA Converter Library on ULTRIX (RISC) systems. ____________________________________________________________ 3.1.1 Installation Prerequisites Before you begin, you should perform a system disk(s) backup and make sure that your system meets the following prerequi- sites: o Access to the root or super_user account. o A valid ULTRIX operating system image with ULTRIX Version 3.1 or higher or ULTRIX Worksystem Software Version 2.2 or higher. o The required hardware, as detailed in the CDA Converter Library Software Product Description (SPD). o Adequate system disk space. The CDA Converter Library installation requires up to a maximim of approximately 15 megabytes in the /usr structure, depending on the converters you choose to install. The installation requires approximately 5 to 30 minutes, depending on the type of media and your system configuration. Installing the CDA Converter Library for ULTRIX (RISC) 3-1 ____________________________________________________________ 3.1.2 Distribution Media Your distribution kit contains one of the following sets of media: o One 9-track magnetic tape o One TK50 cartridge tape This media contains the CDA Converter Library files. The following table lists these files and their location on your system after you install them: ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ /usr/bin CDRBASE110 cda_read_cda Symbolic link to ../kits/CDR110/cda_ read_cda cda_write_ Symbolic link to ../kits/CDR110/cda_ analysis write_analysis cdoc Symbolic link to ../kits/CDR110/cdoc ddif_read_ Symbolic link to ../kits/CDR110 text /ddif_read_text ddif_write_ Symbolic link to ../kits/CDR110 ps /ddif_write_ps ddif_write_ Symbolic link to ../kits/CDR110 text /ddif_write_text vdoc Symbolic link to ../kits/CDR110/vdoc Version 3.1 defstyle.ddif Symbolic link to ../kits/CDR110 only /defstyle.ddif 3-2 Installing the CDA Converter Library for ULTRIX (RISC) ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ CDRCVTDOC110 ddif_read_ Symbolic link to ../kits/CDR110 dca /ddif_read_dca ddif_read_ Symbolic link to ../kits/CDR110 sgml /ddif_read_sgml ddif_write_ Symbolic link to ../kits/CDR110 afs /ddif_write_afs ddif_write_ Symbolic link to ../kits/CDR110 dca /ddif_write_dca ddif_write_ Symbolic link to ../kits/CDR110 sgml /ddif_write_sgml CDRCVTDX110 ddif_read_dx Symbolic link to /kits/CDR110/ddif_ read_dx ddif_write_ Symbolic link to ../kits/CDR110 dx /ddif_write_dx CDRCVTGRA110 ddif_read_ Symbolic link to /kits/CDR110/ddif_ cgm read_cgm ddif_read_ Symbolic link to ../kits/CDR110 macpaint /ddif_read_macpaint ddif_read_ Symbolic link to ../kits/CDR110 tiffd_tiff /ddif_read_tiff ddif_write_ Symbolic link to ../kits/CDR110 graphics /ddif_write_graphics Installing the CDA Converter Library for ULTRIX (RISC) 3-3 ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ ddif_write_ Symbolic link to ../kits/CDR110 macpaint /ddif_write_macpaint ddif_write_ Symbolic link to ../kits/CDR110 tiff /ddif_write_tiff CDRCVTTBL110 dtif_read_ Symbolic link to ../kits/CDR110 ascii_ /dtif_read_ascii_tabular tabular dtif_read_ Symbolic link to ../kits/CDR110 calcgrd /dtif_read_calcgrd dtif_read_ Symbolic link to ../kits/CDR110 dif /dtif_read_dif dtif_read_ Symbolic link to ../kits/CDR110 wk1 /dtif_read_wk1 dtif_write_ Symbolic link to ../kits/CDR110 ascii_ /dtif_write_ascii_tabular tabular dtif_write_ Symbolic link to ../kits/CDR110 wk1 /dtif_write_wk1 ________________________________________________________________ /usr/lib Version 4.0 libddif.a Symbolic link to ../kits/CDR110 only /libddif.a 3-4 Installing the CDA Converter Library for ULTRIX (RISC) ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ Version 4.0 libddif_fe.a Symbolic link to ../kits/CDR110 only /libddif_fe.a ________________________________________________________________ /usr/lib/cda / CDRCVTDX110 dx_cour.doc_ Symbolic link to ../kits/CDR110/dx_ style cour.doc_style dx_ Symbolic link to ../kits/CDR110/dx_ guide.doc_ guide.doc_style style dx_helv.doc_ Symbolic link to ../kits/CDR110/dx_ style helv.doc_style dx_ Symbolic link to ../kits/CDR110/dx_ times.doc_ times.doc_style style ________________________________________________________________ /usr/doc/ CDRBASE110 convert_ Symbolic link to ../kits/CDR110 messages.mem /convert_messages.mem ________________________________________________________________ Installing the CDA Converter Library for ULTRIX (RISC) 3-5 ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ /usr/kits /CDR110/ CDRBASE110 cda_read_cda DTIF to DDIF domain converter cda_write_ Analysis back end analysis cdoc Converters invocation command convert_ Table and Document Conversion messages.mem Messages ddif_read_ Text front end text ddif_write_ PostScript back end ps ddif_write_ Text back end text release.notes release notes saved Directory for saving CDRBASE110 files vdoc CDA Viewer character cell command libddif.a CDA toolkit library libddif_fe.a CDA front-end converter library defstyle.ddif Default style guide for text back end 3-6 Installing the CDA Converter Library for ULTRIX (RISC) ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ CDRCVTDOC110 ddif_read_ AFS front end afs ddif_read_ DCA front end dca ddif_read_ SGML front end sgml ddif_write_ AFS front end afs ddif_write_ DCA front end dca ddif_write_ SGMS front end sgml CDRCVTDX110 ddif_read_dx DX front end ddif_write_ DX back end dx dx_cour.doc_ DX courier style guide style dx_ DX style guide guide.doc_ style dx_helv.doc_ DX helvetica style guide style Installing the CDA Converter Library for ULTRIX (RISC) 3-7 ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ dx_ DX times style guide times.doc_ style CDRCVTGRA110 ddif_read_ CGM front end cgm ddif_read_ Macpaint front end macpaint ddif_read_ TIFF front end tiff ddif_write_ Graphic back end graphics ddif_write_ Macpaint back end macpaint ddif_write_ TIFF back end tiff ghc_font1 Font file used by ddif_write_ graphics CDRCVTTBL110 dtif_read_ ASCII tabular front end ascii_ tabular dtif_read_ CALCGRD front end calcgrd dtif_read_ DIF front end dif 3-8 Installing the CDA Converter Library for ULTRIX (RISC) ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ dtif_read_ WK1 front end wk1 dtif_write_ ASCII tabular back end ascii_ tabular dtif_write_ WK1 back end wk1 ________________________________________________________________ /usr/kits /CDR110/ivp/ CDRBASE110 CDRBASE110.IVPBase system IVP base.ddif example file base.options options file CDRCVTDOC110 CDRCVTDOC110.IDocument subset IVP doc.ddif DDIF example file doc.options Document options file latin.dca DCA example file CDRCVTDX110 CDRCVTDX110.IVDX subset IVP accept.dx DX example file Installing the CDA Converter Library for ULTRIX (RISC) 3-9 ________________________________________________________________ Directory and_Subset____File_Name_____Description_________________________ CDRCVTGRA110 CDRCVTGRA110.IGraphics subset IVP autumn.tiff TIFF example file champagne.macpMacpaint example file gra.ddif Graphics DDIF file gra.options Graphics options file std_test.cgm CGM example file CDRCVTTBL110 CDRCVTTBL110.ITable subset IVP input.calc_ CALCGRD example file grd input.dif DIF example file input.dtif DTIF example file input.tab ASCII tabular example file input.wk1 WK1 example file ______________tbl.options___Table_options_file__________________ ____________________________________________________________ 3.1.3 Accessing the Online Release Notes and Command Files The CDA Converter Library provides online release notes in the directory /usr/kits/CDR110/release.notes 3-10 Installing the CDA Converter Library for ULTRIX (RISC) ____________________________________________________________ 3.2 Installing the CDA Converter Library on ULTRIX (RISC) This section tells you how to install the CDA Converter Library files on an ULTRIX system. It also tells you how to restore normal operation, if necessary. During installation, the system prompts you for a response to several questions. Some prompts have accompanying default responses that appear in brackets ([]). To choose a default response, press the RETURN key. You can request help at any step by typing help in response to a prompt. If the prompt requests a YES or NO answer, you can also type anything that does not begin with a y or n to get help. When you invoke the installation procedure at step 4, the process is the same if you are using either 9-track magnetic tape or TK50 tape cartridge media, and you should proceed to Section 3.3.1. At any point during the procedure, you can return to the beginning of step 4 by pressing CTRL/C. ____________________________________________________________ 3.3 Performing the Installation on ULTRIX (RISC) When you have met the prerequisites listed in Section 3.1.1, you are ready to install the CDA Converter Library product. Perform the installation at your system console, in the following order: Step 1: Log in to the root account with the root user name and its password. login: root password: # If you are currently logged into another account, you can switch to the root account by issuing the su command: % su - password: # Installing the CDA Converter Library for ULTRIX (RISC) 3-11 Step 2: Ensure that no one attempts to use the CDA Converter Library during installation. If necessary, place your system into single-user mode by issuing the following shutdown command: # /etc/shutdown +5 "Installing CDA Converter Library" This command notifies other users that the system will shut down in 5 minutes (as specified by the +5). Then, in five minutes, it logs them out and enters single-user mode. You should note that, in single user mode, the only valid input device is the console. Step 3: Invoke the installation procedure as appropriate for your particular media. If you use 9-track magnetic tape or TK50 tape cartridges, proceed to Section 3.3.1. ____________________________________________________________ 3.3.1 9-Track Magnetic Tape and TK50 Tape Cartridge Users Step 1: Invoke the ULTRIX installation procedure with the following command, substituting your device file unit number for the question mark. # setld -l /dev/rmt?h When you invoke the installation procedure, the following message and prompt appears, identifying your specific media: Please make sure your installation media is mounted and on-line. Are you ready (y/n)?: y Step 2: Respond to the ready prompt. If you type NO, the system repeats the prompt. If you type YES, the following messages appear, identifying your specific media: Positioning tape...done. *** Enter Subset Selections *** 3-12 Installing the CDA Converter Library for ULTRIX (RISC) The subsets listed below are optional: 1 CDA Base System 2) CDA DX Converters) 3 CDA Document Converters 4) CDA Graphics Converters) 5 CDA Table Converters) 6 All of the Above) 7 None of the Above) Enter your choice(s): 6 You are installing the following subsets: CDA Base System CDA DX Converters CDA Document Converters CDA Graphics Converters CDA Table Converters Is this correct? (y/n): Y The system proceeds to display a list of verification mes- sages for the base system and for each subset you installed. ____________________________________________________________ 3.4 After the Installation on ULTRIX (RISC) The CDA Converter Library is now installed and can be invoked by all users with the cdoc command. ____________________________________________________________ 3.5 Sample Installation on ULTRIX (RISC) This section contains a sample installation of the CDA Converter Library. Note that this is only a sample. The in- stallation procedure is sometimes modified in maintenance updates of this product. Because this installation guide is not usually revised for maintenance updates, be sure to read the Read Before Installing or Using the CDA Converter Library letter before you install this product. This letter notes any significant changes in the installation that vary from this sample. Installing the CDA Converter Library for ULTRIX (RISC) 3-13 Sample CDA Converter Library Installation Procedure # setld -l /dev/rmt0h Please make sure your installation tape is mounted and on-line. Are you ready? (y/n): y Positioning tape...done. *** Enter Subset Selections *** The subsets listed below are optional: 1 CDA Base System 2) CDA DX Converters) 3 CDA Document Converters 4) CDA Graphics Converters) 5 CDA Table Converters) 6 All of the Above) 7 None of the Above) Enter your choice(s): 6 You are installing the following subsets: CDA Base System CDA DX Converters CDA Document Converters CDA Graphics Converters CDA Table Converters Is this correct? (y/n): Y Copying CDA Base System (CDRBASE110) from tape Verifying CDA Base System (CDRBASE110) Copying CDA DX Converters (CDRCVTDX110) from tape Verifying CDA DX Converters (CDRCVTDX110) Copying CDA Document Converters (CDRCVTDOC110) from tape Verifying CDA Document Converters (CDRCVTDOC110) Copying CDA Graphics Converters (CDRCVTGRA110) from tape Verifying CDA Graphics Converters (CDRCVTGRA110) Copying CDA Table Converters (CDRCVTTBL110) from tape Verifying CDA Table Converters (CDRCVTTBL110) 3-14 Installing the CDA Converter Library for ULTRIX (RISC) #setld -v CDRBASE110 CDRCVTDOC110 CDRCVTDX110 CDRCVTGRA110 CDRCVTTBL110 Checking setld data files. Verifying the installation of CDRBASE110 Checking text back-end and front-end converters Checking analysis back-end converter Checking ps back-end converter The CDRBASE110 IVP has completed successfully Verifying the installation of CDRCVTDOC010 Checking afs back-end and front-end converters Checking dca front-end and back-end converters Checking sgml back-end and front-end converters The CDRCVTDOC010 IVP has completed successfully Verifying the installation of CDRCVTDX010 Checking dx front-end and back-end converters The CDRCVTDX010 IVP has completed successfully Verifying the installation of CDRCVTGRA010 Checking cgm front-end converter Checking macpaint front-end and back-end converters Checking tiff front-end and back-end converters Checking graphics back-end converter The CDRCVTGRA010 IVP has completed successfully Verifying the installation of CDRCVTTBL010 Checking ascii_tabular front-end and back-end converters Checking calcgrd front-end converter Checking dif front-end converter Checking wk1 front-end and back-end converters The CDRCVTTBL010 IVP has completed successfully # Installing the CDA Converter Library for ULTRIX (RISC) 3-15 Index ________________________________________________________________ A___________________________ Distribution media Accessing the online command for ULTRIX (RISC), 3-2 files for ULTRIX (VAX), 2-2 for ULTRIX, 2-10, 3-10 E Accessing the release notes ____________________________ for ULTRIX, 2-10, 3-10 Error conditions for VMS, 1-2 on VMS, 1-15 After the installation on ULTRIX (RISC), 3-13 F___________________________ on ULTRIX (VAX), 2-12 Files created or modified Authorize Utility during ULTRIX (RISC) for VMS, 1-3 installation, 3-2 C___________________________ during ULTRIX (VAX) Command files installation, 2-2 accessing on line for during VMS installation, ULTRIX, 2-10, 3-10 1-11 Conventions I described in the preface, ____________________________ vii Installation prerequisites for ULTRIX (RISC), 3-1 D___________________________ for ULTRIX (VAX), 2-1 Determining and reporting Installation procedure problems for ULTRIX (RISC), 3-11 described in the preface, to 3-13 vi for ULTRIX (VAX), 2-10 to 2-12 Index-1 Installation procedure Prerequisites (Cont.) (Cont.) to install on ULTRIX for VMS, 1-6 to 1-14 (RISC), 3-1 Installation procedure to install on ULTRIX (VAX) requirements , 2-1 for VMS, 1-2 Prerequisite software for Installation Verification VMS, 1-1 Procedure (IVP) Product Authorization Key on VMS, 1-14 (PAK) L for VMS, 1-3 ____________________________ R License Management Facility ____________________________ (LMF) Release notes for VMS, 1-3 accessing on ULTRIX, 2-10, M 3-10 ____________________________ accessing on VMS, 1-2 Maintenance updates S described in the preface, ____________________________ v Sample installation Media on ULTRIX (RISC), 3-13 for ULTRIX (RISC), 3-2 on ULTRIX (VAX), 2-13 for ULTRIX (VAX), 2-2 on VMS, 1-16 O___________________________ U___________________________ Optional software for VMS, ULTRIX (RISC) installation 1-1 procedure, 3-11 to 3-13 ULTRIX (VAX) installation P___________________________ procedure, 2-10 to 2-12 PAK User account quotas and for VMS, 1-3 privileges Preface, v to vii for VMS, 1-2 conventions, vii Using VMSINSTAL determining and reporting to install on VMS, 1-4 problems, vi V maintenance updates, v ____________________________ preparing to install, vii VMSINSTAL Preparing to install using to install on VMS, described in the preface, 1-4 vii Prerequisites Index-2 VMS installation procedure, 1-6 to 1-14 Index-3