There are two parts to the ILMServer: The Server and the Client. The Server program runs on your server. The Client runs on the computer that the Subject is using. There will be one client for each subject. The Server receives data from the Clients (e.g. a Subject’s input), sends data to Clients and stores results on the blake server. The Client program is the one you run as detailed in the section on ‘Running the Experiment’.
A server is associated with a port number. This is the port number that you enter to connect when running an experiment. There may be several ILMServers running on blake at one time.
The server runs continually in the background, but you may need to restart it if things aren’t working.
First, use a terminal window to SSH into your server (you’ll need the username and password).
Navigate to the correct folder by typing (e.g.):
cd ILM_OB/
start the server by typing:
java ilmServer/Server XXXX
Where XXXX is the port number you want the server to run on. If you want the server to keep running, even when you log out of the SSH session, use
nohup java ilmServer/Server XXXX &
The output of the server will now be saved to nohup.out and the server will continue running when you log out.
If you get an error message like:
Exception in thread "main" java.net.BindException: Address already in use
This means that there is already a server program running which is using this port. Choose a different port, or close the existing server. You can close the server by halting the program via the command line by using the kill, ps and top commands (e.g. see here). You can then re-start the server.
In order to make sure no one’s work is interrupted, it may be wise to run a server on a different port number for each experimenter.