Jama Connect User Guide

Install the Admin Console (internet)

The Admin Console (Replicated) is the interface used to install the Jama Connect application and Docker. You can use the Replicated installation script to install the latest supported version of Docker and Replicated. 

Important considerations

  • During installation, the application server must have access to the internet, including the Replicated listed domains.

  • The Admin Console isn't compatible with Internet Explorer.

  • If you receive a warning that Docker is using the devicemapper storage driver, cancel the installation and configure Docker to use the overlay2 storage driver.

  • The Release Notes might include the unique cURL command for your version of Jama Connect.

  • The supported software page in the Community specifies which versions were used during regression testing of the version of Jama Connect you want to install.

To install the Admin Console:

  1. Connect to the command shell of the application server using SSH.

  2. As root user or a user with sudo bash privileges, download and install the Admin Console using one of these methods:

    • Use the cURL command from the Release Notes.

    • Download and install a specific version of the Admin Console with this command:

      curl -sSL "https://get.jamasoftware.com/docker?replicated_tag=<REPLICATED_VERSION>"| sudo bash -s no-auto
  3. Replace <REPLICATED_VERSION> with the Replicated versions recommended in the Release Notes for your version of Jama Connect. For example:

    curl -sSL "https://get.jamasoftware.com/docker?replicated_tag=2.38.1" | sudo bash -s no-auto

    If the cURL command displays the following message, the Admin Console must be installed manually.

    Either your platform is not easily detectable, is not 
    supported by this installer script, or does not yet have 
    a package for Replicated.Please visit the following URL 
    for more detailed installation instructions:
    
    https://www.replicated.com/docs/distributing-an-application/installing/

    Note

    The no-auto option is only used to make sure that questions during the installation don't time out (default timeout setting is 20 seconds).

  4. Follow the installation prompts, then you can leave the installation unattended.

    Important

    The prompts are displayed for 20 seconds unless you chose the no-auto option. If you skip the step to choose an IP address, the URL that you see at the end of this step doesn’t work. You must run the cURL command again and select an IP address.

    Please choose one of the following network interfaces:
    
    [0] eth0 10.0.2.15
    [1] eth1 172.28.128.3
    [2] docker0 172.17.0.1
    Enter desired number (0-2):
    • Enter the number (0–2) of the network used to access Jama Connect (your DNS entry also routes to this network). The same network is used to access the Admin Console and the Jama Connect application.

       Does this machine require a proxy to access the Internet?
       (y/N)
    • If using a proxy, enter Y and input the proxy information. If your server is set up to use a proxy, the user environment auto-detects that configuration and asks if you want the installer to configure the proxy for you.

    • When prompted for a service IP address, leave it blank and press Enter.

    When the installation is complete, you see the following message:

    ==> default: To continue the installation,
    visit the following URL in your browser:
    https://<your_ip_address>:8800
  5. Take note of the URL of the Admin Console; you will need it when you configure Replicated settings.

  6. In the /data directory, create a custom Replicated snapshots folder and change the ownership to the replicated user with the following command. Later you can configure the Admin Console to store snapshots there. 

  7. Change the ownership of the folder to the Replicated user with this command:

    mkdir -p /data/replicated/{snapshots,statsd,support-bundle}
    chown -R replicated /data/replicated

    After changing ownership to Replicated with the command, the permissions look something like this:

    # ll /data/replicated/
    total 20
    drwxr-xr-x 5 replicated root 4096 Oct 21 21:27 ./
    drwxrwxrwx 10 root root 4096 Nov 7 18:48 ../
    drwxr-xr-x 5 replicated root 4096 Oct 21 21:29 snapshots/
    drwxr-xr-x 6 replicated docker 4096 Oct 21 22:11 statsd/
    drwxr-xr-x 2 replicated root 4096 Oct 21 21:27 support-bundle/

Later you can configure the Admin Console to store snapshots in the Replicated snapshots folder.