Analog Devices VisualDSP 50 Licensing Guide Rev 14

							VisualDSP++ 5 Licensing Guide 3-1 
3 INSTALLING A FLOATING 
LICENSE SERVER
There are two parts to floating licenses: server and client. The server 
manages the license pool stored locally on the server. The clients 
“check-out” and return licenses to the server as needed, when 
VisualDSP++ is started and exited.
This chapter describes all the steps required to install floating licenses. 
First, the Floating License Server (version 2.00.7 or later is compatible 
with VisualDSP++ 5) and server license(s) are installed on your server 
machine. Second, VisualDSP++ 5 and your client license(s) are installed 
on your client machine(s).
This chapter also describes the FLEXnet license borrowing feature, 
which is new to VisualDSP++ 5.
If you are upgrading to VisualDSP++ 5 from an earlier version, 
readUpgrading to VisualDSP++ 5 from Earlier Versions.
The chapter is organized as follows:
Server Machine
Client Machine
License Borrowing 
						

							Server Machine
3-2 VisualDSP++ 5 Licensing Guide
Server Machine
There are two parts to the VisualDSP++ Floating License Server:
 VisualDSP++ License Manager
 FLEXnet (formerly called FLEXlm) LMTOOLS
Your floating license serial number is installed through the VisualDSP++ 
License Manager. A Windows service must then be configured and started 
using FLEXnet LMTOOLS.
If you are installing the Floating License Server for the first time, go 
directly to Task 1B: Installing the VisualDSP++ Floating License Server.
If you are upgrading an existing installation of the VisualDSP++ Floating 
License Server, first you must disable and uninstall this existing installa-
tion as described in Task 1A: Disabling and Uninstalling an Existing 
Floating License Server, and then install the new version.
Version 2.00.7 and later of the Floating License Server are compat-
ible with VisualDSP++ 4.0, VisualDSP++ 4.5, and VisualDSP++ 5. 
						

							VisualDSP++ 5 Licensing Guide 3-3 Installing a Floating License Server
Task 1A: Disabling and Uninstalling an Existing 
Floating License Server
You must perform the following procedure if you are upgrading an 
existing installation of the VisualDSP++ Floating License Server. 
The procedure disables and then uninstalls the software.
Uninstalling the Floating License Server tools from Add/Remove pro-
grams leaves your 
license.dat file intact in the \LMSERVER 
directory. This means that you can simply re-use your original 
license.dat file and skip Task 2.
However, to take advantage of the new license borrowing feature 
introduced in VisualDSP++ 5 and version 2.00.7 of the Floating License 
Server, you must move your existing 
license.dat file out of the way and 
re-install and re-validate your serial numbers. From VisualDSP++ 5 
onwards, license strings (and therefore validation codes) have changed in 
format. This means that you need to re-register all your serial numbers 
and install the version 5-compatible validation codes sent to you.
For further details, see Registering and Validating Your License.
Save your \LMSERVER\license.dat file to a safe 
place before proceeding.
1. From the Windows Start menu, choose All Programs -> Analog 
Devices -> VisualDSP++ Floating License Server -> FLEXnet 
LMTOOLS.
The LMTOOLS window appears.
2. Click the Start/Stop/Reread tab and click Stop Server.
3. Close LMTOOLS. 
						

							Server Machine
3-4 VisualDSP++ 5 Licensing Guide4. In the Windows Control Panel, open Add/Remove Programs and 
uninstall VisualDSP++ Floating License Server (or VisualDSP++ 
License Manager Server, as it was named in earlier versions).
5. Reboot the machine.
Task 1B: Installing the VisualDSP++ Floating License 
Server
The following one-time procedure installs the VisualDSP++ Floating 
License Server, consisting of the VisualDSP++ License Manager and 
FLEXnet LMTOOLS.
1. Download the Floating License Server Installer from the 
VisualDSP++ Downloads and Updates Web page at
http://www.analog.com/en/processors-dsp/software-and-ref-
erence-designs/content/visualdsp_tools_upgrades/fca.html
.
2. Navigate to the download target folder, and unzip the 
VisualDSP_-
FLS_xxxx.zip
 file.
3. Run setup.exe. 
The InstallShield wizard appears. 
						

							VisualDSP++ 5 Licensing Guide 3-5 Installing a Floating License Server
