JProbe Installation Guide

JProbe Installation Guide

3

Licensing JProbe

This chapter contains the following sections:

JProbe License Options ..............................................................................................................36

Requesting Node-Locked Licenses .............................................................................................37

Registering Node-Locked Licenses .............................................................................................39

Using Concurrent Licenses .........................................................................................................41

36 JProbe

Installation Guide

JProbe License Options

There are three types of licensing models available: node-locked, concurrent, and enterprise. For more information, review the JProbe licensing options on the Quest web site at:

http://www.quest.com/jprobe/licensing_info.aspx.

Node-Locked Licensing

A node-locked license allows JProbe to run on a predefined set of computers. The standard license is for a single developer. The license file contains the licensed host name and operating system, the type of license (purchase or evaluation), and the JProbe name, version, and license number. For evaluation (or leased) software, it also contains

the evaluation expiry date. For more information, see “ Requesting Node-Locked

Licenses ” on page 37.

Concurrent Licensing

Concurrent licensing offers flexibility in where JProbe is installed and who may use the product. Instead of having one node-locked license per developer, you purchase a number of licenses that are shared by the entire team via the Quest Software License

Server.

Note

Concurrent licensing is not available with evaluation versions of JProbe.

When you launch JProbe, the product checks to see if a license is available from the

License Server. If so, you can use the product; if not, you need to try again later. If developers consistently have trouble obtaining a license, you can increase the number of

licenses by contacting Quest Software. For more information, see “ Using Concurrent

Licenses ” on page 41.

Enterprise Licensing

Enterprise licensing allows your entire development team to use JProbe. This option is not covered in this guide. For more information, contact your Sales representative.

Chapter 3: Licensing JProbe

Requesting Node-Locked Licenses

37

Requesting Node-Locked Licenses

You can obtain a node-locked license while installing JProbe, or you can skip this step and request a license when you launch JProbe. Alternatively, you can go to the Quest

Software SupportLink web site and request your license.

Requesting a License During Installation or from Within JProbe

This procedure assumes that you are working from the computer where your application and JProbe are installed, and that this computer has a graphical display and a connection to the Internet. When you request a license file, your hostname and number of CPUs is sent to Quest Software. This information is required for the license file.

Note

If the computer you want to license does not have Internet access, or if you want to request

a license for a different hostname, you can request a license through SupportLink. For more information, see “ Requesting a License via SupportLink ” on page 38.

If you want to run remote sessions, specify the second host name when the License

Details web site is displayed. The second host can only run the JProbe Console for the product, not the JProbe Analysis Engine. After you receive the license file, you register the same license file on both computers.

To request a node-locked license:

1

On the computer running your application and the JProbe Engine, do one of the following:

2

• To request the license while installing JProbe, select the Node Locked

Licenses tab in the Licensing Setup installation screen.

• To request the license after installation, launch JProbe and select the Node

Locked Licenses tab in the Manage JProbe Licenses dialog box.

Click Obtain License.

You are advised that your hostname and number of CPUs will be sent to Quest

Software. If you agree to transfer this information, continue with this procedure.

Otherwise, see “ Requesting a License via SupportLink ” on page 38

.

3

Click OK.

Your default browser opens. If the Quest Software license page does not display, ensure that cookies are enabled in your browser and try again.

4

Follow the instructions on the web site to request your license.

38 JProbe

Installation Guide

5

• If you are not subscribed, complete the subscription details.

• If someone else in your organization has subscribed with this license number, you may not be able to license JProbe on your computer.

• If you want to run remote sessions, be sure to add the host name of the second computer when prompted.

Tip

To find the host name of a computer, enter hostname in a command prompt or xterm session.

After you complete the instructions on the web site, your JProbe license file is sent to your email address. Save the license file to your computer.

6

Now you can register the node-locked license. See “ Registering a License During

Installation or from Within JProbe ” on page 39.

Requesting a License via SupportLink

You can request a JProbe license file using any computer that has Internet access. Go to the Get JProbe License page (URL below) and follow the online instructions. If the person who will be using this copy of JProbe has not subscribed, you need to complete the subscription details before you can receive a license file.

Alternatively, instead of following this procedure, you can contact Quest to request a

license file. For more information, see “ Contacting Quest Support ” on page 12.

To request a node-locked license:

1

2

3

Go to SupportLink at

http://support.quest.com

.

Select License Keys.

Follow the instructions on the web site to request your license.

• If you are not subscribed, complete the subscription details.

• If someone else in your organization has subscribed with this license number, you may not be able to license JProbe on your computer.

• When prompted, enter the host name of the computer running your application.

• If you want to run remote sessions, add the host name of the second computer from which you want to monitor JProbe sessions and review the collected data.

Tip

To find the host name of a computer, enter hostname in a command prompt or xterm session.

Chapter 3: Licensing JProbe

Registering Node-Locked Licenses

39

4

After you complete the instructions on the web site, your JProbe license file is mailed to the subscribed person’s email address. Save the license file to your computer.

5

Now you can register the node-locked license. See “ Registering a License During

Installation or from Within JProbe ” on page 39.

Registering Node-Locked Licenses

You can register a node-locked license while installing JProbe, or you can skip this step and register a license when you launch JProbe. Alternatively, you can run a command line tool to register JProbe.

Registering a License During Installation or from Within JProbe

This procedure walks you through registering a license file on the computer or computers named in the license file. It assumes that the computer has a graphical

display. If not, a command line utility is also available. For more information, see

“ Registering Licenses from the Command Line ” on page 41.

To register node-locked licenses:

1

On the computer running your application and the JProbe Engine, do one of the following:

2

• To register the license while installing JProbe, select the Node Locked

Licenses tab in the Licensing Setup installation screen.

• To register the license after installation, launch JProbe and select the Node

Locked Licenses tab in the Manage JProbe Licenses dialog box.

Click Add License, navigate to and select the saved license file, and click Open.

The license is installed to JPROBE_HOME/config/jprobe.licenses. Some of the details of the license are displayed in the table.

40 JProbe

Installation Guide

3

To view all the license details, select the license and click View.

The License Properties dialog opens with the details displayed.

4

5

Click OK to close the License Properties dialog box.

To save a back up of your license file in case you ever need to reinstall JProbe, click Save.

6

To end the license registration process, do one of the following:

• From the Licensing Setup installation screen, click Next.

• From the Manage JProbe Licenses dialog, click Close.

7

For a remote setup, go to the other computer that you specified when requesting the license file and repeat this procedure. If the license file is not accessible from the other computer, use FTP to put a copy of the license on the second computer.

8

You can now use JProbe.

Chapter 3: Licensing JProbe

Using Concurrent Licenses

41

Registering Licenses from the Command Line

You use the jplicense

utility to register node-locked licenses. You can also use this utility to list, view, replace, and delete licenses. For more information, see the JProbe

Reference Guide.

Note

You can request a JProbe license file using any computer that has Internet access. For more information, see “ Requesting a License via SupportLink ” on page 38.

To register node-locked licenses from the command line:

1

2

3

On the computer running your application and JProbe, open a command prompt.

Navigate to the JPROBE_HOME/bin directory.

To add one or more node-locked licenses, use the following syntax:

4

5

Windows:

jplicense add <license_file> [<license_file>...]

UNIX:

./jplicense add <license_file> [<license_file>...] where

license_file

is the fully qualified path to the JProbe license file(s).

To extract a node-locked license as a backup in case you need to reinstall JProbe, use the following syntax:

Windows:

jplicense extract <serial_number> <license_file>

UNIX:

./jplicense extract <serial_number> <license_file> where

serial_number

is the license to extract and

license_file

is the fully qualified path to the file where you want to save the extracted license. To get a list of serial numbers, use jplicense list

.

You can now use JProbe.

Using Concurrent Licenses

Concurrent licensing means that multiple people can start simultaneous JProbe analysis sessions on the same application. Each concurrent license permits a developer to run a

