JOnAS AutoStart tutorial

JOnAS AutoStart tutorial

You will find here some descriptions concerning the usage of JOnAS Builder and JOnAS Starter tools.
These tools are intended to facilitate and make automatic the access to Java EE applications with JOnAS server.
As the following diagram shows, you have two steps:

• the producer step (1): allows a producer to generate an executable jar file with an embedded JOnAS server zip file. The producer can also deploy Java EE applications.
• the user step (2): the final user executes the generated jar file to start the JOnAS server.

JOnAS Auto-Start :: Builder Guide

This section describes how to use the builder tool to generate a JAR file (jonas-starter) with an embedded JOnAS server. JOnAS Builder is implemented in three versions : Java Swing, Flex, Maven plugin. Please follow these instructions:

Step 1: choose your version

• Swing version can be downloaded here JOnAS Builder Swing ;
• Flex version is included in JOnAS Administration interface. Run your JOnAS server and open your web browser to access to admin interface ;
• Maven plugin module can be set in your local repository using a maven specific command.

• Run the jar file using the command line: java -jar or double-click the JAR file to launch the program ;
• Read and accept the license agreements.
• Select the applications to include in the packaging process.
• Select how JOnAS Builder will get JOnAS server zip file:
  • From web site option: select your JOnAS server version and type (full or micro). This option requires a valid Internet connexion. You can set (if you have) the proxy settings using 'Preferences' button.
  • From an existing folder: if you have a valid JOnAS Root (JOnAS Base) folder, please select this option.
  • From an existing zip file: if you have an existing JOnAS zip file in your disk or other web site, please select this option and set the parameters.
• Optionally, you can customize JOnAS server by choosing this option using 'Set config' button.

JOnAS Auto-Start :: Starter Guide

This section shows the usage of the JOnAS Starter tool. The embedded JOnAS server included in the JAR file is extracted and installed in the local disk; after the extraction, the server is launched.
JOnAS Starter is implemented in two versions:

• Command line
• Graphical user interface.

Command line

Execute the command:

java -jar [-option [parameter]]

• Option:
  • --existing-jonas or -e: to run JOnAS server with an existing JOnAS Root folder. If this option is not specified, the embedded JOnAS server will be extracted. JOnAS server will be started using this folder
  • --jonas-root or -r: to specify JOnAS Root location
  • --jonas-base or -b: to specify JOnAS Base location
  • --stop-jonas or -s: to stop JOnAS server
• Example:
  • java -jar jonas-starter.jar: this command executes JOnAS Starter tool command line version. No option and parameter are spectified. JOnAS server will be installed in /tmp or C:Temp folder. After the extracting process, JOnAS Starter tool will start JOnAS server using /tmp/JOnas_Root_id folder
  • java -jar jonas-starter.jar --jonas-root <your-folder>: JOnAS server will be installed in <your-folder&lgt;
  • java -jar jonas-starter.jar --existing-jonas --jonas-root /tmp/JOnas_Root_id: JOnAS server will be started using the existing JOnAS folder /tmp/JOnas_Root_id
  • java -jar jonas-starter.jar --stop-jonas /tmp/JOnas_Root_id: JOnAS Starter tool will stop JOnAS server using /tmp/JOnas_Root_id folder

Graphical user interface

Two types of JOnAS Starter graphical user interface are available: the full type and minimal type:

• full type: allows the JOnAS server configuration before starting it
• minimal type: no configuration are possible.