[SeMoA Logo Strip] [SeMoA Logo Strip] [SeMoA Logo Strip]
 About  -  Documentation  -  Download  -  Misc 

Start SeMoA using the SeMoA-Starter

  • Use the shell of the operating system to change to the created semoa folder and type: java -jar semoa-launcher.jar.
  • The SeMoA-Starter GUI should appear (see below). By enabling the "Help Tooltips" you get further information about the particular setup parameters.
  • The SeMoA-Starter guesses the right settings as good as possible. Nevertheless, you can change them using the various input fields. If the button "Start >>" in the lower right corner of the GUI is enabled, all settings needed are given, and you can start the SeMoA-Server.
  • The settings are automatically stored in a property file in your personal home folder, when you either close the SeMoA-Starter GUI, or press the "Start >>" button.
  • If a manually set configuration is not valid, the SeMoA-Starter will indicate this by changing the color of the corresponding configuration field to yellow or red, disabling the "Start >>" button, and generating a warning tooltip.
  • Once you have setup the SeMoA properties, you may skip the SeMoA-Starter GUI by calling java -jar semoa-launcher.jar -nogui.

Further SeMoA-Starter command line options:

USAGE: java -jar semoa-launcher.jar [<options>]
If no option is defined, a GUI will show up.


  • -nogui Starts the SeMoA shell without displaying the SeMoA-Starter GUI. (SeMoA settings are guessed and/or read from a previously created property file.)
  • -f <semoa_start_script> [<script_parameters>] Starts the SeMoA shell, and parses the given <semoa_start_script> with the according <script_parameters>, if given as well.
  • -rc <semoa_configuration> Starts the SeMoA shell with the given <semoa_configuration>. (This is equivalent to -f ${semoa_base_directory}/etc/rc <semoa_configuration>.)
  • -daemon Starts the SeMoA shell as daemon in a non-interactive mode. Output is written to a logfile in ${semoa_base_directory}.
  • -headless Starts the SeMoA shell on a host without display or running X-Server (all GUIs are omitted). This option can be usefull to start a SeMoA server on a remote machine.
  • -debug Prints out some debug information.
  • -config <properties_file> Reads an optional properties file instead of the default (.semoa.properties in the user home directory).
  • -D<key>=<value> Passes a user defined system property to the Java VM that will start the SeMoA server. Multiple usage of this option is permitted.

When starting SeMoA using one of the given options, the basic SeMoA settings are guessed and/or read from a previously created property file, without displaying the SeMoA-Starter GUI.