Installing StarTeam Server on Windows

This topic describes the installation process for a StarTeam Server installation on Windows.

Run the setup

This section guides you through the setup process. If you are upgrading from a previous release of StarTeam Server, see Upgrade 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, select only 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 clear 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:

    1. Install ActiveMQ Message Broker
    2. 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.

    Follow these guidelines:

    • 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
    • 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
    • MPX Event Transmitter must be manually edited for any changes with IPV6 networks. The IPV6 address must be closed in brackets.
    • 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 cannot be resolved by DNS. Edit the ActiveMQ MPX configuration file and enter the correct IP address.

  15. Click Next.

  16. Use the default setting and 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.

Back to top

Configure Tomcat

During the installation of the StarTeam Server, Apache Tomcat is installed. The default port number is 9090. If you need to change this value, you will also have to change a few configuration files to keep the services synchronized.

To configure Tomcat:

  1. Open the Microsoft Windows Component Services window.
  2. Stop the StarTeam Web Service.
  3. Navigate to the conf folder in the Apache Tomcat installation directory ( C:\Program Files\Micro Focus\StarTeam Server <version #>\WebServer\conf).
  4. Open server.xml for editing. Look for the following element: 
    <Connector connectionTimeout="20000" port="9090" protocol="HTTP/1.1" redirectPort="8443"/>
  5. Change port="9090" to the new value.
  6. Save and close the file.
  7. Open the starteam-server-configs.xml file found in C:\Program Files\Micro Focus\StarTeam Server <version #>.
  8. For each configuration that uses search, locate the following item: RESTServicePort. If the option is not there, add it: <option name="RESTServicePort" value="9090"/
  9. Change the value from 9090 to the new value that will match the Apache Tomcat value.
  10. Save the starteam-server-configs.xml.
  11. Restart each server configuration.

Back to top

Post-Installation tasks for a new installation

If you have not installed StarTeam Server previously, you must perform the following tasks before team members can begin using StarTeam.

  1. Create a server configuration using the Server Administration tool. For details about creating a server configuration, see the section about your database type:

    When you create a StarTeam Server configuration, you set values for the configuration’s session options, which are stored in the starteam-server-configs.xml file. Session options specify the core information that StarTeam Server requires to start a server configuration.

    Note: See Loading Server Configuration Sample Data to create a new sample configuration.

  2. Log on to that configuration using the Server Administration tool. StarTeam Server comes with a free administrative user, named StarTeam Server Administrator. That user has the default logon name Administrator and the default password Administrator.
  3. Configure the server using the Server Administration tool tool and, for some options, by editing the file starteam-server-configs.xml.

    After StarTeam Server configuration is created, you can set configuration options, which are stored in the database for the StarTeam Server configuration. Configuration options enable you to fine-tune StarTeam Server configuration performance and enable the use of several features, such as:

    • Email and audit features
    • Compression and encrypting of data that is transferred between the server and client workstations
  4. Add users and groups using the Server Administration tool.
  5. Create projects and views using the StarTeam Cross-Platform Client.
  6. Set the appropriate access rights for the server configuration, projects, and views using the Server Administration tool and the StarTeam Cross-Platform Client.
  7. If desired, you can run the server configuration as a Microsoft Windows service using the Server Administration tool.

Back to top

Loading Server Configuration Sample Data

  1. Create a new server configuration.
  2. To start the StarTeam Server, select the newly created configuration from the list of servers and click Actions > Start Server.

    Tip: The server configuration must be empty (no existing projects) in order to load the samples.

  3. After the StarTeam Server has started and is running, select the server in the list of servers and click Actions > Load Samples.
  4. Click Yes to load the sample data. You may be prompted to log on to the server. The Loading Samples dialog box displays showing the progress of the download. The download may take several minutes.
  5. Users can now connect to this new server and access the sample data from within the StarTeam Cross-Platform Client. The sample data is installed in C:\Program Files\Micro Focus\StarTeam Server <version>\Samples.

Back to top