Deploy ALM Octane

This section describes how to deploy an RPM file for installing an ALM Octane server.


Installing the ALM Octane RPM package does the following:

  • Creates the correct directory structure.

  • Copies all the files to the right locations.

  • Creates a user and group for running the ALM Octane service that starts the ALM Octane server.

    By default, both the user and group are named octane. However, you can use a pre-defined user instead by defining the following environment variables: OCTANE_USER and OCTANE_GROUP.

  • Installs the octane service so that the operating system recognizes it.

Back to top


Before installing:

Back to top


  1. Download the ALM Octane RPM package:

    Tip: To verify the digital signature of the RPM package, see "Installation Security" in the ALM Octane Secure Deployment and Configuration Guidelines.

  2. Install the ALM Octane RPM package.

    • To install the ALM Octane RPM package in the default installation directory /opt/octane, run:

      rpm -ivh <name of the RPM file>
    • Alternatively, install the ALM Octane RPM package to a different directory:

      rpm -ivh --prefix <base path> <name of the RPM file> 

      Note: If you install RPM to a different directory, make sure to replace "/opt/octane" with the relevant path when following these instructions.

  3. Set up repository access.

    • If the repository is located on a remote, dedicated machine, the ALM Octane server user account must have network access to the remote repository.

    • The repository directory has to be shared so that user performing the installation (generally, the octane user) can write to the repository.

    • Single-node configuration:

      On the ALM Octane server, create a mount directory that points to the file repository directory.

    • Cluster configuration:

      • The repository directory has to be a shared directory visible to all cluster nodes.

      • On each cluster node, create a mount directory that points to the repository directory.

      • It is important that you enter the repository path using the same path name on all nodes. For example, you cannot have the path on the first server node defined as /opt/octane/repo and on additional nodes defined as /server1/opt/octane/repo.

      • If the repository is not located on a remote, dedicated machine, the repository location cannot be /opt/octane.

  4. Verify the required file permissions.

    Default directory Description Permissions

    ALM Octane installation directory and all its sub-directories and files. These files are used for configuring the server.

    Full read, write, and execute
    /opt/octane/log Log file directory. Full read, write, and execute
  5. If planning to install ALM Octane on additional cluster nodes, perform the steps described under Deploy in cluster environment.

Back to top

Deploy in cluster environment

  1. Configure the IP addresses (or fully qualified domain names) of the cluster nodes. Configure the node IP addresses or fully qualified domain names in the octane.conf file. For details, see Configure site settings.

  2. Verify ports are open in your firewall. When deploying ALM Octane over a cluster, ALM Octane needs to communicate between the nodes in the cluster located on port 5701. Therefore, make sure that your firewall enables communication between the nodes of the cluster on the specified port.

Back to top