Post-installation configuration steps

After running the installation and Configuration wizard, you must perform additional configuration steps in Administration before you can use the product.

Configure servers and hosts post-installation

Note: You can skip these steps if you configured servers and hosts during the installation process.

While you can configure servers and hosts during the installation process, you can also configure them post‑installation from the Configuration wizard in the Start menu. To do this, you must run the wizard as an administrator.

  1. Prerequisites

    Install OpenText Enterprise Performance Engineering. For details, see Install and configure servers and hosts.

  2. Launch the Server Configuration Wizard or Host Configuration Wizard from the Start menu using the Run as administrator option.

    For details, see Configure servers and hosts.

Back to top

Sign in to Administration

OpenText Enterprise Performance Engineering administration tasks are performed in Administration.

To sign in to Administration:

  1. Open your Web browser (Chrome, Edge, Firefox and Safari are supported) and type the Administration URL in the following format: http://<Server_name>/admin.

    You can also sign in from the landing page (http://<server name>/homepage for on‑premises, or http://<server name>/homepage/?tenant=<tenant> for SaaS), and open the administration area by clicking Manage your environment.

    The Administration Sign in window opens.

  2. In the User Name box, type your user name. Only a Site or Tenant Admin user can sign in to Administration. For details, see Predefined admin roles.

    Note: The first time you sign in to Administration, you must use the site administrator name that you specified during the installation. After you sign in, you can define additional site administrators. For details, see Define a Site Admin user.

  3. In the Password box, type the site administrator password.

    If you are signing in using your internal OpenText Enterprise Performance Engineering password, you can reset the password by clicking Forgot or want to change password; this is not available when using LDAP or SSO authentication.

  4. Select the language for displaying the user interface.

    The multilingual user interface, or MLU, provides support for multiple languages on a single instance of OpenText Enterprise Performance Engineering without having to install language packs. Supported languages are English, French, Italian, Korean, German, Japanese, Simplified Chinese, and Spanish.

  5. Click the Sign in button. Administration opens.

Back to top

Perform site and lab administration tasks

After installing servers and hosts, you perform the site and lab administration tasks from Administration.

  1. Sign in to Administration.

    For details, see Sign in to Administration.

  2. Perform site configuration tasks.

    Configure the authentication method which allows users to sign in and define the project file repository.

    For details, see Select authentication type and Project repository.

  3. Create and maintain projects.

    You can create and maintain projects, and define the limits and other settings for the project from Management > Projects.

    For details, see Manage projects.

  4. Create and manage users and user roles.

    You can create users and control access to a project by defining the users who can sign in to the project, and by specifying the types of tasks (roles) each user may perform from Management > Users.

    For details, see Manage users in a project and Assign project roles and permissions to users.

  5. Add or reconfigure hosts.

    To work with hosts, you must first add them to Administration and define the host's location. If the host is a load generator over a firewall, you must define the MI Listener through which the load generator communicates with the server.

    When adding hosts, the system configures the OpenText Enterprise Performance Engineering user on that machine. For details, see Add a host.

    Note: If you upgrade from an earlier version or migrate an existing LAB_PROJECT from OpenText Application Quality Management (direct migration is supported up to OpenText Enterprise Performance Engineering 2023), the hosts become unavailable and you must reconfigure them as follows:

    1. Install the latest version. For details, seeUpgrades.

    2. In Administration, select Management > Hosts.

    3. Select the hosts you want to reconfigure in the Hosts grid, and click Reconfigure Host.

  6. Run a system health check.

    After adding an OpenText Enterprise Performance Engineering server to the system, and adding or reconfiguring hosts, you should perform a system health check to make sure all components are running as expected.

    For details, see Perform a system health check.

  7. Set the license keys.

    To run performance tests, you must install the appropriate server and host licenses.

    For details, see Manage licenses.

Back to top

Change the database administrator and user passwords

You can change the database administrator and user passwords that you configured for the OpenText Enterprise Performance Engineering server from the Database Passwords Changer utility in the Start menu.

Note: You can use a REST command to change the database user password in the Database Password Changer utility without having to use the user interface. For details, see Change passwords using REST APIs.

  1. Stop the OpenText Performance Engineering Backend Service.

  2. Change the database administrator and/or user passwords (according to the required change) on the database server.

  3. Run the Database Passwords Changer utility from the Start menu, and enter the new password for the OpenText Enterprise Performance Engineering database administrator and/or user.

    Note for Oracle databases only: Changing the username password affects only the LRE_SITE_MANAGEMENT_DB and LRE_SITE_ADMIN_DB user's password.

    For more details on DB Administrator and User credentials, see Configure the connection to the database server..

  4. On successful completion of the utility, restart the OpenText Performance Engineering Backend Service.

Back to top

Change passwords using REST APIs

You can use REST APIs to update passwords in OpenText Enterprise Performance Engineering configuration tools and components. This enables you to rotate passwords more easily, with minimal user intervention.

REST commands can be used in the following tools and components.

Tool / Component Action
Identity Changer utility Silently run the System Identity Changer utility to reconfigure the password of the system user. For details, see To update the system user password:.
Database Password Changer Update database user passwords in the Database Password Changer utility. For details, see To update the database passwords:.
SMTP page in OpenText Enterprise Performance Engineering Administration

Update the password for the user specified to connect to the SMTP mail server in the SMTP server tab of Administration. For details, see To update the SMTP user password:.

To run the Configuration Service application:

To use REST commands to perform these actions, the ConfigurationService application must be running.

  1. You can run the application using a service named OpenText Performance Engineering Configuration Service, or by launching LRE.Tools.ConfigurationService.exe with "--console" as the argument.

    • In Powershell, run the command:

      Copy code 
      .\LRE.Tools.ConfigurationService.exe --console

    • In a command prompt window, run the command:

      Copy code 
      LRE.Tools.ConfigurationService.exe --console

  2. Change to <Server_installdir>\LRE_CONFIGURATION_SERVICE\directory) located under <Server_installdir>\LRE_CONFIGURATION_SERVICE\.

    Note: If the application cannot be started by the Configuration Service, make sure that the default port, 5000, is not already in use by another application. You can either change the port used by the other application, or change the port used by the Configuration application as described in the next step.

  3. You can change the port listened by the application under localhost in the appsettings.json file. For security reasons, the application has been limited to be accessible through localhost only.

  4. After launching the Configuration Service application, you can access a Swagger page that displays all the available REST commands exposed by the application and how to use them.

    To open the Swagger page, make sure the application is running, and type the following in a web browser:

    http://localhost:5000/swagger/index.html

  5. After running the Configuration Service Tool REST APIs, we recommend restarting the OpenText Professional Performance Engineering Backend Service for the password changes to take effect.

To update the system user password:

You can use a REST command to silently run the System Identity Changer utility to reconfigure the password of the system user without having to use the user interface.

You can also use a REST commend to have the System Identity Changer utility provide an update of the reconfiguration status of the server and hosts in a .CSV file.

Step Description
Prerequisites Make sure the ConfigurationService application is running. For details, see To run the Configuration Service application:.
Request URL

POST http://localhost:5000/CredentialsUpdater/update-password-of-lre-account

Payload

  1. In the "siteAuthenticate"property, enter the authentication credentials of the Site Management user (not the user account in the OS platform).

  2. In the "newPassword" property, enter the new password to be set for the system account used by OpenText Enterprise Performance Engineering.

    Copy code 
    {
    "siteAuthenticate": {
    "username": "string",
    "password": "string"
    },
    "newPassword": "string"
    }
Response A CSV file that can be queried for progress in the next command.

To get an Identity Changer progress report:

After running the command to update the password, you can get a progress report on Identity Changer reconfiguration.

Step Description
Request URL

POST http://localhost:5000/CredentialsUpdater/get-progress-report

Payload

 

  1. In the "siteAuthenticate" property, enter the authentication credentials of the Site Management user (not the user account in the OS platform).

  2. In the "journalName" property, enter the response provided from the update system user password command.

    Copy code 
    {
    "siteAuthenticate": {
    "username": "string",
    "password": "string"
    },
    "journalName": "string"
    }

To update the database passwords:

You can use a REST command to reconfigure the password of OpenText Enterprise Performance Engineering database users in the Database Password Changer utility without having to use the user interface.

Step Description
Prerequisites Make sure the ConfigurationService application is running. For details, see To run the Configuration Service application:.
Request URL

POST http://localhost:5000/CredentialsUpdater/update-database-passwords

Payload

  1. In the "systemIdentity" property, enter the same system account used to run OpenText Enterprise Performance Engineering.

  2. In the "databasePasswords" property, enter the new database passwords.

    Copy code 
    {
       "systemIdentity": {
         "domain": "string",
         "userName": "string",
         "password": "string"
      },
       "databasePasswords": {
          "strongUserNewPassword": "string",
          "newDefaultPassword": "string"
      }
    }

  3. After running the Configuration Service tool REST API, we recommend restarting the OpenText Professional Performance Engineering Backend Service for the password changes to take effect.

Response The answer will be true or false with a reason message.

To update the SMTP user password:

You can use a REST API call to update the SMTP user password in Administration without having to use the user interface.

Step Description
Prerequisites Make sure the ConfigurationService application is running. For details, see To run the Configuration Service application:.
Request URL

POST http://localhost:5000/CredentialsUpdater/set-smtp-configuration

Note: If multiple tenants are defined in your environment, you must specify the tenant in the URL as a parameter.

Example: If you have a tenant guid a128c06-5436-413d-9cfa-9f04bb738df3 (this is the default tenant, but you can specify any other one in your environment), the URL looks like this:

http://localhost:5000/CredentialsUpdater/set-smtp-configuration?tenant=fa128c06-5436-413d-9cfa-9f04bb738df3

Payload

  1. In the "adminAuthenticate" property, enter the authentication credentials to the Administration page of the OpenText Enterprise Performance Engineering server or the tenant.

  2. In the "newPassword" property, enter the new password to be used in SMTP. The tenant looks like this:

    Copy code 
     {
       "adminAuthenticate": {
         "username": "string",
         "password": "string",
         "accessKey": {
           "clientIdKey": "string",
           "clientSecretKey": "string"
        }
      },
       "newPassword": "string"
    }

Not using SSO authentication

If you are not using SSO authentication, your payload should either contain:

  • Credentials of a user with access to the Administration page of the OpenText Enterprise Performance Engineering server:

    Copy code 
     {
       "adminAuthenticate": {
         "username": "string",
         "password": "string"
      },
       "newPassword": "string"
    }

  • An access token of an administration user (see the example for SSO authentication below).

Using SSO authentication

If you are using SSO authentication, you must create an access token and then use a payload like this:

Copy code 
{
   "adminAuthenticate": {
     "accessKey": {
       "clientIdKey": "string",
       "clientSecretKey": "string"
    }
  },
   "newPassword": "string"
}
Response The answer will be true or false.

Notes for changing passwords using REST APIs

The following notes apply when changing passwords using REST APIs:

  • The ConfigurationService application must be part of the OpenText Enterprise Performance Engineering server; it cannot be used on its own or as a standalone application.

  • You can run the update database passwords command while the server is down. The other commands, update system user and SMTP user, will not work without the server being up and running.

  • In the response of all commands, there is an option to provide an error as a response instead of expected response which indicates a failure.

Back to top