Requirements

Hardware

OKA should be installed on a virtual machine or physical server separated from the main cluster frontend node. Minimal hardware requirements are:

• CPU: 4 cores

• Memory: 8GB

• Disk space: at least 8GB of free disk space (not including the space for databases, see below)

In case OKA is configured to use a local Elasticsearch and/or memcached then it is recommended to use between 32 and 64GB of RAM.

System

• Operating Systems: Amazon Linux 2/2023, Debian 11, RHEL 7/8, Rocky Linux 8/9

• A user account, different from the root account to run OKA (e.g., okauser)

Software Requirements

The following table lists all the software dependencies needed by OKA:

Software	Version	Mandatory
Elasticsearch	>= 7.14 <= 7.17	Yes
PostgreSQL	>= 12 <= 15	Yes
Python	== 3.9	Yes
RabbitMQ	>= 3.0.0	Yes
PipEnv	>= 2023.9.1	Yes
NGINX	>= 1.20	Yes
sudo		Yes, if running installer as root
[envsubst]		Yes
Memcached	>= 1.6.6	Optional

[envsubst]

Part of gettext or gettext-base package

Note

Each dependency must be installed carefully in agreement with their minimum system requirements. The following pages also provides information on hardware requirements scaling with the use of OKA, and will guide you through the installation of all dependencies needed to run OKA in production.

• Elasticsearch
  • Hardware requirements
  • Installation
  • HowTo
• NGINX
  • Installation
  • How to configure HTTP or HTTPS to serve OKA
• Postgresql
  • Hardware requirements
  • Installation
  • HowTo
  • Setting up
• Python and PipEnv
  • Installation
• RabbitMQ
  • Hardware requirements
  • Installation
  • HowTo

Job Scheduler

OKA needs to have access to a job scheduler to retrieve its accounting logs

OKA supports the following job schedulers:

Name	Version	Notes
SLURM™	14.11.6 to 21.08	SLURM™ binaries must be accessible from the PATH SLURM™ SlurmDBD server must be reachable from the server where OKA will run the extraction commands. Accounting must be turned on with SlurmDBD: AccountingStorageType must be set to accounting_storage/slurmdbd, JobAcctGatherType must be set to jobacct_gather/linux [slurm] (see *https://slurm.schedmd.com/accounting.html* for more details)
Open Grid Engine (GE) Univa® Grid Engine® (UGE)	GE 6.0u6 to 2011.11 UGE 8.5.4 to 8.6.15	OKA relies on the accounting file of Grid Engine. This file only exists if accounting is turned on (accounting=true in the reporting_params configuration option). This file must be readable from the server where OKA will run its commands (default $SGE_ROOT/$CELL/common/accounting)
Altair® PBS Professional® OpenPBS	19.2 or 2022.1.0 19.1.3 to 22.05.11	The PBS Professional® logging directory must be readable from the server where OKA will run its commands (default directory is <PBS_HOME>/server_priv/accounting/).
Torque	5.0 to 6.1.3	The Torque logging directory must be readable from the server where OKA will run its commands (e.g., <TORQUEROOT>/server_priv/accounting/).
LSF	9 and 10	The LSF lsb.acct files must be readable from the server where OKA will run its commands (e.g., <LSB_SHAREDIR>/cluster_name/logdir)
OpenLava	2	The OpenLava lsb.acct files must be readable from the server where OKA will run its commands (e.g., <LSB_SHAREDIR>/cluster_name/logdir)

Note: OKA can either access job scheduler logs directly on the server where it is running, or through SSH commands. In this latter case, OKA must be allowed to do a passwordless SSH to the server where the job scheduler commands/log files are accessible.

[slurm]

jobacct_gather/cgroup does not gather correctly memory usage in SLURM™ version lower than 17.02

Web browser

OKA functionalities are accessible through most popular modern browsers. Generally speaking, OKA supports the latest versions of each major platform’s (Linux®, Apple® Mac® OS X®, and Microsoft® Windows®) default browsers (Google™ Chrome™, Mozilla Firefox®, Apple® Safari®, Microsoft® Edge®).

Requirements:

• JavaScript® must be enabled on browsers.

• The width of the page must at least 1280px.