Managing Token Pools

The default port for communication between client computers and the MxServe service is Port 1234.  If Port 1234 is not available, you will be notified when you install MxServe.  At the command prompt, you can use the command netstat -a to show what ports are in use.  This will help you select an alternate port.

After a license is installed (validated), changing the name of the server or the port renders the license unusable. You can recover the license by restoring the original machine name and port number.

Changing machine name or port is possible with assistance from Danlaw using the procedure below.

To change the Port:

1.Kill the license.

2.Navigate to the install folder for MxServe.  Typically C:\Program Files (x86)\MicroMax\MxServe

3.Using Notepad, open the XML file named MxServe.exe.config

4.Change the Port Id and save the file.

5.Using the Windows Services Manager, stop and start the service called MxServe.

6.Generate a new Site Code and send it to mxsupport@danlawinc.com

7.When you receive a new License Key from Danlaw, use the Validate button to install it.

8.Notify any users of the Token Host server of the Port change.

If you want more than one token pool on a single server, use these steps to set up a second token pool once the first one is established:

1.Make a copy of the MxServe installation folder. Normally MxServe is installed in one of the following:

•C:\Program Files (x86)\MicroMax\MxServe

•C:\Program Files\MicroMax\MxServe

For example, copy C:\Program Files (x86)\MicroMax\MxServe to: C:\Program Files (x86)\MicroMax\MxServe2.

2.Delete <port>etats.loop and <port>etats.loopA from the new folder.
 
For example: 1234etats.loop and 1234etats.loopA

3.Create a second MxServe service:

•On the command line enter: sc create “<name>” binpath= “<path>” where
 
<name> is the name of the new service (e.g. “MxServe2”)
 
<path> is the absolute path to MxServe.exe in the new folder (for example, "C:\Program Files (x86)\MicroMax\MxServe2\MxServe.exe")

Notes:

•A space is requried between binpath= and “<path>”

•Always use the absolute path to MxServe.exe, even if you have changed directories into the MxServe2 folder.

4.Configure a new Port for the new MxServe:

•Using Notepad open MxServe.exe.config in the MxServe folder copy you made in Step 1. (for example: "C:\Program Files\MicroMax\MxServe2")

•Change the Port number as described steps 2 through 5 of the section above.

5.Configure the new service:

•In the Windows Services windows, change the service to start automatically.

•Start the service manually or reboot the computer.

6.Set up the Tokens:

•Use the MxServe Monitor in the usual way to generate a site code and validate the tokens.  Be sure to use the new Port Id.

When upgrading MxServe to a new release, use these instructions if you have a second token pool:

1.Make sure you have first upgraded MxServe using the MxServe installer.

2.Stop the MxServe service that you are about to upgrade.

3.Copy the following files from the freshly upgraded installation folder of MxServe to the folder you wish to upgrade. Make sure to overwrite anything it asks you to.

•MxServe.exe

•MxServeManager.exe

•MxServe.exe.config (when upgrading from MxServe 1.0.x to 2.0.x)

•Micromax*.dll (The * denotes a wildcard. Copy the files beginning with "Micromax" and ending with the ".dll" extension.)

Note: DO NOT COPY THE ENTIRE MxSERVE FOLDER. This will overwrite your license settings and you will have to contact Danlaw to obtain a new license.

4.If upgrading from MxServe 1.0.x to 2.0.x, reset the port number for the second pool as described in the section above.

5.Start the MxServe service that you stopped in step 2.

You can check the status of Token Host Servers from your desktop computer as follows:

1.Launch the MxServe Monitor or MxV License Manager.

2.Select a server in the Server Information section.

3.Click the Refresh button.

Information on the token pool is displayed in the MxServe Status column. Also, see Viewing Users (Clients Tab).