Installation flow

This document describes the overall flow for installing the ALM Octane server on Linux.


Verify your system meets hardware and software requirements.

This includes setting up permissions, opening ports, database configuration, and more.

You need three separate server machines. 

  • ALM Octane server

  • Database server

  • Elasticsearch server

For details, see Prerequisites and Best practices.

Note: We recommend you review security considerations in the knowledge base article KM02707977. This article contains Instructions on how to set up a secure configuration for ALM Octane.

Back to top


Deploy ALM Octane on a machine dedicated for the ALM Octane server on Linux.

ALM Octane is deployed using the RPM Package Manager (as an .rpm file).

The deployment path is /opt/octane.

The command to deploy is: rpm -Uvh <name of the RPM file>

For details, see Deploy ALM Octaneand Best practices for deploying ALM Octane.

Back to top


Configure ALM Octane by editing these files with your site's settings: 

  • setup.xml for initial configuration
  • octane.yml for ongoing configuration

The path to these files is /opt/octane/conf.

For details, see Configure initial site settings and Configure other settings.

Back to top

Start the server

Start the ALM Octane server: 

service octane start 

For details, see Start the ALM Octane server.

Back to top

Log in

Verify that ALM Octane was properly installed. For details, see Checking logs.

Log into ALM Octane. For details, see Log in to ALM Octane.

Back to top

Cluster configuration (optional)

After starting the server on the first machine, configure and initialize each additional cluster node. For details, see Cluster installation (optional).

Back to top

See also: