Skip to main content

 

Documentation & User Guides | FotoWare

Setting up a FotoWare License Server

Applies to:FotoWare versions 7.0 and 8.0

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:

  1. You have a redundancy license of a server application

  2. You have licensed a client application for use in a Terminal Server or Citrix environment

  3. You have a concurrent usage license for a client application

Outline

The process of installing and setting up the license server consists of the following steps:

  1. Obtaining one or more license certificates

  2. Merging the license certificates (if more than one)

  3. Configuring the associated .opt file to control which named users can check out licenses.

  4. Installing the FotoWare License Server

  5. Installing the license certificate

  6. Testing the license server

  7. 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 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 (aka. a 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:

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 fotoware.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.

  1. First, download the .opt file here.

  2. 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)

  3. 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.

The license server uses the TCP Port 27000. It is possible to change this to avoid collisions with other applications. See ‘Configuring the License Server port number’ below.

The application is installed in C:\Program Files (x86)\FotoWare\License Server 11.4. It runs as a service, which is registered with short name fwlicsrv and is listed as FotoWare License Server in the Services Control Panel applet.

Configuring the License Server 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

​To:

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.

Installing the license certificate and .opt file

Copy fotoware.lic and fotoware.opt to C:\Program Files (x86)\FotoWare\License Server 11.4

Start the license server using the Services control panel or the Command prompt:

net start fwlicsrv

Testing the license server

You can test the license server by issuing the following command from a command prompt:

lmutil lmdiag

This will display the features that can be checked out from the server. You can also use lmtools to further diagnose and configure the server. Note that if you change the configuration using lmtools, the uninstallation may not be able to completely uninstall the application.

Configuring the 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.

  • Was this article helpful?