...
toptop Anchor
Running SPECjAppServer2004 benchmark on Geronimo
...
Issues still exist that prevent SPECjAppServer2004 from running on Geronimo.
This article is not a success story, but a collection of notes on the progress that has been made in this direction.
Current issue that requires your help is: #Running the benchmark
...
Disclaimer: This article is created to write down the existing experience and to make it reproducible. It is not targeted to be a comprehensive guide on either product or on merging them together. It's not also a replacement to the products' documentation, but just a step-by-step guide on how to make things work in a simple configuration, as it worked for me. Make sure you at least look through the documentation on both products before you proceed.
...
SPECjAppServer is a trademark of the Standard Performance Evaluation Corp. (SPEC). The SPECjAppServer2004 results or findings in this publication have not been reviewed or accepted by SPEC, therefore no comparison nor performance inference can be made against any published SPEC result. The official web site for SPECjAppServer2004 is located at http://www.spec.org/jAppServer2004/.
...
Sharing geronimo.host
with emulator.host
or driver.host
is contradicting with the SPECjAppServer2004 documentation and would impact the performance severely and invalidate the benchmark results. However technically this is possible.
...
It was reported that some components may work incorrectly if working paths are too long or contain spaces. So it's recommended that you avoid long paths and spaces in them.
...
Installing SPECjAppServer2004
Run:
...
...
java -jar SPECjAppServer2004-Kit-v1.05-050425.jar
...
Click Next, read and accept the license agreement, and type in the directory you want the SPECjAppServer2004 to be installed to. This directory will be your <SPEC>
directory.
...
This is necessary to allow the SPECjAppServer2004 Driver to remotely access the EJBs deployed in Geronimo.
...
...
If your geronimo.host
and your driver.host
are the same machine, you have to adjust the port number of the Geronimo RMI Registry (to e. g. 1199), otherwise it would conflict with the SPECjAppServer2004 Driver that uses the default port of 1099:
...
...
Starting Geronimo
Go to your <GERONIMO>
directory.
Start Geronimo by typing:
...
...
java -jar bin/server.jar
...
It will take some time to start. After that, you will see: bgColor No Format
black
If you get another result, particularly, if network errors show up, then something has gone wrong.
...
Sometimes, the startup fails because some local network addresses are inaccessible. This could happen, for example, if you have used a VPN interface that is disconnected now. By default, Geronimo uses the first local address it comes across to access its components, and may try to use a stale address, causing startup errors.
You may try disabling and then re-enabling the unused network interfaces to resolve such issues.
...
Use forward slashes ( / ) as directory separators!
...
Clean-up your installation:
...
...
ant/bin/ant clean
...
Build the application and configure it for Geronimo:
...
...
ant/bin/ant -Dappserver=geronimo
...
You will get the BUILD SUCCESSFUL diagnostic.
...
Go to the <SPEC>/config
directory. Replace the content of each of the *db.properties
files you find there with the contents of the attached db.properties template file. Make sure the pipeDir
variable there points to a valid temporary directory, adjust if necessary.
Loading the tables
Run:
...
...
ant/bin/ant -Dappserver=geronimo loaddb
...
After some time, you will get the BUILD SUCCESSFUL diagnostic.
...
Note that if your geronimo.host
and your driver.host
are the same machine, and you changed the port number of the Geronimo RMI Registry, you should specify that port number in all deployer commands, like this:
...
java -jar bin/deployer.jar --port 1199 ...
...
To deploy a connector to the Derby SPECDB database you created earlier, go to the <GERONIMO>
directory and run:
...
...
java -jar bin/deployer.jar --user system --password manager deploy repository/tranql/tranql-connector-derby-embed-xa/1.1/tranql-connector-derby-embed-xa-1.1.rar <KIT>/sjas-db.xml
...
You will get the Deployed SPEC/SPECjAppServerDB/1.05/car diagnostic.
...
To deploy an ActiveMQ JMS connector for SPECjAppServer2004, go to the <GERONIMO>
directory and run:
...
...
java -jar bin/deployer.jar --user system --password manager deploy repository/geronimo/ge-activemq-rar/1.1/ge-activemq-rar-1.1.rar <KIT>/sjas-jms.xml
...
You will get the Deployed SPEC/SPECjAppServerJMS/1.05/car diagnostic.
...
Go to the <GERONIMO>
directory and run:
...
...
java -jar bin/deployer.jar --user system --password manager deploy <SPEC>/jars/SPECjAppServer.ear <KIT>/sjas2004.xml
...
You will get the Deployed SPEC/SPECjAppServer/1.05/ear diagnostic.
...
Note that SPECjAppServer2004 documentation requires that the Supplier Emulator servlet container should have the keep-alive
option turned off. You can ignore this requirement, but that would impact the performance severely.
...
java -jar bin/deployer.jar --user system --password manager deploy <SPEC>/jars/Emulator.war <KIT>/sjas-emulator.xml
...
Do not bother editing <SPEC>/config/tomcat.env
file or running ant/bin/ant -f tomcat.xml
.
Both files are obsolete, they generate the Emulator.war
file, which has already been created at #Building the application phase.
...
Go to the <TOMCAT>
directory on the emulator.host
and start Tomcat:
...
...
bin/catalina run
...
Veryfying the deployment
Go to the page http://emulator.host:8080/Emulator/
. It should load normally and contain a single directory, dtd
, with two files inside, delivery.dtd
and po.dtd
.
Go to the page http://emulator.host:8080/Emulator/EmulatorServlet
. You should see a page with text like this:
...
...
Emulator Servlet seems to work OK
JAS_HOST : emulator.host
JAS_PORT : 8080
Servlet URL : Supplier/DeliveryServlet
Number of Transactions : 0
Servlet invoked without command specified
...
Running the benchmark
...
bin/setenv.bat
...
bin/driver.bat
...
borderStyle | solid |
---|
...
bin/driver.bat master.host
...
After starting the Driver, you should see the output like this:noformat
This means the Driver started normally.
...
You can interrupt the run at any point with Ctrl-C
.
...
Sometimes binding exceptions or other problems may occur at the Driver startup. In such a case, interrupt the test run with Ctrl-C
and rerun it again. Sometimes it helps.
...
...
It's recommended to reload the database tables before each run, particularly if previous run was not finished correctly. Otherwise, errors like this may occur:
...
black
...
solid
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
During the run, the following diagnostics may appear in the Driver window:
No Format
and in the same time, various TransactionRolledback
and other exceptions of the same kind are being printed in the Geronimo shell.
...
These diagnostics are probably caused by the fact that TranQL version 1.3 used in Geronimo version 1.1 does not provide the necessary transaction isolation level. Hopefully, this problem will be fixed in TranQL version 1.3.1.
...
After the run has completed successfuly, you will see the output like this:
No Format
The number of JOPS is a final benchmark metric.
...
For now these values for Geronimo are terribly low, and don't depend on the hardware being used. Probably this is due to some configuration issues that still exist or due to TranQL issue mentioned above.
...
java -cp reporter.jar reporter Your_Submission.txt
...
Run the following command to generate a text-only benchmark report, it would be named Your_Submission.report.txt
:
...
...
java -cp reporter.jar reporter -a Your_Submission.txt
...
For the details on how yo submit your results, see SPECjAppServer2004 User's Guide :: Section 5.3 – Submitting the Results
...