Aquarius Server Install

By installing this software you agree to these Terms and Conditions. As the server software is Freeware the EULA parts relating to the license, duration and fee can be ignored as they are only relevant for the Aquarius client.

This options is for users who have a working external internet connection on their Linux server. If you would prefer to download the install files and install the software offline, click here.

To install the Aquarius server you will need to perform the following steps:

Installation Process

CentOS | RedHat | RedHat Enterprise | Fedora

  1. Configure your system to use the Lloyd's Register repository.
  2. Install the Pre-Compiled OpenFOAM
  3. Install the Aquarius Server

Notes:

  • The easiest way to install the Aquarius Server is through a terminal session. If you are connecting from a windows client then consider using putty.

  • The installation requires sudo access but must be run from a normal user account.

  • Installing the Aquarius server requires that you already have OpenFOAM 2.1.1 installed on your linux distribution and that it is running properly.  The Aquarius server install will look for a couple key environment variables to ensure this is the case.

  • All commands in linux are case sensitive so type them exactly as they are shown below. The easiest way is to copy and paste directly from the site. If you're using putty then you can copy from the site and right-click on your putty window to paste the text.

  • Ensure that yum is configured correctly to connect to external repositories
    We have seen issues with people behind proxies. It is important that you add the line:
    proxy=<your proxy address>

1. Configure LR Repository

The LR Repository will give you access to the Lloyd's Register software suite available for your server.

Get the LR Repository

Run the following command to add a repository to your system:

sudo vi /etc/yum.repos.d/LR.repo

Press i and then type or copy the following text into the file:

[LloydsRegister]
name=Lloyds Register Tools Repository
baseurl=http://downloads.lr-marine-tools.org/repo
enabled=1
gpgcheck=0
metadata_expire=1h
Press escape to exit the insert mode and then type
:wq
and press enter to save and close the file.

Now you need to update the yum install cache so that the new Lloyd's Register install packages become available. Enter the following command:

sudo yum makecache

Provided there were no errors, your system is now ready to install the LR Aquarius Server software.

2. Install Pre-Compiled OpenFOAM

Installing LROpenFOAM

If you already have OpenFOAM 2.1.1 running on your system you may continue to step 3.

To see if you have OpenFOAM installed type:

interDyMFoam
if you get anything other than:
-bash: interDyMFoam: command not found
then there is a current copy of OpenFOAM installed. You can tell the version of OpenFOAM by looking for the Build line in the output:
/*---------------------------------------------------------------------------*\
| ========= | |
| \\ / F ield | OpenFOAM: The Open Source CFD Toolbox |
| \\ / O peration | Version: 2.1.1 |
| \\ / A nd | Web: www.OpenFOAM.org |
| \\/ M anipulation | |
\*---------------------------------------------------------------------------*/
Build : 2.1.1-221db2718bbb
...
FOAM exiting
If it doesn't start with 2.1.1 then you need to remove it first.

You can either install OpenFOAM 2.1.1 via the installation instructions found here

or

you can install the LROpenFOAM which is a pre-compiled version for use on 64 bit CentOS/RedHat/RedHat Enterprise/Fedora systems. This version will remove the need to install all the developer components that are required to build OpenFOAM from source.

Install LROpenFOAM by typing the following command:

sudo yum install LROpenFOAM

If there are no errors then OpenFOAM 2.1.1 has been installed in /opt/LROpenFOAM and an entry has been made in your .bashrc file to create the OpenFOAM environment variables.

This will be run automatically for you when you next log in but this time you will have to initiate it yourself. Do this by typing the following command:

. ~/.bashrc

Notes:

  • Make sure to note the space between the two periods in the above command.

You can test your copy of OpenFOAM is working by typing the following command:

interDyMFoam
you should see something like this:
/*---------------------------------------------------------------------------*\
| ========= | |
| \\ / F ield | OpenFOAM: The Open Source CFD Toolbox |
| \\ / O peration | Version: 2.1.1 |
| \\ / A nd | Web: www.OpenFOAM.org |
| \\/ M anipulation | |
\*---------------------------------------------------------------------------*/
Build : 2.1.1-221db2718bbb
Exec : interDyMFoam
Date : Nov 25 2014
Time : 15:07:46
Host : "localhost.localdomain"
PID : 27420
Case : /srv/aquarius
nProcs : 1
sigFpe : Enabling floating point exception trapping (FOAM_SIGFPE).
fileModificationChecking : Monitoring run-time modified files using timeStampMaster
allowSystemOperations : Disallowing user-supplied system call operations

// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
Create time



--> FOAM FATAL IO ERROR:
cannot find file

file: /srv/aquarius/system/controlDict at line 0.

From function regIOobject::readStream()
in file db/regIOobject/regIOobjectRead.C at line 73.

FOAM exiting
if you don't see anything like this or you get a:
-bash: interDyMFoam: command not found
then something has gone wrong with the installation. Consult the output from your installation commands for the reason.

3. Install Aquarius Server

Installing Aquarius Server

The Aquarius server is a collection of:

  • Aquarius communications server
  • Aquarius daemons to handle database monitoring and process execution
  • Aquarius utilities to handle compression and gathering of data for transmission
  • Aquarius utilities to handle mesh generation
  • modifications to OpenFOAM standard software

Install the Aquarius Server by typing the following command:

sudo -E yum install aquariusServer
The -E tells the installer that even though you are issuing the commands with the sudo directive it will keep your current users environment variables which are necessary for the install process.

If there are no errors then the Aquarius Server has been installed in /srv/aquarius and the Aquarius utility and daemon software has been placed in /usr/bin. The OpenFOAM modifications are placed in /home/<username>/OpenFOAM/<username>-2.1.1.

You can check to see if the Aquarius OpenFOAM modifications are in the correct place by issuing the following command:

which interDyMFoam
you should see something like this:
~/OpenFOAM/<username>-2.1.1/platforms/linux64GccDPOpt/bin/interDyMFoam
if you don't see anything like this or you get a:
/opt/LROpenFOAM/OpenFOAM-2.1.1/platforms/linux64GccDPOpt/bin/interDyMFoam
then something has gone wrong with the installation. Consult the output from your installation commands for the reason.

The Aquarius server is now installed and running!

You will need to configure the IP address for your server in the file /etc/aquarius.conf. This is all explained on the Server Configuration page.

Quick script

echo "[LloydsRegister]" >> LR.repo
echo "name=Lloyds Register Tools Repository" >> LR.repo
echo "baseurl=http://downloads.lr.org/repo" >> LR.repo
echo "enabled=1" >> LR.repo
echo "gpgcheck=0" >> LR.repo
echo "metadata_expire=1h" >> LR.repo

sudo mv LR.repo /etc/yum.repos.d/LR.repo
sudo yum makecache
sudo yum install LROpenFOAM -y
. ~/.bashrc
sudo -E yum install aquariusServer -y