Installing StarTeam Server

Before you install the StarTeam Server, make sure you read Pre-installation Requirements for a New Installation. If you are upgrading from a previous release of StarTeam Server, make sure that you also read Upgrading StarTeam.
Note: StarTeam Server comes bundled with a root Message Broker and Micro Focus Connect. When installing the StarTeam Server, these tools will automatically be installed and configured.
  1. Close all applications.
  2. Navigate to the directory that contains the downloaded files.
  3. Run the downloaded installer.
  4. Select a language from the list, and then click OK.
  5. On the Introduction page, read the information, and click Next.
  6. On the License Agreement page, read the agreement. If you agree with the license agreement, click I accept.... If you do not accept the license agreement, you cannot install the product.
  7. Click Next.
  8. On the Choose Install Set page, choose either Typical, Full, or Custom.
    Typical
    Installs StarTeam Server with the most common options. Recommended for most users.
    Full
    Installs StarTeam Server with all required options.
    Custom
    Enables you to choose the options you want to install.
  9. For a custom installation only, select the options you want:
    StarTeam Server
    If you use the custom installation to install something that was not installed during a previous installation of StarTeam Server, you may choose to uncheck this check box. For example, suppose that in a previous custom installation, you elected to bypass the installation of PostgreSQL. To add that database now without reinstalling all of the server program files, you would clear the Server check box.
    PostgreSQL
    PostgreSQL is an open source relational database and is the default database.
    StarTeam Toolbar
    Installs the StarTeam Toolbar which remembers passwords so that logging on is easier.
  10. Click Next.
  11. On the Choose Install Folder page, browse for the location to be used as the installation folder.
    The default location is C:\Program Files\Micro Focus\StarTeam Server <version>.
  12. If you chose the PostgreSQL option, you will see the PostgreSQL Configuration page. Enter the Database superuser password and the Port Number and then click Next. The Message Brokers page opens.
  13. Select which Message Broker that you want to install:

    Install ActiveMQ Message Broker

    Install legacy Smart Sockets Message Broker

    Click Next.

    The Message Broker Options page opens.
  14. If this is the first time that the MPX Event Transmitter and MPX File Transmitter have been installed on this computer, use the this page to make changes to the MPX profiles used by your StarTeam Server configurations. During the first install, the installer creates both MPX Event Transmitter and MPX File Transmitter template files using information about the message broker on this page). These files are stored in a subfolder of the installation folder named EventServices. The local host name and IP address are provided at the top of this page for reference purposes. By default, the Message Broker connection address uses your local computer's IP address. To specify a different Message Broker for MPX Event Transmitter (and any clients that will use the default profile), change the proposed Message Broker connection address.
    Host name
    The host name on which the Message Broker operates.
    IP address
    The IP address on which the Message Broker operates.
    Port
    The TCP/IP port number (endpoint) with which the Message Broker accepts connections:
    • Default for ActiveMQ MPX is 61616.
    • Default for StarTeamMPX is 5101.
    Important: When installing to a computer that has more than one NIC or multiple IP addresses, do not accept the default server address settings. You must manually enter the correct server IP address. When the installer detects multiple network addresses on the host computer, it sets up default profiles that contain a server-address property whose syntax is invalid because it contains multiple addresses.
    Note: You can enter the connection information for more than one Message Broker. In the event that the MPX Event Transmitter (or a client using the default profile) is unable to connect with the first Message Broker in the list, it will attempt to connect with the next Message Broker listed. Separate the address for each Message Broker with a comma (,). For example: tcp:HostA:61616,tcp:HostB:61616
    Note: MPX Event Transmitter must be manually edited for any changes with IPV6 networks. The IPV6 address must be closed in brackets.
    Note: StarTeam installer of ActiveMQ MPX pulls the localhost IP addresses for a Windows 2012 R2 OS, if the OS has a static IPV 6 address and the hostname is not able to be resolve by DNS. Edit the ActiveMQ MPX configuration file to enter the correct IP address.
  15. Click Next.
  16. On the Choose Shortcut Folder page, use the default setting (that is, keep the Other option button set to C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Micro Focus\StarTeam Server <version>).
  17. On the Pre-installation Summary page, review the settings and click Previous one or more times if you want to change the installation options. Then return to the Pre-installation Summary page, and click Next or Install.
  18. On the Install Complete page, click Done.
  19. After you finish installing StarTeam Server, ensure that the permissions on the StarTeam Server installation folder and files are set correctly. The Microsoft Windows account for the StarTeam administrator must have full permissions on the installation folder and files. Set the Microsoft Windows permissions for all other StarTeam users in accordance with your company policy. See your network administrator if you need assistance. If you use the default location, installing StarTeam Server places files in the following folders under your Program Files folder:
    Micro Focus\Server <version>
    This folder and its subfolders contains the executables, DLLs, and utilities used to run StarTeam Server. This folder also contains the StarTeam_Server_<version>_InstallLog.log file, which documents what happened during the installation process.
    Micro Focus\Server <version>\EventServices
    This folder contains the MPX Event Transmitter and MPX File Transmitter template files. It has a subfolder for each existing server configuration. Inside those subfolders are the MPXEventTransmitter.xml and FileTransmitter.xml files that will be used by the server configurations. If you have an Enterprise server, you may want to delete the FileTransmitterTemplate.xml and FileTransmitter.xml files. The file transmitter is part of Enterprise Advantage only.
Parent topic: StarTeam Server for Microsoft Windows Installation