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 <localename1> <localename2> ...

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 <localename1>/.
	# cp -p index.html <localename2>/.
	...	

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 <localename1>
	# vi index.html
	
	Note:  Use the plain text editor you prefer.
	
	You are now editing index.html.  On the line which reads:
	
	  <A HREF="/servlet/com.sun.webaccess.selector.Frameset?realm=Sims">
	
	change "realm=Sims" to "realm=Sims_<localerealmname1>".		

	
	# cd ../<localename2>
	# vi index.html
		
	You are now editing index.html.  On the line which reads:
	
	  <A HREF="/servlet/com.sun.webaccess.selector.Frameset?realm=Sims">
	
	change "realm=Sims" to "realm=Sims_<localerealmname2>".	
		
	...
		

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_<localerealmname1>.properties
	# cp -p realm.Sims.properties realm.Sims_<localerealmname2>.properties
	...
	
8.  Edit realm.Sims_<localerealmnamen>.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_<localerealmname1>.properties:
	
		locale=<2-letter-language-id-1>
		country=<2-letter-country-id-1>
		
	Editing realm.Sims_<localerealmname2>.properties:
	
		locale=<2-letter-language-id-2>
		country=<2-letter-country-id-2>
		variant=<variant-from-column7-for-locale2>
		
	...
	
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/<localename>
	

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


