System Administration IBM HTTP Server documentation
Pertains to UNIX users

Understanding National Language Support

This section provides important information regarding National Language Support (NLS). This information includes documentation locations and configuration options per platform. Links to related topics appear at the end of this section.

The IBM HTTP Server supports nine languages, in addition to US English:

  • Brazilian Portuguese
  • Chinese Simplified
  • Chinese Traditional
  • French
  • German
  • Italian
  • Japanese
  • Korean
  • Spanish

Pertains to AIX users
Pertains to HP-UX users
Pertains to Linux users
Pertains to Solaris users
Pertains to Windows users

Locating NLS documentation

You can find documentation supporting all nine languages located in language-specific subdirectories. For the IBM HTTP Server, these directories follow:
  • AIX operating system: /usr/IBMIHS/htdocs/<Lang>
  • HP operating system: /opt/IBMIHS/htdocs/<Lang>
  • Linux operating system: /opt/IBMIHS/htdocs/<Lang>
  • Solaris operating system: /opt/IBMIHS/htdocs/<Lang>
  • Windows operating systems: c:\Program Files\IBM HTTP Server 2.0\htdocs\<Lang>
Pertains to UNIX users

Understanding options for configuration of languages for the IBM HTTP Server

You can choose from two options to configure languages for the IBM HTTP Server on UNIX platforms: Using a script installed with the IBM HTTP Server product, or manually editing the configuration files and the IKEYMAN start script.

Using the installed script

A script named <setuplang>, installs with the IBM HTTP Server on UNIX platforms. The SETUPLANG script handles changes for the IBM HTTP Server.

Pertains to AIX users
Pertains to HP-UX users
Pertains to Linux users
Pertains to Solaris users

This script makes the necessary changes to the configuration files for the IBM HTTP Server. These necessary changes help to recognize the language directories. Execute the following command for each operating system:

  • AIX: /usr/IBMIHS/bin/setuplang
  • HP: /opt/IBMIHS/bin/setuplang
  • Linux: /opt/IBMIHS/bin/setuplang
  • Solaris: /opt/IBMIHS/bin/setuplang

Pertains to AIX users

Manually editing IBM HTTP Server configuration files and the IKEYMAN start script on the AIX operating system

To manually edit the IBM HTTP Server configuration files and the IKEYMAN start script, on the AIX operating system:

  1. Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the directive, DocumentRoot from: DocumentRoot /usr/IBMIHS/htdocs/en_US to: DocumentRoot /usr/IBMIHS/htdocs/<Lang>
    where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows:
    DocumentRoot /usr/IBMIHS/htdocs/Fr_FR.
  2. Edit the IBM HTTP Server IKEYMAN start script, /usr/bin/ikeyman.

    Change the first entry of export IKMLANG= from: export IKMLANG=en_US
    to: export IKMLANG=<Lang>
    where: <Lang> represents the language-specific directory. For example, to use the French directory, specify:

    export IKMLANG=Fr_FR
Pertains to HP-UX users

Option 2: Manually editing IBM HTTP Server configuration files and the IKEYMAN start script on the HP operating system

To manually edit the IBM HTTP Server configuration files and the IKEYMAN start script on the HP-UX operating system:

  1. Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the directive, DocumentRoot from: DocumentRoot /opt/IBMIHS/htdocs/en_US
    to: DocumentRoot /opt/IBMIHS/htdocs/<Lang>
    where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows:
    DocumentRoot /opt/IBMIHS/htdocs/Fr_FR
  2. Edit the IBM HTTP Server IKEYMAN start script, /usr/bin/ikeyman, and change the first entry of export IKMLANG= from: export IKMLANG=en_US to: export IKMLANG=<Lang>
    where: <Lang> represents the language-specific directory. For example, to use the French directory, specify:
    export IKMLANG=Fr_FR
Pertains to Linux users

Option 2: Manually editing the IBM HTTP Server configuration files and the IKEYMAN start script on the Linux operating system

To manually edit the IBM HTTP Server configuration files and the IKEYMAN start script on the Linux operating system:

  1. Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the directive, DocumentRoot, from: DocumentRoot /opt/IBMIHS/htdocs/en_US to: DocumentRoot /opt/IBMIHS/htdocs/<Lang>
    where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows: DocumentRoot /opt/IBMIHS/htdocs/Fr_FR.
  2. Edit the IBM HTTP Server IKEYMAN start script, /usr/bin/ikeyman, and change the first entry of export IKMLANG= from: export IKMLANG=en_US to: export IKMLANG=<Lang>
    where: <Lang> represents the language-specific directory. For example, to use the French directory, specify:
    export IKMLANG=Fr_FR
Pertains to Solaris users

Option 2: Manually editing the IBM HTTP Server configuration files and the IKEYMAN start script on the Solaris operating system

To manually edit the IBM HTTP Server configuration files and the IKEYMAN start script on the Solaris operating system:

  1. Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the directive, DocumentRoot, from: DocumentRoot /opt/IBMIHS/htdocs/en_US to: DocumentRoot /opt/IBMIHS/htdocs/<Lang>
    where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows:
    DocumentRoot /opt/IBMIHS/htdocs/Fr_FR
  2. Edit the IBM HTTP Server IKEYMAN start script, /usr/bin/ikeyman, and change the first entry of export IKMLANG=, from: export IKMLANG=en_US to: export IKMLANG=<Lang>
    where: <Lang> represents the language-specific directory. For example, to use the French directory, specify:
    export IKMLANG=Fr_FR
Pertains to Windows users

Manually editing IBM HTTP Server configuration files on Windows operating systems

To manually edit the IBM HTTP Server configuration files on Windows operating systems:

  1. Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the DocumentRoot directive from:
    DocumentRoot "C:\Program Files\IBM HTTP Server\htdocs\en_US"
    to:
    DocumentRoot "C:\Program Files\IBM HTTP Server\<Lang>"
    where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows:
    DocumentRoot "C:\Program Files\IBM HTTP Server\htdocs\Fr_FR"
    
  2. Change the Include directive from:
    Include conf/admin.msg.en_US
    to:
    Include "conf/admin.msg.<Lang>"
    where: <Lang> represents the language-specific directory. For example, to use the French directory, specify:
    Include "conf/admin.msg.fr_FR"
    
 
Finding related information

     (Back to the top)