|
Here...
Here is how you do them.
AIX 4.3Man Page Document
About This Document
This document discusses the software and procedures needed to set up man pages
in AIX Version 4.3.
SECTION 1 deals with installation of filesets to read man pages installed by free software.
SECTION 2 deal with installation of AIX man pages from the Documentation CD. (Regular Man Pages)
------------------------------------
SECTION 1
Generally man pages can not be read without the commands : nroff and tbl.
Install bos.txt.tfs off of the base install CD.
Set your MANPATH variables.. normally : export MANPATH=/usr/local/man
The default is /usr/man
Now you should be able to read these documents as well.
----------------------------------------
SECTION 2
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
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 above
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 above filesets, enter the following SMIT fastpath:
smit install_all
Then select the following:
1. Specify your CD-ROM device (/dev/cd0 usually).
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 section on "Possible Errors".
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 section on "Possible Errors".
Possible Errors
When following either of the preceeding 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
|
