How to install and set up a FotoWare License Server and install a license certificate. This can be used in scenarios where activation over the Internet is not an option.
When to use a license server?
You will need a license server for the following scenarios:
You have a redundancy license of a server application
You have licensed a client application for use in a Terminal Server or Citrix environment
You have a concurrent usage license for a client application
The process of installing and setting up the license server consists of the following steps:
Obtaining one or more license certificates
Merging the license certificates (if more than one)
Configuring the associated .opt file to control which named users can check out licenses.
Installing the FotoWare License Server
Installing the license certificate
Testing the license server
Configuring the clients to access the license server
Getting a license certificate
If you have not already received a valid license certificate from FotoWare, contact us to get one.
FotoWare will require the Ethernet ID (aka MAC address) of the network card on the machine that will work as the license server in your network. The license server can be installed on Windows Servers. The server's Ethernet ID / MAC address can be found by running ipconfig / all from the command line.
Merging license certificates
A typical license file (LicenseFile.lic) looks like this:
Note: The license file is tied to the server's Ethernet (MAC) address.
SERVER localhost 0A1B3C4D5E VENDOR fotoware FEATURE ColorFactoryBase fotoware 1.0 permanent 1 SIGN="11E0 CD95 4F5E \ 8553 8664 265E 6B05 4FE3 C140 097D 6D00 96C3 4B17 E30E C32A \ 038C CE7D 8C3A 1501 A513 33C1 912A 8CA7 E43C 669E 5A12 CEED \ 250A 3AE2 4CC9"
A merged license file consists of a single header, followed by all the FEATURE lines combined:
SERVER localhost 0A1B3C4D5E VENDOR fotoware FEATURE ColorFactoryBase fotoware 1.0 permanent 1 SIGN="11E0 CD95 4F5E \ 8553 8664 265E 6B05 4FE3 C140 097D 6DE0 96C3 4B17 E30E C32A \ 038C CF7D 8C3A 1501 A593 33C1 912A 8CA7 E43C 669E 5A12 CEED \ 250A 3AC2 4CC9" FEATURE IndexManagerBase fotoware 1.0 permanent 1 SIGN="11E0 CD95 4F5E \ 8553 8664 265E 6B05 4FE3 C140 097F 6DE0 96C3 4B17 E30E C32A \ 038C CF7D 8C3E 15A1 A514 33C1 912A 8CA7 E43C 669E 5A12 CEED \ 250A 3AC2 4CC9"
Important: Although merging license files is unproblematic, changing anything else in the license file will render it unusable.
If you need to replace the license server, you must perform a Rehost operation from the activation server.
(Contact FotoWare Support for assistance.)
- After having done any merging, rename the license file to licensefile.lic
Read on to learn how to define users, install the license server and, finally, loading the license file and user definition file on the license server.
Define users in the license .opt file
Now you'll need to define which users can check out licenses from the license server. The licenses are named, which means they have to be tied to actual logged-in usernames.
First, download the .opt file here.
Edit the fotoware.opt file to include the username(s) entitled to start the software. (Instructions are included in the .opt file your downloaded above)
Make sure the firewall on the server allows incoming TCP traffic on port 27000
Important - case sensitivity with usernames
The user names specified in the opt file are case sensitive. Hence users will need to log on to Windows using the exact user name casing used in the opt file. Recommended practice is to stick to lower-case usernames throughout the system.
Tip: If you're managing users in an Active Directory you may find it useful to schedule the .opt file to be updated daily to reflect user changes in the AD group.
Installing the FotoWare License Server
The FotoWare License Server can be downloaded from the FotoWare Update Center.
Important: If your system is running a previous version of the FotoWare License server, remove it as follows:
As an administrator, execute the following two commands from a command prompt:
net stop fwlicsrv sc delete fwlicsrv
Then proceed to install FotoWare License Server 11.16, and then configure it as described below. It is installed in C:\Program Files\FotoWare\FotoWare License Server 11.16.
Configuring the License Server
- Start by placing the license file (.lic) file and the .opt file in the program files folder where the license server is installed (C:\Program Files\FotoWare\FotoWare License Server 11.16.)
- Then start lmtools.exe in the same folder to configure the license server.
- Go to the Config Services tab:
- Now you need to supply the following information - see numbers in screenshot above.
- Service Name (1): Give the service a logical name
- Path to the lmgrd file (2): Use the Browse button and locate the license server executable (lmgrd.exe). It should be located in C:\Program Files\FotoWare\FotoWare License Server 11.16
- Path to license file (2): Use the Browse button to locate the license file.
We recommend storing both the license file and the opt file in the same folder as the program executables (point above)
- Path to the debug log file (2): Use the Browse button to locate the log file. It is located in C:\ProgramData\FotoWare\FWLicenseServer64 and is called fwlicsrv.log.
- Having filled out all of the above, select Use Services and Start Server at Power Up (3), and finally click on Save Service (4)
- Next, go to the Start/Stop/Reread tab and click on Start Server to start the service. (See screenshot below)
Changing the port number
To run on another port than the default (27000), the LicenseFile.lic file must be updated. The file can be opened in Notepad.
Change the first line of the file as indicated below:
SERVER localhost 0A1B3C4D5E
SERVER localhost 0A1B3C4D5E 8000
The service must be restarted in order for this change to take effect, and will then run on port 8000. Make sure you select a port number that is not already in use.
Configuring the vendor daemon port number
In addition to setting the server port number, the port for the fotoware vendor daemon should be fixed in environments where the license server and clients are separated by a firewall.
This is done by modifying the VENDOR property in LicenceFile.lic as follows:
VENDOR fotoware PORT=8001
The vendor daemon port needs to be different from the service port. Having made the change in the license file you need to restart the license server. Also make sure to open the port in the firewall as required to allow client-server communications.
Configuring clients to access the license server
It is necessary to configure the client computers to access the license server by setting up an environment variable.
For detailed instructions on configuring your Windows and Mac clients to use the license server, please study this topic in detail.