Log on to and off a server

This topic describes how to log on and off a StarTeam server and how to open a project.

Log on to StarTeam server and create or open a project

Before you can create a new project or open an existing project, you must select a server configuration for the project and log on.

To log onto the server and open a project:

  1. Click Start > Programs > Micro Focus > StarTeam Cross-Platform Client <version> on Windows or on Linux, open the Console, navigate to the extraction folder starteam-<language>-<version>-java/bin, and type ./StarteamCPC.
  2. Choose Project > New or Project > Open.

    The Log On to [server_name] dialog box opens.

  3. Type the User Name and Password in the appropriate fields.

    Note: Passwords are case sensitive and may have length restrictions.

  4. Check Save As Default Credentials For This Server to save your default credentials for this server configuration as this user name and password. This name will then appear in parentheses after the server configuration name in lists.

    The New Project Wizard or the Open Project Wizard displays allowing you to create a new project or work on an existing project.

Note: StarTeam user credentials are stored in Windows Credential Manager Store.  You can edit and remove the credentials from Control Panel > Credential Manager.

Back to top

Log on as a different user

Before you can create a new project or open an existing project, you must select a server configuration for the project and log on.

To log on as a different user:

  1. Click Start > Programs > Micro Focus > StarTeam Cross-Platform Client <version> on Windows or on Linux, open the Console, navigate to the extraction folder starteam-<language>-<version>-java/bin, and type ./StarteamCPC.
  2. Choose Project >New or Project > Open.
  3. Click the Log On As button.

    The Log On to [server_name] dialog box opens.

  4. Type the User Name and Password in the appropriate fields.

    Note: Passwords are case sensitive and may have length restrictions.

  5. Check Save As Default Credentials For This Server to save your default credentials for this server configuration as this user name and password. This name will then appear in parentheses after the server configuration name in lists.
  6. Click OK.

Back to top

Log off

To log off a StarTeam Server:

  1. Switch the StarTeam client window to a project view on the StarTeam Server of which you want to log off.

  2. Click File > Log Off.

    A confirmation dialog box opens asking if you want to completely log off this StarTeam Server.

  3. Click Yes to continue.

    StarTeam closes all the views on this StarTeam Server that you have logged into during this StarTeam session.

Back to top

Log on using SSO / Multi-Factor authentication

This section describes how to log on to the StarTeam server using single sign-on (SSO) or Multi-Factor authentication. If Single Sign-on/Multi-Factor authentication was enabled in the StarTeam server configuration to which you are trying to connect, the client will automatically display the SSO authentication page.

To log in using SSO/MF authentication:

  1. Click Start > Programs > Micro Focus > StarTeam Cross-Platform Client <version> on Windows or on Linux. Open the console, navigate to the extraction folder starteam-<language>-<version>-java/bin, and type ./StarteamCPC.
  2. Select Project > New or Project > Open. You are automatically redirected to a default system browser for single sign-on/multi-factor authentication.
  3. Complete the first and second factor authentication (as configured on the StarTeam server). You will then be redirected back to the StarTeam Cross platform client. The login to StarTeam server is complete and the user now has access to all the projects on the server.

Once logged in using SSO, the session remains active as long as the browser window instance is open, so there is no need to re-authenticate until the session times out. The default value of SSO session timeout is 1 hour. This value can be configured using the StarTeam server administration tool.

Note: Session cookies must be enabled on the web browser and be allowed to be saved.

To disable Single sign-on authentication, select the Disable Single Sign-on authentication check box in the server properties in the StarTeam Cross Platform client. This allows logins via the standard password-based authentication.

Back to top

Login troubleshooting

The following error messages may display following an attempted login:

This error means the user is trying to make a secure connection over TLS and the hostname the user is trying to connect is not valid when compared to the TLS certificate of the server. Contact your server administrator to add hostname/ip address to the Subject alternate names in the TLS certificate on the server. A server restart is required.

The TLS certificate on the server has been revoked by the Certificate authority and can no longer be used to successfully connect to the StarTeam server. Contact your server administrator to replace the server TLS certificate. A server restart is required.

The TLS certificate on the server has expired and can no longer be used to successfully connect to the StarTeam server. Contact your server administrator to replace the expired server TLS certificate with an active one.

TLS certificate on the server is configured incorrectly or the chain of certificates is incomplete.

Contact your server administrator to fix the certificate and restart the server.

Back to top