Installing the Entitlement LAN Service
- Matthew Garrett
- Peter Nikolic
- Athina Arabatzis
Article Index
Ensure you have reviewed Framework v8 Pre-Requisites Checklist, prior to continuing with this guide.
IMPORTANT
Insula is required to setup your Entitlement access on the Perspective Platform, prior to you completing these steps.
Please ensure that you are connected by reaching out to our support team.
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.
IMPORTANT
We recommend leaving the Framework Hardware Sentinel Key plugged in for a period of time after switching over to Entitlements. Once removed the Framework Hardware Sentinel Key should be stored in a safe place for at least 6 months, after switching over to entitlements.
Enabling IIS on Windows Server and Desktop
Open the start menu and type Server Manager in windows search bar. Click on Server Manager Desktop app.
In Server Manager click on ‘Add roles and features’
Click Next on the Add Roles and Features Wizard
Select Role based or feature-based installation and click Next.
Select the server and click Next.
Enable the below Server Roles and click Next.
Enable the below Features and click Next. (Ensure you have .NET framework 3.5 and 4.7 checked)
Note – If you receive an error while installing .NET framework 3.5
You can also install .NET Framework 3.5 from the command line:
Using DISM:
DISM /online /Enable-Feature /FeatureName:"NetFx3"
Or with PowerShell:
Enable-WindowsOptionalFeature -Online -FeatureName "NetFx3"
To make sure that the .NET Framework is successfully installed, run the command:
Get-WindowsCapability -Online -Name NetFx3~~~~
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_v13.bak)
Setup SQL Server Authentication
Ensure your SQL server is setup for windows and SQL authentication.
Right click on your SQL server – Properties
Select Security tab and ensure you have SQL Server and Windows Authentication checked – Click OK.
Creating the entitlement database
Right click the Databases folder and select New Database.
Name the Database INS_Entitlements and click OK.
Restoring the entitlement database
Right-click the databases folder and select Restore Databases.
Restore the entitlement database (Insula will provide this) and overwrite the database you just created.
Under the options tab select overwrite the existing database and click OK.
Once restored you will need to set up a sql server user to have access to this database.
Click the dropdown under security - right click Logins and select New Login.
Create a Login name - select SQL Server authentication (eg: Entitlement) - create a password with NO SYMBOLS. Update Keeper. (Note you will need these details later)
Uncheck Enforce password policy and Enforce password expiration.
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 under the user mapping tab 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.
Installing Microsoft Web Deploy
Scroll down to the bottom of the page and select the below and click Download
Run the installer – click Next.
Check the box and click Next.
Click Complete.
Click Install.
Click Finish.
Creating the Web Site
Create a new folder in the inetpub folder called ‘EmsLanService’.
Ensure that the “Users” have the following permissions below
Open the IIS Manager by clicking Start > Run and typing inetmgr.
Right-click the Sites folder, choose 'Add Website'.
Enter the Site Name 'EmsLanService' Click the Select button next to the application pool and choose 'DefaultAppPool'.
Set the Physical Path to point to your EmsLanService folder.
Ensure the port is 85, and the settings look like below, click Ok.
Importing the package files
In IIS Manager, expand the Sites and you'll see the new EmsLanService site.
Right-click the new EmsLanService Website and choose Deploy - Import Application. NOTE: If the '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) click Next.
Ensure everything is checked and click Next.
On the 'Application Package Information page, clear the Application Path field and click Next.
You will receive a warning - click OK.
Select No and click Next.
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.
Confirm service is running.
You should now confirm the service is running. Click on the Site EmsLANService then choose 'Browse.' under the actions on the right. This will open the browser window and it should display a login screen.
Create Windows Firewall Rule to allow access to LAN Service
Press Windows Key + R and type wf.msc
Select 'Inbound Rules' and 'New Rule'
Select ‘Port' and click ’Next'.
Specify Port 85' and click ’Next'.
Allow the connection and click ’Next'.
Specify when the rule applies and click ’Next'.
Give the rule a name and click Finish.
Next steps - Framework v8 Pre-Requisites Checklist