Installing the Entitlement LAN Service


ECM Usage	ECM FAQ	ECM Best Practice	ECM Technical Resources	ECM Release Information
Return to Framework Resource Centre

Article Index

Introduction

Framework Version 8 saw the introduction of the Entitlement system to manage licensing replacing the hardware sentinel key. This article explains how to install the LAN service. To be able to use this you need to install Internet Information Services on a machine that is within the network used by Framework.

This article provides step-by-step instructions on how to set up the Entitlement LAN Service.

Enabling IIS on Windows Server

In Server Manager click on ‘Add roles and features’

Enable the below Server Roles.

Enable the below Features.

Enabling IIS on Windows Desktop

You need to ensure that Internet Information Services is enabled. Go to Start->Run type inetmgr and press OK. If you get an IIS configuration screen it is installed, otherwise you will get an error message

If you need to enable it open Control Panel \ Programs and Features and select Turn Windows features on or off.

Click on Internet Information Services and the click on OK.

Return to top

Installing the Entitlement Server database

The Entitlement LAN Service uses a local SQL database to store licensee details you need to restore the entitlement backup file to a new database .(entitlement_new_v13.bak)

Creating the entitlement database - Click here to expand...

Once installed you may need to set up an sql server user to have access to this database.

Click on the User Mapping tab and add the user to your database. Please be sure to check db_owner.

Furthermore, when creating a new SQL login even if you check db_owner you will need to go back into the user and check db_owner again.

This is important in the final step of logging into the LAN Service for the first time, where we have to connect to the database with a valid user and password.

Return to top

Other Software Requirements

If you are setting up the machine for the first time, you will also need to ensure the following are also pre-installed;

Check if .NET 4.5.2 is installed. https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed#net_b .
If it is not installed, go here and download/install it www.microsoft.com/en-au/download/details.aspx?id=42643
asp.net needs to be configured and registered with the IIS server using the command line
C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -iru

Installing on Standalone Windows 10

Installing on a server - Click here to expand...

BACKUP YOUR IIS MANAGER

Always make a backup prior to changing your system. Run the following command to backup an IIS 7.0 or above server: %windir%\system32\inetsrv\appcmd add backup "PreMsDeploy"

Return to top

Creating the Web Site

Create a directory underneath the inetpub directory called EmsLanService.

Ensure that Users have Full Control of the inetpub directory

Open the IIS Manager by clicking Start > Run and typing inetmgr.
Right click the Sites folder, choose 'Add Web Site...'. Enter the Site Name 'EmsLanService' Click the Select button next to the application pool and choose 'DefaultAppPool'.
Set the Physical Path to be like in the image below. You will need to Make a new folder for the service.
Ensure the port is 85, and settings look like below, click Ok.

Return to top

Importing the package files

In IIS Manager, expand the Sites node, you'll see the new EmsLanService site.
Right click the new EmsLanService Website and choose deploy → Import Application. NOTE: If 'Deploy' menu is missing you need to check the pre-install steps above.

Select the package .ZIP file to import (Eros.Subtle.Samarthya.LANService.zip) (This does NOT need to be Unzipped)
On the 'Application Package Information page, clear the Application Path field (you'll get a warning, say yes to continue) leave the default connection strings.

Click Next to install the package.
The Summary page will provide a high-level overview of some items that were installed from the package. The Details tab will give a lot of detail of exactly what was added. Click Finish.

Return to top

Confirm service is running

You should now confirm the service is running. Click on the Site then choose 'Browse..' under the actions on the right. This will open the browser window and it should be displaying correctly.