Starting Mulgara¶

After building Mulgara, or downloading and unpacking a binary distribution, the main Mulgara JAR file will be found in the dist directory. This file will have the name mulgara-x.y.z.jar, where x.y.z will be the version number of the release (e.g. mulgara-2.0.9.jar).

To start a Mulgara server with default settings, then execute the following command:

  java -jar mulgara-x.y.z.jar

Note: replace the x.y.z with the current release number.

If the server shuts down with a message like

2009-08-21 11:34:19,451 WARN  [[MortbayLogger]] - failed [[BlockingChannelConnector]]@<hostname>:8081
java.net.BindException: Address already in use: bind

then try starting it with different port numbers, e.g. -p 8088 -u 8089

By default, Mulgara will use the following ports. They should be made available to Mulgara, or else Mulgara should be reconfigured to use ports that are free instead. See the [[Args|Command Line Arguments]] for details on specifying other ports.
* *1099*: RMI registry
* *8080*: HTTP read-write access
* *8081*: HTTP read-only access

h1. Stopping Mulgara

Mulgara can be safely stopped in one of 3 ways.

h2. Command Line Interrupt

If Mulgara was started from the command line, then go to the console that was used to start the application, and press *Control-C*.

h2. Stop Command

The Mulgara JAR can be used to stop another running Mulgara instance using the command:
<pre>
  java -jar mulgara-x.y.z.jar -x
</pre>

h2. Remote Shutdown

<pre>

On Unix-style systems, this can be easily performed with the _netcat_ command:
<pre>
  echo shutdownmulgara | nc localhost 6789
</pre>