JProbe Analysis Engine and a JProbe Console. Two people cannot connect JProbe

Consoles to the same instance of a JProbe analysis session; a separate instance of the application is run under JProbe for each concurrent user.

Concurrent licenses are managed automatically. If you attempt to use JProbe while all licenses are in use, you are notified. You need to wait for an available license. If this

42 JProbe

Installation Guide

occurs frequently, you may want to contact Quest Software to increase your number of licenses.

The following procedures assume that you have completed these tasks:

Task Help on Task

1 Purchased JProbe for the operating system that your application runs on and asked for concurrent licensing.

To order, contact [email protected]

2 Downloaded the Quest Software

License Server from the Web page specified in the confirmation email that you received, and specified the host name and OS of the network server where it will run.

To download the License Server, follow the instructions in the confirmation email, the License Details Web page, and the License Server download Web page. You will be emailed your license file.

3 Installed and started the License Server on the network server you specified.

To install the License Server, run licensing <version>-platform

.

For example, questlicensing4.2.3-lnx.bin

.

To start the License Server, follow the instructions in the License Server documentation.

4 Added the license file to the License

Server via its Web interface. The license file was mailed to the email address provided when you downloaded the

License Server.

To open the home page for the License

Server, see the Readme file. To add a license, follow the on-screen instructions.

Tip

You can also launch the Web interface from the JProbe Concurrent Licenses tab by selecting View License Usage.

5 Installed JProbe on the computer that runs your application.

See “ Installing JProbe ” on page 29.

6 Installed JProbe on each of the developers’ workstations.

See “ Installing JProbe ” on page 29.

7 Ensured that all computers have access to the server running the License Server.

For help with network issues, see your

System Administrator.

Chapter 3: Licensing JProbe

Using Concurrent Licenses

43

Setting the License Server During Installation or from Within

JProbe

This procedure assumes that you are working from the computer running your application and the JProbe Analysis Engine. If you do not have a graphical display, see

“ Setting the License Server from the Command Line ” on page 43.

To set the license server for concurrent licensing:

1

2

On the computer running your application and the JProbe Analysis Engine, do one of the following:

• To set the license server while installing JProbe, select the Concurrent

Licenses tab in the Licensing Setup installation screen.

• To set the license server after installation, launch JProbe and select the

Concurrent Licenses tab in the Manage JProbe Licenses dialog box.

Type the fully qualified host name or IP address of the computer running the

License Server in the License Server Hostname field.

3

Click Test Server.

A message tells you whether or not the computer is available.

4

5

To set the specified host as your license server, click Set Server.

To view your license and the licenses currently in use, click View License Usage.

6

• The License Server home page opens in your default browser.

• For details on each screen, click the Help link.

• To close the License Server web interface, close your browser.

To end the license registration process, do one of the following:

7

8

• From the Licensing Setup installation, click Next.

• From the Manage JProbe Licenses dialog, click Close.

Repeat on each of the developer workstations.

You can run JProbe if a concurrent license available.

Setting the License Server from the Command Line

You can test and set the license server from the command line. For more information, see “ Using Concurrent Licenses ” on page 41.

44 JProbe

Installation Guide

To set the license server for concurrent licensing from the command line:

1

2

3

From a command prompt, navigate to the JPROBE_HOME/bin directory.

To test that the license server is available, enter:

Windows:

jplicense test <license_server> <port> <application>

UNIX:

./jplicense test <license_server> <port> <application> where

license_server

is the name of the server running the Quest Software

License Server,

port

is the port number that the license server listens on, and

application

is the licensing application name. For example: jplicense test serve_lics 8133 licensing

To set the license server, use the following syntax:

Windows:

jplicense server <license_server> <port> <application>

UNIX:

./jplicense server <license_server> <port> <application> where

license_server

is the host running the Quest Software License Server,

port

is the port number that the license server listens on, and

application

is the licensing application name.

4

5

Repeat on each of the developer workstations.

You can run JProbe if a concurrent license available.

Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement

Table of contents