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.

Please note all of the following before continuing with your installation:

Important: The installation package must be installed on an English language operating system.

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.
If you have Atlas Planning and Tracking Suite 2.0 or greater installed, you do not need to uninstall before your upgrade. Please note the following:
- Upgrading Atlas Planning and Tracking Suite to the latest version involves upgrading the Atlas Hub as well. A valid license key is required during the install process.
- The current option to perform a Hub Only Upgrade on top of Atlas Planning and Tracking Suite 2.0 is not supported.
- If you are a current Micro Focus Connect customer, your version of Connect.xml will automatically be saved for you during an upgrade. It is available in the <APTS install path>\MicroFocusConnect\AppData\data directory. Backup versions of this file are available in \AppData\backup.
We recommend backing up the Atlas Hub installation directory in order to preserve your configuration files.
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.x SDK that is installed with the Atlas Hub:
```
stcmd rhythm-conversion -p "user:password@host:port/project name/"
```
Running this command will do the following:
- 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.
- Each Story in the Project will receive updated values on the Rank and Order fields which are compatible with the Rhythm UI. The overall Rank and Order of the Stories in the Project Backlog will be retained and all new Story revisions will have a "Rhythm Conversion" comment.

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.
Read the introduction and click Next on the Introduction screen.
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.
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. 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.
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.
Select the shortcut folders and click Next. The Pre-Installation Summary screen opens.
Review the information and click Install.