How to install ARD Hub for Docker Offline
search cancel

How to install ARD Hub for Docker Offline

book

Article ID: 269660

calendar_today

Updated On:

Products

CA Agile Requirements Designer

Issue/Introduction

Our server that we want to use to install ARD Hub does not have Internet access.

How do we install ARD Hub offline, since we are unable to pull the Docker images from Broadcom for that machine?

Environment

Release : ARD Hub 3.2.x and ARD Hub 3.3.x

Cause

In order to pull the required images, you will need to use another Linux system that has Internet access to download the required images. Then move a copy of the images to the system, where you wish to run the installation. If you do not have a Linux system, with Internet access, please open a support case, and request a copy of the Docker images from support. Please provide the exact version of ARD Hub you are needing for the installation.

Resolution

Requirements:

  • Verify the ARD Hub installation requirements, such as Docker 19.03.12 and Docker Compose 1.26.2, are preinstalled on the Server where the ARD Hub is to be installed.
    For more information, see ARD Installation Requirements.

  • Verify you have sudo permissions to run the ard.sh script and docker, dockerd, docker-compose, and other Linux commands listed on the ARD Installation Requirements page.

  • Verify the service account has sudo permissions to start the Docker container.

  • You will need a Linux system, with Docker installed, and an internet connection to download Docker images online, as well as the ability to transfer the images to the offline server, so you can import the Docker images manually into an offline Docker repository.

Pre-installation Steps:

