Geronimo configurat=
ion

It's recommended that you backup your var/config/config.xml fil=
e before editing it – you may need the original file if you want to r=
un your Geronimo in=
stallation on SunJava or if you make a mistake w=
hile editing and damage the file beyond repair.

Configure the server to use Harmony RMI Registry provider f=
or JNDI

Harmony places JNDI=
pro=
viders in org.apache.harmony.jndi package tree, not in=
com.sun.jndi like SunJava does, so y=
ou have to point Geronimo into the right direction to locate and properly access the RMI Registr=
y provider.

Change default =
keystore type

Geronimo uses a =
JKS keystore that Harmony doesn't support, see GERONIMO-3757 for details. So you have to gene=
rate another keystore, of PKCS12, BKS (default for Harmony), or another type Harmony has support for, and to instruct =
Geronimo to use it.=
p>

To convert the existing Geroni=
mo JKS keystore to PKCS12 type, you could use a simple Java pro=
gram like JKStoPKCS12.java. The program needs to =
be run on SunJava, as it supports both JKS and P=
KCS12 keystores. If you need a BKS keystore, you'd need to convert your PKC=
S12 keystore again, with PKCS12toBKS.java running=
on Harmony – as=
SunJava doesn't support BKS and Harmony doesn't support JKS.

Alternatively, you may just overwrite you keystore file over the var=
/security/keystores/geronimo-default, then you may omit the keysto=
rePath tag in the config. However, this is not recommended, as you may=
need the original keystore if you need to run your Geronimo installation on SunJ=
ava=
sup>. If you decide to overwrite, don't forget to backup your or=
iginal keystore. Just in case you have no backup and need the original keys=
tore, you may use the one attached to this article, just in case: geronimo.jks=
.

Change keystore type in TomcatWebSSLConnector

If you intend to use geronimo-tomcat6-javaee5-2.1-SNAPSHOT-bin =
as the application server, edit var/config/config.xml file and adj=
ust TomcatWebSSLConnector GBean configuration to set the path for =
keystore in attribute KeystoreFile and keystore type in attribute =
KeystoreType as followed :

Place the required jar files in &=
lt;harmony-hdk>\jdk\jre\lib\ext

Customize the s=
erver startup

You may either edit the Geroni=
mo startup scripts or run the server from the command line, but=
in either case you should consider the following adjustments:

1. Harmony doesn't=
accept the -javaagent option (HARMONY-5462), so you have to om=
it it. Or, you may remove bin/jpa.jar file from Geronimo distribution – this way =
the -javaagent option would be omitted by the Geronimo startup script.

2. Geronimov2.1 needs access to Internet for applications like SPECjAppServer2004 to be deployed – it tries to fetch XML schemas from http://java.sun.com site. So if you're =
going to deploy applications like that, and you're behind a firewall, you s=
hould add the appropriate -Dhttp.proxyHost=3D and -Dhttp.proxy=
Port=3D options to the Geron=
imo=
sup> command line. This problem is caused by OPENEJB-700 bug an=
d should disappear after that bug is fixed and the fix is propagated to a n=
ew version of Geronimo.