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

The command line also accepts a number of command line arguments to change the default settings (some of which are documented by java -jar mulgara.x.y.z --help). Alternatively, these settings can also be configured using Java System Properties.

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 Command Line Arguments for details on specifying other ports.

• 1099: RMI registry
• 8080: HTTP read-write access
• 8081: HTTP read-only access

Stopping Mulgara

Mulgara can be safely stopped in one of 3 ways.

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.

Stop Command

The Mulgara JAR can be used to stop another running Mulgara instance using the command:

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

Remote Shutdown

By default, Mulgara listens to port 6789 for a shutdown request. Sending the string shutdownmulgara to this port will stop the server.

On Unix-style systems, this can be easily performed with the netcat command:

  echo shutdownmulgara | nc localhost 6789