These steps need to be performed on the Linux system that has Internet access.

  1. Download the ARD Hub installation media from the Broadcom Support Portal (https://support.broadcom.com).

    For Example:
         'CA Agile Requirements Designer Hub 3.2.7 - Docker Launcher.zip'
         'CA Agile Requirements Designer Hub 3.3 - Docker Launcher.zip'

  2. Place the file in the folder of your choice.

    Note: The file is a zip file. The Linux system will need to have the zip and unzip packages installed. You may need to have your Linux Admin help you with this. 
  3. If you are upgrading a previous ARD Hub installation, it's recommended to take a backup of the MySQL database before upgrading ARD Hub. If you do not know how to back up the MySQL database files, open a support case and request a copy of the hub-db-backup.sh script.
    1. Place a copy of the script in a directory that sudo access has been granted

    2. Execute the script by running: sudo ./hub-db-backup.sh

    3. The script will create the backup file in the same directory where it was executed from. The file name will be backup-DATE-TIME.sql
              NOTE: you may want to rename the backup file to backup_3.2.7-DATE-TIME.sql, just so you know what version the backup file is from.

Download the required Docker images:

  1. From the Broadcom Support Portal (https://support.broadcom.com) save a copy of the export 'Token' command and the export 'customer_name' command.
    You will need to run these commands before running the ard.sh script. These commands export temporary user variables used by the ard.sh installation script to pull the ARD images.

    Note: The token is only valid for 2 hours, so do not do this until you are ready to perform pull the required images.
    1. Log into https://support.broadcom.com

    2. Select Enterprise Software


    3. Select "My Downloads" > "Agile Requirements Designer"


    4. Expand the Product SKU that your site has access to. Your choices could be different from the example used.

    5. Click the Docker icon that correlates to ARD release that you want to use. In this example, we are using ARD 3.2.7.


    6. Copy the provided custom commands and paste them into a terminal window. Run the custom commands to initialize temporary local environment variables:
           export token='your token'
           export customer_name='your name'

  2. Change directories to the location where the 'CA Agile Requirements Designer Hub <version> - Docker Launcher.zip' file was placed and unzipped the file.

  3.  

    Run the following commands to pull and save the required docker images. If you use sudo, run ard.sh as sudo -E ard.sh to preserve the user's environment variables.

    Note: the following table contains a list of supported component versions, that you will need to refer to, depending on the release of ARD Hub you are working with:

    ARD Version

    percona Version

    Keycloak Version

    traefik Version

    ard/aux TAG

    ard/hub TAG

    3.2

    ps-5.7

    13.0.1

    1.7.12-alpine

    3.2.269

    3.2.269

    3.2.5

    ps-5.7

    15.1.1

    1.7.12-alpine

    3.2.5.293

    3.2.5.293

    3.2.7

    ps-5.7

    16.0.0

    1.7.12-alpine

    3.2.7.362

    3.2.7.362

    3.3

    ps-8.0.29-21

    20.0.5

    2.9.6

    3.3.467

    3.3.467

    3.3.1

    ps-8.0.29-21

    20.0.5

    2.9.6

    3.3.1.488

    3.3.1.488

     

    NOTE: if you are needing to pull the images for ARD 3.3.x, please contact Broadcom Support, and let the Support team know that you need the keycloak 20.0.5 image. You will not be able to pull this image from Broadcom, and Support will need to provide you with a copy.

     

    • sudo –E ./ard.sh –get-files
    • sudo docker pull percona:<version>
    • sudo docker pull quay.io/keycloak/keycloak:<version>
    • sudo docker pull traefik:<version>
    • sudo docker image save –o percona.<version>.tar percona:<version>
    • sudo docker image save –o keycloak.<version>.tar quay.io/keycloak/keycloak:<version>
    • sudo docker image save –o ard_aux.tar ard/aux:<TAG>
    • sudo docker image save –o ard_hub.tar ard/hub:<TAG>
    • sudo docker image save –o traefik.<version>.tar traefik:<version>

      Where you are replacing <version> and <TAG> with the appropriate release in the table above.

  4. Verify that you have downloaded the following tar files:
    • percona.<version>.tar
    • keycloak.<version>.tar
    • traefik.<version>.tar
    • ard_aux.tar
    • ard_hub.tar

Load the images in the Offline Docker registry:

  1. Move the tar files to the system without Internet access. The system where you want to install ARD Hub.

  2. Run the following commands on the system without Internet access to import the images into the local Docker registry:
    • sudo docker image load -i percona.<version>.tar
    • sudo docker image load -i keycloak.<version>.tar
    • sudo docker image load -i traefik.<version>.tar
    • sudo docker image load -i ard_aux.tar
    • sudo docker image load -i ard_hub.tar
  3. Replace the keyword TAG by running the following commands to set the appropriate tag version for ard/aux and ard/hub.

    sudo docker tag SOURCE_IMAGE:[TAG] TARGET_IMAGE:[TAG]

    Note: You can use the provided table in this KB as a reference. However, to verify the appropriate TAG version, open the ard.sh file in a word editor, and check the third line: HUB_VERSION=3.x.x

    For example:
    • sudo docker tag ard/aux:3.2.7.362 ard/aux:3.2.7.362
    • sudo docker tag ard/hub:3.2.7.362 ard/hub:3.2.7.362


Install the ARD Hub using the Offline Repository:

  1. To install the ARD Hub on the system without Internet access, run the ard.sh script using the following options:
    • sudo ./ard.sh --hostname <hub_server.mydomain.com> --port 8080 --jvm-heap-max-size 8192 --offline

      Where:

      --hostname is used to set the hostname of the server hosting the ARD Hub
      --port sets the communication port used to connect to the ARD HUB (default is 8080)
      --jvm-heap-maz-size sets the maximum amount of memory (in MB) allocated to the JVM used by ARD HUB (this is an optional setting and can be adjusted as needed for your installation)
      --offline tells ard.sh to use the local docker repository and not to pull the images from Broadcom.

  2. Wait for the installation to complete. 

    The installer installs Docker images, creates configuration files, and proceeds with the ARD Hub installation. The installer creates a /var/ard/application-data/.ard directory, which contains configuration files.
    When the script completes, it prints the URL of the ARD web interface.

    Example: http://hub_server.mycompany.com:8080/ard/ui

  3. If you are a customer using the PLA license, configure your pla.properties file now. For more information, see Configure the License.

  4. Open your web browser and verify that you can log into the ARD web interface with the admin password.
    By default, the admin password is admin
  •  

 

 

Additional Information

Now that you have installed ARD Hub and the web interface, add users to the Hub by configuring the LDAP connection, so users can log in using their existing Active Directory accounts.

 For more information regarding the ARD Hub Installation, see https://techdocs.broadcom.com/us/en/ca-enterprise-software/devops/agile-requirements-designer/3-3/installing/install-ard-hub/install-ard-hub-using-docker.html

 

For steps to upgrade ARD Hub (Online Method), see https://knowledge.broadcom.com/external/article?articleId=265355