4. Installation & Initial Configuration

Prerequisites: Ubuntu 24.04 LTS installed and updated.

It is highly recommended that any robotics, systems, tape drives and other storage devices are configured, linked and tested BEFORE installing SF Archive. Each node you intend to add to the solution will require access to the same devices and storage. Nodes do not require a cache of their own.

The setup process is extremely simple, but it also assumes you will have configured any peripheral devices before it starts. You may also want to plan and install MySQL server on a separate node before starting. The installer can install MySQL on a cluster node automatically, but you may wish to use a separate node for database storage.

- installation is very simple. A package is supplied which contains all binaries, a setup script and all auxiliary packages required for a full installation.

You should note that internet access by each node is required for an installation to succeed. This is because the packages themselves automatically look for the latest package updates via the internet and Ubuntu host sites.

Installation is a two-part process, firstly involving installation using the package management tool dpkg. This is the standard way of installing software on most Linux distributions.

SF Archive packages are provided as a single file with version number as part of their name. An example of an installation is given below.

sudo dpkg -i sfs-2.3.9.deb 

Once executed dpkg will unpack and install all binaries and other files into the home directory.

The main file of consequence within the home directory is connectionInfo.txt. Most of the information required to run the basic system is already added to this by the installation script setup.sh (detailed in setup below). However, it is worth noting some of the features it contains:

 // Connection to the NxN database server nxConnectionString|"Server=10.10.50.146; Database=SFArchive; uid=sfs; pwd=sfs; SslMode=Required" nxDatabaseName|SFArchive nxNodeName|10.10.50.146

// Licence keys LicenceKey|MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEL3SJPvZKnVZQkqW2j1QQJbdArd QCqEBvNG3OHdH3gzaTgtyp6tiS/ZMhw/Np2KdYS5wfA+iPKMxSY8onGJSk9g==

// This is the home directory where config resides, default /usr/share/SFS homeDirectory|"/usr/share/SFS"

// Set the trace level higher for more details Logging Level|2