White Paper Fabasoft Folio Thin Client Support

Fabasoft Folio 2019 Update Rollup 1

Fabasoft Folio Thin Client Support 2

Copyright © Fabasoft R&D GmbH, Linz, Austria, 2019.

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

3.2.1 Program Neighborhood Agent _____________________________________________________________ 25

3.2.2 Load File Type Associations to Citrix Server _______________________________________________ 31

3.2.3 Publish Applications ________________________________________________________________________ 31

4 Citrix Client Configuration ____________________________________________________________________ 36

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

10. Read the license agreement, accept it and click “Next”.

11. Read the prerequisites and click “Next”.

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

14. Click “Next”.

15. Select the tools to be installed and click “Next”.

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

19. Click „Next“.

20. Select an installation directory and click “Next”.

Fabasoft Folio Thin Client Support 12

21. Click „Next“.

22. To start the installation click “Next”.

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

37. Add a user list and click “Next”.

38. After the installation has completed successfully click “Finish”.

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

41. Click “Next”.

42. Follow the installation wizard.

43. To install the Document Center click “Next”.

Fabasoft Folio Thin Client Support 23

44. Specify an installation directory for the Document Center and click “Next”.

45. Click “Finished”.

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

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

3. Click “Next”.

4. Click “Next”.

Fabasoft Folio Thin Client Support 28

5. To start the installation click “Next”.

6. After the installation click “Finish” and start the configuration.

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

“http://cps/Citrix/PNAgent” > “config.xml”.

Fabasoft Folio Thin Client Support 31

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

command line. Click “Next”.

6. Add a server which should provide this application and click “Next”.

Fabasoft Folio Thin Client Support 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 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.: http://www.landonline.govt.nz/software/vista/Ica32Pkg.msi

Version 10)

2. Execute the installer package on the client system.

Fabasoft Folio Thin Client Support 37

3. Select a language.

4. Click “Next”:

5. Read and accept the license agreement and click “Next”.

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

through authentication can be disabled later.

11. Click “Next”.

Fabasoft Folio Thin Client Support 41

12. Click “Next”.

13. After the installation has been completed click “Finish”.