Sentinel License Manager (SLM) v7.2

License Server Installation/Startup -- Quick Instructions

for Windows

	This documents explains how to start the SentinelLM license server for managing licenses for EMA software.  Forinformation on installing a standalone license key (ratherthan a server key), see the software Installation Guide.

INSTALLATION

	The license server files are installed by the installationprogram, in the following subfolder of the EMA softwareinstallation folder:

	<install_dir>\<application_dir>\lic

Here, <install_dir> is the folder where the application was installed (for example, could be something like "C:\Program Files\EMA").

<application_dir> is the name of the top-level folder containing the installed application files.  It could be something like "EMA3Dv3.0.1" or "MHarnessv2.2", for example, depending on which software application you have.

	The license server executable file is "lservnt.exe".  To use it, it must first be registered as a Windows service, then started.  Optionally, it may also then be configured to start every time the computer starts (this is recommended).

REGISTRATION AS A WINDOWS SERVICE

The license server is registered as a Windows service with the command "loadls.exe", which is one of the files installed by the installation program in the "lic" folder. To register the server, log on as Windows Administrator and run the "loadls.exe" command (for example, by double-clicking on it after finding it within the "lic" folder using Windows Explorer).

"loadls" will prompt you for the name of the folder where the license server executable is. This will probably be the same folder as where "loadls.exe" is. Double-check the location of the license server executable "lservnt.exe" displayed under "Executable Path" in the "loadls" dialog box. When the path is correct, press "Add" and exit the dialog box.

STARTING THE SERVER MANUALLY

The license server can now be started manually at any time from the "Services" applet in the Windows Control Panel.  The name of the service in the "Services" applet will be something like "SentinelLM" or "Sentinel License Manager".

STARTING THE SERVER AUTOMATICALLY

Using the "Services" applet in the Windows Control Panel, the license server can also be set to start automatically when Windows starts.

LICENSE KEY FILE

	You will be issued one or more license keys to activate the EMA software you have purchased.  Each license key is an alphanumeric string, usually e-mailed as ASCII text.  All of the license keys for the various EMA products must be placed into a single text file which the license server reads upon startup.  The file should be named "lservrc" and should be placed in the same folder as the license server executable (the "lic" folder of the installation).  (In the examples
above, this was "C:\Program Files\EMA\EMA3Dv3.0.1".)

LICENSE KEY FILE FORMAT

	License key files sent by EMA should already be in the correct format.  However, if there is trouble, the following are the important points to check regarding the format of the license key file.

- Each line in the key file consists of a license key code, optionally followed by a comment.  A '#' marks the beginning of a comment.

- Every line in the key file must begin with a license key code
and not some other text, not even a comment.

- There should be exactly one license key code per line in the
file.

LICENSE KEY FILE PERMISSIONS

	The permissions of the license key file should be set so that the lserv process has permission to read it.

MACHINE LOCKING CODES

	In order to obtain a license for the software you have purchased, you will need to obtain some machine locking codes for the machine on which the license server will run.  This is done with the utility "echoid" which is part of the licensing software and lives in the same folder as the license server.  To generate the fingerprinting information, go to the "lic" folder using Windows Explorer and double-click on "echoid.exe".  Transmit the resulting "Lock Codes" to EMA, and EMA will generate one or more licenses for the appropriate product(s)
based on the locking code(s).
	There may also be a shortcut on the Start Menu for "echoid".  It would be something like

Start MenuProgramsEMAEMA3D v3.0.1Show Machine ID
(for licensing)

	(The path may vary depending on software product and version installed).  The machine locking codes can be generated by clicking on this shortcut, if it exists.
	Be sure to run the utility "echoid" on the machine on which the license server will be running.  This could be a different machine from the one(s) the software application(s) will be used on.

NOTE about "echoid":

	In order to generate the correct locking codes, it is important that the folder where "echoid" lives is the current working directory when you run the command!  This will be true if you run "echoid" using either method described above.
	This is because there is a file "echoid.dat" that also lives in the "lic" folder, which tells "echoid.exe" how to generate the locking codes for EMA software.  "echoid.exe" always looks in the current working directory for this file.  Running "echoid.exe" from some other directory (for example, from a command prompt using its full path name without changing dir to that directory first) will result in
incorrect locking codes.

MORE INFORMATION

	This read-me file is a very brief quick-start guide for starting the Sentinel LM license server for use with EMA software.  For standalone licensing instructions or for more complete information about setting up licensing, see the software Installation Guide.