Install using a Docker image

This section describes how to install OpenText Software Delivery Management using a Docker image.

1. Download and install the latest version of Docker:

2. In the Docker Hub, search for Octane.

3. Select lifecyclemanagement/octane. The description should say: The official repository for ALM Octane.

4. Select Tags.

5. Choose the version you want to install, and copy the download command.

   Note: The list you see includes both SaaS versions and on-premises versions of OpenText Software Delivery Management, but only on-premises versions are supported. Select an on-premises version now.

6. Execute the copied command.

7. Run the Docker image:

   Linux

   Run the following command:

   docker run -d \
   -p 8080:8080 \
   -p 8443:8443 \
   -v /opt/octane_docker/conf:/opt/octane/conf \
   -v /opt/octane_docker/log:/opt/octane/log \
   -v /opt/octane_docker/repo:/opt/octane/repo \
   --name alm_octane \
   --network host \
   lifecyclemanagement/octane:onprem

   Note: This command includes the following:

   -d - Run container in background and print container ID.
   -v - Bind mount a volume (local_path:path_in_container).
   -p - Publish a container's port(s) to the host (local_port:port_in_container).
   --name - Container name
   --network - Network mode for the container

   Windows

   1. In Docker Desktop, select Images.

   2. Locate the OpenText Software Delivery Management version you want to install. To configure the container, click Run.

   3. Open the Optional Settings, and enter the following:

      • In Container name, enter a name of your choice.

      • In Ports, enter 8080 to use HTTP, or 8443 to use HTTPS.

      • In Volumes, enter the following:

        Host path	Container path
        C:\OctaneDocker\conf	opt/octane/conf
        C:\OctaneDocker\log	opt/octane/log
        C:\OctaneDocker\repo	opt/octane/repo

   4. Click Run to run the Docker image for the first time.

   The first run fails with errors, because OpenText Software Delivery Management has not yet been configured.

8. Open the octane.conf file located in:

   • Linux: /opt/octane_docker/repo/conf-discover/octane.conf
   • Windows: C:\OctaneDocker\repo\conf-discover

9. Configure OpenText Software Delivery Management as described in Configure site settings.

   Note: If you want to use resources from your local machine instead of localhost, use host.docker.internal.

10. When you are done, run the container:

    • Linux: docker start alm_octane (using the name defined in step 7)
    • Windows: Run the container from Containers/Apps.

11. Check for errors in the wrapper.log and octane.log files in the log folder:

    • Linux: /opt/octane_docker/log
    • Windows: C:\OctaneDocker\log

12. OpenText Software Delivery Management is now ready to use.