Here are the mandatory technical requirements to run a REVEN server:
/tmp
directory must be mounted on a RAM filesystem with at least 4Gb available,The following points may be necessary to improve the REVEN server performance. Metrics are given for information only: they are an estimation based on the assumption of a single project consisting of a 1-second long scenario.
project_data
folder (see Build configuration ) should be the on fastest storage possible (eg: avoid cyphering) and should have at least 200Gb available (for multiple projects, 1Tb is recommended).Note that the version of REVEN-Axion you received may be specifically tailored to a hardware machine of which you would have provided characteristics. If that is the case, please install the REVEN server on this machine only.
To run the Axion client, the requirements are:
In the following steps we assume the following configuration:
REVEN is usually shipped as a compressed tar archive. To install it, first you have to extract the archive using the tar unix utility. We recommend storing REVEN packages in /home/tetrane/repo
.
The following commands will extract a REVEN archive named reven-XXX.tgz
(located in /home/tetrane/
) to the /home/tetrane/repo
folder. This should be ajusted to your needs.
To be able to use the Debian package manager to install REVEN, you must register a new package repository. The recommended way is to create a /etc/apt/sources.list.d/tetrane.list
file with the following content:
In the case of a local repository stored in /home/tetrane/repo
:
And then update the package database (as root
user):
You can make sure your package configuration has been taken into account by issuing the following command:
It should display information about this package.
Before anything else, you should ensure your /tmp
folder is indeed mounted as a ramfs. You can do so by adding the following line to your /etc/fstab
file:
You can now force the system to remount /tmp:
Once the REVEN packages are available through the package manager, you can install the REVEN server.
As root
user:
At some point, the installer will ask for information about the new REVEN user, simply enter default choices (with <Enter>
) and confirm with <Y>
.
At the end of the installation you can check the REVEN service is running:
By default, REVEN automatically start at boot, to avoid that and only start it manually, use the update-rc.d
command (as root
user):
Once REVEN is installed some more setup is needed before you can actually use it. Note that the installation process creates a user named reven
. You should not use this this user for any operation on the machine.
Now that you have installed the REVEN server software, it is time to configure the clients. All following commands will have to be issued on the client machine.
By default, the server installation you just went through will configure the machine to serve the client REVEN-Axion packages on an http server. Therefore, the easiest way to deploy the client is to configure the Debian client machine to use a new package repository by creating a file name /etc/apt/sources.list.d/tetrane.list
with:
Of course REVEN.server.host
should match the address or hostname corresponding to the machine you installed the REVEN server on.
Once Axion packages are available through the package manager, you can install the Axion client.
As root
user
To upgrade a previous installation of a REVEN server or Axion client, you must ensure the latest packages are available through the package manager: if you followed the recommended steps above, this means replacing the content of /home/tetrane/repo
with the new packages. Then, simply issue the following command (as root
user) on the server first, then on the clients: