Start ALM

This task describes how to launch ALM on your machine from your Web browser. You can work with multiple versions of ALM side-by-side on a client machine.

To start ALM:

  1. Browse to your ALM URL:
    http://<ALM server name/IP address>[<:port number>]/qcbin. Contact your system administrator if you do not have the correct URL.

  2. For Single-Sign-On users:

    1. If the user discovery page is displayed, add your user name or email address as specified in ALM. Click Submit.
    2. In the IDP page, add your IDP credentials. Click the log in button.
  3. The Application Lifecycle Management Options window opens.

  4. If you want to open ALM using IE, do the following.

    1. Click the ALM Desktop Client link. Each time ALM is run, it carries out a version check. If it detects a newer version, it downloads the necessary files to your machine.

      Tip: Click the Open in Full Screen mode icon to open ALM in Full Screen mode. Full Screen mode enables you to take advantage of the entire screen when using ALM.

      Keep in mind the following guidelines:

      • If you do not have administrator privileges on your machine, and a Security Warning displays, click Don't Install. You are redirected to the Install screen.
      • If file downloads are prohibited through your browser, you can install these files by using the ALM Client MSI Generator add-in, available from the Application Lifecycle Management Add-ins page (Help > Add-ins).
      • If you run ALM over a virtual environment, such as Citrix or VMware, only the system administrator can install a new version.
      • If files are downloaded, but the Login window does not display, you must install a Microsoft Hotfix on your machine. For details, see this KB article.
    2. Follow the on-screen instructions.

      After the ALM version has been checked and files have been updated if necessary, the ALM Login window opens.

      Note: If ALM was configured for external authentication, the Username and Password fields do not appear in this window.

      User name

      Type your username.

      Not available for Single-Sign-On users.


      Type the password assigned to you by your site administrator.

      Available in 16.0.1 and later: You can click and hold the eye icon () next to your password to show it in plain text.

      Not available for Single-Sign-On users.

      Forgot Password

      If you cannot remember your password, click link to reset your password. For details, see Reset your password

      Not available for Single-Sign-On users.

      Automatically log in to my last domain and project on this machine

      Select check box if you want ALM to automatically log in to the last project in which you were working.

      Not available for Single-Sign-On users.


      Click to verify your user name and password. ALM determines which domains and projects you can access. If you specified automatic login, ALM opens.

      If authentication fails, check that your user name and password are correct and try again.


      • If authentication fails multiple times, you can be locked out of ALM. The number of authentication attempts you are allowed is determined by your site administrator. For details, see Lock out users.

      • Not available for Single-Sign-On users.

      Domain Select a domain. By default, the last domain in which you were working is displayed.

      Select a project. By default, the last project in which you were working is displayed.


      ALM opens and displays the module in which you last worked during your previous session.

      The first time you run ALM, the Welcome page opens.

      When an ALM user session is inactive for a period of time, the session expires. This releases the license in use, making it available for other users. When a session expires, you are prompted to reconnect.

      You can edit reconnect options by modifying the FAST_RECONNECT_MODE parameter in the Site Configuration tab. This parameter is not valid for external authentication, since the user must always be certified when reconnecting. For details, see Set configuration parameters.

    3. To exit and return to the ALM Login window, click Logout in the upper-right corner of the window.

      Alternatively, on the ALM masthead, click <Domain, Project> and select Select to log in to a different project.

  5. If you want to open ALM using ALM Client Launcher, do the following.

Back to top

See also: