Installation and Administration Issues

Upgrading an Existing AnswerBook2 Server

If an AnswerBook2 server is already installed on your system and you want to install a newer version of the server software, shut down the existing server and remove it from your system before installing the new server software. Use the following commands:

# /usr/lib/ab2/bin/ab2admin -o stop
# pkgrm SUNWab2r SUNWab2s SUNWab2u

Dependency on iconv (4204219)

The Solaris operating environment uses the iconv utility to convert characters from one code set to another. For the AnswerBook2 server to properly respond to requests from clients in non-English locales (such as European or Asian locales), you must have the iconv packages installed on the server's system. These iconv packages must be installed before you install the AnswerBook2 server software packages:

If all the iconv packages are not installed, you will see a "dependency" warning when you install the SUNWab2u package. Also, the Library page for this server will not display properly (collection titles may be strung together with no book titles displayed). In addition, users might see an Internal Server Plugin Error/TCL script exception error.

The solution is to install the iconv packages before you install the AnswerBook2 server software packages. If you install the AnswerBook2 packages first, you will have to remove and reinstall them after you install the iconv packages.

For Solaris 2.6 and Solaris 7, the iconv packages are available on the Solaris Software CD. Note that the iconv packages are part of the Developer System Support cluster, which can be a different system cluster from what is installed on your system (for example, you might have installed the End User System Support cluster on your system).

During Installation, the AnswerBook2 Server Starts Up in the C Locale (4202215)

The pkgadd utility is not able to pass environment variables to its child processes. Thus, when you install the AnswerBook2 server software or document collections, the post-install process starts up the AnswerBook2 server in the C locale.

The workaround is to run the AnswerBook2 server in a locale other than C. This is done by restarting the server using the AnswerBook2 administration interface. Use the following commands:

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

AnswerBook2 Server Does Not Support Use of pkgadd -R Option

The pkgadd(1M) man page says to use the -R option of the pkgadd utility to relocate a package. Using this option when installing the AnswerBook2 server software gives unexpected results.

The workaround for installing the AnswerBook2 server software in a location other than the default is to use the following format of the pkgadd command:

# pkgadd -a none -d . SUNWab2u

Do not relocate the SUNWab2r and SUNWab2s packages.