White Paper. Fabasoft Folio Thin Client Support. Fabasoft Folio 2017 R1

Size: px

Start display at page:

Download "White Paper. Fabasoft Folio Thin Client Support. Fabasoft Folio 2017 R1"

Randolf Job Banks
6 years ago
Views:

1 White Paper Fabasoft Folio Thin Client Support Fabasoft Folio 2017 R1

2 Copyright Fabasoft R&D GmbH, Linz, Austria, 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 2

3 Contents 1 Introduction 4 2 Software Requirements 4 3 Citrix Presentation Server Installation Configuration Program Neighborhood Agent Load File Type Associations to Citrix Server Publish Applications 31 4 Citrix Client Configuration 36 5 Configuration of Native WebDAV Support in Fabasoft Folio 41 Fabasoft Folio Thin Client Support 3

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 2016 Standard 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 4

5 1. Run autorun.exe in the Citrix Presentation Server installation kit. 2. Click Install Products and Updates ( Produktinstallationen und Updates ). 3. Click Remap Drives ( Laufwerke neu zuordnen ). Fabasoft Folio Thin Client Support 5

During the installation Java runtime environment 5 Update 6 is going to be installed as it is a prerequisite of die Citrix Licensing. 8.

6 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 ). 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 ). Fabasoft Folio Thin Client Support 6

7 10. Read the license agreement, accept it and click Next. 11. Read the prerequisites and click Next. Fabasoft Folio Thin Client Support 7

8 12. The components to be installed can be selected or deselected. Click Next. 13. As the license server has been installed previously select the second option and click Next. Fabasoft Folio Thin Client Support 8

9 14. Click Next. 15. Select the tools to be installed and click Next. Fabasoft Folio Thin Client Support 9

To install the web interface, ASP.NET 2.

10 16. Click Next. 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 10

11 19. Click Next. 20. Select an installation directory and click Next. Fabasoft Folio Thin Client Support 11

12 21. Click Next. 22. To start the installation click Next. Fabasoft Folio Thin Client Support 12

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

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

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

For testing purposes you can select local Microsoft Office Access

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

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

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

To avoid troubles with the Internet Information Service define

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

20 37. Add a user list and click Next. 38. After the installation has completed successfully click Finish. Fabasoft Folio Thin Client Support 20

21 39. Click Close. 40. The next part of the setup is the installation of the management console. Click Next. Fabasoft Folio Thin Client Support 21

22 41. Click Next. 42. Follow the installation wizard. 43. To install the Document Center click Next. Fabasoft Folio Thin Client Support 22

23 44. Specify an installation directory for the Document Center and click Next. 45. Click Finished. Fabasoft Folio Thin Client Support 23

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

Start the Access Management Console by clicking Start > Programs > Citrix > Management Consoles > Access Management Console. 3.2.

25 Start the Access Management Console by clicking Start > Programs > Citrix > Management Consoles > Access Management Console 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 25

To create a new Program Neighborhood Agent service site select

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

27 3. Click Next. 4. Click Next. Fabasoft Folio Thin Client Support 27

28 5. To start the installation click Next. 6. After the installation click Finish and start the configuration. Fabasoft Folio Thin Client Support 28

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

The Program Neighborhood Agent can be configured in the Access Management

30 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 > > config.xml. Fabasoft Folio Thin Client Support 30

11. To use single sign-on, change the authentication mode to Pass-through and set it as default. 3.2.

31 11. To use single sign-on, change the authentication mode to Pass-through and set it as default 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 Publish Applications To publish an application which is installed on the server, perform following steps: Fabasoft Folio Thin Client Support 31

Right-click Applications and select New > Publish Application.

32 1. In the Access Management console navigate to Citrix Resources > Presentation Server > Farm > Applications. Right-click Applications and select New > Publish Application. 2. Now a wizard starts. Click Next. Fabasoft Folio Thin Client Support 32

33 3. Specify a name for the application and click Next. 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 Fabasoft Folio Thin Client Support 33

34 command line. Click Next. 6. Add a server which should provide this application and click Next. Fabasoft Folio Thin Client Support 34

35 7. Specify users and groups which are allowed to use this application and click Next. 8. Select Add to client s Start menu, so that the user can access this application within his start menu. Fabasoft Folio Thin Client Support 35

Redirection. Check Show all available file for this application and click Select All. Then click OK.

36 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 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.: Version 10) 2. Execute the installer package on the client system. Fabasoft Folio Thin Client Support 36

37 3. Select a language. 4. Click Next : 5. Read and accept the license agreement and click Next. Fabasoft Folio Thin Client Support 37

Specify the address of the Citrix Presentation server.

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

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

40 through authentication can be disabled later. 11. Click Next. Fabasoft Folio Thin Client Support 40

WebDAV. This results in no local copy of the document.

41 12. Click Next. 13. After the installation has been completed click Finish. 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 Fabasoft Folio Thin Client Support 41

42 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. Fabasoft Folio Thin Client Support 42

White Paper. Fabasoft on Microsoft Windows - Cluster Support. Fabasoft Folio 2017 R1 Update Rollup 1

White Paper. Fabasoft on Microsoft Windows - Cluster Support. Fabasoft Folio 2017 R1 Update Rollup 1 White Paper Fabasoft on Microsoft Windows - Cluster Support Fabasoft Folio 2017 R1 Update Rollup 1 Copyright Fabasoft R&D GmbH, Linz, Austria, 2018. All rights reserved. All hardware and software names