Installing the Entitlement LAN Service
[click logo to return to home]
TFS Version 13 saw the introduction of the Entitlement system to manage the licensing of TFS. To be able to use this you need to install Internet Information Services on a machine that is within the network used by TFS.
This article provides step by step instructions on how to set up the Entitlement LAN Service.
These instructions have been created using Version 7.5 of IIS. Ensure you've logged onto the machine under a user that has administrator access or you will not be able to perform some of the actions listed.
- Enabling Internet Information Services.
- Install the Entitlement Database.
- Software requirements.
- Creating the website.
- Importing the package files.
- Confirm the service is running.
- Create Windows firewall rule.
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.
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)
Create a new database;
Restore the database {{Insert name here}}
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.
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
If you are installing TFS as a standalone system on a Windows 10 system you need to install
- Install Web Platform Components - https://www.microsoft.com/web/downloads/platform.aspx
You will need to first install 'Web Platform Components' from - https://www.microsoft.com/web/downloads/platform.aspx
Once installed you will need to close IIS Manager and relaunch it. You will now see Web Platform Components under Management. Double click on Web Platform Components.
Click on the Products Tab and search for 'Web Deploy 3.5' and press enter.
Click on 'Add' next to Web Deploy 3.5 and the Install.
Once installation is complete you will then need to close and relaunch IIS Manager.
- Ensure Windows Deployment Services is installed in the Server Manager. Run Server Manager, right click on Roles and choose 'Add Roles'.
- A dialog will open, click the 'Server Roles' menu on the left, and ensure 'Windows Deployment Services' is installed.
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"
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.
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.
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.
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'.
Specify Port 85.
Allow the connection.
Specify when the rule applies.
Give the rule a name and click Finish.
