Contents. TSM Remote Server Installation guide

(1)

Version 1.22 - 1 - Last Modified by David Younger

TSM Remote Server Installation guide

1 Introduction

This document describes how to install the TSM Remote service. TSM Remote supports the following Operating Systems:

 Windows Server 2003 – 32bit/64bit  Windows 7 – 32bit/64bit

 Windows 7 SP1 -32bit/64bit

 Windows Server 2008 (Not Server Core Role)  Windows Server 2008 R2 (Not Server Core Role)  Windows Server 2008 R2 SP1 (Not Server Core Role)

2 Pre-installation requirements

2.1 .NET Framework 4.0

If not already installed, download .Net Framework 4.0 from the Microsoft site. Make sure .Net Framework 4.0 must be FULL version

2.2 Adobe Air

Obtain Adobe Air from http://get.adobe.com/air/thankyou/?installer=Adobe_AIR_3.4_for_Win32

2.3 IE8 or higher version

(4)

3 Windows 7 x86 (32bit)

3.1 IIS installation

Start -> Control Panel -> Programs and Features -> Turn Windows features on or off

(5)

3.2 .NET Framework 4.0 installation

Download the Full version of .NET Framework 4.0 and install

After the installation process has completed, entering the following URL http://localhost or

http://127.0.0.1 into your browser and you should see the following::

3.3 Virtual directory creation

Extract the contents of the tsmremoteserver.zip file into c:\inetpub\wwwroot. You can obtain this file from

http://www.theservicemanager.com/tsmdl/tsmremote/tsmremoteserver.zip

3.4 Convert the directory into an application

 Access the IIS manager from Control Panel -> Administrative Tool -> Internet Information Service (IIS) Manager

(6)

Version 1.22 - 6 - Last Modified by David Younger o .NET Framework version: .NET Framework v4.0.30319

o Managed pipeline mode: Integrated o Check: Start application pool immediately

 On the left panel, expand <yourrmachine> -> Sites -> Default Web Site

 Right click on TSMService and select Convert to Application, in application pool, select TSM then leave the rest as default.

3.5 Accessing the TSM Remote Config screen via browser

URL: http://<SERVER-IP>/TSMService/

3.6 Creating a website and virtual directory

If you want to create a new website rather than default website in IIS manager, you can: 1. Open IIS manager right click on Sites and choose Add Web Site

2. In the Add Web Site wizard, type TSMRemote as a name to the website, proper Application pool configuration refers to step 3.3

3. For the Physical path, choose the upper directory of the TSMRemote folder 4. Type in the reserved IP address, port number and host name for this new website 5. Click Ok

6. Right click the TSMService and select Convert to Application 7. Apply read permission to IIS_IUSERS in the virtual directory

(7)

4 Windows 7 x64 (64bit)

4.1 IIS installation

Refer to step 3.1

4.2 .NET Framework 4.0 installation

4.3 Virtual directory creation

(8)

4.4 Convert directory into application

Refer to step 3.4

4.5 Activate 32bit mode Microsoft IIS

As the operation system is 64 bit and the application “TSMService” is 32 bit, we have to run IIS in 32 bit mode.

To activate 32 bit mode in Microsoft IIS

1. Open a Command Prompt under Administration rights 2. Type the flowing command to enable the 32 bit mode:

cscript %systemdrive%\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1

4.6 Register .NET Framework 4.0 to IIS

Run the following command in Command Prompt under Administration rights %windir%/Microsoft.NET/Framework/VERSION/aspnet_regiis.exe -i

Replace VERSION with your ASP.NET version which is most likely to be v4.0.30319

4.7 Access to TSMService via browser

Refer to step 3.5

(9)

5 Windows Server 2008 R2

5.1 IIS installation

1. Click start -> All programs -> Administrative Tools -> Server manager

2. In Server Manager scroll down to roles and summary and then click Add roles

3. The Add roles Wizard will start with a “before you begin” page asking for verification of the settings

4. Select Web Server (IIS) on the select server roles pages. An introductory page will open with links for further information

5. Select IIS service to be installed on the select roles service page 6. Select ASP.NET in application development and other desired modules 7. IIS should now be installed with ASP.NET

5.2 .NET Framework 4.0 installation

5.3 Creating a website and virtual directory

1. Open IIS management from Administrative Tool

2. On the left panel, expand then right click on Sites and click Add Web Site 3. Type TSMRemote as site name in this guide,

(10)

(11)

5.4 Converting your TSM Remote web site into an Application

