SCO OpenServer Release 6.0.0 Russian Language Support Release and Installation Notes ------------------------------------------------------------------------ Table of Contents 1. Downloading and unpacking 2. Before Installing 2.1. Supported releases 2.2. Internal charset 2.3. Graphic environment 3. Installation and Setup 3.1. Installation 3.2. Setup 3.3. Changing graphical environment 3.4. Removal 4. Usage Notes 4.1. General localization information 4.2. Alphanumeric console 4.3. Terminal input-output mapping 4.4. File conversion 4.5. Printing 5. Testing 6. Files 6.1. Files supplied by the package 6.2. Files affected by the installation and setup 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 directly 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: 1. 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. 2. 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 1. Run the SCOAdmin Software Manager. 2. From the Software menu, select Install New. 3. Select the current host and press Continue. 4. Select Media Images and press Continue. 5. Enter the absolute pathname to the directory containing files from downloaded archive, e.g. /tmp. Press OK. 6. Press Install to start installation. 7. When installation is complete, press OK. 8. 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. 1. From SCO Admin, start the System Administrator and then System -> International Settings Manager. 2. From menu Settings choose Codeset -> Internal and pick an internal charset. 3. From menu Settings choose Codeset -> Console and verify that the console charset is IBM866. 4. Specify Laguage: ru_RU. 5. 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. 6. Save with File -> Save. Press OK in responce to the message Please shutdown and reboot system to ensure changes take effect. 7. 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 1. Run the SCOAdmin Software Manager. 2. 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. 3. When removal is complete, press OK. 4. 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" is the original encoding and "to" is 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 1. Run date command and check that day of the week and month are printed in Russian. 2. Run ls -la command and check that files timestamps are printed in Russian. 3. 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. 4. Save file and close the editor. 5. 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 6. 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