2    Worldwide Language Support Installation Procedures

This chapter contains the following information:

2.1    Worldwide Language Support Overview

The WLS software subsets provide support for many languages and countries other than United States English, which is installed by default. Installing WLS software subsets enables software developers to develop internationalized software that can be used in different countries and lets users work in their native languages.

You can install software to support one or more languages during a Full Installation as documented in the Installation Guide. But, you also can add language support after the base operating system is installed by using the procedures described in this chapter.

WLS software is installed in the /usr/i18n directory, which can be created as its own file system or can be created as a symbolic link to another file system. If a /usr/i18n directory or file system does not already exist, you are prompted to create it if you use the wwinstall command to install WLS. The abbreviation for internationalization is i18n.

For more information about the terminals and printers supported for different languages, refer to the Software Product Description (SPD). The SPD is on the CD-ROM labeled Operating System Volume 1, and various printable formats of the SPD are located in the /DOCUMENTATION directory.

2.2    Step 1: Preparing for a WLS Installation

Perform the following tasks before you start a WLS installation:

  1. Read the preinstallation tasks section of the Installation Guide, which describes the general preparation you should do before any installation.

  2. Make sure that the current version of the base operating system is already installed on your system.

  3. Refer to the WLS software subset descriptions in the Installation Guide for any dependency WLS subsets may have on operating system software subsets. If a WLS subset depends on an operating system subset that is not installed on your system, use the setld command to install the operating system subset before beginning the WLS installation.

  4. If you are installing the WLS software subsets from a RIS server, ensure that your system is registered as a client on the RIS server. The RIS area to which your system is registered must contain the WLS product.

    If you are a network or RIS administrator and need more information about how to set up a RIS server and RIS client, refer to the guide to Sharing Software on a Local Area Network.

2.3    Optional Step: Increasing Available Disk Space for WLS Software

The WLS installation procedure loads most WLS files to the subdirectories under the /usr/i18n directory. If the /usr/i18n directory does not exist, the installation procedure creates it. During the software selection process, all WLS software subsets are considered during /usr file system size calculations. If the /usr/i18n directory exists, the installation procedure uses it.

If you find that there is insufficient disk space for the WLS software subsets, and you know that you have additional space on other disks or disk partitions on your system, follow the procedures to increase disk space shown in Section 2.3.1 or Section 2.3.2 depending upon the file system type.

2.3.1    Increasing Disk Space in UFS File Systems

Before beginning the installation procedure, follow these steps to increase disk space for the /usr/i18n directory in a the UNIX file system (UFS):

  1. Log in as root or use the su command to become superuser.

  2. Create the /usr/i18n directory if it does not exist: 

    # mkdir /usr/i18n

  3. Add a line similar to the following to the /etc/fstab file so that the newly created directory is a mount point to a disk partition where there is additional space: 

    /dev/disk/dsk2c   /usr/i18n   ufs,rw 0 0

  4. Mount the new mount point of /usr/i18n: 

    # mount -a

2.3.2    Increasing Disk Space in AdvFS File Systems

Before beginning the installation procedure, follow these steps to create an AdvFS file domain for the /usr/i18n directory:

  1. Log in as root or use the su command to become superuser.

  2. Create a /usr/i18n directory if it does not exist: 

    # mkdir /usr/i18n

  3. Create an AdvFS domain using the following command syntax

    mkfdmn /dev/disk/dsk<disk_number>c domain_name

    For example, create the i18n_domain domain on dsk2: 

    # mkfdmn /dev/disk/dsk2c i18n_domain

  4. Create an AdvFS filetset: 

    
# mkfset i18n_domain i18n

  5. Use a text editor of your choice to add the following line to the /etc/fstab file so that the newly created domain can be mounted: 

    i18n_domain#i18n      /usr/i18n        advfs   rw, 0 0

  6. Mount the new file domain: 

    
# mount -t advfs i18n_domain#i18n /usr/i18n

2.4    Step 2: Starting a WLS Installation

Starting a WLS installation differs slightly depending upon the source of the distribution media:

During the installation procedure, you are asked some questions about configuring the system. If you need help, enter a question mark ( ? ) to display online help.

2.4.1    Installing from a CD-ROM