1. In the left panel in IIS manager, in Application Pools, right click on TSMRemote in the middle panel and choose Advanced Setting

2. Change .NET Framework Version to v4.0 and Enable 32-Bit Application to True

3. Click OK to continue

(12)

5.5 Accessing your TSMService via a browser

URL: http://<SERVER-IP>/tsmservice/

(13)

6 Windows Server 2003 x86 (32bit)

6.1 IIS installation

1. Click Start -> Control Panel -> Add or Remove Programs

2. Click Add / Remove Windows components in Add or Remove Programs

3. In Windows component wizard select Application Service and then click details 4. Select ASP.NET and the click ok.

5. Click next and then finish

6. Some necessary files from Windows Server 2003 installation disc may be required, please insert the installation disc to continue the process.

7. IIS is installed with ASP.NET

8. In order to check if ASP installed correctly, from any browser access http://localhost or http://<server-ip> and the following page should appear:

6.2 .NET Framework 4.0 installation

1. Download .Net Framework 4.0 full version

2. Double click to start .Net Framework 4.0 installation

(14)

Version 1.22 - 14 - Last Modified by David Younger 4. After installation, a restart may be required

6.3 IIS configuration

Open the IIS manager - click start -> Control Panel -> Administrative tool -> IIS manager and select web service extensions. Check that ASP.NET v4.0 is allowed and if not select it and click on allow. If you cannot see ASP.NET in the web service extension it may be that it is not registered correctly with IIS. In order to register ASP.NET 4.0 with IIS, start a Command Prompt under Administration rights and then type:

%windir%/Microsoft.NET/Framework/Version/aspnet_regiis.exe –i

Replace Version with your ASP.NET version which is most likely to be v4.0.30319

6.4 Creating a website and virtual directory

1. Open IIS manager and right click on Web Sites and click New, and Web Site

2. In website creation wizard click next and type TSMRemote as the web site description Click next. Leave the IP address as default and set the port to a unique port available for TSM Remote. Ensure your firewall does not block this port for external access.

(15)

4. Click next and in Web site access permissions select Read and Execute to be ticked. 5. Click finish and a new TSM Remote website will be created

6.5 Creating an application pool

1. Expand your website which is TSMRemote in this guide and right click TSMService -> Properties

2. Under the Directory Tab, in Application Settings, click Create and a new application will be created and named TSMService

3. Under the ASP.NET tab, check that the ASP.NET version is updated to at least 4.0.30319 4. Click OK to finish

6.6 Access to TSMRemote

TSMRemote is available in a browser by selecting the URL is <reservered-ip>/TSMService, or you can use http://localhost:89/TSMService on the TSM Remote server.

7 Windows Server2003 x64 (64bit)

7.1 IIS installation

Refer to step 6.1

(16)

7.3 IIS configuration

1. Open IIS manager click start -> Control Panel -> Administrative tool -> IIS manager and select web service extensions. Check that ASP.NET v4.0 is allowed if not select it and click on allow.

If you cannot see ASP.NET in the web service extension it may be that it is not registered to IIS. In order to register ASP.NET 4.0 with IIS, start a Command Prompt under

Administration rights then type

%windir%/Microsoft.NET/Framework/Version/aspnet_regiis.exe –i

Replace Version with your ASP.NET version which is most likely to be v4.0.30319 2. As the operating system is 64 bit and the application “TSMService” is 32 bit, we have to

run IIS in 32 bit mode.

To activate 32 bit mode Microsoft IIS

1. Run the Command Prompt under Administration rights 2. Type the flowing command to enable the 32 bit mode: cscript %systemdrive%\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1

7.4 Creating a website and virtual directory

Refer to step 6.4

Check if ASP.NET 32bit mode is activatied by the Web service extension

7.5 Accessing to TSMRemote

TSMRemote is available via a browser and the URL is <reservered-ip>/TSMService, or

(17)

8 FAQ

Q: Cannot create Active X component? A1: Enable 32-bit mode in IIS

A2: Run the Command Prompt under Administration rights, change into the TSM folder and type regsvr32 TSM.dll

Q: Cannot find aspnet_regiis.exe file?

A: Check if your .NET framework is the Full version

Q: Error message:

global.lasterror_assign c:\tsm\testlib.vct Error in line 33 Cannot update the cursor L_A_LASTERROR, since it is read-only. 111

A: Change the TSM folder security permission for everyone to have full control

(18)

9 Version history

Date Version Editor Comment

06/25/2012 1.1 Liang Tan TSM Remote guide1.1 for website

06/26/2012 1.2 Liang Tan Name correction