Software Requirements

The Synthetic Server requires the following software to run and function correctly. You are required to have outbound internet access to install Python, pip, and flake8.

SoftwareRequired VersionFunction
Java17

The Synthetic Server requires JDK 17 to run services such as Synthetic Scheduler and Synthetic Shepherd.

You need to set the environmental variable JAVA_HOME to the home directory of the JDK.

Python2.7+The Synthetic Server relies on Python to validate scripts.
pip9+

Python uses pip to install software. For example, pip could be used on some Linux distributions to install flake8, a Python utility used to lint scripts.

If the machine where you're installing the Synthetic Server does not have Internet access, run the following steps to fetch and install flake8:

  1. From a machine with internet access and pip installed:

    1. Create a directory for the flake8 library:

       mkdir ~/flake8
    2. Download the flake8 package:

      Python 2
      python -m pip download flake8 -d ~/flake8
      Python 3
      python3 -m pip download flake8 -d ~/flake8
    3. Zip and tar the flake8 package:

      tar cvfz flake8.tgz ~/flake8
    4. flake8.tgz to the $HOME directory of the host machine of the Synthetic Server.

  2. From the host of the Synthetic Server that has no internet access, but does have pip installed:
    1. Unzip and extract the flake8.tgz file:

      tar xvfz flake8.tgz ~/flake8
    2. Change to the flake8 directory.

    3. Install the flake8 library with pip with the following command, replacing <version> with the correct version.

      Python 2
      python -m pip install flake8-<version>-py2.py3-none-any.whl -f ./ --no-index
      Python 3
      python3 -m pip install flake8-<version>-py2.py3-none-any.whl -f ./ --no-index
libaioN/A

The Synthetic Server requires the libaio library to be on the system. This library facilitates asynchronous I/O operations on the system.

See How to Install libaio for instructions.

How to Install libaio

Install libaio on the host machine if it does not already have it installed. You may require outbound internet access if you don't have a locally hosted repository.

The following table provides instructions on how to install libaio for some common flavors of the Linux operating system. Note that if you have a NUMA based architecture, you are required to install the numactl package.

Linux FlavorCommand
Red Hat and CentOS

Use yum to install the library, such as:

  • yum install libaio
  • yum install numactl
Fedora

Install the library RPM from the Fedora website:

  • yum install libaio
  • yum install numactl
Ubuntu

Use apt-get, such as:

  • sudo apt-get install libaio1
  • sudo apt-get install numactl
DebianUse a package manager such as APT to install the library (as described for the Ubuntu instructions above).