Share this page

# Unlock entities and manage unlocking jobs

This section describes how to view and unlock entities locked by any use and to manage unlocking jobs.

In this topic:

## About the Entity Unlocker

The Entity Unlocker is a standalone application that can be used to unlock entities. Entities are locked when they are being edited, where a browser is closed without a proper log out, or where a network is down. Lockable entities include tests, scripts, monitor profiles, and analysis templates.

A site administrator can perform the following on any project that has been assigned to them, provided a role has also been assigned:

- Use the Entity Unlocker application to view and unlock entities locked by any user on a specific domain and project (a typical user can only unlock an entity that was locked by that user). The tool shows the test ID, test name, name of user locking the entity, and the time that the entity was locked.

- Manage the unlocking job from Administration which automatically unlocks entities that have not been updated after a specified amount of time.

The Entity Unlocker application integrates securely with OpenText Enterprise Performance Engineering when SSO authentication is enabled. For details, see SSO authentication.

Back to top

## Use the Entity Unlocker

You can perform the following Entity Unlocker tasks.

Action | How to
--- | ---
Download Entity Unlocker | For details, see Download applications and components.
Schedule periodic unlocking jobs | In Administration, click Maintenance > System Health. Select the Maintenance Tasks tab. Click the Entity Unlocking Task link to open the Entity Unlocker scheduling job, and configure the following settings: Set the frequency of the maintenance task in the Recurrence (min) field. Specify the amount of time after which the maintenance task unlocks any locked entity in the Value box for the TIMEOUT_UNLOCK parameter. By default, both of these values are set to 120 minutes.
Manually unlock entities | Sign in to the Entity Unlocker application as a Site Admin user. For a single tenant, the URL should be: `http://<Server_name>/loadtest` For a multi-tenant environment, the URL should be: `http(s)://<Server_name>/loadtest?tenant=<tenant UID>` You can see all locked entities in projects and domains that have been assigned to the Site Admin user, provided a role has also been assigned. Unlock any locked entity as required.
View Entity Unlocker log files | The Entity Unlocker log files are created in the \orchidtmp\LTLogger\EntityUnlocker folder. When running on a machine with a server, load generator, or Analysis, the log is created in the <Server/Host/Analysis_installdir>\orchidtmp\LTLogger\EntityUnlocker\ folder. Example:`C:\Program Files (x86)\OpenText\OpenText Enterprise Performance Engineering\orchidtmp\LTLogger\EntityUnlocker` On a machine that does not have any of these products installed, the log is created in the <Entity_Unlocker_installdir>\orchidtmp\LTLogger\EntityUnlocker folder. Example:`C:\tools\EntityUnlocker\orchidtmp\LTLogger\EntityUnlocker\`

Back to top

## Notes and limitations

To use the Entity Unlocker tool while running on a proxy environment, you must use one of the following `<system.net>` elements (as required) under the `<configuration>` element in the EntityUnlocker.exe.config file.

Using system network proxy settings:

Copy code

    <configuration>
      <system.net>
        <defaultProxy>
          <proxy usesystemdefault="True" />
        </defaultProxy>
      </system.net>
    </configuration>

Using a specific proxy:

Copy code

    <configuration>
      <system.net>
        <defaultProxy>
          <proxy proxyaddress="http://<myproxy>:<port#>"/>
        </defaultProxy>
      </system.net>
    </configuration>

If proxy requires authentication:

Copy code

    <configuration>
       <system.net>
         <defaultProxy useDefaultCredentials="true">
         </defaultProxy>
       </system.net>
    </configuration>

For more information and parameter details, see the Microsoft knowledge .NET documentation.

Back to top

https://admhelp.microfocus.com Enterprise Performance Engineering,LoadRunner Enterprise 8942
Tips to improve your search results...OpenText™ Enterprise Performance Engineering Help Center OpenText™ Enterprise Performance Engineering Help 26.1 All View Local Help Center View Online Help Center Version: