Changing Documentation Server Configuration

When you install the AnswerBook2 server software, certain variables are set to default values. Use the fields on the Modify Server Configuration page to change these values. You can change the following server settings:

• Server name -- When you install the documentation server, AnswerBook2 automatically sets this variable to the current host name (for example, cats). If you want anyone outside of your domain to access documents on this server, change the name to a fully qualified name (for example, cats.house.pets.com ).

• Server port number -- To use a port other than 8888 for the AnswerBook2 server, enter the port number in this field. To use a port number below 1024, you need to perform some additional steps. For more information, see "Using a Port Number Less Than 1024".

• Maximum threads -- This is the maximum number of concurrent AnswerBook1 searches the server will perform. If you have lots of AnswerBook1 collections and people search them frequently, you might want to increase this number. If you increase this number, however, it might slow your server's response time.

• Maximum server requests -- This tells the server how often to perform "housekeeping" activities and restart itself. The number indicates the number of http requests to the server.

• Access log file -- Click the appropriate item to turn on or turn off access logging. If you anticipate many users accessing your documentation server, you might want to periodically save and restart this log file. For more information about rotating the access log file, see "Rotating Log Files".

• Error log file -- Click the appropriate item to turn on or turn off error logging. If you experience large numbers of server errors, you might need to periodically save and restart this log file. For more information about rotating the error log file, see "Rotating Log Files".

• Administration access control -- Click the appropriate item to turn on or turn off administrative access control. When access control is turned on, only those users who have administrative access defined can perform administrative functions for this server.

These functions are also available through the administration command-line interface (ab2admin). For detailed information about the command-line interface, see the ab2admin(1m) man page. You can also edit the server_config_path/dwhttpd.cfg file (which defaults to /usr/lib/ab2/dweb/data/config/dwhttpd.cfg) to change these values.

If you change any of these values, you must stop and start the documentation server. Log in as root on the server machine and type the following commands:

# /usr/lib/ab2/bin/ab2admin -o stop
# /usr/lib/ab2/bin/ab2admin -o start