Understanding National Language Support: IBM HTTP Server

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.

Locating NLS documentation
Understanding options for configuration of languages for the IBM HTTP Server

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

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

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/HTTPServer/htdocs/<Lang>
HP operating system: /opt/HTTPServer/htdocs/<Lang>
Linux operating system: /opt/IBMHTTPServer/htdocs/<Lang>
Solaris operating system: /opt/IBMHTTPD/htdocs/<Lang>
Windows NT and Windows 2000 operating systems: c:\Program Files\IBM HTTP Server\htdocs\<Lang>

For the Administration Server, you can find documentation in the following directories:

AIX operating system: /usr/HTTPServer/admindocs/<Lang>
HP operating system: /opt/HTTPServer/admindocs/<Lang>
Linux operating system: /opt/IBMHTTPServer/admindocs/<Lang>
Solaris operating system: /opt/IBMHTTPD/admindocs/<Lang>
Windows NT and Windows 2000 operating systems: c:\Program Files\IBM HTTP Server\admindocs\<Lang>

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

Understanding options for configuration of languages for the IBM HTTP Server and the Administration Server

You can choose from two options to configure languages for the IBM HTTP Server and the Administration 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 both the IBM HTTP Server and the Administration Server.

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

AIX: /usr/HTTPServer/bin/setuplang
HP: /opt/HTTPServer/bin/setuplang
Linux: /opt/IBMHTTPServer/bin/setuplang
Solaris: /opt/IBMHTTPD/bin/setuplang

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

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

Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the directive, DocumentRoot from: DocumentRoot /usr/HTTPServer/htdocs/en_US to: DocumentRoot /usr/HTTPServer/htdocs/<Lang>
where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows:
```
DocumentRoot /usr/HTTPServer/htdocs/Fr_FR.
```
Edit the Administration Server configuration file, ADMIN.CONF, and change the directive, DocumentRoot from: DocumentRoot /usr/HTTPServer/admindocs/en_US to: DocumentRoot /usr/HTTPServer/admindocs/<Lang>
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
DocumentRoot /usr/HTTPServer/admindocs/Fr_FR
```

Change the 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>

where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:

Alias /admin  /usr/HTTPServer/admindocs/Fr_FR

Change the directive, Include, from: Include conf/admin.msg.en_US to: Include "conf/admin.msg.<Lang>"
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
Include conf/admin.msg.fr_FR
```
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 run the Administration Server in French, specify:
```
export IKMLANG=Fr_FR
```

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

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

Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the directive, DocumentRoot from: DocumentRoot /opt/HTTPServer/htdocs/en_US
to: DocumentRoot /opt/HTTPServer/htdocs/<Lang>
where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows:
```
DocumentRoot /opt/HTTPServer/htdocs/Fr_FR
```
Edit the Administration Server configuration file, ADMIN.CONF, to change the directive, DocumentRoot from: DocumentRoot /opt/HTTPServer/admindocs/en_US
to: DocumentRoot /opt/HTTPServer/admindocs/<Lang>
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
DocumentRoot /opt/HTTPServer/admindocs/Fr_FR
```

Change the 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>

where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:

Alias/admin/opt/HTTPServer/admindocs/Fr_FR

Change the directive, Include, from: Include conf/admin.msg.en_US to: Include "conf/admin.msg.<Lang>"
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
Include conf/admin.msg.fr_FR
```
.
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
```

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

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

Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the directive, DocumentRoot, from: DocumentRoot /opt/IBMHTTPServer/htdocs/en_US to: DocumentRoot /opt/IBMHTTPServer/htdocs/<Lang>
where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows: DocumentRoot /opt/IBMHTTPServer/htdocs/Fr_FR.
Edit the Administration Server configuration file, ADMIN.CONF, to change the directive, DocumentRoot, from: DocumentRoot /opt/IBMHTTPServer/admindocs/en_US to: DocumentRoot /opt/IBMHTTPServer/admindocs/<Lang>
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
DocumentRoot /opt/IBMHTTPServer/admindocs/Fr_FR
```

Change the 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:

Alias /admin/opt/IBMHTTPServer/admindocs/<Lang>
Alias /manual/opt/IBMHTTPServer/htdocs/<Lang>/manual
Alias /error/opt/IBMHTTPServer/htdocs/<Lang>

where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:

Alias/ admin/opt/IBMHTTPServer/admindocs/Fr_FR

Change the directive, Include, from: Include conf/admin.msg.en_US to: Include "conf/admin.msg.<Lang>"
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
include conf/admin.msg.fr_FR
```
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
```

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

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

Edit the IBM HTTP Server configuration file, HTTPD.CONF, and change the directive, DocumentRoot, from: DocumentRoot /opt/IBMHTTPD/htdocs/en_US to: DocumentRoot /opt/IBMHTTPD/htdocs/<Lang>
where: <Lang> represents the language-specific directory. For example, the representation of the French directory follows:
```
DocumentRoot /opt/IBMHTTPD/htdocs/Fr_FR
```
Edit the Administration Server configuration file, ADMIN.CONF, and change the directive, DocumentRoot, from: DocumentRoot /opt/IBMHTTPD/admindocs/en_US to: DocumentRoot /opt/IBMHTTPD/admindocs/<Lang>
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
DocumentRoot /opt/IBMHTTPD/admindocs/Fr_FR
```

Change the 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>

where: <Lang> represents the language in which to run the Administration Server. For example, the representation of the French directory follows:

Alias /admin /opt/IBMHTTPD/admindocs/Fr_FR

Change the directive, Include, from: Include conf/admin.msg.en_US to: Include "conf/admin.msg.<Lang>"
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
Include conf/admin.msg.fr_FR
```
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
```

Manually editing IBM HTTP Server and Administration Server configuration files on the Windows NT and Windows 2000 operating systems

To manually edit the IBM HTTP Server and the Administration Server configuration files on the Windows NT and Windows 2000 operating systems:

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"
```
Edit the Administration Server configuration file, ADMIN.CONF, and change the DocumentRoot directive from:
```
DocumentRoot "C:\Program Files\IBM HTTP Server\admindocs\en_US"
```
to:
```
DocumentRoot "C:\Program Files\IBM HTTP Server\admindocs\<Lang>"
```
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
DocumentRoot "C:\Program Files\IBM HTTP Server\admindocs\Fr_FR"
```

Change the Alias directive from:

Alias /admin "C:\Program Files\IBM HTTP Server\admindocs\en_US"
Alias /manual "C:\Program Files\IBM HTTP Server\htdocs\en_US\manual"
Alias /error "C:\Program Files\IBM HTTP Server\htdocs\en_US"

to:

Alias /admin "C:\Program Files\IBM HTTP Server\admindocs\<Lang>"
Alias /manual "C:\Program Files\IBM HTTP Server\htdocs\<Lang>\manual"
Alias /error "C:\Program Files\IBM HTTP Server\htdocs\<Lang>"

where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:

Alias /admin  "C:\Program Files\IBM HTTP Server\admindocs\Fr_FR"

Change the Include directive from:
```
Include conf/admin.msg.en_US
```
to:
```
Include "conf/admin.msg.<Lang>"
```
where: <Lang> represents the language in which to run the Administration Server. For example, to run the Administration Server in French, specify:
```
Include "conf/admin.msg.fr_FR"
```

Finding related information

     (Back to the top)