2    Software Installation

This chapter provides a step-by-step description of the installation procedure. Before you start the installation procedure, be sure to read Chapter 1.

2.1    Starting the Installation Procedure

If you are installing the Advanced Printing Software from CD-ROM, start with Section 2.1.1.

If you are installing the New Hardware Support software from a RIS server, start with Section 2.1.2.

2.1.1    Using the Associated Products CD-ROM

If you are installing the software from the Associated Products CD-ROM Volume 2, start the installation procedure as follows:

  1. Mount the media on the appropriate disc drive. See the documentation that came with your media for instructions on mounting CD-ROM media.

  2. Log in as the root user on the system where you plan to install the software.

  3. Enter the following command to ensure that you are at the root (/) directory:

    # cd /
    

  4. Specify the /mnt directory to be the mount point for the distribution file system:

    # mount -r  -t cdfs /dev/rz1c /mnt (Version 5.0x)
    # mount -r  /dev/disk/cdrom0c /mnt (Version 5.0x)
    

  5. Enter the setld command with the -l (load) option and specify the directory in the mounted file system where the subsets are located. For a Tru64 UNIX system, the directory location for Advanced Printing Software subsets is /mnt/Advanced_Printing/kit. For example, enter:

    # setld -l /mnt/Advanced_Printing/kit
    

See Section 2.2 and Section 2.3 to continue the installation.

2.1.2    Using Remote Installation Services (RIS)

If you are installing Advanced Printing Software from a RIS server, start the installation procedure as follows:

  1. Log in as the root user on the system where you plan to install the software.

  2. Enter the following command to ensure that you are at the root (/) directory:

    # cd /
    

  3. Enter the setld command with the -l (load) function and specify the system where the subsets are located. For example, if you are loading Advanced Printing Software subsets from a RIS distribution area on node bigsys, enter the following command:

    # setld -l bigsys:
    

See Section 2.2 and Section 2.3 to continue the installation.

2.2    Installing Advanced Printing Software Server Software

The Advanced Printing Software server software consists of the following subsets:

For server systems, the minimum system installation requires only the APXBASE120, APXSVR120, and APXADMIN120 subsets. The GUI subset is optional. The following example demonstrates how to install all of the server subsets.

After you enter the setld command, the installation procedure displays the names of the Advanced Printing Software subsets and directs you to select the subsets you want installed:

# setld -l /mnt/Advanced_Printing/kit
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) Advanced Printing Software Administrator Utilities
     2) Advanced Printing Software BASE and Client Commands
     3) Advanced Printing Software Graphical User Interface
     4) Advanced Printing Software Spooler and Supervisor
     5) Advanced Printing Software lpr/lpd Gateways
 
Or you may choose one of the following options:
 
     6) ALL of the above 
     7) CANCEL selections and redisplay menus
     8) EXIT without installing any subsets 
 
Enter your choices or press RETURN to redisplay menus.
Choices (for example, 1 2 4-6): 6

If you specify more than one number at the prompt, separate each number with a space. You can specify a range of numbers by entering the starting and ending numbers with a hyphen between them.

In the next step, the setld script asks you to verify your choice of subsets to install:

You are installing the following optional subsets:
 
        Advanced Printing Software Administrator Utilities
        Advanced Printing Software BASE and Client Commands
        Advanced Printing Software Graphical User Interface
        Advanced Printing Software Spooler and Supervisor
        Advanced Printing Software lpr/lpd Gateways
 
Is this correct? (y/n): y

If the displayed subsets are not the ones you want to load, enter n; the subset selection menu will be redisplayed. When the displayed subsets are the ones you want loaded, enter y. There is no further user interaction required to complete this installation procedure.

Appendix A provides a sample listing of the full installation procedure.

The Advanced Printing Software System Administration and Operation Guide describes how to configure servers, printers, and gateways.

2.3    Installing Advanced Printing Software Client Software

The Advanced Printing Software client software allows end users to print and monitor jobs. It consists of the following subsets:

For client systems, the minimum system installation requires only the APXBASE120 subset. The APXGUI120 subset is optional. The following installation demonstrates how to install both of these client subsets.

After you enter the setld command, the installation procedure displays the names of the Advanced Printing Software subsets and directs you to select the subsets you want installed:

# setld -l /mnt/Advanced_Printing/kitThe 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) Advanced Printing Software Administrator Utilities
     2) Advanced Printing Software BASE and Client Commands
     3) Advanced Printing Software Graphical User Interface
     4) Advanced Printing Software Spooler and Supervisor
     5) Advanced Printing Software lpr/lpd Gateways
 
Or you may choose one of the following options:
 
     6) ALL of the above 
     7) CANCEL selections and redisplay menus
     8) EXIT without installing any subsets 
 
Enter your choices or press RETURN to redisplay menus.
 
Choices (for example, 1 2 4-6): 2 3

If you specify more than one number at the prompt, separate each number with a space.

In the next step, the setld script asks you to verify your choice of subsets to install:

You are installing the following optional subsets
 
        Advanced Printing Software BASE and Client Commands
        Advanced Printing Software Graphical User Interface
 
Is this correct? (y/n): y

If the displayed subsets are not the ones you want to load, enter n; the subset selection menu will be redisplayed. When the displayed subsets are the ones you want loaded, enter y. There is no further user interaction required to complete this installation procedure.

Appendix A provides a sample listing of the full installation procedure.

2.4    Installing Advanced Printing Software in a Dataless Environment

For the Advanced Printing System GUI clients to function properly in a dataless environment, the system administrator must issue the following command on each dataless client system for which the GUI clients are installed:

# dtappintegrate -s /usr/pd

If any Advanced Printing Software servers (supervisors or spoolers) are run on the client system, the administrator must also issue the following command:

# /sbin/init.d/apx start

2.5    Removing Advanced Printing Software Subsets in a Dataless Environment

It is important that the following steps be performed on the dataless client system prior to removing the Advanced Printing Software subsets from the dataless server system:

  1. Unintegrate the Advanced Printing Software GUIs from CDE using the following command:

    # dtappintegrate -s /usr/pd -u
    

  2. Ensure that Advanced Printing Software servers are stopped using the following command:

    # /sbin/init.d/apx stop