Last week, G11n checked in our l10n module in GlassFish CVS repository. What does this mean? L10n module is finally opensourced for 9.1.1 release!! It includes translation for both CLI and web based GUI admin tools UI, online help, and log messages. In this blog entry I'll describe how to build GlassFish v2 ML from CVS source. For general GlassFish build instruction please refer to this document.

1. First, checkout GlassFish bootstrap and l10n modules. Then bootstrap the server image.This way you don't need to build the whole GlassFish from scratch but only build l10n subset of modules.

% cvs -d :pserver:<userid>@cvs.dev.java.net:/cvs checkout -r SJSAS91_FCS_BRANCH glassfish/bootstrap glassfish/l10n
% cd glassfish/bootstrap
% maven bootstrap

This generates GlassFish server image at publish/glassfish directory. Note that maven 1.0.2 is the requirement.

2. Build l10n module. Run following and you will have l10n jars placed in publish/glassfish.

% cd ../l10n
% maven bootstrap include-all-locales publish

Above will include all 7 locales. You can also specify only the locales you need as follows.

% maven bootstrap {include-<locale>, include-<locale>, ...} publish

locale can be one of fr ,de, es, ko, ja, zh_CN, or zh_TW.

3. Now we have ML server image in publish/glassfish directory. Let's configure the GlassFish server runtime. Following will create domain1 with default configuration.

% cd ../bootstrap
% maven configure-runtime

Default configuration (ports, admin user/password, etc) is found in glassfish/bootstrap/setup.xml file. Starting the server instance.

% cd ../../publish/glassfish/bin
% ./asadmin start-domain

You should be seeing localized console output and the ML version of server up and running :-)

4. Optionally you can also create installer jar file. You may be familiar with this jar as you can find these at promoted build download area. First, make sure the publish/glassfish server is not running and clean the domain configuration.

% ./asadmin stop-domain
% cd ../../../glassfish/bootstrap
% maven clean-config

Build installer as follows.

% maven build-jarinstaller

You'll find publish/glassfish-installer.jar. Copy it somewhere and enjoy.

% java -jar -Xmx256m glassfish-installer.jar
% cd glassfish
% ant -f setup.xml
% ./bin/asadmin start-domain

So, to summarize, you can use localization done in v2 UR1 and try v2.1 ML today. Enjoy, and if you have any feedback please send them here. I'll have to post another entry describing more about l10n module when I got time.