- 2.1. Introduction
- 2.2. Installing free perClass Lite
- 2.3. Installing perClass Toolbox
- 2.4. Making USB dongle working on Linux
- 2.5. Installing perClass Group (floating license)
- 2.5.1. Starting the license server
- 2.5.2. Using perClass on client machines
- 2.6. License error messages
- 2.6.1. No license for product (-1)
- 2.6.2. Wrong host for license (-4)
- 2.6.3. Requested version not supported (-6)
2.1. Introduction ↩
perClass is very easy to install. It is enough to add perclass
directory
from perClass distribution to Matlab path. Optionally, you may also wish to
add data
directory from perClass distribution as number of examples in
this manual use data sets stored there.
This can be done with File/Set path command or via addpath
on command
line.
2.2. Installing free perClass Lite ↩
In order to instal perClass Lite you need distribution archive downloaded via http://perclass.com
The installation consists of the following steps:
- Unzip perClass distribution archive
- Start Matlab
- Add the
perclass
directory on your Matlab path using Set Path command in File menu or usingaddpath
command
perClass Toolbox should be now ready for use. In case you encounter any problems, please send us the error message so we can help you out.
2.3. Installing perClass Toolbox ↩
To install perClass Toolbox, you will need:
- Login information for the perClass Customer center
- Hardware dongle
Installation instructions:
- Go to http://perclass.com/index.php/html/customer/ web page and click on "Log in" link in the right part of the page
- Enter username and password you received from us when purchasing the software
- Click on Customer Center link in the web site header
- Download perClass distribution archive and unzip it
- Download your private license file and save it into
perclass
directory. The license filename should match with your dongle number. Please make sure that the license file extension is.lic
(browsers may sometimes append an additional.txt
file extension after the download.) - Start Matlab
- Plug in your hardware dongle
- Add
perclass
directory on your Matlab path using Set Path command in File menu or usingaddpath
command
perClass Toolbox should be now ready for use. Type sdversion
to see the version and license information which should look similar to this:
>> sdversion
perClass 4.0 (06-May-2013), Copyright (C) 2007-2013, PR Sys Design, All rights reserved
Customer: PR Sys Design (PRSD) Issued: 27-mar-2013
Toolbox with DB,imaging: The license expires on 1-jul-2013.
SDK: The license expires on 1-jul-2013.
Installation directory: '/Users/pavel/matlab/toolboxes/perclass'
In case you encounter any problems, please send us the error message so we can help you out.
2.4. Making USB dongle working on Linux ↩
Under Linux, it may be needed to allow user access to the perClass USB hardware dongle. This can be accomplished by adding a rule to udev subsystem.
open terminal
change directory
cd /etc/udev/rules.d
create a file
85-usb-perclass.rules
as root. Use your favourite editor, example:sudo emacs 85-usb-perclass.rules
copy the following text in the editor and save the file
SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="0e50", ATTR{idProduct}=="000[1-9]", MODE="0666"
Plug in the hardware dongle, start Matlab, add path to perclass
directory and type sdversion
. The udev should be updated automatically and you should see the version message without error. In case the problem remains, contact support@perclass.com
.
2.5. Installing perClass Group (floating license) ↩
- Download license server distribution archive for your system architecture from Customer Center
- Unzip the distribution file. This creates the your license server directory
- Download your floating license file from the Customer center
- Edit the floating license file with the text editor (e.g. Notepad on Windows) and change the hostname (or IP address) of the machine where license server will run.
- Copy the floating license file to the license server directory
- Copy the floating license file to the
perclass
directory used by the client machines
2.5.1. Starting the license server ↩
- Plug in the hardware dongle for the license server to your license ser123ver machine
- On the command line, start the rlm executable (
rlm.exe
in Windows) in the license server directory
Correctly installed server should output message similar to this one (with specific hostname, dongle id and name of floating license file):
11/17 07:19 (prsysd) Server started on Selene (hostid: prdongle=4c972b4f) for:
11/17 07:19 (prsysd) perclass_toolbox sdexport perclass
11/17 07:19 (prsysd)
11/17 07:19 (prsysd) License files:
11/17 07:19 (prsysd) floating.lic
2.5.2. Using perClass on client machines ↩
- Start Matlab on the client machine
- Add path to the
perclass
directory which contains the floating license file
In case of problems with installation, contact support@perclass.com
2.6. License error messages ↩
2.6.1. No license for product (-1) ↩
Three possible reasons:
- There was no license file detected in the directory where the perclass executable is located.
- The license file is found but originates from older perClass release
- The license file is found but is describes different product (e.g. you use license file for perClass Toolbox trying to execute Runtime)
Example:
>> sdversion
No license file with .lic extension present '/Users/pavel/work/perclass'
Error checking out license: No license for product (-1)
Installation directory: '/Users/pavel/work/perclass'
Solution:
Make sure there is a .lic license file present in the directory listed with the error message.
Make sure the license file has .lic extension. Sometimes, email clients or browsers save the file with and extra .txt extension (e.g. "license.lic.txt"). In this case, the license file is invisible to perClass
Make sure the license file present matches the perClass release and product. You can find the correct license files in Customer center. You can open the license file in a text editor (for example Matlab editor) to validate that it's the correct one.
2.6.2. Wrong host for license (-4) ↩
Reason: The host definition in the license file does not match with the hardware dongle (or PC host id)
Solution:
- Make sure you use a correct license file with your dongle. Each license file has a dongle number in
2.6.3. Requested version not supported (-6) ↩
Reason: Your license file is valid for older releases than the distribution you use. This may happen when your software maintenance expired and your try to use new release. Old releases will always keep working.
If you are on active software maintenance (within the first year from purchase or later paying for software updates), you should be able to use all new software relases.
If your maintenance perior expired (you decided not to pay for software updates), you may still use all versions released before maintenance expiration date. Software versions released after will show the above error message.
Solution:
- Make sure you the latest license file
- Make sure the perClass version you use was released before espiration of your maintenance plan