SCO OpenServer Release 6.0.0

Russian Language Support

Release and Installation Notes

The Russian Language Support package enables Russian language in console (alphanumeric) and graphical (X-window) applications in SCO OpenServer Release 6.0.0.

Please read this document entirely. It contains information that you will need during and after installing the package.

1. Downloading and unpacking

The package is available to download free of charge from the OpenServer 6.0.0
download web page at:

http://www.sco.com/support/update/download/product.php?pfid=12&prid=20

direclty from:

http://www.sco.com/support/update/download/release.php?rid=181

and

ftp://ftp.sco.com/pub/openserver6/600/other/rls.6.0.0

Download the archive, copy it into server and unpack into temporary directory e.g. /tmp.

2. Before Installing

2.1. Supported releases

This package may be installed on the following operating system release:

SCO OpenServer Release 6.0.0 with Maintenance Pack 2 or later

To obtain the latest Maintenance Pack for OpenServer 6.0.0 please go to:

http://www.sco.com/support/update/download/product.php?pfid=12&prid=20

2.2. Internal charset

Decide which character set will be used internally as default on your system. Internal charset is the way Russian letters are stored in programs memory. If a program doesn't perform additional conversion then it's also the way Russian text is stored in files, transmitted over network etc.

The following Russian charsets are supported:

CP866 (IBM866 in the ScoAdmin International Settings Manager)

Cyrillic encoding used by MS-DOS operating system. (Called OEM by Microsoft.) Use this encoding if you plan to work with legacy data coming from MS-DOS era.

Synonyms: cp866, IBM866, 866.

CP1251 (WIN1251 in the ScoAdmin International Settings Manager)

Cyrillic encoding used by Windows operating system. (Called ANSI by Microsoft.) Use this encoding if you plan to work with data coming from/to Windows PCs.

Synonyms: cp1251, windows-1251, WIN1251, 1251.

KOI8-R

Cyrillic encoding used by Unix/Linux applications, also the standard for email in Russian language. Use this encoding if you plan to work only with Unix/Linux data.

Synonyms: koi8-r.

ISO8859-5

This encoding isn't used in Russia but you may encounter it in a program developed abroad.

2.3. Graphic environment

SCO OpenServer 6 comes with two graphical environments:

The OpenServer XDT3 Desktop (the default) provides limited Russian language support. It can be used for tasks like server administration. The Mozilla internet browser which is accessible from the XDT3 Desktop does support the Russian language.
KDE Desktop fully supports Russian language. You can run arbitrary Russian X-window applications within KDE.

Decide whether you need graphical environment and whether you are going to run Russian applications. In case of positive answers to both questions switch grahical environment to KDE.

3. Installation and Setup

Installation, setup and removal should be performed by root.

3.1. Installation

It is recommended that you install the latest version of KDE from SCO prior to installing the Russian Language supplement.
You can check availability of updated versions of KDE at:

http://www.sco.com/support/update/download/product.php?pfid=12&prid=20

Run the SCOAdmin Software Manager.
From the Software menu, select Install New.
Select the current host and press Continue.
Select Media Images and press Continue.
Enter the absolute pathname to the directory containing files from downloaded archive, e.g. /tmp. Press OK.
Press Install to start installation.
When installation is complete, press OK.
Exit Software Manager by selecting Host and then Exit.

3.2. Setup

It is recommended that you peform setup immediately after installation. You are free to do it later, or repeatedly to change settings.

Important

Simply installing the package without performing setup will only affect screen font loading but will not change language settings.

From SCO Admin, start the System Administrator and then System — International Settings Manager.
From menu Settings choose Codeset — Internal and pick an internal charset.
From menu Settings choose Codeset — Console and verify that the console charset is IBM866.
Specify Laguage: ru_RU.
Assign Keyboard: ps.ru_alt.rus to switch between Russian and English by Alt-Shift or ps.ru_ctr.rus to switch by Ctrl-Shift.
Save with File — Save. Press OK in responce to the message Please shutdown and reboot system to ensure changes take effect.
Reboot the system.

3.3. Changing graphical environment

To start using KDE graphical environment a user should create a file in the home directory named .xsession containg the following line:

/opt/kde/bin/startkde

(Alternatively, to make KDE the default desktop environment for all users on the system, edit the file /etc/default/X11 and change the value of XDESKTOP to "kde3".)

The first time KDE is run, the following regional settings should be entered: Country — Eastern Europe/Russia, Language — Russian. To switch keyboard input between Russian and Latin, press Ctrl-Shift.

3.4. Removal

Run the SCOAdmin Software Manager.
Select Russian Language Support in the Installed Software window. Make sure it is selected (highlighted and/or displayed with an asterisk). From the Software menu, select Remove.
When removal is complete, press OK.
Exit Software Manager by selecting Host and then Exit.

