manpages.info - online man pages   

SunOS man pages : ab2cd (1)

Maintenance Commands                                    ab2cd(1M)

NAME

ab2cd - run AnswerBook2 server from the Documentation CD

SYNOPSIS

ab2cd [ -h ] [ stop ] [ -d path_to_CD_mountpoint ] [ -p port_number ] [ -s ] [ -v ]

DESCRIPTION

The ab2cd utility runs an AnswerBook2 server directly from the Documentation CD by creating necessary space in the /tmp/.ab2 directory to store configuration files and other necessary data. It attempts to launch a web browser with the appropriate URL to display the library page for the user.

OPTIONS

The following options are supported: -d path_to_CD_mountpoint Specifies a mount point for the CD other than /cdrom. -h Displays a usage statement and a brief list of options. -p port_number Specifies a port number to use for the server. Default value is 8888. -s Scans for AnswerBook1 and AnswerBook2 collections installed on the system and adds them to the database of the AnswerBook2 server running from the CD. stop Stops AnswerBook2 server running from the CD and removes any files in the /tmp/.ab2 directory. -v Returns the version number of the ab2cd script.

USAGE

ab2cd expects /cdrom as the default mount point. To override this default, use the -d option. Use the stop option to shut down the server running from the Documentation CD. This option cleans up any files in /tmp/.ab2. By default, the ab2cd script attempts to launch a web browser (preferably Netscape Navigator) with the appropriate URL to display the library page for the user. If Netscape is not found in the user's path, it then looks for other browsers. For an AnswerBook2 server to read multi-byte characters correctly, the iconv utility must be installed on the SunOS 5.8 Last change: 24 Mar 1999 1 Maintenance Commands ab2cd(1M) system. If it is not, the ab2cd script starts the server, but the user cannot correctly view Asian book titles or other information.

EXAMPLES

Example 1: Running ab2cd In this example, the user runs the AnswerBook2 server from the CD. The ab2cd script then offers to launch a web browser with the URL for the library page. example# ab2cd Scanning for collections and attempting to start AnswerBook2 server from CD. Please wait ... Adding AnswerBook2 Help collection in C locale Adding AnswerBook2 Help collection in de locale Adding AnswerBook2 Help collection in es locale Adding AnswerBook2 Help collection in fr locale Adding AnswerBook2 Help collection in it locale Adding AnswerBook2 Help collection in ja locale Adding AnswerBook2 Help collection in ko locale Adding AnswerBook2 Help collection in sv locale Adding AnswerBook2 Help collection in zh locale Adding AnswerBook2 Help collection in zh_TW locale Solaris 7 System Administrator Collection Solaris 7 User Collection . . . Solaris 7 Installation Collection - sv Solaris XGL 3.3 AnswerBook Starting AnswerBook2 server from CD ... Started http-8888 service on port 8888 To read documents from the CD, open a browser with the URL: http://threads1:8888 Do you want to start Netscape now? [y,n] y Starting browser with URL http://threads1:8888 .... After you are finished reading documents from the CD, stop the server using: /tmp/ab2cd stop SunOS 5.8 Last change: 24 Mar 1999 2 Maintenance Commands ab2cd(1M) Example 2: Running ab2cd with Local Collections In this example, you want to add any locally-installed col- lections to the server's database. Also, no browser is defined in the user's path. example# ab2cd -s Scanning for collections and attempting to start AnswerBook2 server from CD. Please wait ... Adding AnswerBook2 Help collection in C locale Adding AnswerBook2 Help collection in de locale Adding AnswerBook2 Help collection in es locale Adding AnswerBook2 Help collection in fr locale Adding AnswerBook2 Help collection in it locale Adding AnswerBook2 Help collection in ja locale Adding AnswerBook2 Help collection in ko locale Adding AnswerBook2 Help collection in sv locale Adding AnswerBook2 Help collection in zh locale Adding AnswerBook2 Help collection in zh_TW locale Solaris 7 System Administrator Collection Solaris 7 User Collection . . . Solaris 7 Installation Collection - sv Solaris XGL 3.3 AnswerBook Detecting local collections ... Added SGMLDOCS, SGML Authoring Collection Added SUNWnstab, Netra st Systems Starting AnswerBook2 server from CD ... Started http-8888 service on port 8888 To read documents from the CD, open a browser with the URL: http://threads1:8888 After you are finished reading documents from the CD, stop the server using: /tmp/ab2cd stop Example 3: Running ab2cd Without Support for Multi-byte Locales In this example, the user launches ab2cd successfully; how- ever, support for all locales is not provided. Also, the ab2cd script is located in a specific place. SunOS 5.8 Last change: 24 Mar 1999 3 Maintenance Commands ab2cd(1M) example# ab2cd -d /home/myuser/CDROM Warning : AnswerBook2 requires the following iconv packages to be installed prior to running ab2cd: SUNWciu8 SUNWhiu8 SUNWjiu8 SUNWkiu8 SUNWuiu8 If you continue running ab2cd, multiple-byte characters might not display correctly and collections with non-English titles will not be viewable with this server. Do you want to continue? [y,n]y Scanning for collections and attempting to start AnswerBook2 server from CD. Please wait ... Adding AnswerBook2 Help collection in C locale Skipping AnswerBook2 Help collection in de locale Skipping AnswerBook2 Help collection in es locale Skipping AnswerBook2 Help collection in fr locale Skipping AnswerBook2 Help collection in it locale Skipping AnswerBook2 Help collection in ja locale Skipping AnswerBook2 Help collection in ko locale Skipping AnswerBook2 Help collection in sv locale Skipping AnswerBook2 Help collection in zh locale Skipping AnswerBook2 Help collection in zh_TW locale Solaris 7 System Administrator Collection Solaris 7 User Collection Solaris 7 Software Developer Collection KCMS Collection Solaris 7 Reference Manual Collection Skipping Solaris 7 Userbook Collection - de collection Skipping Solaris 7 Installation Collection - de collection Solaris Common Desktop Environment Developer Collection . . . Skipping Solaris 7 Installation Collection - sv collection Solaris XGL 3.3 AnswerBook Starting AnswerBook2 server from CD ... Started http-8888 service on port 8888 To read documents from the CD, open a browser with the URL: http://ow:8888 Do you want to start Netscape now? [y,n] n After you are finished reading documents from the CD, stop the server using: /tmp/ab2cd stop SunOS 5.8 Last change: 24 Mar 1999 4 Maintenance Commands ab2cd(1M)

FILES

/tmp/.ab2/* Configuration files and other necessary data

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | Documentation CD | |_____________________________|_____________________________|

SEE ALSO

answerbook2(1), ab2admin(1M), attributes(5) SunOS 5.8 Last change: 24 Mar 1999 5