Aquarius Server Configuration
Configuring the server involves modifying the file /etc/aquarius.conf to change the default values.
The following values are configurable:
| Option | Description |
|---|---|
| port | This is the communications port that the aquarius client will use to talk with the server |
| ip | This is the external Internet address for your server. It needs to be the external address in order for the aquarius client to see it. |
| dbloc | This is the directory location where the Aquarius Server database will be saved. This value should not include the trailing '/' |
| dbname | This is the name of the database to be placed in dbloc |
| jobloc | This is the location of the OpenFOAM and Aquarius job files. When an Aquarius job is requested by the client a new folder is placed in this folder to contain all the files related to this job. This value should not have a trailing '/'. |
| jobprefix | This is the prefix for the folder that is created under the jobloc folder. Without a prefix, the directory name will simply be a number. |
| duration | This is the number of seconds between database checks. Unless there is a problem it is best to leave this at 8. |
| maxjobs | This is the maximum number of OpenFOAM solver jobs that can be run on this Aquarius server. This value will count all processes named interDyMFoam, even those you run outside of Aquarius. Make sure that this number is at least 1 less than the number of cores your system has. If your system has just one core, then set this to one. |
Modifying the Server Configuration
Most of the settings in the configuration file can be happily left at their default values. In fact, only the ip really needs to be modified as without doing so, your server will not be guaranteed accessible by your client.
You will first need to determine the ip address for your system, you can do this by typing the following command:
You will get something akin to the following result:
| eth0 |
Link encap:Ethernet HWaddr 08:00:27:63:B2:43 inet addr:192.168.100.189 Bcast:192.168.100.255 Mask:255.255.255.0 inet6 addr: fe80::a00:27ff:fe63:b243/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:218338 errors:0 dropped:0 overruns:0 frame:0 TX packets:28933 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000 RX bytes:86507060 (82.4 MiB) TX bytes:3011839 (2.8 MiB) |
| lo |
Link encap:Local Loopback inet addr:127.0.0.1 Mask:255.0.0.0 inet6 addr: ::1/128 Scope:Host UP LOOPBACK RUNNING MTU:16436 Metric:1 RX packets:0 errors:0 dropped:0 overruns:0 frame:0 TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:0 RX bytes:0 (0.0 b) TX bytes:0 (0.0 b) |
This listing shows the network interfaces available on your system. In the example there are two interfaces eth0 and lo.
The part of the interface you are looking for is Inet addr:. In the example above, there exists:
| interface | IP Address |
|---|---|
| eth0 | 192.168.100.189 |
| lo | 127.0.0.1 |
You will want to use the eth address. If there is more than one of these because you have more than one network card and you will need to decide which of these to use. Use the one that exists on the same network that your client computer will be run on or that your client computer can reach.
Once you have this value, modify the /etc/aquarius.conf file to reflect this value.
Now that you have made the appropriate changes to the configuration file, you must restart the server in order for this to take effect. To do this type the following command:
The Aquarius server is now configured and running!