Propalms TSE Quickstart Guide TSE 7.0 Propalms Ltd. Published February 2013 Overview Note: This guide is based on installation on Windows Server 2012. However, it is also applicable if you are using a previous version of Windows Server. This guide walks you through installing the first server in a Propalms TSE 7 Team. Once complete you will have a Windows 2012 Server running Remote Desktop Services and the following Propalms TSE roles:- TSE WEB Server TSE Load Balancer TSE Application Server TSE Database (database can be hosted on TSE server or another server running SQL) Note: This guide presumes your server is a member server in a domain. Software Requirements: Propalms TSE 7.0 Windows Server 2012 Microsoft SQL Server / SQL Express Edition Install Database Software Propalms TSE can use the following versions of database engines only: Microsoft SQL Server OR SQL Express Edition 1
SQL Express is included in the support directory on the TSE 7 media. An install script (InstallSQLEXPRESS.cmd) is included which when run on the server will install SQL Express with the required settings for use with Propalms TSE. The install script creates a SQL instance named Propalms. When prompted for the database server name in the propalms installation, use the format SERVERNAME\Propalms. NB: For increased security please edit the installsqlexpress.cmd file and change the value for the SA password. Currently set to SET SAPWD=propalms Enable Network DTC Access You should ensure these settings are configured on all Propalms TSE Servers including the database server if this is running on another server. Firewall settings Go to Control-Panel and turn off Windows Firewall if it is currently on. 2
Propalms TSE 7.0 Installation The Propalms TSE 7.0 installer now performs an automated installation of all server OS prerequisites providing a much simpler and faster installation experience. From installation media, right click Propalms-TSE.exe and select Run as administrator option. Read and accept license agreement to continue. Choose Domain or Local users for purpose of securing published application access. Domain User option is not available unless the server is a member of a domain. Choose Create New Team. 3
TSE installer ensures pre-requisite checks are met. TSE installer configures required COM+ settings for system automatically. In addition to the TSE Web and Load balancer roles which are installed automatically on the 1 st TSE server in the team, the administrator can optionally install the Application Server and Relay Server roles at this time. Select Application Server Role and continue. In order for the TSE Web role to function, Internet Information Service is required along with a number of other web components. Check the box to Install required Windows roles and services to allow the TSE installer to automatically install these required services and components. 4
The TSE Application server role requires Remote Desktop Services to be enabled. Check the box to Install required Windows roles and services to allow the TSE installer to automatically install these required services and components. Enter Licensing information. Leave as default option for 30 day - 5 user evaluation license. Alternatively, if you already have a Base Key issued from Propalms then you can enter it by selecting the Product Key option. Type your chosen Database name. Provide a valid SQL instance in format of SERVERNAME or SERVERNAME\instancename. If SQL Express was installed using the script provided with the TSE 7 media then use SERVERNAME\Propalms as the value. 5
Enter a Team Name. This can be changed later from the TSE Console. Enter user credentials for the Propalms TSE Identity Account. It is recommended to create a dedicated domain user for this account as certain TSE services will be installed to run under this user context. Therefore any password changes to this account will cause disruption to the TSE environment. This account should already have been created in the Domain or on the local machine. The TSE Identity account should have a local server profile. We recommend installing TSE logged in as the TSE Identity account itself. Enter a Propalms TSE Administrator Group. The account specified above automatically becomes a member of this group. Any users added to this group are provided permission to administer the TSE system. (i.e. Logon to the TSE Management Console) This group should already have been created in the Domain or on the local machine Choose a Destination Folder for installation. 6
Click Next to begin the installation. Shortly after install starts a second installer window will be displayed showing TSE Role installation progress. Please be aware that the Web role can take a number of minutes to complete due to the list of pre-requisite installs it has to perform including.net install which can take some time. Note that.net 2/3.5 install on Windows 2012 downloads files from the MS download site. This may take some time based on the internet connection. If for some reason the.net install fails, the TSE Dashboard page in TSE Console may not function. This can be easily fixed by manually installing.net 2/3.5 on the server. To resolve this, install the.net framework manually on the Windows 2012 server through Server Manager- Add Roles- Features option. You may need to specify the source path for the.net framework install files, available on the 2012 server install media in the \Sources\Sxs folder. Once.Net 2.0 is installed, run the RegNetConsole script available in the Console directory of TSE WEB server \Inetpub\wwwroot\Console folder. Run the script from an Admin Command prompt and then do iisreset.this will register the required.net version with the TSE Console Web directory in IIS. Restart when the installation is complete. 7
TSE Management Console Your Propalms TSE server should now be fully installed. To administer the system go to the Propalms TSE Management Console - http://servername/console and login using the Propalms Identity account specified above or any member of the TSE Administrators group. TSE LaunchPad To login as a user go to the Propalms TSE LaunchPad - http://servername/launchpad and login with a valid user account. The first time you access the Propalms TSE LaunchPad the website will detect whether you have the Propalms Connection Manager Client (TSE Client) installed. If not then you will be prompted to download and install the client software. Chose Download Now and save the client locally. Right click the client executable and choose Run as administrator to install the Propalms Connection Manager software. Once complete click Done to return to the logon page. 8
TSE Desktop Client The new TSE Desktop Client (TSE-DC) offers users a browser-less way to access, manage and configure TSE published applications. The TSE-DC removes browser dependency but offers a user experience and capability similar to that of the TSE Launchpad web portal. TSE-DC is included with the standard v7 TSE Client installation and requires Microsoft.NET 4.0 client profile framework installed on the client machine. TSE v7 client installation will verify if.net 4.0 is available on the client machine, if not it will prompt for approval and also install.net 4.0 client profile framework. The installation package for.net 4.0 is downloadable from the TSE Launchpad portal Download client page and can be installed manually. Alternately the TSE v7 client will prompt the user for a download from MS download site if it does not detect.net v4 client profile framework installed. This needs internet connection. You can launch the Desktop Client using the icon on the desktop or by a right click on the Propalms Connection Manager icon in the notification area. Please note that in order for applications to appear for your users after they login, you have to publish them to groups/ous/users within the Propalms TSE Management Console. For more information refer to the Propalms TSE Administrators Guide. Propalms Ltd is a global provider of application delivery and secure remote access solutions for Terminal Services and Virtual Desktop Infrastructures. Delivering to Enterprises of all sizes we offer reliable, scalable and affordable solutions that simply work. Our belief is that application delivery solutions should be flexible, dynamic and above all, simple to use. 9 2013 Propalms Ltd. All Rights Reserved. Microsoft, Windows are registered trademarks of Microsoft Corporation in the United States and other countries. All other trademarks and registered trademarks are the property of their respective owners.