Use this procedure to invoke the wwinstall script from CD-ROM:

  1. Load the Associated Products Volume 1 CD-ROM into the CD-ROM drive.

  2. Make a directory to be the mount point of the CD-ROM, and then mount the CD-ROM: 

    # mkdir /cdrom
# mount /dev/disk/cdrom0c /cdrom
# cd /cdrom/Worldwide_Language_Support/kit

    In the previous example, /dev/disk/cdrom0c is the name of the CD-ROM device. If you do not know the device name of your CD-ROM device, enter the following command: 

    
# ls /dev/disk/cdrom*c
 

  3. Invoke the wwinstall script: 

    
# ./wwinstall

Go to Section 2.5 to continue the WLS installation procedure.

2.4.2    Installing from a RIS Server

This section describes how to use the setld utility to install the WLS software subsets from a RIS server. If you want to use the wwinstall command instead, you use a Network File System (NFS) mount to mount the exported RIS area. You than can run wwinstall from the mounted RIS area (this procedure is not documented).

Use this procedure to start a WLS installation from a RIS server:

  1. If the network is not configured on the system you want to install, use the Quick Setup application to set up basic networking services. Quick Setup is available from the System Setup application: 

    
# /usr/sbin/checklist

  2. Check with the RIS server administrator to make sure your system is registered as a client of the server that is serving the current version of the WLS software.

  3. Start the WLS installation process: 

    # setld -l ris_server_name:

    Replace ris_server_name with the name of your RIS server appended with a colon ( : ). Go to Section 2.5 to continue the WLS installation procedure.

2.5    Step 3: User Responses During the WLS Installation Process

The prompts displayed during the WLS installation apply to systems where all the prerequisite base operating system software subsets are installed. The installation screens are similar for installations regardless of whether you are using CD-ROM or RIS. However, if you used the setld utility to install from a RIS server, you do not have the option to create a symbolic link to another partition to hold the WLS software.

The wwinstall script calculates the disk space available in the /usr/i18n area and gives you the opportunity to choose how to create the /usr/i18n area. The amount of disk space required in /usr/i18n depends on the country or language you select. For example, installing support for the Japanese language requires more disk space (about 200 MB) than installing support for the Italian language (about 20 MB). Refer to the Release Notes for the disk space requirements for each language.

If you are installing from CD-ROM or ran the wwinstall command to install WLS from a RIS server, a message similar to the following is displayed: 

Most of the subsets will be installed under the /usr/i18n directory.
Depending on the number of subsets you choose to install, you may
need more than 200 MB of free disk space for installation.
 
You have the following amount of free disk space
available in /usr:
 
$ df -k /usr/i18n
Filesystem     1024-blocks        Used   Available Capacity  Mounted on
usr_domain#usr      716800      238120      456512    35%    /usr
 
Two ways to set up the /usr/i18n directory :
 
[1] Create the /usr/i18n directory
[2] Set up a symbolic link to another partition that has enough
    free disk space for installation
 
Which way do you want ? [1] :

Do one of the following:

The installation script lists the countries and languages that are available to install: 

*********************************************************************
*                                                                   *
*  Tru64 UNIX WORLDWIDE LANGUAGE SUPPORT INSTALLATION PROCEDURE     *
*                                                                   *
*********************************************************************
 
Please select the countries for which you want to install support subsets:
 
   1) Belgium (French)                   2) Canada (French)
   3) China (Hong Kong)                  4) China (Simplified Chinese)
   5) China (Taiwan)                     6) Czech Republic
   7) Euro (Latin-9 & Unicode)           8) France
   9) Germany                           10) Greece
  11) Hungary                           12) Israel
  13) Italy                             14) Japan
  15) Korea                             16) Lithuania
  17) Poland                            18) Russia
  19) Slovakia                          20) Slovenia
  21) Spain (Catalan)                   22) Spain (Spanish)
  23) Sweden                            24) Switzerland (French)
  25) Switzerland (German)              26) Thailand
  27) Turkey
 
  28) All of the above
  29) None of the above
 
Choices (for example, 1 2 3) :

If you enter more than one number at the prompt, separate each number with a space. After making your selections, a message similar to the following is displayed: 

You are installing localized software for the following countries:
 
<list of countries>
 
Is this correct? [n]

To respond to the question:

Depending upon the countries you selected, the following questions may be asked:

Section 2.5.1 describes the WLS software selection process; Section 2.5.2 describes the WLS software load process; and Section 2.5.3 describes the WLS software configuration process.

2.5.1    Selecting Worldwide Software Subsets

Next, a menu of available software subsets is displayed. The menu first shows a list of mandatory software subsets for the country or language you selected. These software subsets will be loaded automatically. The installation procedure then displays a list of optional software subsets that you can install depending on which countries you have selected. If you specify more than one number at the prompt, separate each number with a space or a comma. Separate a range of numbers with a hyphen ( - ).

The following example shows the optional software that is available when Japan is chosen. The software subset list is similar to the following: 

*** Enter subset selections ***
 
The following subsets are mandatory and will be installed automatically
unless you choose to exit without installing any subsets:
 
      * Japanese Standard Kernel Modules
      * Japanese CDE Mail Interface
      * Japanese Base System
      * Japanese Base System Management Applications and Utilities
      * Japanese Graphical Base System Management Utilities
      * Japanese Graphical System Administration Utilities
      * Japanese Basic X Environment
      * Japanese CDE Desktop Environment
      * Japanese CDE Minimum Runtime Environment
      * Japanese DECwindows 100dpi Fonts
      * Japanese DECwindows 75dpi Fonts
      * Japanese DECwindows Fonts
      * Japanese Netscape Communicator V4.7
 
The subsets listed below are optional:
 
     There may be more optional subsets than can be presented on a single
     screen. If this is the case, you can choose subsets screen by screen
     or all at once on the last screen. All of the choices you make will
     be collected for your confirmation before any subsets are installed.
 
 - Japanese Support - General Applications :
     1) Additional Japanese Software
 
--- MORE TO FOLLOW ---Enter your choices or press RETURN to display the next screen.
 
Estimated free diskspace(MB) in root:53.1 usr:346.7
 
Choices (for example, 1 2 4-6):
 
     2) Japanese DOS tools
     3) Wnn Input Method
 
 - Japanese Support - Reference Pages :
     4) Japanese Ref. Pages for Additional Software
     5) Japanese Reference Pages
     6) Japanese Windows Reference Pages
 
 - Japanese Support - Software Development :
     7) Japanese CDE Software Development
     8) Japanese Ladebug Debugger Version 4.0
     9) Japanese Software Development
    10) Japanese Software Development Desktop Environment
    11) Japanese X Window Software Development
    12) Wnn Software Development
 
 - Japanese Support - System Administration :
    13) Japanese Advanced File System Graphical User Interface
    14) Japanese Logical Storage Manager GUI
 
 - Japanese Support - Windowing Environment :
    15) Japanese (SJIS) CDE Online Help
    16) Japanese CDE Online Help
    17) Japanese DECwindows Additional 100dpi Fonts
    18) Japanese DECwindows Additional 75dpi Fonts
 
 - Japanese Support - Windows Applications :
    19) Japanese Additional DECwindows Applications
    20) Japanese CDE Additional Applications
 
 - Worldwide Language Support - General Applications :
    21) Worldwide MULE
 
 
 - Worldwide Language Support - Obsolete Components :
    22) Worldwide Obsolete Commands and Utilities
 
 
 - Worldwide Language Support - Operating System :
    23) Worldwide European Unicode Locales
 
    24) Worldwide Phrase Input Support
 
    25) Worldwide User Defined Character Support
 
 - Worldwide Language Support - Software Development :
    26) Worldwide SVE MNLS Migration Tools
    27) Worldwide Software Development
    28) Worldwide X Window Software Development
 
 - Worldwide Language Support - Windowing Environment :
    29) Worldwide Composite Unicode Fonts
    30) Worldwide DECwindows Additional Fonts
    31) Worldwide Two-Byte Outline Font Renderer
    32) Worldwide User Defined Character Workstation Service
    33) Worldwide X/Motif 1.1
 
--- MORE TO FOLLOW ---Add to your choices or press RETURN to display the next screen.
 
Estimated free diskspace(MB) in root:53.1 usr:337.0
 
Choices (for example, 1 2 4-6):  3
 
The following choices override your previous selections:
 
    34) ALL mandatory and all optional subsets
    35) MANDATORY subsets only
    36) CANCEL selections and redisplay menus
    37) EXIT without installing any subsets
 
Estimated free diskspace(MB) in root:53.1 usr:337.0
 
Add to your choices, choose an overriding action or
press RETURN to confirm previous selections.
 
Choices (for example, 1 2 4-6):  3
 

You have a chance to verify your choices as shown in the following example: 

You are installing the following mandatory subsets:
 
        Japanese Standard Kernel Modules
        Japanese CDE Mail Interface
        Japanese Base System
        Japanese Base System Management Applications and Utilities
        Japanese Graphical Base System Management Utilities
        Japanese Graphical System Administration Utilities
        Japanese Basic X Environment
        Japanese CDE Desktop Environment
        Japanese CDE Minimum Runtime Environment
        Japanese DECwindows 100dpi Fonts
        Japanese DECwindows 75dpi Fonts
        Japanese DECwindows Fonts
        Japanese Netscape Communicator V4.7
 
You are installing the following optional subsets:
 
 - Japanese Support - General Applications :
        Wnn Input Method
 
Estimated free diskspace(MB) in root:53.1 usr:337.0
 
Is this correct? (y/n): y

Enter n if you want to begin the software subset selection again. Enter y if the list is correct.

Section 2.5.2 describes the WLS software load process.

2.5.2    Loading Worldwide Software Subsets

The installation process checks to make sure there is enough disk space to load the selected subsets. A message similar to the following is displayed: 

Checking file system space required to install selected subsets:
        Working....Wed Jan 13 13:50:50 EST 1999
 
File system space checked OK.

If there is not enough disk space to hold all the software subsets you selected, go back and select fewer optional software subsets.

Next, the installation process installs the software subsets on your system. Messages similar to the following are displayed: 

14 subsets will be installed.
 
Loading subset 1 of 14 ...
 
Japanese Base System
   Copying from system9 (inet)
        Working....Fri Apr 28 13:49:58 EST 2000
   Verifying
 
Loading subset 2 of 14 ...
 
Wnn Input Method
   Copying from system9 (inet)
        Working....Fri Apr 28 13:50:30 EST 2000
   Verifying
 
Loading subset 3 of 14 ...
 
Japanese Basic X Environment
   Copying from system9 (inet)
   Verifying

.
.
.
Loading subset 12 of 14 ...
 
Japanese Base System Management Applications and Utilities
   Copying from system9 (inet)
   Verifying
 
Loading subset 13 of 14 ...
 
Japanese CDE Mail Interface
   Copying from system9 (inet)
   Verifying
 
Loading subset 14 of 14 ...
 
Japanese Standard Kernel Modules
   Copying from system9 (inet)
   Verifying
 
14 of 14 subsets installed successfully.

Section 2.5.3 describes the WLS software configuration process.

2.5.3    Configuring Worldwide Software Subsets

Subset configuration occurs next, which is the process of tailoring the operating system software for use. Review the screen output carefully; depending upon the software subsets you installed, you may be instructed to run setup scripts. If you performed the installation from CD-ROM, after the installation is complete, review the log file, /var/adm/smlogs/wwinstall.log file for a record of the installation. A log file is not created during RIS installations. 

Configuring "Japanese Base System" (IOSJPBASE505)
Configuring "Wnn Input Method" (IOSJPWNN505)
Configuring "Japanese Basic X Environment" (IOSJPX11505)

.
.
.
Configuring "Japanese CDE Mail Interface" (IOSJPCDEMAIL505)
Configuring "Japanese Standard Kernel Modules" (IOSJPBIN505)

Section 2.5.4 describes the kernel build process.

2.5.4    Building the Kernel

If necessary, a kernel build begins automatically after software subset configuration.

Note

If you performed a dataless installation, the kernel build does not happen automatically. Follow the instructions in Section 2.6 to build the kernel.

The messages displayed by the kernel build are similar to the following. Please read this information carefully because it may require user action to restart the X Server to include the language option on the first login screen: 

    *********************************************************************
    *                                                                   *
    *     Reconfiguring kernel to incorporate Asian/Thai tty drivers    *
    *                                                                   *
    *********************************************************************
 
 **** Adding Worldwide Support tty Features into Kernel Configuration File ****
Loading I18N tty kernel modules ... done
 
The installation software has completed the installation process.
The log file /var/adm/smlogs/wwinstall.log contains a record of
your installation.
 
