National Language Support: IBM HTTP Server
System Administration IBM HTTP Server documentation
Applies to UNIX

National Language Support


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

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

Applies to UNIX Applies to Windows NT

Note: On UNIX platforms, multiple languages can install at the same time. Windows NT only supports one language at a time and this language is chosen at installation.

Applies to AIX
Applies to HP-UX
Applies to Linux Applies to Solaris

Documentation supporting all nine languages is located in language specific subdirectories. For IBM HTTP Server, the directory is:

  • /usr/HTTPServer/htdocs/<lang>, for AIX.
  • /opt/HTTPServer/htdocs/<Lang>, for HP
  • /opt/IBMHTTPServer/htdocs/<Lang>, for Linux
  • /opt/IBMHTTPD/htdocs/<Lang>, for Solaris
Applies to AIX
Applies to HP-UX
Applies to Linux Applies to Solaris

For Administration Server the directory is:

  • /usr/HTTPServer/admindocs/<Lang>, for AIX
  • /opt/HTTPServer/admindocs/<Lang>, for HP
  • /opt/IBMHTTPServer/admindocs/<Lang>, for Linux
  • /opt/IBMHTTPD/admindocs/<Lang>, for Solaris

Install these languages, by selecting the appropriate install images at IBM HTTP Server install time.

Options for configuration of Languages for IBM HTTP Server and Administration Server

OPTION 1:

There is a script installed with IBM HTTP Server, named <setuplang>. SETUPLANG will handle changes for both IBM HTTP Server and Administration Server.

Applies to AIX
Applies to HP-UX
Applies to Linux Applies to Solaris

This script will make the necessary changes to the configuration files for IBM HTTP Server and Administration Server. These changes are necessary to recognize the language directories. Execute command:

  • /usr/HTTPServer/bin/setuplang, for AIX
  • /opt/HTTPServer/bin/setuplang, for HP
  • /opt/IBMHTTPServer/bin/setuplang, for Linux
  • /opt/IBMHTTPD/bin/setuplang, for Solaris

Applies to AIX OPTION 2: (For AIX)

Manually edit the IBM HTTP Server and Administration Server Configuration files and the IKEYMAN start script:

  1. Edit IBM HTTP Server configuration file, HTTPD.CONF, and change directive "DocumentRoot" from:
    DocumentRoot /usr/HTTPServer/htdocs/en_US
    to: DocumentRoot /usr/HTTPServer/htdocs/<Lang>

    Note: <Lang> is the language-specific directory. For example, fr_FR would be

    DocumentRoot /usr/HTTPServer/htdocs/Fr_FR.
  2. Edit Administration Server configuration file, ADMIN.CONF, and change directive "DocumentRoot" from:
    DocumentRoot /usr/HTTPServer/admindocs/en_US
    to: DocumentRoot /usr/HTTPServer/admindocs/<Lang>

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be

    DocumentRoot /usr/HTTPServer/admindocs/Fr_FR
    .
  3. Change directive "Alias" from:
    Alias /admin /usr/HTTPServer/admindocs/en_US
    
    Alias /manual /usr/HTTPServer/htdocs/en_US/manual
    
    Alias /error /usr/HTTPServer/htdocs/en_US
    
    to:
    Alias /admin /usr/HTTPServer/admindocs/<Lang> Alias /manual /usr/HTTPServer/htdocs/<Lang>/manual Alias /error /usr/HTTPServer/htdocs/<Lang>

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be

    Alias /admin  /usr/HTTPServer/admindocs/Fr_FR
    .
  4. Change directive "Include" from:
    Include conf/admin.msg.en_US
    to: Include "conf/admin.msg.<Lang>"

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be

    Include conf/admin.msg.fr_FR
    .
  5. Edit IBM HTTP Server IKEYMAN Start Script, /usr/bin/ikeyman.

    Change first entry of "export IKMLANG=" from:

    export IKMLANG=en_US
    to: export IKMLANG=<Lang>

    Note: <Lang> is the language-specific directory. For example, Fr_FR would be

    export IKMLANG=Fr_FR
Applies to HP-UX OPTION 2: (For HP)

Manually edit the IBM HTTP Server and Administration Server Configuration files and the IKEYMAN start script:

  1. Edit IBM HTTP Server configuration file,HTTPD.CONF, and change directive "DocumentRoot" from:
    DocumentRoot /opt/HTTPServer/htdocs/en_US
    to: DocumentRoot /opt/HTTPServer/htdocs/<Lang>

    Note: <Lang> is the language-specific directory. For example, Fr_FR would be DocumentRoot /opt/HTTPServer/htdocs/Fr_FR.

  2. Edit Administration Server configuration file, ADMIN.CONF, to change directive "DocumentRoot" from:
    DocumentRoot /opt/HTTPServer/admindocs/en_US
    to: DocumentRoot /opt/HTTPServer/admindocs/<Lang>

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be DocumentRoot /opt/HTTPServer/admindocs/Fr_FR.

  3. Change directive "Alias" from:
    Alias /admin /opt/HTTPServer/admindocs/en_US
    
    Alias /manual /opt/HTTPServer/htdocs/en_US/manual
    
    Alias /error /opt/HTTPServer/htdocs/en_US
    to:
    Alias /admin /opt/HTTPServer/admindocs/<Lang> Alias /manual /opt/HTTPServer/htdocs/<Lang>/manual Alias /error /opt/HTTPServer/htdocs/<Lang>

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be Alias/admin/opt/HTTPServer/admindocs/Fr_FR.

  4. Change directive "Include" from:
    Include conf/admin.msg.en_US
    to: Include "conf/admin.msg.<Lang>"

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be Include conf/admin.msg.fr_FR.

  5. Edit IBM HTTP Server IKEYMAN Start Script, /usr/bin/ikeyman, and change first entry of "export IKMLANG=" from:
    export IKMLANG=en_US
    to: export IKMLANG=<Lang>

    Note: <Lang> is the language-specific directory. For example, Fr_FR would be export IKMLANG=Fr_FR

