White Paper
Fabasoft Folio Thin Client Support
Fabasoft Folio 2015 Update Rollup 2
Fabasoft Folio Thin Client Support 2 Copyright ©
Fabasoft R&D GmbH, Linz, Austria, 2015.
All rights reserved. All hardware and software names used are registered trade names and/or registered trademarks of the respective manufacturers.
No rights to our software or our professional services, or results of our professional services, or other protected rights can be based on the handing over and presentation of these documents.
Fabasoft Folio Thin Client Support 3
Contents
1 Introduction___________________________________________________________________ 4 2 Software Requirements _________________________________________________________ 4 3 Citrix Presentation Server _______________________________________________________ 4 3.1 Installation _________________________________________________________________ 4 3.2 Configuration ______________________________________________________________ 25 3.2.1 Program Neighborhood Agent _____________________________________________ 26 3.2.2 Load File Type Associations to Citrix Server __________________________________ 32 3.2.3 Publish Applications _____________________________________________________ 32 4 Citrix Client Configuration ______________________________________________________ 38 5 Configuration of Native WebDAV Support in Fabasoft Folio _________________________ 44
Fabasoft Folio Thin Client Support 4
1 Introduction
This document describes how to install and configure Citrix Presentation Server to use Fabasoft Folio with.
2 Software Requirements
System environment: All information contained in this document implicitly assumes a Microsoft Windows environment.
Supported platforms: For detailed information on supported operating systems and software see the software product information on the Fabasoft distribution media.
Descriptions in this document are based on the following software:
Citrix Presentation Server 4.5
Microsoft Windows Server 2008 R2 Enterprise SP1
Microsoft Windows Terminal Server
Microsoft Internet Information Services
3 Citrix Presentation Server
3.1 Installation
Note: The Citrix setup recommends a remapping of all local drives to other letters than “C”, “D” etc. It is strongly recommended to install Citrix Presentation Server on an “empty” system (no Microsoft SQL Server, no Fabasoft Folio) otherwise other applications won’t work anymore after remapping the drives.
Fabasoft Folio Thin Client Support 5 1. Run autorun.exe in the Citrix Presentation Server installation kit.
2. Click “Install Products and Updates” (“Produktinstallationen und Updates”).
Fabasoft Folio Thin Client Support 6 3. Click “Remap Drives” (“Laufwerke neu zuordnen“).
4. Select a letter and click „OK”.
5. After the remapping is finished, restart the computer.
6. Next install Citrix Licensing. Click on the appropriate option in the setup screen (“Citrix Lizenzierung installieren”).
Fabasoft Folio Thin Client Support 7
7. Follow the instructions of the installation wizard. There are no further settings to change. During the installation Java runtime environment 5 Update 6 is going to be installed as it is a
prerequisite of die Citrix Licensing.
8. After the primary installation the configuration wizard starts. Follow this wizard. There are no further options to consider.
9. To install Citrix Presentation Server 4.5 click the appropriate option in the setup screen (“Citrix Presentation Server 4.5 und Komponenten”).
10. Read the license agreement, accept it and click “Next”.
Fabasoft Folio Thin Client Support 8 11. Read the prerequisites and click “Next”.
12. The components to be installed can be selected or deselected. Click “Next”.
Fabasoft Folio Thin Client Support 9 13. As the license server has been installed previously select the second option and click “Next”.
14. Click “Next”.
Fabasoft Folio Thin Client Support 10 15. Select the tools to be installed and click “Next”.
16. Click “Next”.
Fabasoft Folio Thin Client Support 11 17. After this part of the installation has been completed successfully click “Finish”. Afterwards the
Visual J# 2.0 Redistributable package is going to be installed.
18. To install the web interface, ASP .NET 2.0 must be activated in the Internet Information Services. Click “OK” to let the setup do the necessary changes.
Fabasoft Folio Thin Client Support 12 19. Click „Next“.
20. Select an installation directory and click “Next”.
Fabasoft Folio Thin Client Support 13 21. Click „Next“.
22. To start the installation click “Next”.
Fabasoft Folio Thin Client Support 14 23. After this part of the installation has been completed successfully click “Finish”.
24. The next part of the setup starts immediately. Click “Next”.
Fabasoft Folio Thin Client Support 15 25. Select the components which should be installed and click “Next”.
26. Specify a URL for the Passthrough-Client. This address can be changed after the installation.
Click “Next”.
Fabasoft Folio Thin Client Support 16 27. To use single sign-on select “Yes”, so the Passthrough-Client can use the credentials of the user
currently logged in.
28. If this is a new Citrix-Installation select “Create new farm” and click “Next”.
Fabasoft Folio Thin Client Support 17 29. Specify a farm name and a database system where all information is stored. For testing
purposes you can select local Microsoft Office Access database.
30. Specify an administrative user and his domain for the server farm and Click “Next”.
Fabasoft Folio Thin Client Support 18 31. Select IMA-Encryption, to encrypt the data in the IMA data store and click “Next”
.
32. If you have selected the IMA-encryption a certification key must be specified here.
Fabasoft Folio Thin Client Support 19 33. Specify the Citrix license server and click “Next”.
34. If there are no licenses on the Citrix license server, you can add a license or skip this step and do so later.
Fabasoft Folio Thin Client Support 20 35. Define whether user sessions can be mirrored on this server and click “Next”.
36. Specify a port for the Citrix XML service. To avoid troubles with the Internet Information Service define another port than “80” (e.g. 8080).
Fabasoft Folio Thin Client Support 21 37. Add a user list and click “Next”.
38. After the installation has completed successfully click “Finish”.
Fabasoft Folio Thin Client Support 22 39. Click “Close”.
40. The next part of the setup is the installation of the management console. Click “Next”.
Fabasoft Folio Thin Client Support 23 41. Click “Next”.
42. Follow the installation wizard.
43. To install the Document Center click “Next”.
Fabasoft Folio Thin Client Support 24 44. Specify an installation directory for the Document Center and click “Next”.
45. Click “Finished”.
Fabasoft Folio Thin Client Support 25 46. Click “Finish”.
47. After the installation has completed restart the computer.
3.2 Configuration
The complete configuration of the Citrix Presentation Server can be done in the Access Management Console.
Fabasoft Folio Thin Client Support 26 Start the Access Management Console by clicking “Start” > “Programs” > “Citrix” > “Management Consoles” > “Access Management Console”.
3.2.1 Program Neighborhood Agent
The Program Neighborhood Agent provides the published applications on the client computer. It needs a configuration file which is provided over a web service on the Citrix server. Therefore a web interface for the Program Neighborhood Agent must be created in the Access Management
Console.
Fabasoft Folio Thin Client Support 27 1. Under “Citrix Resources” > “Configuration Tools” right-click “Web Interface” and select “Create
Site”.
2. To create a new Program Neighborhood Agent service site select “Program Neighborhood Agent Service site” and click “Next”.
Fabasoft Folio Thin Client Support 28 3. Click “Next”.
4. Click “Next”.
Fabasoft Folio Thin Client Support 29 5. To start the installation click “Next”.
6. After the installation click “Finish” and start the configuration.
Fabasoft Folio Thin Client Support 30 7. Click “Next”.
8. Specify the server farm this Program Neighborhood Agent should use. Enter a Farm name and add at least one server. It is recommended to specify another port number than 80 for the XML service. Afterwards click “Next”.
Fabasoft Folio Thin Client Support 31 9. As the published applications should only run on the server select “Remote”. Click “Next”.
10. The Program Neighborhood Agent can be configured in the Access Management console.
Navigate to “Citrix Resources” > “Configuration Tools” > “Web Interface” >
Fabasoft Folio Thin Client Support 32
“http://cps/Citrix/PNAgent” > “config.xml”.
11. To use single sign-on, change the authentication mode to “Pass-through” and set it as default.
3.2.2 Load File Type Associations to Citrix Server
To load the Windows registry settings for file type associations to the Citrix Presentation Server perform following steps.
1. Navigate to “Citrix Resources” > “Presentation Server”.
2. Right-click on the farm and click “All Tasks” > “Update file types”.
3.2.3 Publish Applications
To publish an application which is installed on the server, perform following steps:
Fabasoft Folio Thin Client Support 33 1. In the Access Management console navigate to “Citrix Resources” > “Presentation Server” >
“Farm” > “Applications”. Right-click “Applications” and select “New” > “Publish Application”.
Fabasoft Folio Thin Client Support 34 2. Now a wizard starts. Click “Next”.
3. Specify a name for the application and click “Next”.
Fabasoft Folio Thin Client Support 35 4. Select the type of application and click “Next”.
5. Browse the executable of the application.
Note: In order that the application should use any parameters add “%*” at the end of the command line. Click “Next”.
Fabasoft Folio Thin Client Support 36 6. Add a server which should provide this application and click “Next”.
7. Specify users and groups which are allowed to use this application and click “Next”.
Fabasoft Folio Thin Client Support 37 8. Select “Add to client’s Start menu”, so that the user can access this application within his start
menu.
9. Click “Finish”.
10. To publish the file type associations to the clients open the properties of the application and navigate to “Advanced “ > “Content Redirection”. Check “Show all available file for this
Fabasoft Folio Thin Client Support 38 application” and click “Select All”. Then click “OK”.
4 Citrix Client Configuration
To install the Citrix ICA Client, perform the following steps:
1. Get the installer package. (e.g.: http://www.landonline.govt.nz/software/vista/Ica32Pkg.msi Version 10)
2. Execute the installer package on the client system.
3. Select a language.
Fabasoft Folio Thin Client Support 39 4. Click “Next”:
5. Read and accept the license agreement and click “Next”.
Fabasoft Folio Thin Client Support 40 6. Ensure that the Program Neighborhood Agent is selected to be installed and click “Next”.
7. Specify the address of the Citrix Presentation server. Consider that the full path to the config.xml is needed. Click “Next”
Fabasoft Folio Thin Client Support 41 8. Specify an installation folder for the client and click “Next”.
9. Now set a name for the client. Ensure that the client name is unique in the network and click
“Next”.
10. Define whether the local username and password should be used to log in to Citrix sessions.
Note: Better to select “Yes” now as it is not possible to change it later. However the pass-
Fabasoft Folio Thin Client Support 42 through authentication can be disabled later.
11. Click “Next”.
Fabasoft Folio Thin Client Support 43 12. Click “Next”.
13. After the installation has been completed click “Finish”.
Fabasoft Folio Thin Client Support 44
5 Configuration of Native WebDAV Support in Fabasoft
Folio
Fabasoft Folio provides functionality for applications to open the content via WebDAV. This results in no local copy of the document. The content is transferred directly from Fabasoft Folio to the client via a WebDAV URL. This functionality works only with applications that support reading or editing documents via the WebDAV protocol. You can start these applications on the Citrix server which will load the file directly from Fabasoft Folio. No local copy of the file is created on the Citrix client.
In order to use the native DAV functionality you have to configure native WebDAV support in your Fabasoft Folio Domain or Fabasoft Folio Tenant.
Additional information about the configuration of Fabasoft Folio and the client can be found in the
“Native WebDAV Support” white paper.