Visual Prototyper User's Guide

Justinmind Prototyper Licensing server: installation and configuration

Contents Licensing server..............................................................................................3 Part 1: Installation...........................................................................3 Part 2: Configuration.......................................................................4 Part 3: (optional) Configuration of a licensing server behind a firewall....................................................................................................12

Licensing server

Part 1: Installation The installation of Justinmind Prototyper Licensing server is straightforward, simply run the installer program and follow the instructions until the end. Justinmind Prototyper's Licensing Server runs as a service and has a management console that you can start from: [Windows] Start Menu. Go to: Start-> Programs → Protection! Licensing Server and click on “Licensing Server Management Console”. Or go to the folder “bin” located inside the installation folder and run ManagementConsole.exe [Linux/Gnome] Go to: Applications-> Other and click on “Licensing Server Management Console” Or go to the folder “bin” located inside the installation folder and run ManagementConsole

Justinmind® 2009. Todos los derechos reservados.

3

Licensing server

Part 2: Configuration 1. Launch the licensing server management console from Justimind's folder in the start menu (see Part 1). The following screen will pop up:

Justinmind® 2009. All rights reserved.

Licensing server

2. Enter your name, “admin” in the field “Login” and leave blank all the other fields. Press “Ok” in the “New connection” dialog and “Connect” in the main window once the “New connection” dialog has closed. If the connection is correctly established with the server you will see the Summary screen.

Justinmind® 2009. All rights reserved.

Licensing server

The next step is to load the floating licenses you have bought, into your licensing server. This is necessary to avoid the installation of these licenses in every computer where your company has a copy of Justinmind Prototyper. 3. Click on the icon labelled “License Storage” this is where you have to load Justinmind Prototyper's floating licenses (the license file send to you by Justinmind when you buy floating licenses)

Justinmind® 2009. All rights reserved.

Licensing server

4. The first time you see this “License Storage” it will be empty. Now drag and drop to the big space in the centre of the screen the floating licenses file sent to you by Justinmind. Note: the floating licenses file is always just one file even if you buy many floating licenses from Justinmind. You will see that your licenses have been loaded into your licensing server:

Justinmind® 2009. All rights reserved.

Licensing server

The last step is to indicate which users or computers are allowed to get a floating license from your license server. Is very important that you do this step carefully in order to restrict the use of your floating licenses to just the users you want. The licensing server management console allows you to select which user names, hosts names and/or IPs will be able get your Justinmind Prototyper floating licenses. 5. As an example, I'll explain how to configure a license server to allow getting floating licenses just to computers located in a local network. Click on the option “License User groups...” in the menu “Edit”.

Justinmind® 2009. All rights reserved.

Licensing server

6. Click on “New” and enter a name for the group, and the IPs that form you local network. You can express these IPs by using the wildcards '*' and '?'. For instance if your local network IPs start by 192.168.1 then you'll need to enter 192.168.1.* in the “Add user group” dialog, like this:

Justinmind® 2009. All rights reserved.

Licensing server

7. Click “OK” and “OK” again in the “License User groups”. 8. Now you have to add the group you just created to your licenses. In the “License Storage” screen there is a tab called “Allocation” on the right part of the screen. Click on the icon that looks like a person with a plus sign (

)

and select the user group you created in steps 6-7 in the dialog that pop ups then click “OK” You should see a screen similar to the following one:

9. Now your licensing server is prepared to start delivering your Justinmind Prototyper Licenses and managing concurrent connections of your user's Justinmind Prototypers instances. 10. Go to the folder “bin” inside of the installation folder of Justinmind's Prototyper Licensing Server. This folder was selected during the installation process

and,

if

Justinmind® 2009. All rights reserved.

you

have

not

changed

it,

is:

\Justinmind\ProtectionLS. 11. Open the file “server.xml” in a text editor. It should look, more or less, like this: ... more text here ...

12. Add to the tag a parameter called “hostName” with the fully qualified name of the machine where the Licensing server is being installed. The result should look like this: . . .

13. Restart the Licensing server: 1. In Windows: go to “Control Panel\Administrative Tools\Services” and restart the service named “ProtectionLS” 2. In Linux: go to the folder “/etc/init.d/”, run “./ProtectionLS stop” and then “./ProtectionLS start”.

Justinmind® 2009. All rights reserved.

Licensing server

Part 3: (optional) Configuration of a licensing server behind a firewall In the case you want to run the licensing server behind a firewall there are a few more steps you will have to go through: 1. Go to the folder “bin” inside of the installation folder of Justinmind's Prototyper Licensing Server. This folder was selected during the installation process

and,

if

you

have

not

changed

it,

is:

\Justinmind\ProtectionLS. 2. Open the file “server.xml” in a text editor. It should look, more or less, like this: ... more text here ...

3. Choose two free TCP ports that are not in use in the computer where the licensing server has been installed and add the following attributes to the “server” tag: ◦ port: port used by Justinmind Prototyper to find the licensing server (default is 1099) ◦ exportPort: secondary port used by Justinmind Prototyper to connect to the licensing server. Choose a port that is not in use in the computer where the licensing server is running (default is 10991). ◦ mgmtPort and mgmtExportPort: these ports are used by the Licensing server console. You should open these ports in the firewall if you want to use the Licensing server console from a computer situated behind the firewall but they are not needed for Justinmind Prototyper (default are

Justinmind® 2009. All rights reserved.

Licensing server

9999 and 9998) The result should look like this: ... more text here ...

4. Open the two TCP ports you have just configured in “server.xml” in your firewall. In the example: the ports 1099 and 10991, both TCP, not UDP. The other two ports: mgmtPort and mgmtExportPort are needed for the Licensing Server console and not for Justinmind Prototyper. 5. Restart the licensing server as explained in step 13 of part 2.

Justinmind® 2009. All rights reserved.

Licensing server

Justinmind Prototyper Licensing Server has many features that are out of the scope of this installation guide, to summarize a few: –

You can configure different users and passwords to restrict the access to the management console. And you can assign different roles to these users in order to allow to perform just certain operations to certain users.

–

You can see which Justinmind Prototypers are connected to the licensing server and thus how many concurrent licenses are is use and who is using them.

–

You can get usage statistics from the management console or from the licensing server log files, etc...

You can find a full explanation of Justinmind Prototyper Licensing Server and its management console capabilities in the “Administrator guide” which is accessible through the “Help” menu.

Justinmind® 2009. All rights reserved.