Installation flow

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

Prerequisites

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

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 Octane and Best practices for deploying ALM Octane.

Back to top

Configure

  1. Edit the octane.conf file with your site's settings for initial configuration.

  2. (Optional) Depending on your needs, configure optional configuration files:

    • elasticsearch-security.conf to configure secure Elasticsearch.
    • proxy.conf to use a proxy server.
    • ldap.conf to use LDAP authentication.
    • sso.conf to use SSO authentication.

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

For details, see Configure site settings.

Back to top

Start the server

Start the ALM Octane server: 

systemctl start octane

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

Configure cluster (optional)

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

Back to top

Next steps: