PureLoad License Manager 6.0 Documentation

Introduction

The purpose of PureLoad License Manager application is to provide a browser based user interface to manage multiple Naming servers and licenses.

Included features are:

These features allows for maximum flexibility for a site with multiple licenses. For 2 examples of usage see the following use cases.

Use case: Moving Licensed Threads

Lets say that we have 3 licenses (and 3 Naming servers) with max 5000 threads each. This normally allows us to run 3 concurrent load test session, each using max 500 threads.

Now we want to run one larger test, using 10000 threads. We then use PureLoad License Manager to move 5000 licensed threads from one Naming server to another. This gives you a setup where you can run 2 concurrent load test session, one using 10000 threads and one using 5000 threads.

Use case: Moving Worker Managers

Let's say that we have a lab setup with 10 hosts running Worker Managers to generate load. We have 2 licenses (and 2 Naming servers). Each Worker Manager is configured to be connected to one Naming server. We by default have 5 Worker Manager servers connected to each Naming server.

Now we want to rearrange this setup, so that 3 Worker managers is connected to one Naming server and 8 Worker Managers are connected to the second Naming server. This is easily done using the PureLoad License Manager.

Installation

The PureLoad License Manager is a web application, including a bundled web server. You install by extracting the provided tar file anywhere. After you have extracted the tar file, make sure that you edit the start script bin/pureload_mgr.sh

b> to use Java version 7 or 8.

Installation Directory

The installation directory includes:

Web Server Configuration

The web server is by the default started using available network interfaces and port 8080. If this must be changed, please edit tomcat/conf/server.xml. Please see comments in the file or consult Tomcat 5.5 documentation.

Web Server Authentication

The web server uses basic HTTP authentication and by default the userid is admin and password pureload.

You can (and should) change this by editing tomcat/conf/tomcat-users.xml. If you need more secure authentication (like using DIGEST) please contact support@pureload.com.

Advanced Configuration

If PureLoad License Manager is installed on the same host as the Naming servers, there is not further configuration required. If on the other hand installed on a separate host, then the property activationURL in the file tomcat/webapps/ROOT/WEB-INF/web.xml must be updated. Please contact support@pureload.com for details.

Upgrade Instructions

Install the new version and then manually copy the following file from the previous version:

Also check tomcat/webapps/ROOT/WEB-INF/web.xml (if you have modified the activationURL.

Starting PureLoad License Manager

The web server is started using the bin/pureload-mgr.sg script:

% ./bin/pureload-mgr start

When the server is started you can access the we application by specifying the URL: http://localhost:8080 where 'localhost' is the host where the web server is running. I.e replace this with a host name or IP address if running remotely.

Stopping PureLoad License Manager

To stop the web server use the bin/pureload-mgr.sh script:

% ./bin/pureload-mgr stop

Naming Servers View

The default view when starting PureLoad License Manager is the Naming view, that shows you the known Naming servers:

Naming view

Note: initially the list will be empty, but as soon as you have added your naming servers the list will be persistently saved and available on server restarts.

The list of naming servers shows various information per naming server and include links to view license information, managers or log for a naming server. You can also add a comment to each naming server by edition the comment field and pressing the "Save" button. Deleting a naming server from the list is done by pressing the "Delete" button.

Adding a Naming server

To add a Naming server, simply add host name and port of the naming server at the bottom and select "Add" button. The specified Naming server will then be added to the list.

View Naming server log

If a log is enabled for a naming server ("naming.logging" property enabled for the naming server) this log can be viewed by selecting the "Log -> View" link per naming server.

The log is displayed in a separate window.

Manager Servers View

Managers servers All Manager Servers for a specified naming server is viewed selecting License "View" link from Naming Servers View, or selecting the "Manager Servers" Tab:

Manager view

Moving a Manager

To move manager server(s) to a new naming server, select the manager servers to be moved, specify what naming server they should be moved to and press the "Move" button.

License Info View

License information for a specified naming server is viewed selecting License "View" link from Naming Servers View, or selecting the "Manager Servers" Tab:

License Info view

Moving Licensed Threads

To move licensed threads to to a new naming server, specify number of threads to move, naming server they should be moved to and press the "move" button.

After licenced threads has been moved the license information is updated and can also be viewed in the Naming Servers view.