4. Usage Notes

4.1. General localization information

SCO OpenServer 6 includes programs from SCO OpenServer 5 and SCO UnixWare. They use different localization schemes: the former depend on /etc/default/lang while the latter depend on /etc/default/locale. Locale data files are also placed differently. The Russian Language Support package updates both localization systems.
SCO UnixWare Localization scheme assumes that environent variable LANG is set. Setup procedure modifies /etc/profile file to set up this variable in accordance with specified internal charset.

4.2. Alphanumeric console

Screen font is loaded by loadfont. Loading via vidi is also supported for compatibility with OpenServer 5.

4.3. Terminal input-output mapping

The alphanumeric console keyboard and screen use IBM866 charset. Translation from IBM866-encoded symbols entered from keyboard to internal charset and back from internal charset to screen encoding IBM866 is performed by mapchan. The setup procedure writes appropriate settings for virtual screens /dev/tty01 — /dev/tty15 into /etc/default/mapchan file.
If a remote terminal or terminal emulation program is used which uses charset IBM866 but doesn't automatically translate input and output, then use the the following command to set up input-output mapping:
```
mapchan -f /usr/lib/mapchan/internal_charset/cons.866
```
For KOI8-R terminals (xterm in particular):
```
mapchan -f /usr/lib/mapchan/internal_charset/xterm.KOI8-R
```
The KDE Konsole terminal calls mapchan automatically.

To disable mapchan, i.e., if the terminal program performs its own mapping:

mapchan -n

4.4. File conversion

Use the iconv utility to convert files from one encoding to another:

iconv -f from -t to file

Where from — original encoding, to — requested encoding.

Russian encodings supported:

cp866
cp1251
koi8-r
utf-8
iso8859-5

4.5. Printing

Normally, printer Russian fonts are CP866-encoded. Use iconv with appropriate arguments as a filter to translate from other charsets.

5. Testing

Run date command and check that day of the week and month are printed in Russian.
Run ls -la command and check that files timestamps are printed in Russian.
Start a text editor and enter arbitrary Russian text.
- Make sure that all symbols are entered and displayed on the screen exactly as they are marked on the keyboard.
- Check letters, digits, punctuation marks.
- Check CapsLock switch, symbol entry with pressed Shift and Alt.
- Check arrow keys and functional keys.
- Check switching between virtual screens with Ctrl-F1...F12.
Save file and close the editor.
Perform a circular translation of created file from one encoding to another. If for example your internal charset is set to CP866 then run the following commands:
```
iconv -f cp866 -t cp1251 file >file.cp1251
iconv -f cp1251 -t koi8-r file.cp1251 >file.koi8-r
iconv -f koi8-r -t cp866 file.koi8-r >file.cp866
```
Compare original and resulting files, there shoud be no differences:
```
diff file file.cp866
```

6. Files

6.1. Files supplied by the package

Core files:

/opt/K/SCO/Unix_RU/6.0.0Ni/usr/lib/lang/ru/RU/: language settings in OpenServer 5 format
/opt/K/SCO/Unix_RU/6.0.0Ni/usr/lib/locale/ru_RU.*/: language settings in UnixWare format
/opt/K/SCO/Unix_RU/6.0.0Ni/usr/lib/keyboard/ps.*.rus.Z: Russian keyboard layout
/opt/K/SCO/Unix_RU/6.0.0Ni/etc/fonts/cp866*: Russian screen fonts loaded by loadfont
/opt/K/SCO/Unix_RU/6.0.0Ni/usr/lib/vidi/: Russian screen fonts loaded by vidi
/opt/K/SCO/Unix_RU/6.0.0Ni/usr/lib/mapchan/: console mapping files

Base X client:

/opt/K/SCO/BaseX_RU/5.2.0Ni/usr/lib/X11/ru_RU.*/Codeset.Z: SCO desktop locale settings
/opt/K/SCO/BaseX_RU/5.2.0Ni/usr/share/fonts/URW-RU: Russian screen fonts

KDE:

/opt/K/SCO/KDE3RU/3.3.5/opt/kde332/share/apps/: Russian resources for KDE applications
/opt/K/SCO/KDE3RU/3.3.5/opt/kde332/share/doc/HTML/ru/: Russian manuals for KDE applications
/opt/K/SCO/KDE3RU/3.3.5/opt/kde332/share/locale/ru/LC_MESSAGES/: Russian messages for KDE applications

6.2. Files affected by the installation and setup

/etc/default/lang, /etc/default/locale: Russian locales added
/etc/default/codeset, /etc/default/mapchan, /etc/default/mapkey: Russian charsets added
/sbin/loadfont: loading Russian font in BDF format added
/etc/sysadm.d/isadmin/isadminGUI: Russian language support added to International Settings Manager
/etc/profile: LANG setting added, stty command call added