Total installation time = 17 minutes 36 seconds.
 
You may want to invoke /usr/sbin/i18nconfig to do I18N configuration later on.
 
For terminal session that is not running on the X Server of the host
machine, please restart the X Server using the following command in
order for the new languages to show up in the language option menu of
the login screen.
 
      # /sbin/init.d/xlogin restart
 
If your active terminal session is on the X Server that is being
restarted, you would have to issue the following command to stop the
X Server first.
 
     # /sbin/init.d/xlogin stop
 
Then you should log into the console terminal and issue the following
command to start the X Server.
 
     # /sbin/init.d/xlogin start
 
A reboot of the operating system will also achieve the same effect.

If the kernel build fails, check the log file at /var/adm/smlogs/it.log for information to diagnose the problem.

2.6    Optional Step: Building an Asian Kernel After the Installation

If you installed support software subsets for Japan, China, Hong Kong, Korea, Taiwan, or Thailand, the worldwide installation process builds a kernel with all the installed Asian or Thai terminal supports. Afterwards, you reboot the system with the new kernel to enable Asian or Thai terminal support in the kernel.

If you want to enable or disable some of the Asian or Thai terminal supports from the kernel, Section 2.6.1 describes the procedure to rebuild an Asian kernel.

2.6.1    Reconfiguring the Kernel to Support the Asian Terminal Driver and Daemons

To reconfigure the kernel to support the Asian terminal driver and daemons, invoke the wwconfig script with the -a option: 


# /usr/sbin/wwconfig -a

Refer to the wwconfig(8) reference page for more information.

If you installed IOSWWBIN505 and installed at least one of the following subsets: IOSWWUDCOS505 (on-demand font loading), IOSWWPHRASE505 (software input method), or IOSJPBASE505 (kana-kanji conversion), a UTX configuration selection table similar to the following is displayed. UTX is the mechanism to support communication between the Asian terminal driver and daemons. 

*** UTX  CONFIGURATION SELECTION ***
 
    Selection   Asian service Daemon
-------------------------------------------------------        1       On Demand Font Loading (odld)
        2       Software Input Method  (simd)
        3       Kana-Kanji Conversion  (kkcd)
        4       All of the above
        5       None of the above
-------------------------------------------------------Enter the selection number for each daemon you want.
For example, 1 2 :

After you make your selection, the daemons are displayed for your confirmation. If you choose 4 (All of the above), the following confirmation message is displayed: 

You specified the following daemons:
 
	   On Demand Font Loading (odld)
	   Software Input Method  (simd)
	   Kana-Kanji Conversion  (kkcd)
 
Is this correct? (y/n) [n]:

Enter y if the list includes the daemons you want to set up.

The installation procedure then asks how many UTX devices you want to create. 

How many UTX devices do you want to create? [default: 32] :

The number you enter is saved in the /var/i18n/sys/stanza.loadable file. The actual creation of the UTX devices occurs when you reboot your system.

There is one utxd master daemon that uses one UTX device. Each invocation of one of the odld, simd, and kkcd daemons uses one UTX device. Each user who turns on odld on a database not already served by another odld starts a new odld process. Refer to the stty(1) and cedit(1) reference pages for more information. Each user session that has the Software Phrase Input Method turned on requires one simd. Each user who turns on Kana-Kanji Conversion on a database (refer to stty(1) for more information) not already served by another kkcd starts a new kkcd process. For example, a system needs 31 UTX devices to support all three services for each of 10 users.

If you installed the IOSZHBIG5505, IOSZHTELEX505, and IOSZHCONV505 software subsets, the following menu is displayed: 

*** ADDITIONAL TERMINAL CODESETS SELECTION ***
 
    Selection   Terminal Codeset
-------------------------------------------------------------        1       BIG-5
        2       Telecode
        3       Traditional & Simplified Chinese Conversion
        4       All of the above
        5       None of the above
-------------------------------------------------------------Enter the selection number for each codeset you want.
For example, 1 2 :

Selecting a terminal codeset at this prompt means that you want to build support for that terminal codeset into the terminal driver. When codeset support is built into the terminal driver, users can select that codeset as their terminal code by using the /usr/i18n/bin/stty command.

Choose 3 if you want to support the proper codeset conversion when the terminal code is set to a Simplified Chinese codeset and the application code is set to a Traditional Chinese codeset. The reverse is also true.

