Installation and Configuration Supplement

Serving Documentation in Multiple Languages

To serve translated versions of the DB2 online documentation on the web, you might prefer to start with a UNIX server, where you can use symbolic links instead of making multiple copies of files and directories.

When you install DB2 on a UNIX server, you can select one or more languages for the online product library. English (en_US) HTML books are always installed with books in any other language, because some books are available only in English.

The installation through the db2setup utility creates a doc/html subdirectory that contains a link to each translated book or individual HTML file, or the English one if no translated version is available.

The doc/html subdirectory can be found in the following paths on UNIX systems:

• On AIX systems: /usr/lpp/db2_07_01/doc/html
• On HP-UX and Solaris systems: /opt/IBMdb2/V7.1/doc/html

This provides a well-known location for the DB2 documentation, regardless of the language chosen.

If you install through the smit or another native operating system installation tool instead of the db2setup utility, you must follow the instructions in the DB2 for UNIX Quick Beginnings manual for running the db2insthtml command. You must run this command for each language in which you installed DB2 documentation.

For example, if you used smit on AIX to install English, German, and French documentation, you would run these commands afterward:

   cd /usr/lpp/db2_07_01/doc
   db2insthtml en_US
   db2insthtml de_DE
   db2insthtml fr_FR
 

Specifying the fr_FR locale last means that the links in /usr/lpp/db2_07_01/doc/html would point to the French versions of files that are translated into French, and English files for everything else. When running the db2insthtml command for multiple languages, always run it for en_US first.

Example 1: English and Japanese

You want to set up a web server for users who speak only Japanese, or a mixture of Japanese and English. Because only two languages are involved, you can select both the English and Japanese languages for the Product Library and set up a virtual directory on the server that points to the doc/html subdirectory, which has links to all the Japanese books, and to English books where no translated version is available. The index.htm file in this directory provides a list of all the product manuals, and is the place to begin when looking for information.

Example 2: English, Japanese and Swedish

Now, you want to set up a web server for users who speak a mixture of Japanese, English, and Swedish. The Japanese books are in the doc/ja_JP/html subdirectory, the English books are in the doc/en_US/html subdirectory, and the Swedish books are in the doc/sv_SE/html subdirectory. The Japanese and Swedish directories have symbolic links so that any books that are not translated are displayed in English.