Installing the Atlas Planning and Tracking Suite

The following steps describe how to install the Atlas Planning and Tracking Suite. The suite includes Atlas, Micro Focus Connect, Rhythm, and Atlas Hub. These applications will all be installed together.
Tip: If you want to install the Atlas Hub on a separate server, you should plan to do that first. Go to that server, run the installer and select the Atlas Hub option on the Choose Install Set screen. Complete that installation. Then, on the server for the web applications, choose the Atlas Planning and Tracking Suite option, during the installation, you will be asked to point to an existing Atlas Hub, the one that you just set up.
Important: When upgrading from StarTeam Agile to Rhythm, it is necessary to migrate Target Releases from the StarTeam Agile Release Views to the Rhythm Releases. This migration is accomplished by running the below command using the StarTeam 16.0 SDK that is installed with the Atlas Hub:
stcmd target-releases -p "user:password@host:port/project name/"

Running this command will create new Releases in Rhythm that match the Target Releases in StarTeam Agile. All Stories and Sprints that have a Release value set will also be updated.

If you run the migration command after assigning Release values in Rhythm, then those assignments will be removed as the purpose of the migration is to match up the Target Release data in StarTeam Agile with Rhythm.

Note: The base installation no longer configures StarTeam Agile to run. If you want to continue to use StarTeam Agile, you must remove the _deprecated from the .WAR_deprecated StarTeam Agile file.
Important: Unless you are upgrading from Atlas Planning and Tracking Suite 2.0, if you have any other version of Atlas, Rhythm, Micro Focus Connect, or the Atlas Hub installed, you must uninstall them before proceeding. If you are a current Micro Focus Connect customer and you want to maintain your mappings, you must retain a copy of Connect.xml before uninstalling. Afer installation, you can check your original Connect.xml file back into the StarFlow Extensions/Connect folder.
Important: We recommend backing up the Atlas Hub installation directory in order to preserve your configuration files.
  1. Run the installer.
    Note: During an upgrade from a previous version, the Atlas Planning and Tracking Suite installer expects valid license keys. The Atlas Hub will fail to start if license keys are invalid.
  2. Read the introduction and click Next on the Introduction screen.
  3. Read the license agreement, select the option to accept the license agreement and click Next. The Choose Install Set screen appears. This is where you will be able to install either all of the applications or just install a new Atlas Hub.
  4. To install all of the web applications, choose the Atlas Planning And Tracking Suite option to install Atlas, Rhythm, Micro Focus Connect, and optionally, Atlas Hub. Click Next.
    1. Select where you want the files installed on the Choose Install Folder screen. Do not click Next until you read the following:
      Important: The next part of the installation is where you choose the location. lf you are upgrading, you need to make sure that you select the existing directory where the previous version was installed. If you used the default, you don't need to do anything in the next step because it is selected for you. However, if you chose a different location, you must browse to that folder and select it for the upgrade.

      If you are upgrading, you will receive an Upgrade Required message. Click OK and walk through the upgrade screens. Your upgrade will complete, and you are finished with the installation!

      If you are not upgrading, click Next. The Atlas Hub Connection screen appears.

      To connect to an existing Atlas Hub:
      1. Select Connect to existing Atlas Hub.
      2. Click Next. The Atlas Hub Parameters screen appears.
      3. Enter the Atlas Hub connection information:
        Atlas Hub Host Name or IP Address
        The IP address of an existing Atlas Hub installation.
        Important: When specifying the address and port for Atlas Hub in either the installation wizard or directly in the ALMConfiguration.xml file, you must use the actual IP address (or machine name) of the Atlas Hub. Do not use "localhost" even when Micro Focus Connect and the Atlas Hub are running on the same machine.
        Configuration Name
        The configuration name of an existing Atlas Hub installation.
        Configuration GUID
        The configuration GUID of an existing Atlas Hub installation.
        Configuration Port
        The configuration port of an existing Atlas Hub installation.
        User Name
        The user name of an existing Atlas Hub installation.
        Password
        The user's password of an existing Atlas Hub installation.
      4. Click Next.
      To install a new Atlas Hub:
      1. Select Install new Atlas Hub.
      2. Click Next. The New Atlas Hub screen opens.
      3. Enter a Configuration Name for the new Atlas Hub.
      4. If you already have a license key, select the I have a license key option.
      5. Enter the license details.
      6. Click Next.
  5. To install the Atlas Hub only, choose the Atlas Hub option on the Choose Install Set screen.
    Tip: After installation, if something goes wrong or a file is damaged or corrupted, you can attempt to repair the install by running this installer again
    If you are upgrading, you need to:
    1. Stop all Atlas Hub server configurations using the Atlas Hub Admin Tool.
    2. Close the Atlas Hub Admin Tool.
    3. On the installer screen, click Next.
    4. Click Install. The installer will install all upgrade files.

    You are finished upgrading the Atlas Hub!

    If you are not upgrading, click Next.
    1. Select the Message Broker option to install the Message Broker.
    2. Select the PostgreSQL option to install a PostgreSQL database.
    3. Click Next.
    4. If you are installing a message broker, the Message Broker Options screen opens. Enter the port number on which the broker will listen.
    5. If you are installing PostgreSQL, the PostgreSQL Configuration screen opens. Enter the password for the database superuser. Note that the username is postgres.
    6. Click Next.
    The Choose Shortcut Folder screen opens.
  6. Select the shortcut folders and click Next. The Pre-Installation Summary screen opens.
  7. Review the information and click Install.