[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.
Enabling IIS
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 setup a sql server user to have access to this database. 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 Deploy Package http://www.iis.net/downloads/microsoft/web-deploy
Choose the package relevant to your machine;
Select Download
Run the installer
Select Typical and click Next
Click Install
- 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.
