Getting Started

PureAgent Logo
PureTest 3.5
April 2008
http://www.minq.se
support@minq.se

Documentation Index

Introduction

This document serves as the introduction to PureAgent. It covers installation procedures, important concepts and how to get started.

Please read this guide before reading any other PureAgent related documents.

What is PureAgent?

PureAgent simulates end users by executing scenarios of user operations (tasks) at a periodic rate. The purpose is to collect the total response time it takes to execute the scenario and also catch and report any errors that might occur. The agent can be configured to automatically send notifications when alarms are identified or when the defined performance limits are not satisfied.

A scenario is referred to as an activity in PureAgent and it consists of a number of tasks that are executed by the agent. These tasks can be viewing static or dynamic web applications as well as many other types of tasks (ex. database access, FTP, DNS, SMTP, etc).

The agent is managed using a standard web browser. The user interface allows you to specify which activities should be run, time intervals, alarm settings and you can also view the result and progress of the activities.

The PureTest tool is used to develop Scenarios which are installed in PureAgent as activities. The same scenarios may also be used in the sister product PureLoad to load test the server application.

This means that PureAgent benefits from the stability and flexibility found in PureTest and PureLoad. It also has the same extensive support for dynamic web applications, SSL encryption and session handling techniques. Please refer to the PureTest/PureLoad documentation for detailed information.

Requirements

PureAgent is verified on the following operating systems:

PureAgent is written in Java and should run on any operating system that includes Java 1.5.

At least 10 MByte free disk space is required for PureAgent and additional space for Java VM (if not already installed). Additional disk space is also required for storage of the activity history.

A web browser is required to access the PureAgent User Interface. PureAgent is tested and verified with Firefox, but will work with any modern browser that supports cookies and CSS.

Installation

PureAgent is distributed in a self-extracting format. Simply execute the installer and answer the questions about install location, etc.

For details on how to execute the installer on different operating systems, see the instructions on the web page where you downloaded PureAgent.

Installation directory

When installed, the PureAgent installation directory, <install-home>, contains the following sub-directories:

Uninstall PureAgent

The steps to uninstall PureAgent depends on the platform being used, but you will find an application in the <install-home> directory named PureAgent Uninstaller. Start the application and you will be guided through the uninstall process.

Initial Configuration

The default configuration (as defined by the files in the <install_home>/config directory) is to start PureAgent, using the port 6411 and without having any modules installed. See the PureAgent Configuration chapter for details.

Start by installing the license you have received by e-mail into the <install_home>/config directory.

Further configuration details are described in Agent Configuration.

PureAgent Startup

To start up the agent on a UNIX system you execute the pureagent binary as follows:

 % cd <install_home>
 % ./bin/pureagent

On a Windows system, it is easiest to use the PureAgent shortcut in the Start menu.

Once the agent is started it will start a Web server which will listen on port 6411 as default. To access the User Interface, direct your browser to listening port on the machine where the agent is running. Assuming that you are running on your local machine, you can use the URL:

    http://localhost:6411

Quick Start

The following will give you a short introduction on how to get started and executing a very simple PureLoad test session.

Start PureAgent

Windows:
Choose the shortcut pureagent from the PureAgent program menu
UNIX/Mac OS X:
Start the pureagent binary in the bin directory

Access the web interface

Start a web browser and go to http://localhost:6411
(Assuming you run the browser on the same host as you started PureAgent.)

Log In

Log in using user name admin and password pureagent

Create an Activity

You may now create a new activity by pressing the create icon. The create activity page will give you the choice of either installing an activity defined by a scenario or adding an activity defined by a single URL. A Scenario is prepared and developed using the PureTest tool.




Copyright © 2008 Minq Software AB. All rights reserved.