Manage tenants in Site Management

When logging on as a Site Management user, you have access to the Site Management console where you can define and manage all shared spaces (tenants).

Tip: See the Video gallery for a video on tenant administration.

Sign in to Site Management

This task describes how to launch Site Management on your machine from your Web browser.

  1. Open your Web browser (Chrome, Edge, Firefox and Safari are supported) and enter the Site Management URL in the following format:

    http://<Server_name>/Site

    The Site Management Sign in window opens.

  2. In the User Name box, enter your user name. Only a Site Management user can sign in to Site Management (the Site Management console is not visible to users with admin or user roles).

    The first time you sign in to Site Management, you must use the user that you specified during the OpenText Enterprise Performance Engineering installation. After you sign in to Site Management, you can define additional Site Management users. For details, see Create and manage Site Management users.

  3. In the Password box, enter the Site Management user's password.

  4. Select the language for displaying the Site Management user interface.

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

  5. Click the Sign in button. Site Management opens to the Tenants page. For details, see Manage tenants below.

Tip: To avoid having the same user name and password in OpenText Enterprise Performance Engineering and the Site Management console, we recommend creating a new Site Management user and deleting the default configuration user from Site Management.

Back to top

Manage tenants

In Site Management > Tenants, Site Management users can create and manage tenants. The tenant details, status (active or inactive), and the administrator for each tenant are displayed in the Tenant Details tab.

A default tenant is created automatically, and the default Site Management user (the user defined during installation) is assigned as the administrator for this tenant.

As a Site Management user, you can perform the following.

Action Description
Create new tenants
  1. Click the Add Tenant button Add button.

  2. Enter a unique name for the new tenant, and add a description (optional).

  3. Enter the credentials of the admin user for managing that tenant and click Save. The tenant is added to the Tenants list, and the following information is displayed in the Tenant Details tab:

    • Tenant details: unique tenant ID, creation date, status, version.

    • Database and schemas: Database name, Admin Schema, Tenant Lab Schema, Super User, Schema User, DB Server Name, Tenant Repository Path, Tenant Login URL.

Connect to a tenant

Click the Connect link in the grid to connect directly to a tenant.

Alternatively, you can copy the tenant's login URL from the Tenants grid (Copy URL ) or the Tenant Details page to a browser, and bookmark the link.

Note: You can only connect to a tenant that has an Active status.

Rename tenants To edit a tenant name, click the tenant name link in the grid, and rename the tenant in the Tenant Details page.
Remove and restore tenants

Removes a tenant from the Tenants grid (its details are deleted from the server). This does not delete the tenant database schemas and file repository from the database and you can restore the tenant if necessary. For details, see Remove and restore tenants.

Upgrade tenants

You can upgrade tenants to a later version. The Tenant State and Version are updated to reflect the upgrade state and the new version. For details, see Upgrade tenants.

Note: Only a single tenant that is in Completed state, and that has not been upgraded to the latest version, can be upgraded at a time.

Activate or deactivate tenants

You can deactivate a tenant by selecting it and clicking Deactivate or by changing its status to Inactive in the Tenant Details page. This enables you to block access to a tenant. When you deactivate a tenant, the tenant data is kept. If needed, you can reactivate a tenant by clicking Activate or by changing its status to Active.

Note:

  • Changing tenant status is allowed only if all the selected tenants have the same status. You cannot change the status of the default LRE tenant.

  • We recommend that you deactivate a tenant before you change any data that may cause inconsistency for connected users. Users that are currently connected to the tenant cannot perform any new actions.

  • Deactivating a tenant may affect active runs.

Back to top

Create and manage Site Management users

You can create additional Site Management users and perform the following tasks from Site Management > Users.

Action Description
Add new Site Management users

Click the Add User button Add button and enter a user name, password, and email for the new Site Management user, and set the user's status (active or inactive). Only active Site Management users can sign in to Site Management.

Note: When you create Site Management users, you need to add them to Administration as Site Admin users before they can sign in to Administration and configure lab resources for the tenant. For details, see Define a Site Admin user.

Activate or deactivate Site Management users

You can deactivate a Site Management user by selecting it and clicking Deactivate or by changing its status to Inactive in the User Details page. This enables you to block access to a Site Management user. When you deactivate a Site Management user, the user's data is kept. If needed, you can reactivate a Site Management user by clicking Activate or by changing its status to Active.

Note: There must be at least one active Site Management user at all times.

Reset password

In the grid, click the user name link of a Site Management user whose password you want to reset to open the User Details page. Enter a new password for the Site Management user.

Remove Site Management users

In the grid, select a Site Management user and click the Delete User button Delete button.

Note: You can only delete the default LRE Admin user from Site Management after another Site Management user has been created.

Export Site Management user details to Excel Click the Export to XLS button Export to Excel button to export Site Management user details to an Excel file. The Excel file is downloaded to the Downloads folder of the client user.

For more on Site Management users, see User roles.

Back to top

Check the tenant server

A Site Management user can perform the following checks on the tenant server from Site Management > Servers.

Action Description
Run the server check

Click the Check Server button to run the server checks. This displays the current state of the server, and whether the last performance, connectivity, configuration, and installation check passed or failed.

Update server details Click the name link of the OpenText Enterprise Performance Engineering tenant server in the grid to open the Server Details page. You can update the internal and external URLs and deactivate and activate the server state.
View each server check step

To view the status of each step of the server checks, click the name link of the OpenText Enterprise Performance Engineering tenant server in the grid, and select Check Server Status. This includes the category and sub-areas in which the feature checks the server, the expected and actual results, status, and errors (if an error occurred during the check).

Change the server state

You can change the state of the server by selecting it and clicking Non-Operational in the Server Details page. This enables you to block access to a server. You can make the server available by changing its state to Operational.

Delete the tenant server

In the grid, select a Site Management user and click the Delete Server button Delete button.

Back to top

Check tenant log files

You can view events associated with tenants directly from the Site Management console by selecting Site Management > Logs.

You can perform the following actions from the Logs grid.

Action Description
View log details

To view a log, select a log type (W3WP or LRE Core API) and the specific file to display.

Each row in the log displays an event with its severity level (Error, Warning, Debug, and Info), date and time that the event occurred, and the text message that was generated during the event. Events are listed in chronological order with the most recent one being listed at the top.

You can drill down on each event to see the following:

  • Raw Message. This is the same information as Message in an easy to read format.

  • Stack Trace (available in version 2023 only). Stack trace is unavailable by default for security reasons. If you want to display stack trace information in the Site Management console, you can enable it as follows:

    1. Go to <Server_installdir>\LRE_BACKEND and open the appsettings.defaults.json file.

    2. In the Logging section, add "ShowStacktraceInUi":"true".

Click the Select Columns button Select Columns button to display additional log information (Process, Thread, Logger, and Context).

Display other log files

You can display log files not located in the default log directory (provided they have the same format), by clicking the Browse File button and selecting a file, or by dragging and dropping the file on the grid.

When a log from a different directory is displayed, the default log selection fields at the top of the grid are unavailable.

To clear the grid and enable the default log selection fields, click Clear.

Filter

To filter the information being displayed in the grid, click the Search button Search button and define a filter condition based on values of that field. For details, see Filter displayed items.

Export log files

To export information displayed in the Logs page to an Excel file, click the Export to XLS button Export to Excel button. Data displayed in the Logs page is saved to an Excel file and downloaded to the Downloads folder of the client user.

Download log file

To download a log file, click the Download Selected File button . This file contains all the data from the selected log file.

Back to top

Define additional Tenant Admin users

A Tenant Admin user is responsible for configuring its respective tenants in Administration.

After the sSite Management user has created the initial Tenant Admin user in Site Management, the Site Management user or initial Tenant Admin user can define additional admin users in Administration who can then sign in to their respective tenants and start configuring them.

Note:  

  • A Tenant Admin user has restricted access in Administration. For details, see Predefined admin roles.

  • Only a Site Admin or a Tenant Admin user in Administration can define other users as Tenant Admin users. For details on the different user types, see Predefined admin roles.

To define additional Tenant Admin users:

  1. Sign in to Administration. For details, see Sign in to Admin area.

  2. In Administration, select Management > Users, and click the Add User button Add button.

  3. Enter the user details in the Create User page. For details, see Create or edit a user.

    • If you logged onto Administration as the LRE Admin user, select the Admin User check box, and choose Tenant Admin.

    • If you logged onto Administration as a Tenant Admin user, select Tenant Admin.

  4. To assign projects and roles to a user, see Assign projects and roles to a user.

  5. Click Save to add the new user to the Users grid.

Back to top

Change the initial Site Admin password

You can change the password of the initial Site Admin user created during installation or configuration from the Users tab in Site Management. The new password is automatically synchronized across all locations where it is stored to prevent password mismatch.

For details, see Change the initial Site Admin user password.

Back to top

View tenant repository usage

The Tenant Usage Reports enable you to keep track of file storage usage for each tenant.

  1. In Site Management, select the Tenants tab.

  2. Select a tenant in the grid (click the link in the Tenant Name column). The tenant details page opens in the Tenant Edit view.
  3. Select the Tenant Usage Reports view.

    The view displays the following information about file usage for the selected tenant.

    Report Description
    Project Storage Usage

    The pie chart shows the percentage of the total file repository that each project in the tenant uses.

    Project Repository Usage Over Time

    The graph shows the progression of file repository usage (scripts, attachments, results, and resources) over time for all projects in the tenant. You can filter the graph by selecting a start and end date.

Back to top

Perform actions from the entity details menu

You can perform actions on an entity in Site Management using the menu in the entity's details page. To open the menu, click the Menu button in the entity's details page.

You can perform the following actions from the menu.

Module Action
Hosts
Servers

Delete Server. Deletes the selected server. For details, see Check the tenant server.

Users

Delete User. Deletes the selected user. For details, see Create and manage Site Management users.

Cloud Accounts

Delete Cloud Account. Deletes the selected cloud account. For details, see Delete a cloud account.

Tenants Remove Tenant. Removes the selected tenant. For details, see Remove a tenant.

Back to top

See also: