APPENDIX - Installing the LAN server


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

Return to Framework Lan Service.

The MAC address of the machine that you install the LAN service on must be static

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

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.

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 - Click here to expand...

If you are installing TFS as a standalone system on a Windows 10 system you need to install

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

Install Web Platform Components - https://www.microsoft.com/web/downloads/platform.aspx

Installation steps - Click here to expand...

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"

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.