Creating Locale Realms in Web Access ------------------------------------ Web Access allows you to display email and calendars in different character sets and languages. To set up a URL for each language and character set combination, known as a locale, follow the procedures below. Web Access should already be installed and running properly before you begin this procedure. You will need root access to the machine on which Web Access is running. You also may need to change permissions on some files and directories in order to edit them. 1. In a shell window, change to the following directory: # cd /opt/SUNWwa/public_html/WebAccess Note: /opt/SUNWwa/public_html/WebAccess is the default install directory. If you have installed Web Access in another directory, substitute that path in all instructions. 2. Create one subdirectory for each locale your organization wishes to support. See Table 1, column 3 for the specific names. # mkdir ... 3. Make an "images" subdirectory in each locale directory, and in that directory make a symbolic link to the corresponding English "images" directory called "selector". # cd <2-letter-localename1> # mkdir images # cd images # ln -s ../../en/images/selector # cd ../../<2-letter-localename2> # mkdir images # cd images # ln -s ../../en/images/selector Note: The link needs to be in the "images" subdirectory of a directory with a 2-letter language id (Table 1, column 5) for its name. If you have a locale directory with a name which includes the 2-letter country id (Table 1, column 6) there is no need to add this link. Make sure that there is a corresponding 2-letter language id named directory for those locales with longer names. This ensures that the Calendar icon will function properly. 4. Copy the base index.html file into each subdirectory. # cd /opt/SUNWwa/public_html/WebAccess # cp -p index.html /. # cp -p index.html /. ... 5. Edit the index.html file in each locale directory to change the realm name. You will be adding an underscore, "_", and then the locale realm name from Table 1, column 4. # cd # vi index.html Note: Use the plain text editor you prefer. You are now editing index.html. On the line which reads: change "realm=Sims" to "realm=Sims_". # cd ../ # vi index.html You are now editing index.html. On the line which reads: change "realm=Sims" to "realm=Sims_". ... 6. Create a realm properties file for each locale. First, change to the Web Access properties directory. # cd /opt/SUNWwa/properties 7. Next, copy the existing realm.Sims.properties file to a new file with the locale realm appended to "Sims". See Table 1, column 4 for the specific names. # cp -p realm.Sims.properties realm.Sims_.properties # cp -p realm.Sims.properties realm.Sims_.properties ... 8. Edit realm.Sims_.properties. See Table 1 to determine the values for each locale. Change the locale property value from "en" to the 2-letter language identifier for the locale (column 5). Change the country property value from "US" to the 2-letter country identifier (column 6). If there is a variant listed for the locale you are configuring, add a property called "variant" and give it the value specified in Table 1, column 7. Editing realm.Sims_.properties: locale=<2-letter-language-id-1> country=<2-letter-country-id-1> Editing realm.Sims_.properties: locale=<2-letter-language-id-2> country=<2-letter-country-id-2> variant= ... 9. Stop and restart Web Access # /etc/rc3.d/K89webaccess stop # /etc/rc3.d/K89webaccess start 10. Inform your customers of the proper URL. The Web Access login URL for each locale is: http://your_WebAccess_server_name:8080/WebAccess/ Example Scenario ---------------- Web Access customer AcmeISP needs to support Japanese, French and Russian customers on UNIX, Windows, and Macintosh. The AcmeISP Web server administrator has installed Web Access, started it, and verified that it is working. Leaving Web Access running so that customers can continue to access it, the admin performs the following tasks: webaccesservername%su root Password: Step 1 # cd /opt/SUNWwa/public_html/WebAccess Step 2 # mkdir ja ja_JP.PCK fr ru Step 3 # cd ja # mkdir images # cd images # ln -s ../../en/images/selector # cd ../../fr # mkdir images # cd images # ln -s ../../en/images/selector # cd ../../ru # mkdir images # cd images # ln -s ../../en/images/selector Step 4 # cd /opt/SUNWwa/public_html/WebAccess # cp -p index.html ja/. # cp -p index.html ja_JP.PCK/. # cp -p index.html fr/. # cp -p index.html ru/. Step 5 Editing /opt/SUNWwa/public_html/WebAccess/ja/index.html realm=Sims_ja Editing /opt/SUNWwa/public_html/WebAccess/ja_JP.PCK/index.html realm=Sims_ja_JP_PCK Editing /opt/SUNWwa/public_html/WebAccess/fr/index.html realm=Sims_fr Editing /opt/SUNWwa/public_html/WebAccess/ru/index.html realm=Sims_ru Step 6 # cd /opt/SUNWwa/properties Step 7 # cp -p realm.Sims.properties realm.Sims_ja.properties # cp -p realm.Sims.properties realm.Sims_ja_JP_PCK.properties # cp -p realm.Sims.properties realm.Sims_fr.properties # cp -p realm.Sims.properties realm.Sims_ru.properties Step 8 Editing realm.Sims_ja.properties: locale=ja country=JP Editing realm.Sims_ja_JP_PCK.properties: locale=ja country=JP variant=PCK Editing realm.Sims_fr.properties: locale=fr country=FR Editing realm.Sims_ru.properties: locale=ru country=RU Step 9 # /etc/rc3.d/K89webaccess stop # /etc/rc3.d/K89webaccess start Step 10 Customers of AcmeISP are given the following instructions: AcmeISP Japanese UNIX customers, please log into: http://www.acmeisp.com:8080/WebAccess/ja/ AcmeISP Japanese Windows customers, please log into: http://www.acmeisp.com:8080/WebAccess/ja_JP.PCK/ All AcmeISP French customers, please log into: http://www.acmeisp.com:8080/WebAccess/fr/ All AcmeISP Russian customers, please log into: http://www.acmeisp.com:8080/WebAccess/ru/ Notes ----- A. Web Access constructs the realm properties file name by appending the realm name in index.html to "realm." and then appending ".properties". So the center portion of the realm properties file name must be an exact match to the realm name in index.html. B. The user interface for these locale customers is still in English, but their data will be handled according to their locale. That is, they will be able to send new mail messages and make new entries into their calendars in their language, but the menus, buttons, and help files are still in English. C. While you may name the locale directories whatever you determine is best for providing a URL, the 2-letter language directories must still be created with an "images" subdirectory linked back to the English "selector" subdirectory. Otherwise, the Calendar icon will not work. PLEASE WIDEN YOUR SCREEN TO VIEW ALL 7 COLUMNS OF THE TABLE. Table 1 - Languages and their associated locale names Language platform locale name locale realm 2 letter 2 letter variant name language id country id --------- --------- ------------ ------------- ------------ ----------- -------- Chinese- Simplified UNIX/Win/Mac zh zh zh CN Chinese- Traditional UNIX** zh_TW zh_TW zh TW **some UNIX users use BIG5 - these customers should log into the BIG5 locale URL Chinese- Traditional Win/Mac zh_TW.BIG5 zh_TW_BIG5 zh TW BIG5 Czech UNIX/Win/Mac cz cz cz CZ Danish UNIX/Win/Mac da da da DK Dutch UNIX/Win/Mac nl nl nl NL Dutch- Belgium UNIX/Win/Mac nl_BE nl_BE nl BE English- Australia UNIX/Win/Mac en_AU en_AU en AU English- Canada UNIX/Win/Mac en_CA en_CA en CA English- United Kingdom UNIX/Win/Mac en_UK en_UK en UK English- Ireland UNIX/Win/Mac en_IE en_IE en IE English- New Zealand UNIX/Win/Mac en_NZ en_NZ en NZ Estonian UNIX/Win/Mac et et et EE Finnish UNIX/Win/Mac su su su FI French UNIX/Win/Mac fr fr fr FR French- Belgium UNIX/Win/Mac fr_BE fr_BE fr BE French- Canada UNIX/Win/Mac fr_CA fr_CA fr CA French- Switzerland UNIX/Win/Mac fr_CH fr_CH fr CH German UNIX/Win/Mac de de de DE German- Austria UNIX/Win/Mac de_AT de_AT de AT German- Switzerland UNIX/Win/Mac de_CH de_CH de CH Greek UNIX/Win/Mac el el el GR Hungarian UNIX/Win/Mac hu hu hu HU Italian UNIX/Win/Mac it it it IT Japanese UNIX* ja ja ja JP *some UNIX users use PCK/Shift_JIS - these customers should log into the PCK locale URL Japanese Win/Mac ja_JP.PCK ja_JP_PCK ja JP PCK Korean UNIX/Win/Mac ko ko ko KR Latvian UNIX/Win/Mac lv lv lv LV Lithuanian UNIX/Win/Mac lt lt lt LT Norwegian UNIX/Win/Mac no no no NO Polish UNIX/Win/Mac pl pl pl PL Portuguese UNIX/Win/Mac pt pt pt PT Portuguese- Brazil UNIX/Win/Mac pt_BR pt_BR pt BR Russian UNIX/Win/Mac ru ru ru RU Spanish UNIX/Win/Mac es es es ES Spanish- Argentina UNIX/Win/Mac es_AR es_AR es AR Spanish- Bolivia UNIX/Win/Mac es_BO es_BO es BO Spanish- Chile UNIX/Win/Mac es_CL es_CL es CL Spanish- Columbia UNIX/Win/Mac es_CO es_CO es CO Spanish- Costa Rica UNIX/Win/Mac es_CR es_CR es CR Spanish- Ecuador UNIX/Win/Mac es_EC es_EC es EC Spanish- Guatemala UNIX/Win/Mac es_GT es_GT es GT Spanish- Mexico UNIX/Win/Mac es_MX es_MX es MX Spanish- Nicaragua UNIX/Win/Mac es_NI es_NI es NI Spanish- Panama UNIX/Win/Mac es_PA es_PA es PA Spanish- Paraguay UNIX/Win/Mac es_PY es_PY es PY Spanish- Peru UNIX/Win/Mac es_PE es_PE es PE Spanish- El Salvador UNIX/Win/Mac es_SV es_SV es SV Spanish- Uruguay UNIX/Win/Mac es_UY es_UY es UY Spanish- Venezuela UNIX/Win/Mac es_VE es_VE es VE Swedish UNIX/Win/Mac sv sv sv se Turkish UNIX/Win/Mac tr tr tr TR Unicode UNIX/Win/Mac en_US.UTF-8 en_US_UTF-8 en US UTF8