3.7. Client/Server

For smaller races, the simplest way to run JRaceman is to use the default database with a single user. This is how JRaceman runs if you do not specify any special command line options.

For larger races, you may want to allow multiple people to access the database simultaneously. In this situation, you can run a JRaceman database server, after which multiple clients can run and connect to that server.

Scripts are provided (shell scripts for Unix platforms, bat files for Windows) for the most common modes of operation, including standalone, client and server. You can use one of these scripts as-is, or copy one and modify it for your specific use. Or you can use one of the commands listed below.

To start a JRaceman server, run JRaceman on your server machine with this command line:

java -jar jraceman.jar -db database -runserver

This will start a JRaceman database server listening on TCP port 9157. After the server starts, you can start one or more JRaceman clients this this command:

java -jar jraceman.jar -dbhost servername

where servername is the name of the machine on which the JRaceman database server is running. When you want to shut down the server, first exit from all of the clients and then run this command:

java -jar jraceman.jar -dbhost servername -sql SHUTDOWN

If, when installing JRaceman on Windows, you left the "Install Shortcuts on Desktop" selected checked, there will be shortcuts to start the server, stop the server, start the client, and start in standalone mode. You can look at the Properties on these shortcuts to see how they work. For a multi-user system, copy the start-client shortcut and change the Properties to pass in the servername of the JRaceman host computer.