TSM Remote Server Installation guide Contents 1 Introduction... 3 2 Pre-installation requirements... 3 2.1.NET Framework 4.0... 3 2.2 Adobe Air... 3 2.3 IE8 or higher version... 3 3 Windows 7 x86 (32bit)... 4 3.1 IIS installation... 4 3.2.NET Framework 4.0 installation... 5 3.3 Virtual directory creation... 5 3.4 Convert the directory into an application... 5 3.5 Accessing the TSM Remote Config screen via browser... 6 3.6 Creating a website and virtual directory... 6 4 Windows 7 x64 (64bit)... 7 4.1 IIS installation... 7 4.2.NET Framework 4.0 installation... 7 4.3 Virtual directory creation... 7 4.4 Convert directory into application... 8 4.5 Activate 32bit mode Microsoft IIS... 8 4.6 Register.NET Framework 4.0 to IIS... 8 4.7 Access to TSMService via browser... 8 4.8 Creating a website and virtual directory... 8 5 Windows Server 2008 R2... 9 5.1 IIS installation... 9 5.2.NET Framework 4.0 installation... 9 5.3 Creating a website and virtual directory... 9 5.4 Converting your TSM Remote web site into an Application... 11 5.5 Accessing your TSMService via a browser... 12 6 Windows Server 2003 x86 (32bit)... 13 Version 1.22-1 - Last Modified by
6.1 IIS installation... 13 6.2.NET Framework 4.0 installation... 13 6.3 IIS configuration... 14 6.4 Creating a website and virtual directory... 14 6.5 Creating an application pool... 15 6.6 Access to TSMRemote... 15 7 Windows Server2003 x64 (64bit)... 15 7.1 IIS installation... 15 7.2.NET Framework 4.0 installation... 15 7.3 IIS configuration... 16 7.4 Creating a website and virtual directory... 16 7.5 Accessing to TSMRemote... 16 8 FAQ... 17 9 Version history... 18 Version 1.22-2 - Last Modified by
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 Obtain latest version of IE from Microsoft Version 1.22-3 - Last Modified by
3 Windows 7 x86 (32bit) 3.1 IIS installation Start -> Control Panel -> Programs and Features -> Turn Windows features on or off Check Internet Information Service then expand it, then confirm all the following functions are checked: Version 1.22-4 - Last Modified by
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 From Application Pools, right click then select Add Application Pool, o Name: TSM Version 1.22-5 - Last Modified by
o o o.net Framework version:.net Framework v4.0.30319 Managed pipeline mode: Integrated 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 8. The new website should now be successfully deployed and accessible by any browser by keying in the reserved IP or host name in the address bar. Version 1.22-6 - Last Modified by
4 Windows 7 x64 (64bit) 4.1 IIS installation Refer to step 3.1 4.2.NET Framework 4.0 installation Download the Full version of.net Framework 4.0 and install 4.3 Virtual directory creation Refer to step 3.3 Version 1.22-7 - Last Modified by
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 4.8 Creating a website and virtual directory Refer to step 3.6 Version 1.22-8 - Last Modified by
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 Download the Full version of.net Framework 4.0 and install 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, 4. The physical path is the root directory of the TSM Remote folder. In this guide, we will refer to C:\TSMRemote as the root folder but you can create your own root folder anywhere you want. Leave the IP address as default and change the port number to a unique port number for TSM Remote. Ensure that what ever port you choose is open in your firewall for external access. Version 1.22-9 - Last Modified by
5. Click OK to finish Version 1.22-10 - Last Modified by
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 4. Expand the left panel, Sites -> TSMRemote -> TSMService, right click and convert TSMService into an application Version 1.22-11 - Last Modified by
5.5 Accessing your TSMService via a browser URL: http://<server-ip>/tsmservice/ In this guide, TSMRemote can be accessed on the server by using the browser address http://localhost:89/tsmservice/ Version 1.22-12 - Last Modified by
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 3. WIC (Windows Imaging Component) may be required before installation of.net Framework 4.0, follow the recommendation, install WIC Version 1.22-13 - Last Modified by
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. 3. The physical path is the root directory of the TSM Remote folder. In this guide, we will refer to C:\TSMRemote as the root folder but you can create your own root folder anywhere you want. Leave the IP address as default and change the port number to a unique port number for TSM Remote. Ensure that what ever port you choose is open in your firewall for external access. Version 1.22-14 - Last Modified by
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 7.2.NET Framework 4.0 installation Refer to step 6.2 Version 1.22-15 - Last Modified by
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 http://localhost/tsmservice on the TSM Remote server. Version 1.22-16 - Last Modified by
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 Q: Access to the path 'C:\TSMRemote\TSMService\TSM.cfg' is denied. A: Add IIS users permission to the TSMService folder Version 1.22-17 - Last Modified by
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 03/09/2012 1.21 Various proof reading corrections 16/01/2014 1.22 Liang Tan Listed all required IIS options Version 1.22-18 - Last Modified by