Floating Licenses

 

A floating (roaming) license allows multiple users to share use of an application, whereas a normal license is locked down to a single computer.

One floating license is needed for each concurrent user. For example, with one floating license, any number of users can have the software installed, but only one can use it at at a time - the others must wait for them to finish using it.

With two floating licenses, again, any number of users can have the software installed, but only two can use it at the same time - the others must wait. The waiting users see a warning message. When one user finishes using the software, another user can begin.

Each Floating License also includes the Floating License Server, which ensures that only the licensed number of users have access. The Floating License Server is a small application that normally runs on a server-class computer so that it is always monitoring the licenses (even detecting client computer reboots or crashes).

See also the information on unattended installations. Note - this is quite different to the File Server edition also offered, which is intended to allow the software to run directly on the server, eliminating network latency for very large numbers of files (50,000+).

Note

You need to purchase one floating license for each concurrent user. The software is installed on both the client(s) and server computers, but on the server it is invoked with parameters that makes it run as a server. The server key that we send on purchase determines the maximum number of copies that can be run simultaneously. If you purchase additional licenses we will send you a new key.

Note 2

You must login to download the full copy of the software first - it is different to the evaluation copy.

About these examples

For the examples below, we will use TextPipe.exe as the example, but this equally well applies to WordPipe.exe ExcelPipe.exe, etc.

Entering your key

To start the server and enter your license key, run

C:\Program Files (x86)\DataMystic\TextPipe\TextPipe.exe SERVER REGISTER

The very first time you do this you will be prompted for a key. Enter your key now. The key can be found when you login under the 'Downloads...' link for the product you have purchased.

How to start the server

Choose one computer as the server, typically a server-class computer.

To start the server, run

C:\Program Files (x86)\DataMystic\TextPipe\TextPipe.exe SERVER

Now the server is running you can start up client applications.

 

Note: There are several alternative forms of the SERVER command-line option:

• You can use SERVERX to start it up without a timeout, so that the window will remain on the screen until the user dismisses it.  
• You can use SERVERDOWN to programmatically shut down the server.
• To keep the server running even after system restarts or possible server crashes, we recommend FireDaemon.

Starting a client

Once the server is running, you can start each client (on the same computer or different computers) as per normal e.g.

C:\Program Files (x86)\DataMystic\TextPipe\TextPipe.exe

It will start searching for the server, and if not found, it will abort with an error message. It requires a working TCP/IP network to find the server.

 

You can run the client and server on the same computer. To do so, run:

C:\Program Files (x86)\DataMystic\TextPipe\TextPipe.exe SERVER
C:\Program Files (x86)\DataMystic\TextPipe\TextPipe.exe

Specifying the server location - .INI file

You can optionally specify the TCP/IP address where TextPipe should look for the server, or change the time-out value, using an INI file setting. Note that this is seldom necessary, it's needed only if the server cannot be automatically found using UDP broadcasts.

Create the file TextPipe.INI in the same folder as TextPipe.exe (usually C:\Program Files (x86)\DataMystic\TextPipe) and enter the following text:

[LICENSE]
Server=192.168.0.1
Timeout=3

Server=<IP address> This overrides the UDP broadcast that is used to locate the server, and will let it work on networks that block UDP broadcasts, or over the Internet. Note that this does NOT eliminate the need for UDP, only the need for broadcasts.

Timeout=<seconds> This overrides the amount of time the client waits for a response. The default value is three seconds, and should be sufficient for most purposes.

Working with the Windows XP SP2 firewall

Windows XP Service Pack 2 introduced the Windows Firewall. Although far better than no firewall at all, it leaves something to be desired in the realm of compatibility. Here is the way to open the proper UDP port and make client/server Network Licensing work:

• First, run the software in server mode, and note the UDP port number that it is listed on the server message window. It will be on the line saying something like "Locator started on UDP port XXXXX", where XXXXX is the number.
• Go to your Control Panel and click on the Security Center icon.
• Click on Windows Firewall.
• Select the "exceptions" tab on the dialog that will appear.
• Click on the button labeled "Add Port". It will ask for a program name and a port number.
• Enter the full path and filename for the program file, and the port number you found in the first step, into the edit boxes on that dialog. Also, press the UDP radio button, to change it from TCP to UDP. Then click the OK button.

That should let the client copies locate the server and work as designed.

Troubleshooting

You may also need to disable DEP (Data Execution Prevention) to get the software running.

Windows Firewall

You may need to add an exception to allow the server to monitor incoming connections.

You will need to add an exception if running

  textpipe.exe SERVER

or

  textpipe.exe SERVER REGISTER

results in the following dialog:

Upgrading the Server or Client

The server and client use the same executable file but started in different manners. In order to upgrade the client, you also need to upgrade the server at the same time.