Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerpt
FWECM RHEAD
FWECM RHEAD
nopaneltrue

Article Index

Table of Contents
minLevel1
maxLevel7

Ensure you have reviewed Framework v8 Pre-Requisites Checklist, prior to continuing with this guide.

Warning

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. 

Warning

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

Expand
titleEnabling IIS on Windows Server
  • Open the start menu and type Server Manager in windows search bar. Click on Server Manager Desktop app.

...

Image Added
  • In Server Manager click on ‘Add roles and features’

...

image-20240929-235952.pngImage Added

  • Click Next on the Add Roles and Features Wizard

...

image-20240925-013616.pngImage Added

  • Select Role based or feature-based installation and click Next.

...

image-20240925-014233.pngImage Added

  • Select the server and click Next.

...

image-20240925-014341.pngImage Added

  • Enable the below Server Roles and click Next.

...

image-20241212-224309.pngImage Added

  • Enable the below Features and click Next. (Ensure you have .NET framework 3.5 and 4.7 checked)

...

image-20240925-014731.pngImage Added

Expand
titleEnabling 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.

image-20240925-044528.pngImage Added

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

image-20240925-044719.pngImage Added

 

  • Click on Internet Information Services and the click on OK.

Note – If you receive an error while installing .NET framework 3.5 

...

Get-WindowsCapability -Online -Name NetFx3~~~~ 

...

  • 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_v13.bak) - N:\Development\Pre-Flight Setups\Entitlement

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.

...

image-20240925-045235.pngImage Added

Creating the entitlement database

...

  • Name the Database INS_Entitlements and click OK.

...

image-20240925-045442.pngImage Added

Restoring the entitlement database

  • Right-click the databases folder and select restore Restore Databases.

...

  • Restore the entitlement database from - N:\Development\Pre-Flight Setups\Entitlement\Entitlement_v13.bak (Insula will provide this) and overwrite the database you just created.

...

image-20240930-000234.pngImage Added

  • 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.

...

image-20240925-045639.pngImage Added

  • 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 

image-20240902-010502.pngImage Added

  • Scroll down to the bottom of the page , select English x64 link.

...

  • and select the below and click Download

image-20240902-010550.pngImage Added

  • Run the installer – click Next.

...

image-20240902-010735.pngImage Added

  • Check the box and click Next.

...

image-20240902-010823.pngImage Added

  • Click Complete.

...

image-20240902-011011.pngImage Added

  • Click Install.

...

image-20240902-011050.pngImage Added

  • Click Finish.

...

image-20240902-011129.pngImage Added

Creating the Web Site

  • Create a new folder in the inetpub folder called ‘EmsLanService’.

  • Ensure that Users the “Users” have Full Control of the inetpub folder.

...

  • the following permissions below

...

  • Open the IIS Manager by clicking Start > Run and typing inetmgr.

  • Right-click the Sites folder, choose 'Add Website'.

...

  • Select the package .ZIP file to import (Eros.Subtle.Samarthya.LANService.zip) - Located in: N:\Development\Pre-Flight Setups\Entitlement (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 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.

...

image-20240925-050219.pngImage Added

image-20240917-051339.pngImage Added

Return to top

Create Windows Firewall Rule to allow access to LAN Service

...

  • Select 'Inbound Rules' and 'New Rule'

...

image-20240925-050405.pngImage Added

  • Select ‘Port' and click ’Next'.

...

image-20240925-050457.pngImage Added

  • Specify Port 85' and click ’Next'.

...

image-20240925-050611.pngImage Added

  • Allow the connection and click ’Next'.

...

image-20240925-050655.pngImage Added

  • Specify when the rule applies and click ’Next'.

...

image-20240925-050750.pngImage Added

  • Give the rule a name and click Finish.

...

image-20240925-050855.pngImage Added


Next steps - Framework v8 Pre-Requisites Checklist