Install man Pages Using Installation Media in AIX 4.3

Contents

About this document
About the CD
Installing man pages to a fixed disk
Mounting and linking the CD-ROM
Possible errors

About this document

This document discusses the software and procedures needed to set up man pages in AIX Version 4.3.

There are two possible methods of setting up man pages under AIX 4.3:

  1. Install the necessary filesets from the Base Documentation CD directly to a fixed disk.

    or

  2. Mount the Base Documentation CD over /infocd and link the necessary filesets using a script that is provided.

About the CD

The Base Documentation CD is included in the AIX 4.3 distribution and is also available separately. There must be access to this CD in order to perform any of the tasks described in this document.

Installing man pages to a fixed disk

Prerequisites

  1. The LANG variable in the system's environment must be set to the correct value, en_US for US English. To display the variable, enter: 
        echo $LANG

    Use the following SMIT fastpath command to change the LANG variable: 

        smit chlang
  2. The following filesets MUST be installed for man pages to work: 
        bos.html.en_US.topnav.navigate - Top Level Navigation
    bos.html.en_US.nav             - Online Navigation
    bos.html.en_US.cmds.cmds1      - AIX Commands Reference 1
    bos.html.en_US.cmds.cmds2      - AIX Commands Reference 2
    bos.html.en_US.cmds.cmds3      - AIX Commands Reference 3
    bos.html.en_US.cmds.cmds4      - AIX Commands Reference 4
    bos.html.en_US.cmds.cmds5      - AIX Commands Reference 5
    bos.html.en_US.cmds.cmds6      - AIX Commands Reference 6

    Use the command lslpp -l <filesetname> to determine if the preceding filesets are installed on the system.

    If access is needed to AIX system calls and C library functions via the man command, the following filesets must be installed: 

        bos.html.en_US.techref.base  - AIX Base Tech Ref
    bos.html.en_US.techref.commo - AIX Commo Tech Ref

Procedure

To install any or all of the preceding filesets, enter the following SMIT fastpath: 

    smit install_all

Then select the following:

  1. Specify your CD-ROM device (for example, /dev/cd0).
  2. Highlight SOFTWARE to install and press F4.
  3. Select the filesets to install by highlighting the fileset and pressing F7.
  4. Press Enter to initiate the install process and press Enter again to confirm the install.

NOTE: If error messages are displayed, see the section on "Possible errors" in this document.

Mounting and linking the CD-ROM

Prerequisites

  1. To create and mount the CD-ROM file system and run the /infocd/linkbasecd script, root user authority or membership in the system group is required.
  2. The LANG variable in the system's environment must be set to the correct value, en_US for US English. To display the variable, enter: 
        echo $LANG

Use the following SMIT fastpath command to change the LANG variable: 

    smit chlang

Procedure

The first time the documentation databases are accessed from the CD-ROM, the following must be done:

  1. Create a CD-ROM file system with /infocd as the mount point.

    Use the following SMIT fastpath command to create the CD-ROM file system: 

        smit crcdrfs
  2. Mount the CD-ROM file system using the following SMIT fastpath command: 
        smit mountfs
  3. Run the linkbasecd script by entering: 
        /infocd/linkbasecd

    The linkbasecd script links the database subdirectories from the /infocd directory to /usr/share/man/info/en_US/a_doc_lib directory. Each database subdirectory is linked individually, just as each database can be installed separately. This allows databases to be installed on a fixed disk drive, linked from a mounted CD-ROM, or a combination of both. The script also updates the document indexes to reflect the changes made by the script.

NOTE: If error messages are displayed, see the next section, "Possible errors".

Possible errors

When following either of the preceding procedures, some errors may be encountered. Listed below are the most common errors, along with the procedures necessary to correct these errors.

  1. If the install of the Commands Reference databases fails with an error message regarding an index already existing, enter the following:

    NOTE: This procedure is outlined in the System Management Guide: Operating System and Devices, Chapter 18, "Documentation Search Service". 

        /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d cmds01en
    /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d cmds02en
    /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d cmds03en
    /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d cmds04en
    /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d cmds05en
    /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d cmds06en
     cp /var/docsearch/indexes/imnmap.dat /usr/docsearch/indexes

        /usr/IMNSearch/cli/imnixdel cmds01en
    /usr/IMNSearch/cli/imnixdel cmds02en
    /usr/IMNSearch/cli/imnixdel cmds03en
    /usr/IMNSearch/cli/imnixdel cmds04en
    /usr/IMNSearch/cli/imnixdel cmds05en
    /usr/IMNSearch/cli/imnixdel cmds06en
  2. If the Tech Ref database install fails with a similar error, do the following: 
        /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d bstrf1en
    /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d bstrf2en
    /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d cmtrf1en
    /usr/IMNSearch/cli/imndomap /var/docsearch/indexes -d cmtrf2en
     cp /var/docsearch/indexes/imnmap.dat /usr/docsearch/indexes

        /usr/IMNSearch/cli/imnixdel bstrf1en
    /usr/IMNSearch/cli/imnixdel bstrf2en
    /usr/IMNSearch/cli/imnixdel cmtrf1en
    /usr/IMNSearch/cli/imnixdel cmtrf2en
  3. If an error is received during the install that is similar to: 
        chown: 3002-131 imnadm is an unknown username.
    Error changing ownership of /var/docsearch directories !

    Enter the following: 

        mkuser imnadm
    mkgroup imnadm



[ Doc Ref: 90605212114778     Publish Date: Dec. 18, 2001]