If only two out of the three software subsets are installed, the selection menu is displayed but the missing component is not in the list.

If you installed just one of the software subsets, a question is asked instead. As shown in the following example, if you installed the IOSTHBIN505 software subset, the procedure asks if you want to add the Thai terminal driver to the kernel: 

Do you want to install the Thai tty driver? (y/n) [y] :

The Thai terminal driver supports Thai terminal input/output (I/O). The other Asian languages are supported by the Asian terminal driver. If you have installed only the IOSTHBIN505 software subset and not the IOSWWBIN505 software subset, the previous question is the only question asked.

The installation procedure then asks if you want to rebuild the kernel. 

If you wish, you may use an automated kernel build procedure by
answering 'y' to the next question.
 
You will need about 10 MB available in the /sys file system
for the kernel build.  If you do not have this much space,
do not choose an automated build.
 
You have the following amount of free disk space available:
 
df -k /sys
Filesystem   kbytes      used     avail capacity  Mounted on
/dev/disk/dsk3g    825507    670890     72066    90%    /ufs/dsk3g
Do you want this procedure to rebuild your kernel? (y/n):

If you enter y, the kernel build starts, and messages similar to the following are displayed: 

Starting kernel rebuild...
 
*** KERNEL CONFIGURATION AND BUILD PROCEDURE ***
 
Saving /sys/conf/SYSTEM9 as /sys/conf/SYSTEM9.bck
 
Do you want to edit the configuration file? (y/n) [n]: n
 
 
*** PERFORMING KERNEL BUILD ***
       Working....Fri Apr 28 13:54:25 EST 2000
       Working....Fri Apr 28 13:56:25 EST 2000
       Working....Fri Apr 28 13:58:25 EST 2000
 
The new kernel is /sys/SYSTEM9/vmunix
 
Saving /vmunix as /vmunix.IOS505.3
Copying /sys/SYSTEM9/vmunix to /vmunix

In the previous example, SYSTEM9 is the system name.

Note

You can invoke wwconfig with the -s flag to build a statically linked kernel. In that case, the output from the wwconfig command is different from what is shown in this section.

Whenever you want to enable or disable some of the terminal options, you must reconfigure and rebuild the kernel using the following command: 

# /usr/sbin/wwconfig -a

2.7    Backup Files Created by the WLS Installation

During the installation of worldwide support software subsets, some backup files are created to save the contents of the original files that are replaced by the installation procedure. Table 2-1 lists the files replaced by the installation procedure.

The backup files have either the extension .IOS505_sav.* where the asterisk ( * ) is an integer, or have the extension .IOS505_sav (without the integer).

Table 2-1:  Backup Files Created by WLS Installations

Files Saved withExtension File Name
<file>.IOS505_sav.* /vmunix
.<file>.IOS505_sav /usr/bin/X11/dxkeycaps

Backup files with extension IOS505_sav are data or binary files that are not likely to be modified by the system manager. They are restored to the original files when worldwide support software subsets are removed.

Caution

Do not delete files with the IOS505_sav extension. If you delete these files, the corresponding data and binary files cannot be restored during the removal of WLS software.

Data files that might be modified by the system managers, depending on the system configuration, have the extension .IOS505_sav.* as their backup. You can delete files with the extension .IOS505_sav.* to save space. These files are not restored to the originals during subset removal.

2.8    Step 5: Setting Environment Variables

When one language (excluding Euro Latin-9 & Unicode) is installed from the WLS kit for the first time, the CDE desktop starts up in that language by default. However, if more than one language is selected for the first time, the CDE desktop remains in English. If the CDE desktop has been switched to another language, installing more languages at a later time will not affect the default CDE language.

You can reset the default CDE language to English by using the following command: 

# rm -f /etc/dt/config/Xconfig

If you installed support for more than one language, you set the locale by defining the LANG or LC_ALL environment variables.

To set the language for the common desktop environment (CDE) from the CDE login window each time you log in, click on Options, click on Language, and select the language you want to run.

Refer to the locale(1), i18n_intro(5), l10n_intro(5), and to the reference pages for individual languages (such as spanish(5), italian(5), japanese(5), hebrew(5) and so on) for more information about working in an internationalized environment.