Applies to Linux OPTION 2: (For Linux)

Manually edit the IBM HTTP Server and Administration Server Configuration files and the IKEYMAN start script:

  1. Edit IBM HTTP Server configuration file, HTTPD.CONF, and change directive "DocumentRoot" from:
    DocumentRoot /opt/IBMHTTPServer/htdocs/en_US
    to: DocumentRoot /opt/IBMHTTPServer/htdocs/<Lang>

    Note: <Lang> is the language-specific directory. For example, Fr_FR would be DocumentRoot /opt/IBMHTTPServer/htdocs/Fr_FR.

  2. Edit Administration Server configuration file, ADMIN.CONF, to change directive "DocumentRoot" from:
           
    DocumentRoot /opt/IBMHTTPServer/admindocs/en_US
    to: DocumentRoot /opt/IBMHTTPServer/admindocs/<Lang>

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be DocumentRoot /opt/IBMHTTPServer/admindocs/Fr_FR.

  3. Change directive "Alias" from:
     
    Alias /admin/opt/IBMHTTPServer/admindocs/en_US
    
    Alias /manual/opt/IBMHTTPServer/htdocs/en_US/manual
    
    Alias /error/opt/IBMHTTPServer/htdocs/en_US
    to:
    Aias /admin/opt/IBMHTTPServer/admindocs/<Lang> Alias /manual/opt/IBMHTTPServer/htdocs/<Lang>/manual Alias /error/opt/IBMHTTPServer/htdocs/<Lang>

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be Alias/admin/opt/IBMHTTPServer/admindocs/Fr_FR).

  4. Change directive "Include" from:
    Include conf/admin.msg.en_US
    to: Include "conf/admin.msg.<Lang>"

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be Include conf/admin.msg.fr_FR.

  5. Edit IBM HTTP Server IKEYMAN Start Script, /usr/bin/ikeyman, and change first entry of "export IKMLANG=" from:
    export IKMLANG=en_US
    to: export IKMLANG=<Lang>

    Note: <Lang> is the language-specific directory. For example, Fr_FR would be export IKMLANG=Fr_FR.

Applies to Solaris OPTION 2: (For Solaris)

Manually edit the IBM HTTP Server and Administration Server Configuration files and the IKEYMAN start script:

Edit IBM HTTP Server configuration file, HTTPD.CONF

  1. Change directive "DocumentRoot" from:
    DocumentRoot /opt/IBMHTTPD/htdocs/en_US
    to: DocumentRoot /opt/IBMHTTPD/htdocs/<Lang>

    Note: <Lang> is the language-specific directory. For example, Fr_FR would be DocumentRoot /opt/IBMHTTPD/htdocs/Fr_FR.

  2. Edit Administration Server configuration file, ADMIN.CONF, and change directive "DocumentRoot" from:
    DocumentRoot /opt/IBMHTTPD/admindocs/en_US
    to: DocumentRoot /opt/IBMHTTPD/admindocs/<Lang>

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be DocumentRoot /opt/IBMHTTPD/admindocs/Fr_FR.

  3. Change directive "Alias" from:
     
    Alias /admin /opt/IBMHTTPD/admindocs/en_US
    Alias /manual /opt/IBMHTTPD/htdocs/en_US/manual
    
    Alias /error /opt/IBMHTTPD/htdocs/en_US
    to:
    Alias /admin /opt/IBMHTTPD/admindocs/<Lang> Alias /manual /opt/IBMHTTPD/htdocs/<Lang>/manual Alias /error /opt/IBMHTTPD/htdocs/<Lang>

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be Alias /admin /opt/IBMHTTPD/admindocs/Fr_FR.

  4. Change directive "Include" from:
    Include conf/admin.msg.en_US
    to: Include "conf/admin.msg.<Lang>"

    Note: <Lang> is the language you wish to run the Administration Server. For example, Fr_FR would be Include conf/admin.msg.fr_FR.

  5. Edit IBM HTTP Server IKEYMAN Start Script, /usr/bin/ikeyman, and change first entry of "export IKMLANG=" from:
    export IKMLANG=en_US
    to: export IKMLANG=<Lang>

    Note: <Lang> is the language-specific directory. For example, Fr_FR would be export IKMLANG=Fr_FR.