4. Follow the prompts.
The wizard completes the Floating License Server installation. The 
default installation path is shown in Figure 3-1.
A 
client-license.dat file have been created, ready for installation 
on your client machine (see Task 4: Installing a Client License).
5. Copy the 
client-license.dat file from the \LMSERVER
 directory to a shared network folder.
Ensure that it has read-only permissions and is accessible to the 
“Everyone” group.  Figure 3-1. InstallShield Wizard 
						

							Server Machine
3-6 VisualDSP++ 5 Licensing Guide
Task 2: Installing a Server License
If you are upgrading from an earlier release of the Floating License 
Server and still have your original 
license.dat located in the 
\LMSERVER directory, you can skip this task and 
go directly to Task 3: Configuring and Starting FLEXnet 
LMTOOLS.
For further details, see Task 1A: Disabling and Uninstalling an Existing 
Floating License Server.
Perform the following procedure for each floating license serial number. 
One serial number is installed for each single seat or 5-seat package.
1. From the Windows Start menu, choose All Programs -> 
Analog Devices -> VisualDSP++ Floating License Server -> 
VisualDSP++ License Manager.
The VisualDSP++ License Manager dialog box appears 
(Figure 3-2).
2. Click New. Figure 3-2. VisualDSP++ License Manager 
						

							VisualDSP++ 5 Licensing Guide 3-7 Installing a Floating License Server
3. In Serial number, enter the serial number exactly as it appears, 
including dashes.
4. Click OK.
Upon successful installation, a success message appears.
A 
license.dat file has been created and is located in your \LMSERVER
 folder. 
If you are using Windows Vista (or later) and have a User Account 
Control enabled, the 
license.dat file is saved to your Virtual-
Store
 directory: 
C:\Users\\AppData\Local\VirtualStore\Program 
Files\Analog Devices\VisualDSP \System
.
For details, refer to “Windows Vista Compatibility in VisualDSP++ 5.0 
Development Tools” (EE-330) at
http://www.analog.com/en/processors-dsp/blackfin/products/appli-
cation-notes/resources/index.html
.
If using Windows 7 or later, refer to DOC-1190 on the FAQ page at 
http://ez.analog.com.
The new license is activated for a temporary period only. The newly 
installed serial number will appear on the License page of the About  
						

							Server Machine
3-8 VisualDSP++ 5 Licensing Guidedialog box (Figure 3-3) and will have a status of 
Not Validated 
(Expiring in 30 days)
.
In order to make your full floating license permanent, you must validate 
it. You can obtain the necessary validation code by registering online as 
described in Registering and Validating Your License. 
If you do not validate the license within the temporary license 
period, your license will cease to function until you validate it. Figure 3-3. License Page Indicating an Installed Serial Number Expiring 
in 30 Days 
						

							VisualDSP++ 5 Licensing Guide 3-9 Installing a Floating License Server
Task 3: Configuring and Starting FLEXnet LMTOOLS
This section describes how to configure FLEXnet LMTOOLS to run 
the Floating License Server as a Windows service and how to set up the 
path information for your license files.
1. From the Windows Start menu, choose All Programs -> 
Analog Devices -> VisualDSP++ Floating License Server -> 
FLEXnet LMTOOLS.
The LMTOOLS window appears.
2. Click the Service/License File tab and click Configuration using 
services and LMTOOLS ignores license file path environment 
variables. Refer to Figure 3-4.
Figure 3-4. LMTOOLS Service/License File Tab 
						

							Server Machine
3-10 VisualDSP++ 5 Licensing Guide3. Click the Config Services tab. 
4. Set up the options (see Figure 3-5) as follows:
In Service Name, enter the name of the new service you want to 
create (or select an existing service).
Add/modify the name and paths to the existing 
lmgrd.exe file and 
the 
license.dat file. Also, provide a name (.log) for 
the log file, which will then be created if it does not already exist.
By default, FLEXnet LMTOOLS looks for a license file with a 
.lic extension. Files with a .dat extension (the extension used by 
the VisualDSP++ License Manager) are also accepted. Simply 
change the extension in the Files of Type field to License Files 
(*.dat) when browsing for the file. Figure 3-5. LMTOOLS Config Services Tab