(1) Preconditions to run SeMoA
- To run the current SeMoA distribution with all features, you have to install Java: Java 2 Platform Standard Edition (at least version 5.0).
- Download and install the full J2SE Development Kit (JDK), not only the J2SE Runtime Environment (JRE): The Web service engine needs the JDK library tools.jar.
- Nevertheless, all SeMoA sources except the following packages/classes will compile and then run with Java 2 Platform Standard Edition 1.4.2: package examples.wslauncher4 and SSL/TLS-related classes.
- To run the Earth visualizer, you have to download Java 3D API (at least version 1.3.1) and install it.
- With some effort (class exclusions resp. modifications) it's even possible to adjust the current SeMoA distribution to run with Java 2 Platform Standard Edition 1.3.1 or lower.
(2) Download the proper SeMoA modules
- Please consult the licensing page first, before downloading the needed SeMoA modules from the download page.
- The current SeMoA distribution comes as a bunch of base modules (marked boldface) and further add-on modules.
- You have to download and install at least one base module and those add-on modules (listed above the selected base module), whose features you want to use.
- Remember where you saved the SeMoA modules. We refer to the downloaded
base module as semoa-base.zip, to the downloaded add-on modules as semoa-addon.zip.
- Furthermore, you will find corresponding source and javadoc archives. We refer to these as semoa-module_src.zip resp. semoa-module_javadoc.zip.
- The SeMoA tray-bar extension modules allow you to easily stop a SeMoA server running in daemon mode on the supported operating system architectures. We refer to these as semoa-tray.zip.
- Every single SeMoA base module contains all listed additional packages igda8-*.jar on the download page and the Java crypto provider FlexiProvider which is developed at the TU-Darmstadt based on our CODEC ASN.1 package.
- The most convenient way to get the latest source version of SeMoA is to use our read-only SVN mirror, which is updated nightly.
(3) Install the downloaded SeMoA modules
- Unarchive the semoa-base.zip file to a chosen installation folder, e.g. using the jar utility, which is provided as part of Sun's Java runtime environment: jar xf semoa-base.zip.
- Unarchive the semoa-addon.zip files within the created semoa folder: cd semoa; jar xf semoa-addon.zip.
- If you have downloaded semoa-module_src.zip, semoa-module_javadoc.zip, or semoa-tray.zip you may additionally unarchive these modules within the created semoa folder.
- On a Microsoft Windows box, you may use an arbitrary zip utility to unarchive the downloaded modules as well. If you don't have one then you can download for instance the latest version of WinZip from here.
(4) Start SeMoA using the SeMoA-Starter
- Use the shell of the operating system to change into the created semoa folder and type: java -jar semoa-launcher.jar.
- The SeMoA-Starter GUI should appear. 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 or changed configuration property 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.
- For further SeMoA-Starter command line options click here.
(5) Running the SeMoA server
- When running SeMoA shell in interactive mode, which is the default mode, you should see the server booting. At some point, a small window pops up and
requests you to enter a password. Type "semoa.org". The boot process
should continue, and finally a prompt should appear.
- Per default SeMoA is configured STANDALONE. That is, the server does not try to connect to global SeMoA services as there are the Agent Tracking and Location Service (ATLAS), the LDAP-based Public Key Infrastructure (PKI), and the the SeMoA Web Service Registry (UDDI-Server) running on semoa.igd.fraunhofer.de.
- Furthermore, the SeMoA server broadcasts ping (Vicinity) messages within the LAN to discover other SeMoA servers.
- In case, the SeMoA shell prompts the message "Command caused an exception!", details can be displayed using the shell commands why and why all.
- Type the shell command alias info to get some initial help and first information about the installed features.
You started your first SeMoA server and might want to continue with testing, now.