Digital_Extended_Math_Library_for_Digital_UNIX______ Installation Guide Order Number: AA-PRYDH-TE October 1996 This document contains instructions for installing the Digital Extended Math Library on the Digital UNIX operating system running on Alpha architectures. Revision/Update Information: This is a revised document. Operating System and Version: Digital UNIX, Versions 3.2 and 4.0 Software Version: Digital Extended Math Library, Version 3.3 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ First Printing, March 1993 Revised, October 1996 Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation 1993, 1995, 1996. All rights reserved. The following are trademarks of Digital Equipment Corporation: AlphaGeneration, AlphaStation, AlphaServer, Bookreader, VAX DOCUMENT, and the DIGITAL logo. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. CRAY is a registered trademark of Cray Research, Inc. All other trademarks and registered trademarks are the property of their respective holders. This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Preparing to Install DXML 1.1 License Registration.......................... 1-1 1.2 Installation Procedure Requirements........... 1-3 1.2.1 Checking Login Privileges................. 1-3 1.2.2 Hardware Requirements..................... 1-3 1.2.3 Software Requirements..................... 1-3 1.2.4 Determining Which Subsets to Load......... 1-4 1.2.5 Determining Disk Space Requirements....... 1-5 1.2.6 Increasing Disk Space for Installation.... 1-6 1.3 Backing Up Your System Disk................... 1-6 1.4 Stopping the Installation..................... 1-7 2 Installing DXML 2.1 Installing DXML Locally....................... 2-1 2.1.1 Starting the Installation Procedure....... 2-1 2.1.2 Responding to Installation Procedure Prompts and Displays...................... 2-2 2.1.2.1 Selecting Subsets....................... 2-2 2.1.2.2 Monitoring Displays During the Subset Loading Process......................... 2-3 2.2 Installing DXML on a Server................... 2-5 2.3 Recovering from Errors........................ 2-7 iii 3 Completing the Installation A Files Installed on Your System B Sample Installation Index iv _________________________________________________________________ Preface This manual describes how to install the Digital Extended Math Library (DXML) on processors running the Digital UNIX operating system. For information about the compatibility of other software products with this version of DXML, refer to the Software Product Description (SPD). You can use the SPD to verify which versions of your operating system are compatible with this version of DXML. Intended Audience This manual is intended for a system manager who installs DXML software on a Digital UNIX system. Structure of This Document This manual includes three chapters and two appendixes: o Chapter 1 describes the operating system and hardware requirements for a DXML installation and related procedures that you complete before installing DXML. o Chapter 2 describes the installation procedures. o Chapter 3 describes the Installation Verification Procedure (IVP). o Appendix A describes the hierarchy and contents of DXML directories. o Appendix B contains a log for a DXML installation. v Associated Documents Please read the cover letter before installing the software, in case important information missing from this document has been added to the cover letter. The documentation for DXML also includes the Digital Extended Math Library for Digital UNIX Reference Manual. Conventions The following conventions are used in this guide: ___________________________________________________________ Convention_______Description_______________________________ UPPERCASE and The Digital UNIX system differentiates lowercase between lowercase and uppercase characters. Literal strings that appear in text, examples, syntax descriptions, and function descriptions must be entered exactly as shown. bold type For online versions, user input is shown in bold. system output This typeface is used in interactive and code examples to indicate system output. In text, this typeface is used to indicate the exact name of a command, option, partition, pathname, directory, or file. # A number sign is the default superuser prompt. italic type Italic type emphasizes important information and indicates complete titles _________________of_manuals._______________________________ Sending Digital Your Comments on This Product Digital welcomes your comments on this product and on its documentation. You can send comments to us in the following ways: o Internet electronic mail: dxml@hpc.pko.dec.com o FAX: 508-493-3628 ATTN: DXML Team vi o A Reader's Comment Form sent to the address on the form. A Reader's Comment Form appears on the next page. o A letter sent to the following address: Digital Equipment Corporation High Performance Computing Group 129 Parker Street PKO3-2/B10 Maynard, Massachusetts 01754-2195 USA Getting Help from Digital If you have a customer support contract and have comments or questions about DXML software, you contact Digital's Customer Support Center (CSC), preferably using electronic means such as DSNlink. In the United States, customers can call the CSC at (800) 354-9000. vii Readers Comments Form Use the following form as a template for sending comments about DXML documentation. This form can be sent by Internet mail, FAX, or postal service. --------------------------------------------------------------------- Please complete this survey and send an online version (via Internet) or a hardcopy version (via FAX or postal service) to: Internet mail: dxml@hpc.pko.dec.com FAX: (508) 493-3628 Postal Service: Digital Equipment Corporation, High Performance Computing Group Documentation, PKO3-2/B10 129 Parker Street Maynard, Massachusetts 01754-2195 USA Manual Title: ______________________________________________________ Order Number: ______________________________________________________ Version: ________________________________________________ _____________________________________________________________________ _____________________________________________________________________ We welcome any comments on this manual. Your comments and suggestions help us improve the quality of our publications. 1. If you found any errors, please list them: Page Description ____ _______________________________________________________________ ____ _______________________________________________________________ ____ _______________________________________________________________ 2. How can we improve the content, usability, or otherwise improve our documentation set? _____________________________________________________________________ _____________________________________________________________________ _____________________________________________________________________ _____________________________________________________________________ Your Name/Title ____________________________________ Dept. ________ viii Company _____________________________________________ Date ________ Internet address or FAX number ______________________________________ Mailing address _____________________________________________________ ___________________________________________ Phone _________________ --------------------------------------------------------------------- ix 1 _________________________________________________________________ Preparing to Install DXML This chapter discusses the preparations and requirements for installing DXML. Before starting the installation procedure described in Chapter 2, complete the preparations outlined in this chapter. You need to know about installation options and information related to the installation procedure. 1.1 License Registration The DXML software supports the Digital UNIX License Management Facility (LMF). A License Product Authorization Key (License PAK) must be registered in the License Database (LDB) to use DXML on a newly licensed node. The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. The LMF names for DXML are as follows: o EXT-MATH-LIB for the Development Kit o EXT-MATH-LIB-RT for the Run-Time Kit To register a license under Digital UNIX, first log in as superuser. You can then perform the PAK registration in the LDB in the following way: 1. At the superuser prompt, enter the lmf register command: # /usr/sbin/lmf register o Entering the lmf register command brings you into edit mode. o While in edit mode, enter all the information on your License PAK. o After you enter the information, exit edit mode. Preparing to Install DXML 1-1 2. After you register your license, use the following lmf reset command to copy the license details from the LDB to the kernel cache: # /usr/sbin/lmf reset For complete information about using the Digital UNIX License Management Facility, see the DEC OSF/1 AXP Guide to Software Licensing or the lmf(8) reference page. 1-2 Preparing to Install DXML 1.2 Installation Procedure Requirements Installing DXML and the DXML reference pages (manpages), and running the Installation Verification Procedure (IVP) on a standalone system takes about 5 minutes. If you do not install the manpages, less time is needed. 1.2.1 Checking Login Privileges You must be able to log in as superuser on the system where you are installing DXML. Only when you are logged in as superuser do you have sufficient privileges to install the DXML software. 1.2.2 Hardware Requirements For a complete list of supported processors, see the Software Product Description. Installing the DXML serial and parallel libraries and the DXML manpages requires at least 48 megabytes of storage space on your system. To perform the installation, you need a CD-ROM drive. The documentation for the CD-ROM drive that you are using explains how to load media. 1.2.3 Software Requirements DXML, Version 3.3, has been tested and verified on Version 3.2, Version 3.3, and Version 4.0A of Digital UNIX. Before you install the DXML Development Kit, install the required subsets for your version of Digital UNIX as follows: o OSFBASEnnn-Base System o OSFMANOPnnn-Online Manual Pages o OSFDCMTnnn-Document Preparation Software o DFARTLnnn-Digital Fortran Run-Time Support where nnn is the version of the subset. The Run-Time Kit requires only the OSFBASEnnn subset. To confirm that a particular subset, for example, OSFDCMT310, is installed, use the following command: # /usr/sbin/setld -i | grep OSFDCMT310 Preparing to Install DXML 1-3 1.2.4 Determining Which Subsets to Load Your DXML Version 3.3 kit is one of the following: o A development library, denoted by XMD.., that allows you to link an application program and then run the resulting executable image o A run-time library, denoted by XMR.., that allows you to run an executable image that has been linked with the DXML library on another system ________________________ Note ________________________ Only one of the two DXML kits should be installed on any system. ______________________________________________________ The DXML Development Kit includes the following subsets: o XMDLOA330 Shared, archive libraries and utilities for the DXML software. o XMDPLL330 Complete library with certain routines parallelized for SMP configurations. This is a shared library. o XMDMAN330 Reference pages (manpages) for the DXML software. You can load the DXML reference page subset only if the Digital UNIX reference page subset is already loaded on your system. o XMDSCI330 Digital Equipment Corporation's implementation of CRAY LibSci. The DXML Run-Time Kit includes the following subsets: o XMRLOA330 Shared, archive libraries and utilities for the DXML software. o XMRPLL330 1-4 Preparing to Install DXML Complete library with certain routines parallelized for SMP configurations. This is a shared library. 1.2.5 Determining Disk Space Requirements The disk space requirements discussed in this section apply to the disks where you load the DXML subsets. You need approximately 90 megabytes of disk space to install DXML. After installation at least half of that disk space becomes free automatically. The installed subset requirements for DXML are as follows: XMDLOA330 - 30 megabytes XMDPLL330 - 15 megabytes XMDMAN330 - 6 megabytes XMDSCI330 - 6 megabytes XMRLOA330 - 9 megabytes XMRPLL330 - 9 megabytes Compare the space required for subsets with the free space currently on the disks where DXML files will reside. To determine the current amount of free space for a directory path, log in to the system where you plan to install DXML. You can check which file systems are mounted and where they are by displaying the file /etc/fstab. For example: # more /etc/fstab /dev/rz0a / ufs rw 1 1 /dev/rz0g /usr ufs rw 1 2 /dev/rz0b swap1 ufs rw 0 2 /dev/rz1c swap2 ufs sw 0 2 /dev/rz0f /usr/users ufs rw 1 2 The previous display indicates that /usr (mounted to /dev /rz0g) is the only mount point that affects where DXML files will reside; the system has only one local disk drive and the /usr/lib file system resides in the g partition of the disk on that drive. Enter the df command to determine total space and free space for the one or two file systems where DXML files will reside. Based on the previous display of the /etc/fstab file, which shows that only /usr is a mount point, you Preparing to Install DXML 1-5 would only need to inspect free space in the /usr file system: # df /usr Filesystem Total blks blks % node 512-blks used free used Mounted on /dev/rz0g 793406 596672 117392 84% /usr The previous display indicates that there are 117392 blocks free. This free space accommodates the subset requirements. On systems where /usr/opt is mounted to different devices from /usr, enter the following command: # df /usr/opt In this case, you compare space required for DXML files in /usr/opt to the free space displayed in the output list. 1.2.6 Increasing Disk Space for Installation The DXML installation procedure loads files into the following directory (with symbolic links to system directories): /usr/opt If you find that there is insufficient disk space for the DXML subsets, and know that you have additional space on alternative disks or disk partitions for your system, you can take the following steps before installing DXML: 1. Log in as superuser. 2. Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space. 3. Enter the mount -a command so that the new mount points take effect. 1.3 Backing Up Your System Disk Digital recommends that you back up your system disk before installing any software. Use the backup procedures established at your site. For details about how to perform a system disk backup, see your Digital UNIX documentation. 1-6 Preparing to Install DXML 1.4 Stopping the Installation You can stop the installation procedure at any time by pressing Ctrl/C. However, files created up to that point are not deleted. You must delete these files interactively. Appendix A lists the files and directories created during the installation procedure. Preparing to Install DXML 1-7 2 _________________________________________________________________ Installing DXML This chapter describes the procedures for installing DXML on a Digital UNIX system. DXML can be installed locally from a CD-ROM. Section 2.1 explains how to do a local installation. 2.1 Installing DXML Locally This section explains how to start a local installation procedure directly from the CD-ROM and how to respond to installation procedure prompts. 2.1.1 Starting the Installation Procedure Start the DXML installation procedure from CD-ROM as follows: 1. Mount the media on the appropriate drive. 2. Log in as superuser (the login name is root) to the system where you are installing DXML. 3. Make sure that you are at the root (/) directory by entering the following command: # cd / 4. Specify the /mnt directory to be the mount point for the distribution file system on the drive. If your CD-ROM drive is rz33c, enter the following command: # /usr/sbin/mount -dr /dev/rz33c /mnt 5. Enter a setld command that requests the load function and identifies the directory in the file system where DXML subsets are located. Installing DXML 2-1 When you load DXML subsets onto a Digital UNIX system, enter one of the following commands: o To install the DXML Development Kit, use the following command: # /usr/sbin/setld -l /mnt/xmd330/kit o To install the DXML Run-Time Kit, use the following command: # /usr/sbin/setld -l /mnt/xmr330/kit 2.1.2 Responding to Installation Procedure Prompts and Displays The following sections explain the installation procedure prompts and displays. 2.1.2.1 Selecting Subsets After you enter the setld command for local installations, the installation procedure displays the names of DXML subsets and asks you to specify the subsets that you want to load. For example: *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose not to install any subsets: * DXML 3.3 Development Kit (serial library) 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) DXML Reference (man)Pages 2) DXML V3.3 Development Kit (parallel library) 3) DXML V3.3 SCIPORT library Enter your choices or press RETURN to display the next screen: 4) ALL mandatory and all optional subsets 5) MANDATORY subsets only 6) CANCEL selections and redisplay menus 7) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 4 2-2 Installing DXML Next, the script lets you verify your choice. For example, if you enter 3 in response to the previous prompt, the system displays the following: You are installing the following mandatory subsets: DXML 3.3 Development Kit (serial library) You are installing the following optional subsets: DXML Reference (man)Pages DXML V3.3 Development Kit (parallel library) DXML V3.3 SCIPORT library Is this correct? (y/n): y ________________________ Note ________________________ Do not install the DXML Parallel Kit, unless the target system is a multiprocessor SMP configuration. ______________________________________________________ If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is again displayed, and you can correct your choice. If the displayed subsets are the ones you want to load, enter y. 2.1.2.2 Monitoring Displays During the Subset Loading Process The distribution subsets include an EV5 version of DXML optimized for the AlphaServer 5/nnn (Alpha microprocessor 21164) and an EV4 version optimized for the AlphaServer 4/nnn (Alpha microprocessor 210nn). The installation procedure determines whether your system has EV4 or EV5 architecture and chooses the corresponding version of DXML by default. In the event you want to override the default setting, enter a no response to the architecture version question. Do you want to install the EV4 library [y] ? y The system displays the following information: Installing DXML 2-3 The product's license information is: Product Name: EXT-MATH-LIB Issuer: DIGITAL-IM&T Producer: DEC Version: Key Termination Date: Installing DXML V3.3...... DXML Development Kit Copying form /mnt/xmd330/kit (disk) Verifying Next, you are asked if you want to automatically run the Installation Verification Procedure (IVP) after the installation is finished. The IVP checks to ensure that the installation is successful. The IVP consists of a set of sample programs calling DXML subroutines. The programs are compiled and linked as part of the IVP. The execution depends on the Fortran run-time library being installed, see Section 1.2.3. Configuring "DXML 3.3 Development Kit (serial library)" (XMDLOA330) Would you like to run the IVP after the installation [y/n]? y Running DXML V3.3 serial IVP...... Copyright (c) Digital Equipment Corporation, 1996. All rights reserved. Checking for a valid Development Kit PAK IVP_TEST> IVP Testing in progress IVP_TEST> DXML IVP completed OK Configuring "DXML 3.3 Development Kit (parallel library)" (XMDPLL330) Would you like to run the IVP after the installation [y/n]? y Running DXML V3.3 parallel IVP...... Copyright (c) Digital Equipment Corporation, 1996. All rights reserved. Checking for a valid Development kit PAK IVP_TEST> IVP Testing in progress IVP_TEST> DXML IVP completed OK 2-4 Installing DXML Creating Links to new manpages for DXML Completed creating links Configuring "DXML Reference (man)Pages" (XMDMAN330) # /usr/sbin/umount /dev/rz33c # If you encounter errors during the installation, see the Diagnostics section of the setld(8) reference page for an explanation of the error and the appropriate action to take. If the verification process fails, you can look in the file /usr/var/adm/fverify to find information that can help you diagnose the problem. After you correct the installation problem, use the command setld -d to delete the DXML subsets before you reinstall the product. Chapter 3 discusses the postinstallation tasks. 2.2 Installing DXML on a Server This section explains how to use DMU (the dataless management utility) to install DXML in a dataless client /server environment. The following installation example assumes the media has been mounted, and the /mnt directory is the mount point for the distribution file system. 1. Enter the following command to display the DMU main menu: # /usr/sbin/dmu 2. Choose i) INSTALL software environments to display the Software Installation menu where you can choose the type of installation. For example : *** DMU Main Menu *** Installing DXML 2-5 a) ADD a client c) CONFIGURE software environments d) DELETE software environments i) INSTALL software environments l) LIST registered clients m) MODIFY a client r) REMOVE a client s) SHOW software environments x) EXIT Enter your choice: i DMU Software Installation Menu: 1) Install software into a new area 2) Add software into an existing area 3) Perform configuration phase on an existing area Enter your choice: 2 You have chosen to add a product to an existing environment. The existing environment is /usr/var/adm/dms/dms0.alpha. 3. Enter the mount point and DXML kit name at the prompt. If you are installing the Version 3.3 Development Kit, the following is an example of the prompt and a response: Enter the device special file name or the path of the directory where the software is located (for example, /mnt/ALPHA/BASE): /mnt/xmd330/kit 2-6 Installing DXML 4. The DXML installation procedure asks you to specify the subsets you want to load. Follow the instructions in Section 2.1.2.1. After you have installed DXML, choose x) EXIT from the DMU Main Menu. 2.3 Recovering from Errors If errors occur during the installation, the system displays failure messages. If the installation fails due to insufficient disk space, the installation procedure displays the following message: There is not enough file system space for subset . will not be loaded. The is one of the subset names. If any of the following conditions exist, errors can occur during the installation: o The operating system version is incorrect. o The prerequisite software version is incorrect. o The system parameter values for successful installation are insufficient. o The correct PAK is not registered and loaded. For descriptions of error messages generated by these conditions, see the Digital UNIX documentation on system messages, recovery procedures, and Digital UNIX software installation. If you are notified that any of these conditions exist, take the appropriate action described in the message. For information about software requirements, see Section 1.2.3. If an error occurs while using DXML and you believe that the error is caused by a problem with DXML, take one of the following actions: o If you have a basic or DECsupport Software Agreement, call your Customer Support Center (CSC). The CSC provides telephone support for high-level advisory and remedial assistance. Installing DXML 2-7 o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). o If you purchased DXML within the last 90 days and you think that the problem is caused by a software error, you can submit an SPR. 2-8 Installing DXML 3 _________________________________________________________________ Completing the Installation At any time after installing DXML, you can run the Installation Verification Procedure (IVP) to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access DXML. To run the IVP after an installation of the development kit, enter the following command: # /usr/sbin/setld -v XMDLOA330 When the IVP runs successfully, the system displays the following: Running DXML V3.3 IVP...... Copyright (c) Digital Equipment Corporation, 1996. All rights reserved. Checking for a valid Development Kit PAK IVP_TEST> IVP Testing in progress IVP_TEST> DXML IVP completed OK Completing the Installation 3-1 A _________________________________________________________________ Files Installed on Your System This appendix contains a list of directories and files installed by the different DXML kits and subsets. Files installed by the DXML serial subset (XMDLOA330): /usr/opt/XMDLOA330/docs/XMD330_release_note.txt /usr/opt/XMDLOA330/ivp/c_ivp_lapack.o /usr/opt/XMDLOA330/ivp/c_ivp_sig.o /usr/opt/XMDLOA330/ivp/c_ivp_sparse_b1.o /usr/opt/XMDLOA330/ivp/c_ivp_sparse_is.o /usr/opt/XMDLOA330/ivp/c_ivp_sparse_sky.o /usr/opt/XMDLOA330/ivp/c_ivp_vlib.o /usr/opt/XMDLOA330/ivp/dxml_ivp /usr/opt/XMDLOA330/ivp/dxml_ivp.inst /usr/opt/XMDLOA330/ivp/dxml_ivp.verify /usr/opt/XMDLOA330/ivp/dxml_ivp_nofor /usr/opt/XMDLOA330/ivp/ivp_lapack.o /usr/opt/XMDLOA330/ivp/ivp_sig.o /usr/opt/XMDLOA330/ivp/ivp_sparse_b1.o /usr/opt/XMDLOA330/ivp/ivp_sparse_is.o /usr/opt/XMDLOA330/ivp/ivp_sparse_sky.o /usr/opt/XMDLOA330/ivp/ivp_vlib.o Files Installed on Your System A-1 /usr/opt/XMDLOA330/dxml/DXMLDEF.FOR /usr/opt/XMDLOA330/dxml/dxml.ml /usr/opt/XMDLOA330/dxml/dxmldef.h /usr/opt/XMDLOA330/dxml/end.o /usr/opt/XMDLOA330/dxml/equivalence_lapack /usr/opt/XMDLOA330/dxml/equivalence_lapack.c /usr/opt/XMDLOA330/dxml/share/libdxml_ev5.so (or libdxml_ev4.so)1 /usr/opt/XMDLOA330/dxml/share/libdxml_ev5.a (or libdxml_ev4.a)1 /usr/examples/dxml/example_itsol_1.f /usr/examples/dxml/example_itsol_2.f /usr/examples/dxml/example_itsol_3.f /usr/examples/dxml/example_itsol_4.f /usr/examples/dxml/example_itsol_5.f /usr/examples/dxml/example_lapack_1.f /usr/examples/dxml/example_lapack_2.f /usr/examples/dxml/example_skysol_1.f /usr/examples/dxml/example_skysol_2.f /usr/examples/dxml/example_skysol_3.f /usr/examples/dxml/example_skysol_4.f /usr/examples/dxml/examples_sig_proc.f /usr/examples/dxml/read_me.index /usr/examples/dxml/example_sfft_1d.c /usr/examples/dxml/example_sfft_2d.c /usr/examples/dxml/example_itsol_1.c /usr/examples/dxml/example_itsol_1.cxx /usr/examples/dxml/example_skysol_1.c /usr/examples/dxml/example_skysol_1.cxx /usr/examples/dxml/example_lapack_1.c ____________________ 1 _ev4 denotes files optimized for the AlphaServer(AlphaStation)4/nnn. _ev5 denotes files optimized for the AlphaServer(AlphaStation)5/nnn. A-2 Files Installed on Your System Files installed by the parallel subset (XMDPLL330): /usr/opt/XMDPLL330/dxml/c_ivp_lapack.o /usr/opt/XMDPLL330/dxml/c_ivp_sig.o /usr/opt/XMDPLL330/dxml/c_ivp_sparse_b1.o /usr/opt/XMDPLL330/dxml/c_ivp_sparse_is.o /usr/opt/XMDPLL330/dxml/c_ivp_sparse_sky.o /usr/opt/XMDPLL330/dxml/c_ivp_vlib.o /usr/opt/XMDPLL330/dxml/dxml_ivp /usr/opt/XMDPLL330/dxml/dxml_ivp.inst /usr/opt/XMDPLL330/dxml/dxml_ivp.verify /usr/opt/XMDPLL330/dxml/dxml_ivp_nofor /usr/opt/XMDPLL330/dxml/ivp_lapack.o /usr/opt/XMDPLL330/dxml/ivp_sig.o /usr/opt/XMDPLL330/dxml/ivp_sparse_b1.o /usr/opt/XMDPLL330/dxml/ivp_sparse_is.o /usr/opt/XMDPLL330/dxml/ivp_sparse_sky.o /usr/opt/XMDPLL330/dxml/ivp_vlib.o /usr/opt/XMDPLL330/dxml/share/libdxmlp_ev5.so (or libdxmlp_ev4.so)1 Files installed for manpages (XMDMAN330): /usr/opt/XMDMAN330/man [Approximately 1400 manpages files] Files installed by the optional SCIPORT subset (XMDSCI330): /usr/opt/XMDSCI330/ivp/c_ivp_sciport.o /usr/opt/XMDSCI330/ivp/ivp_sciport.o /usr/opt/XMDSCI330/ivp/sciport_ivp. Files installed for manpages (XMDSCI330): /usr/opt/XMDSCI330/man [Approximately 220 manpages files] Files Installed on Your System A-3 Files installed by the Run-Time Kit (XMRLOA330): /usr/opt/XMRLOA330/docs/XMRLOA330_release_note.txt /usr/opt/XMRLOA330/dxml/share/libdxml_ev5.so (or libdxml_ev4.so)1 /usr/opt/XMRLOA330/ivp/dxml_ivp_nofor_rt /usr/opt/XMRLOA330/ivp/dxml_ivp_rt /usr/opt/XMRLOA330/ivp/dxml_ivp_rt.inst /usr/opt/XMRLOA330/ivp/dxml_ivp_rt.verify /usr/opt/XMRLOA330/ivp/ivp_lapack /usr/opt/XMRLOA330/ivp/ivp_sig /usr/opt/XMRLOA330/ivp/ivp_sparse_b1 /usr/opt/XMRLOA330/ivp/ivp_sparse_is /usr/opt/XMRLOA330/ivp/ivp_sparse_sky /usr/opt/XMRLOA330/ivp/ivp_vlib Files installed by the Run-Time Kit (XMRPLL330): /usr/opt/XMRPLL330/ivp/dxml_ivp_nofor_rt /usr/opt/XMRPLL330/ivp/dxml_ivp_rt /usr/opt/XMRPLL330/ivp/dxml_ivp_rt.inst /usr/opt/XMRPLL330/ivp/dxml_ivp_rt.verify /usr/opt/XMRPLL330/ivp/ivp_lapack /usr/opt/XMRPLL330/ivp/ivp_sig /usr/opt/XMRPLL330/ivp/ivp_sparse_b1 /usr/opt/XMRPLL330/ivp/ivp_sparse_is /usr/opt/XMRPLL330/ivp/ivp_sparse_sky /usr/opt/XMRPLL330/ivp/ivp_vlib /usr/opt/XMRPLL330/dxml/share/libdxmlp_ev5.so (or libdxml_ev4.so)1 A-4 Files Installed on Your System B _________________________________________________________________ Sample Installation This appendix contains a log of a complete installation of the DXML Development Kit including the serial library (XMDLOAD330), the parallel library (XMDPLL330), the manpages (XMDMAN330), and the SCIPORT library and manpages (XMDSCI330) # setld -l /mnt/xmd330/kit *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * DXML V3.3 Development Kit (serial library) 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) DXML Reference (man)Pages 2) DXML V3.3 Development Kit (parallel library) 3) DXML V3.3 SCIPORT library Enter your choices or press RETURN to display the next screen. Choices (for example, 1 2 4-6): Or you may choose one of the following options: 4) ALL mandatory and all optional subsets 5) MANDATORY subsets only 6) CANCEL selections and redisplay menus 7) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 4 You are installing the following mandatory subsets: Sample Installation B-1 DXML V3.3 Development Kit (serial library) You are installing the following optional subsets: DXML Reference (man)Pages DXML V3.3 Development Kit (parallel library) DXML V3.3 SCIPORT library Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. ************************************************************************* * * *Copyright Digital Equipment Corporation 1993,1996. All rights reserved.* * * * Restricted Rights: Use, duplication, or disclosure by the U.S. * * Government is subject to restrictions as set forth in subparagraph * * (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR * * 52.227-14 Alt. III, as applicable. * * * * This software is proprietary to and embodies the confidential * * technology of Digital Equipment Corporation. Possession, use, or * * copying of this software and media is authorized only pursuant to a * * valid written license from Digital or an authorized sublicensor. * * * ************************************************************************* Digital Extended Math Library V3.3 for Digital UNIX This installation will take approximately 5 minutes. Do you want to install the EV5 library [y]? y The EV5 library is being installed. The product's license information is: Product Name: EXT-MATH-LIB Issuer: DIGITAL-IM&T Producer: DEC Version: Key Termination Date: Installing DXML V3.3 Development Kit (serial library)...... B-2 Sample Installation DXML V3.3 Development Kit (serial library) Copying from /mnt/xmd330/kit Working....Tue Sep 10 10:56:02 EDT 1996 Verifying Digital Extended Math Library V3.3 for Digital UNIX DXML V3.3 Development Kit (parallel library) Copying from /mnt/xmd330/kit Working....Tue Sep 10 10:56:40 EDT 1996 Verifying ************************************************************************* * * *Copyright Digital Equipment Corporation 1993,1996. All rights reserved.* * * * Restricted Rights: Use, duplication, or disclosure by the U.S. * * Government is subject to restrictions as set forth in subparagraph * * (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR * * 52.227-14 Alt. III, as applicable. * * * * This software is proprietary to and embodies the confidential * * technology of Digital Equipment Corporation. Possession, use, or * * copying of this software and media is authorized only pursuant to a * * valid written license from Digital or an authorized sublicensor. * * * ************************************************************************* Deleting obsolete versions of DXML manpages Completed deleting obsolete versions of DXML manpages DXML Reference (man)Pages Copying from /mnt/xmd330/kit Working....Tue Sep 10 10:57:32 EDT 1996 Verifying Sample Installation B-3 ************************************************************************* * * * Copyright Digital Equipment Corporation 1996. All rights reserved. * * * * Restricted Rights: Use, duplication, or disclosure by the U.S. * * Government is subject to restrictions as set forth in subparagraph * * (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR * * 52.227-14 Alt. III, as applicable. * * * * This software is proprietary to and embodies the confidential * * technology of Digital Equipment Corporation. Possession, use, or * * copying of this software and media is authorized only pursuant to a * * valid written license from Digital or an authorized sublicensor. * * * ************************************************************************* DXML V3.3 SCIPORT library for Digital UNIX Completed deleting obsolete versions of DXML SCIPORT DXML V3.3 SCIPORT library Copying from /mnt/xmd330/kit Verifying Configuring "DXML V3.3 Development Kit (serial library)" (XMDLOA330) Would you like to run the IVP after the installation [y/n]? y Running DXML V3.3 serial IVP...... Copyright (c) Digital Equipment Corporation, 1996. All rights reserved. Checking for a valid Development kit PAK IVP_TEST> IVP Testing in progress IVP_TEST> DXML IVP completed OK Configuring "DXML V3.3 Development Kit (parallel library)" (XMDPLL330) Would you like to run the IVP after the installation [y/n]? y Running DXML V3.3 parallel IVP...... Copyright (c) Digital Equipment Corporation, 1996. All rights reserved. Checking for a valid Development kit PAK B-4 Sample Installation IVP_TEST> IVP Testing in progress IVP_TEST> DXML IVP completed OK Creating Links to new manpages for DXML Configuring "DXML Reference (man)Pages" (XMDMAN330) Creating Links to new manpages for DXML V3.3 SCIPORT Configuring "DXML V3.3 SCIPORT library" (XMDSCI330) Would you like to run the IVP after the installation [y/n]? y Running DXML V3.3 SCIPORT IVP...... Copyright (c) Digital Equipment Corporation, 1996. All rights reserved. Checking for a valid Development kit PAK IVP_TEST> IVP Testing in progress IVP_TEST> DXML SCIPORT IVP completed OK # Sample Installation B-5 _________________________________________________________________ Index A Installation sample, B-1 _______________________________ IVP, 3-1 Architecture, 2-3 L______________________________ B______________________________ Library selection Backing up your system, 1-6 archive, 1-4 EV4 or EV5, 2-3 D______________________________ parallel, 2-3 Dataless Management Utility, serial, 2-2 2-5 shared, 1-4 Disk space requirements, 1-5 License Management Facility (LMF), 1-1 E______________________________ S Error recovery, 2-7 _______________________________ EV4 library, 2-3 Server installation, 2-5 EV5 library, 2-3 Software requirements, 1-3 Storage required for H installation, 1-3 _______________________________ Subsets, 1-4 Hardware requirements, 1-3 selecting, 2-2 I______________________________ Installation storage, 1-3 Installation guide conventions, vi structure, v Installation procedure local, 2-1 server, 2-5 Index-1