XIA Links. Administrator's Guide. Version: 3.0. Copyright 2017, CENTREL Solutions

Transcription

1 Administrator's Guide Version: 3.0 Copyright 2017, CENTREL Solutions

2 Table of contents About... 4 Installation... 6 Installation Requirements (Server)... 7 Prerequisites (Windows Server 2016)... 9 Prerequisites (Windows Server 2012) Prerequisites (Windows Server 2008) Prerequisites (Windows Server 2003) Installation Requirements (Client) Server Installation Accessing Server Client Installation Connecting to the Server for the first time Licensing Client Installation using Group Policy Configuration using Group Policy Configuring the Client with Group Policy Configure the XIA Server Address Disable the close [X] button Enable drag and drop to the client device Enable Offline Mode Administration XIA Administrators Managing Applications Dragging and dropping into the Client Creating an Application using the Wizard Creating a Web Site using the Wizard Creating a Directory using Create Custom Application Advanced Application Properties General Requirements Application Settings Repair Audience Display Directory Settings Web Site Settings Other Application Tasks Deleting an Application Duplicating an Application Starting an Application Move an Application to another Section Copy permissions Pinning Application to the Home Page Managing Sections Creating and Editing a Section General Settings Section Appearance Page 2 of 96

3 Add your own Section images Deleting a Section Nesting Sections Configure the Home Page Offline Mode Drag and drop to the client device Licensing Managing Licenses References Troubleshooting Page Not Found HTTP Error Not Found Access to the registry key is denied Cannot drag and drop when using UAC Prompted for Credentials on Windows 2008 R The trust relationship failed Page 3 of 96

4 About ( is an easy to use, desktop application launcher which helps organisations manage their desktop shortcuts. Shortcuts are managed centrally and presented within a single application so they can easily be found and launched by users. Configure Multiple Possible Shortcut Locations In a large company, it is common to use Roaming Profiles or Group Policies to configure which Desktop Icons and Shortcuts are available for a user. However, there are limitations to this, for example, different PC's may have the same application installed in different locations or not installed at all. The effect of this is that users are presented with inaccessible or dead shortcuts. With, you remove this issue of Desktop Icon management as you can configure multiple possible application locations and automatically hide shortcuts to those that don't exist. Network Support allows you to create Links to Applications both locally and on the network, Web Sites and directories. Target Applications These Links can be configured to be available based on users and groups as well as the local computer name. Page 4 of 96

5 is split into 2 components: The main Server application which is installed onto an IIS Server. This stores the configuration of the links and maintains security. The Client which is the application accessed by end users. This presents each user with their available applications and shortcuts. Page 5 of 96

6 Installation The topics in this chapter describe the installation process. Download the latest installation package: Ensure you have an appropriate license file, or request a trial license. Check that the system you are installing on meets the requirements. Note: the prerequisites differ between the various operating systems. Perform the server installation. Perform the client installation. If you experience issues, refer to the troubleshooting articles. Page 6 of 96

7 Installation Requirements (Server) is built on Microsoft.NET and is split into server and client components. See Installation Requirements (Client) for more information on the client installation prerequisites. Server Requirements The following operating systems are supported for the installation of the Server: Windows Server 2016 Windows Server 2012 and 2012 R2 Windows Server 2008 and 2008 R2 Windows Server 2003 Prerequisites The following prerequisites must be installed: Microsoft.NET 3.5,.NET 3.0 or.net 2.0 IIS ASP.NET installed into IIS with the ASP.NET v Web Service Extension Enabled Note: When installing onto Windows Server 2008 and above, the following Role Services must be installed and enabled for IIS: - Security > Windows Authentication - Application Development > ASP.NET - Management Tools > IIS6 Management Compatibility Page 7 of 96

8 If the prerequisites aren't met, the "installer was interrupted" error may be displayed when you start the installation: Page 8 of 96

9 Prerequisites (Windows Server 2016) Use the Add Roles and Features Wizard > Server Roles to install Web Server (IIS) On Features, install.net Framework 3.5 (includes.net 2.0 and 3.0) Page 9 of 96

10 On Web Server Role (IIS) > Role Services install Security > Windows Authentication And Application Development >.NET Extensibility and ASP.NET 3.5 Page 10 of 96

11 And IIS Management Console and IIS 6 Management Compatibility You may need to specify an alternate source path e.g. from the Windows installation media Page 11 of 96

12 Once the prerequisites are installed, you can begin the installation Page 12 of 96

13 Prerequisites (Windows Server 2012) Use the Add Roles and Features Wizard > Server Roles to install Web Server (IIS) On Features, install.net Framework 3.5 (includes.net 2.0 and 3.0) Page 13 of 96

14 On Web Server Role (IIS) > Role Services install Security > Windows Authentication And Application Development >.NET Extensibility and ASP.NET 3.5 Page 14 of 96

15 And IIS Management Console and IIS 6 Management Compatibility You may need to specify an alternate source path e.g. from the Windows installation media Page 15 of 96

16 Once the prerequisites are installed, you can begin the installation Page 16 of 96

17 Prerequisites (Windows Server 2008) Use the Add Features Wizard to install.net Framework Use the Add Roles Wizard to install Web Server (IIS) Page 17 of 96

18 On Web Server Role (IIS) > Role Services, install Application Development > ASP.NET And Security > Windows Authentication Page 18 of 96

19 And IIS Management Console and IIS 6 Management Compatibility Once the prerequisites are installed, you can begin the installation Page 19 of 96

20 Prerequisites (Windows Server 2003) Ensure that the prerequisites are met. If the.net Framework was installed before IIS, configure ASP.NET by using the following command: c:\windows\microsoft.net\framework\v \aspnet_regiis.exe i In Internet Information Services (IIS) Manager > Web Services Extensions, ensure that the ASP.NET v extension is installed and set to Allowed: Once the prerequisites are installed, you can begin the installation Page 20 of 96

21 Installation Requirements (Client) The Client can be installed onto any of the following operating systems: Windows 2000 Professional Windows XP Windows 2000 Server Windows Server 2003 Windows Server 2008 Windows Vista Windows 7 Windows Server 2012 Windows Server 2012 R2 Windows 8 Windows 8.1 Windows Server 2016 Windows 10 Microsoft.NET Framework Microsoft.NET 2.0, 3.0 or 3.5 must be installed on the machine. To install this on Windows 7, Windows 8 and Windows 10, add the.net Framework 3.5 feature: Page 21 of 96

22 Server Installation Ensure that the server prerequisites have been met. When running on a machine with UAC enabled, you may see the following error message: To resolve this issue, from the start menu, right click the command prompt and select Run as Administrator and start the installation from this elevated command prompt. Run the Server installation file: Page 22 of 96

23 Read the license agreement and continue only if you understand and agree to the terms: Page 23 of 96

24 If upgrading from a previous version, ensure the relevant information is backed up: Select the appropriate Web Site, Virtual Directory and (where appropriate) Application Pool to install the Server to: Page 24 of 96

25 Press Next to start the installation: Once the installation is complete, you can access the Server. Page 25 of 96

26 Accessing Server Once the Server has been installed, you can access it via the web location that was specified in the Select Installation Address step (by default, HTTP Error When accessing the Server on Windows Server 2016 or Windows Server 2012, you may see the error "HTTP Error Not Found". Please see the HTTP Error Not Found. The requested content appears to be script and will not be served by the static file handler. page for a resolution. Page 26 of 96

27 Client Installation Ensure that the client prerequisites have been met. From the Server web address (by default select the Client installation link: Open the XIALinksClient.msi and follow the instructions: Page 27 of 96

28 Read the license agreement and continue only if you understand and agree to the terms: If required, change the installation folder: Page 28 of 96

29 Enter the name of the shortcut as it will appear on the desktop and start menu: Click Install to start the installation: Once the Client is installed, you can connect to the Server for the first time. Page 29 of 96

30 Connecting to the Server for the first time Once you've installed the Client, you can open it from the Desktop or Start Menu: When prompted, enter the URL for the Server (for example If you receive an error when committing the settings, please see the following page Access to the registry key is denied. Once you've connected to the Server, you can apply your licence. Page 30 of 96

31 Licensing Once you've connected to the Server for the first time, you will be prompted to configure licensing: Note: This will deploy the licence to the Server and will licence other Clients on the network. On the licences screen, press Upload new Licence File and browse to your licence file. If you require a trial license, press Get Trial License to request one: If the Licence File is valid, Product Licenced will be shown at the top of the window. Note: As all CENTREL Solutions trial licenses support use on all CENTREL Solutions products, you may see other products listed stating that they are not valid for this product. This is normal and can be ignored. Production licenses will not show this warning. Page 31 of 96

32 Client Installation using Group Policy The Client is a standard Microsoft MSI installer and can therefore be deployed silently from systems such as Group Policy within Active Directory or other software distribution systems. Please see the appropriate software distribution system's documentation for further details. Install Silently The Client application can be installed silently using the following command line: msiexec /i xialinksclient.msi /qb Specify Shortcut Name To configure the name of the shortcut that is displayed on the desktop and start menu, use the SHORTCUT_NAME property - for example, to use the shortcut name "My Applications", use the following: msiexec /i setup.msi SHORTCUT_NAME="My Applications" /qb Page 32 of 96

33 Configuration using Group Policy The Client receives almost all configuration settings directly from the Server, however, it must initially be configured with the Server URL. This configuration can be automated across Clients using Group Policy. Group Policy Overview Group Policy is a Microsoft technology to allow the configuration of Microsoft Windows Client machines from Active Directory. Before proceeding with this section, you must have a complete understanding of Microsoft Group Policy Objects. Note: Any settings you configure in Group Policy will override the local settings configured within the user interface. Page 33 of 96

34 Configuring the Client with Group Policy The XIALinks.adm file contains the settings that can be configured using group policy. Open the appropriate Group Policy Object that you wish to configure. Right click Administrative Templates under Computer Configuration and select Add/Remove Templates... Page 34 of 96

35 Click Add then browse to the XIALinks.adm file (by default C:\inetpub\wwwroot\XIALinks\GroupPolicy\GroupPolicy): Close the Add/Remove Templates window then expand Administrative Templates > Classic Administrative Templates (ADM) > CENTREL Solutions > : You can now modify settings such as Configure the XIA Server Address. Page 35 of 96

36 Configure the XIA Server Address The Server URL can be configured automatically across all Clients using group policy. Ensure you have added the XIALinks.adm file to group policy. Open the appropriate Group Policy Object then expand Administrative Templates > Classic Administrative Templates (ADM) > CENTREL Solutions >. Double click Configure the XIA Server Address. Select Enabled. Enter the appropriate Server address (for example Page 36 of 96

37 Disable the close [X] button The close button and ALT-F4 commands can be disabled on the main form of the Client using group policy. This helps to ensure that users do not accidentally close. Ensure you have added the XIALinks.adm file to group policy. Open the appropriate Group Policy Object then expand Administrative Templates > Classic Administrative Templates (ADM) > CENTREL Solutions >. Double click Disable the close [X] button. Select Enabled. Note: It is still possible to exit the Client using the File > Exit menu item. Page 37 of 96

38 Enable drag and drop to the client device You can enable applications to be dragged and dropped from the Client to the client device using group policy. Ensure you have added the XIALinks.adm file to group policy. Open the appropriate Group Policy Object then expand Administrative Templates > Classic Administrative Templates (ADM) > CENTREL Solutions >. Double click Enable drag and drop to the client device. Select Enabled: Page 38 of 96

39 Enable Offline Mode You can enable the Client to be used without a permanent connection to the Server using group policy. Ensure you have added the XIALinks.adm file to group policy. Open the appropriate Group Policy Object then expand Administrative Templates > Classic Administrative Templates (ADM) > CENTREL Solutions >. Double click Enable Offline Mode. Select Enabled: Page 39 of 96

40 Administration The topics in this chapter provide information on the day to day administration of such as adding, removing and editing Web Sites and Applications for users. Page 40 of 96

41 XIA Administrators To modify the configuration, you must be a XIA Administrator. By default, any member of the local Administrators groups on the server running is automatically a XIA Administrator. To make additional users or groups a XIA Administrator, add them to a local group on the server called XIALinks_Admins: Adding the required domain or local user or groups to the membership of this group will grant those users or groups XIA Administrator rights. Page 41 of 96

42 Managing Applications uses the word "Applications" to describe any link created within the system whether it is a Windows Application, Web Site Link, Directory or file that is opened with another application. You create an Application within and assign it the appropriate properties. Wizards are also available to create Applications to simplify the process for administrators. Page 42 of 96

43 Dragging and dropping into the Client The easiest way to add Applications to the Client is to drag and drop them from the client machine into the right-hand Application Area of the appropriate section Confirm you would like to proceed with the import Page 43 of 96

44 The Application is now available within where it can be opened by users or configured by administrators For more detailed configuration of this Application, right click the Application and select properties Page 44 of 96

45 Creating an Application using the Wizard Open the section in which you would like to create the Application Right click within the Application Area and select Create Application Page 45 of 96

46 Complete the Create New Application wizard Application Display Name This is the name of the Application shown within the Client to users. Application Description This is the description of the Application shown within the Client to users when they select the Application. Application Location You may enter or browse to the location of the Application or file that you wish to add to the XIA Links Client. If this is a File (for example a.txt file), will use the registered application to open this file. Once the Wizard is complete, the Application will be displayed within the Client if the Application can be found on this Computer. For more detailed configuration of this Application, right click the Application and select properties. Page 46 of 96

47 Creating a Web Site using the Wizard Select the section in which you would like to create the Web Site Right click within the Application Area and select Create Web Site Page 47 of 96

48 Complete the Create New Web Site wizard Web Site Name This is the name of the Web Site shown within the Client to users. Web Site Description This is the description of the Web Site shown within the Client to users when the user selects the Web Site. Web Site URL You may enter or browse to the location of the Web Site. This must be in the format ftp://address, or mailto:address. Once the Wizard is complete, the Web Site will be displayed within the Client. For more detailed configuration of this Web Site, right click the Application and select properties. Page 48 of 96

49 Creating a Directory using Create Custom Application You can use Create Custom Application to create a Directory or to access more in-depth configuration than that provided by the Wizards. Select the section in which you would like to create the Directory Right click within the Application Area and select Create Custom Application Page 49 of 96

50 In the Application Properties window, select the Application Type Windows Directory Page 50 of 96

51 On the Directory Settings tab, enter the Directory Path Add any other required application properties Page 51 of 96

52 Advanced Application Properties For more in-depth configuration than that provided by the Wizards, use Create Custom Application or right click an Application and select Properties. This opens the Application Properties window which has the following tabs: General Requirements Application Settings Repair (only shown when using the 'Standard File or Application' Application Type) Audience Display Directory Settings (only shown when using the 'Windows Directory' Application Type) Web Site Settings (only shown when using the 'Web Site' Application Type) Page 52 of 96

53 General Application Display Name This is the name of the Application shown within the Client to users. Application Description Application ID Application Type Application Enabled This is the description of the Application shown within the Client to users when they select it. This is the unique ID for this Application that is automatically generated and cannot be edited. Allows you to select the Application Type - 'Standard File or Application', 'Windows Directory' or 'Web Site'. Dependant on the option selected, different tabs are displayed. Disables this Application so that it is not presented to users. Note: XIA Admins are always shown Applications even if they are not enabled. Page 53 of 96

54 Requirements This tab determines the requirements that the client must meet for the application to be targeted. Architecture Determines the architecture of the client operating system. The options are: Any Architecture (default) x86 (32 bit) x64 (64 bit) Page 54 of 96

55 Application Settings Application Location Path You must enter one or more Application Paths where can find this Application. For example, if the Notepad application can be found on certain Computers at c:\windows\notepad.exe and on others at c:\winnt\notepad.exe, you may enter both of these paths. will check each path until it finds the Application. Check Application Exists Allow Drag and Drop Run as Administrator (UAC) Additional Required File By default, will check each location in the Application Location Paths for the Application and will only show the Application if it is found. In certain circumstances, this may be time consuming e.g. if it is checking network locations over slow network links. This option allows you to bypass the location checking behaviour, however, this means that you may only enter one Application Location. Determines whether the user can drag and drop the application to their client machine. Causes the UAC prompt to be displayed and runs the application as an administrator. This field allows you to specify an additional file (such as configuration file) that must exist before the application is shown. The file can be either an absolute path - for example "c:\application\configuration.xml" or a relative path - for example "configuration.xml". If a relative path is specified, the Page 55 of 96

56 Application Working Directory Command Line Parameters Window Style file is searched for in the same location as the main application file. Allows you to specify the Working Directory that this Application will use. If this option is not configured, will use the directory in which the application resides as the Working Directory. Allows you to configure the Command Line Parameters that will be used when starting this Application. Allows you to specify the Window Style that the Application should use. Options are 'Minimised', 'Normal' or 'Maximised'. Page 56 of 96

57 Repair This tab is only shown when using the 'Standard File or Application' Application Type. Enable Repair Repair Application Repair Command Line Parameters Specified Users Determines whether a Repair context menu item should be shown for a given application. The path to the file that will repair this application. If no path is specified, the detected application path is used. The command line parameters to pass to the repair application, for example "/repair". A list of users (one per line) that are permitted to use the repair function. Note: You can also enter groups (e.g. Everyone) in this field. Page 57 of 96

58 Audience The Audience tab allows XIA Administrators to configure which Local or Active Directory Users, Groups or Computers can see this Application within the Client. By default, 'Everyone' is allowed to see any given Application. Remove Target To Remove an Audience entry, right click the entry and select Remove Target Add Target To Add an Entry, right click the list and select either Add User / Group Target or Add Machine Target as required entering the User/Group or Machine Name. You may either Allow or Deny the Application to this User, Group or Machine. Note: Deny rules override allow rules so if a User, Group or Machine has a matching Allow rule but also a matching Deny rule they will not be given access to the Application. The Server carries out the Audience Checks therefore the Server must be able to resolve Client IP Addresses to Computer Names. XIA Admins are always allocated all Applications regardless of the Audience rules. Page 58 of 96

59 Network Targeting In addition to being able to target to specific groups and workstations, it is also possible to limit applications to specific IP subnets. By default, applications can be seen on all workstations regardless of their IP address. By selecting Display only to workstations in these networks, it is possible to enter one or more subnets that the remote machine must reside in for the application to be shown. Note: When using specific networks, the application must meet both a user or group target in addition to being in a specified network to be displayed. The application is presented to the Client which checks all IPv4 addresses assigned to the local workstation. XIA Admins will see all applications regardless of network targeting rules. Page 59 of 96

60 Display Section Show this Application on the Home Page Use Standard Icon for this File Use the Following Icon Allows you to specify which Section this Application should be assigned to. If selected, this Application will be pinned to the Home Page of the XIA Links Client allowing users to select this Application regardless of which Section they are currently viewing. By default, assigns a built-in Web Icon for Web Sites, a built-in Folder Icon for Directories and, for all other files, will attempt to extract the icon from the Application as it is displayed by Windows. This option allows you to specify an icon to use for this Application. Once selected, you may browse for, or enter a path to, a valid.ico file. You may preview this by selecting the Preview Icon link. Note: The icon file should be available to all machines accessing this Application so should either be in the same location on all machines or located within a shared network location. Should the Icon file not be found by the Client, a "Generic Application" default icon will be used. Page 60 of 96

61 Directory Settings This tab is only shown when using the 'Windows Directory' Application Type. Directory path Allows you to enter, or browse for, the Directory you wish to add. Page 61 of 96

62 Web Site Settings This tab is only shown when using the 'Web Site' Application Type. Web Site URL Allows you to enter the Web Site URL to display. This URL must be in the format ftp://address, mailto:address. Page 62 of 96

63 Other Application Tasks Other Applications tasks available are: Deleting an Application Duplicating an Application Starting an Application Move an Application to another Section Copy permissions Page 63 of 96

64 Deleting an Application Right click the Application and select Delete Application: Page 64 of 96

65 Duplicating an Application Duplicating an Application allows you to create a new identical Application with a new unique Application ID which you can then customise. Right click the Application and select Duplicate Application: A new Application is then shown called Copy of Application Name. You can right click the new Application and select Properties to edit this Application. Page 65 of 96

66 Starting an Application To start any Application, either double click the Application or right click the Application and select Start Application: Page 66 of 96

67 Move an Application to another Section To move an Application to another section, right click the Application and select Properties. Go to the Display Settings Tab and select the appropriate Section that you wish the Application to appear within: Page 67 of 96

68 Copy permissions To copy permissions between applications, select one or more applications to receive the new permissions then right click and select Copy permissions from. When prompted, select the application from where you wish the permissions to be copied: Page 68 of 96

69 Pinning Application to the Home Page Overview By default, users select a section within the Client to view the Applications within that Section. If you would like an Application to be visible at all times, regardless of what section the user is currently viewing, you can pin applications to the home page. Example In the screenshot below, the "My Home" directory (which is a shared drive) has been pinned to the Home Page so it can easily be accessed by all users. Providing this Application is available to the user (and can be located by the Client), it will show in the bottom left hand panel in the main view as well as the Section it originates from: Page 69 of 96

70 Pinning an Application to the Home Page To pin an Application to the Home Page, go to the properties of an Application and select the Display tab. Tick the Show this Application on the Home Page checkbox: Un-pinning an Application from the Home Page To Un-pin an Application right click the Application on the Home Page and click "Unpin this Application". Alternatively, select an existing Application, edit its properties and select the Display tab. From here, uncheck the Show this Application on the Home Page checkbox. Page 70 of 96

71 Managing Sections Sections Overview allows you to group Applications, Web Sites and Directories into folders called Sections. Each section is shown in the menu tree: Sections can be configured with a name, description and title image. All Applications Section There is a built-in Section called All Applications. This Section cannot be edited and shows all Applications, even those not assigned to a specific Section. Page 71 of 96

72 Creating and Editing a Section To create a Section, right click the left-hand menu tree within the Client and select Create Section To edit an existing Section, right click the Section and select Properties The following tabs are available: General Settings Section Appearance Page 72 of 96

73 General Settings Section Display Name This is the name of the Section shown within the Client to users. It must be unique. Section Description This is the description of the Section shown within the Client to users when the user selects this Section. Section ID A unique ID for this Section that is automatically generated and cannot be edited. Page 73 of 96

74 Section Appearance Section Title Image The Section Title Images drop down allows you to select an image that is shown within the Client when the user selects this Section. There are several predefined images included. You may add your own Section images. Page 74 of 96

75 Add your own Section images You can add your own images to the Section Title Images drop down. Create your images as JPEG Ensure they are 1600 x 52 pixels in size Copy the Images into the directory on the Server (by default C:\inetpub\wwwroot\XIALinks\images\section) Page 75 of 96

76 Deleting a Section Note: Before you can delete a Section, you must either delete all Applications within it or reassign those Applications to another Section. Right click on the Section within the Menu Tree and select Delete Section: Page 76 of 96

77 Nesting Sections It is possible to nest sections within other sections to organise and make it easier to find applications and links. To nest sections, logon as an Administrator and drag and drop a section within another section. Once a section is nested, to return it to the root of the tree, drag and drop that section onto My Applications. Page 77 of 96

78 Configure the Home Page When running the Client as an administrator, it is possible to configure the home page and some elements of the user interface. Press the Configure the Home Page link on the Client home page: Note: This link is not displayed to non-administrators. Note: Settings configured within this section are applied to every Client that connects to this server. Page 78 of 96

79 Home Page Settings - General Settings tab Home Page Title Configures the bold text displayed on the home page. Home Page Notes Configures the additional text that is displayed on the home page below the home page title. Title Bar Text Configures the text displayed in the main windows title bar, status bar and also on the Windows taskbar. Default Section When the Client starts, by default, the home page will be displayed including the welcome text and branding. This setting allows you to configure the default section that will be shown at startup. If a default section is configured which is subsequently deleted, the home page will be shown and an error will be logged. Page 79 of 96

80 Home Page Settings - Advanced tab Form height and width Allows the configuration of the default height and width of the main Client application window at startup. Show All Applications Section Configures whether the All Applications section should be automatically displayed in the treeview. Note: Administrators are always able to see the All Applications section. Show Help Menu and Links By default, the Client will show a Help item on the drop-down menu and also an action point for "Learn more about " on the home page. By unchecking this box, both the menu and action point will be removed from users. Note: XIA Admins will always see these items. Allow viewing of applications not found on this machine By default, all users are allowed to select "View applications not found on this machine" on the View menu. This shows the missing applications in the appropriate section with a light red background. By checking this option, the menu item will not be displayed to users. Page 80 of 96

81 Note: XIA Admins will always see this menu item. Expand all sections on startup When using nested sections, selecting this option will ensure that all sections in the tree are expanded and visible at startup. Page 81 of 96

82 Offline Mode operates by querying configuration information from the Server using standard web services. Should your organisation need to use without a permanent connection to the server, you can do so by enabling Offline Mode. To enable this mode, you need to edit Group Policy for the required machines and modify the setting Enable Offline Mode. When Offline Mode is enabled and a user accesses, the configuration settings and applications are cached within the user's temp directory. Should the user attempt to access XIA Links again from the same machine when the Server is unavailable, the applications and settings will be loaded from the cached files. Files are stored in %TEMP%\XIALinks as zipped XML files. The files are RSA signed for tamper resistance. When running in Offline mode, the text [Offline] is displayed in the title bar: When running in Offline mode, custom section images are not displayed. Page 82 of 96

83 Storage Space As the configuration files are compressed, the storage required is approximately 22Kb when there are 500 applications configured for a user. Offline cache files are stored per user and per machine. Page 83 of 96

84 Drag and drop to the client device It is possible to drag and drop applications from the Client to the client device: To drag and drop applications to the client machine, the option to drag and drop must be enabled in Group Policy. In addition to the Group Policy settings, each individual application can be enabled or disabled for drag and drop within the Application Settings Tab of the Advanced Application Properties. Multiple applications can be dragged from the Client to the client device, however, each application must have a unique name. Note: Multiple applications can't be dragged if any of the selected applications are disabled for drag and drop. The system will automatically configure the icon, application location and window style settings as appropriate. Page 84 of 96

85 Licensing requires a valid license for the system to be functional. Licences are installed on the XIA Links Server and validate the access of the Clients. For more information please contact sales@centrel-solutions.com Page 85 of 96

86 Managing Licenses Installing Licenses The Client checks your licenses when the application is run and, if you are a XIA Admin, prompts you to manage your licenses when you connect to the Server for the first time. License Management Tool Once is licensed, you are permitted for its use within the terms of the End User License Agreement (EULA). If you are using a Time Limited Trial License, you will find that after the Time Period has expired, will cease to function. Should you find that your Trial Period has expired or you wish to view the License configuration of your Server Instance: Logon to a machine with the Client installed as a user account with the XIA Admin role. Open the Client. (Note: You may need to right click and Run as Administrator). Select Tools > Licences. Here you can view the Licences currently installed on the Server this Client is connected to. You may find that there are many Licences available some of which are not valid. This is not an issue as long as there is at least one Licence that is valid for your installation. At the top of this screen will be a message indicating whether or not this installation is licenced. Uploading a License File Open the Licence Management Tool (described above). Select Upload Licence File (Note: This will replace any existing License File on the Server). Browse to the licence file. You will be informed if there is an issue with the license file. At the top of this screen will be a message which indicates whether or not this installation is now licensed. Page 86 of 96

87 References The topics in this chapter are provided for reference and contain detailed information about the system design of. Page 87 of 96

88 Troubleshooting Should you experience issues with Server, please see the following topics for common resolutions. Page 88 of 96

89 404 Page Not Found Issue When attempting to access XIA Server the browser reports 404 Page not found Viewing the IIS Log files reports Error 404 with a subcode of 2. Cause This can be caused by ASP.NET Extensions not being enabled within IIS. Resolution For Windows Server 2008 confirm that the ASP.NET Server role is enabled. For Windows Server 2003 go to the IIS Manager > Web Service Extensions and ensure that "ASP.NET v " is enabled. Page 89 of 96

90 HTTP Error Not Found Error "HTTP Error Not Found. The requested content appears to be script and will not be served by the static file handler." Issue When accessing the Server on Windows Server 2016 or Windows Server 2012, you may see the following error: HTTP Error Not Found The requested content appears to be script and will not be served by the static file handler. Cause This can be caused by.net 3.5 or ASP.NET 3.5 not being installed. It can also be caused because on Windows Server 2016 and Windows Server 2012, the DefaultAppPool is, by default, set to the incorrect.net CLR Version v Page 90 of 96

91 Resolution Make sure.net 3.5 and ASP.NET 3.5 are installed. Open Internet Information Services Manager (IIS) and check the Application Pool (by default, Server uses the DefaultAppPool) to ensure it's configured with.net CLR Version v Re-register ASP.NET in a command prompt: C:\Windows\Microsoft.NET\Framework\v >aspnet_regiis -i Page 91 of 96

92 Access to the registry key is denied Issue When attempting to configure the settings with the client, you receive an error stating that access to the registry key is denied: Cause The user account running is not a local administrator or the computer is running UAC and the application was not run as administrator. Resolution Configure the client using Group Policy Logon as a user account with local admin rights When User Access Control (UAC) is enabled ensure the application is run with administrator rights by right clicking the application and selecting run as Administrator Page 92 of 96

93 Cannot drag and drop when using UAC Issue When you try to drag and drop applications into the window on a system running UAC, the cursor displays a "denied" icon: More Information This is due to the nature of Microsoft User Access Control (UAC). If is Run as Administrator, it is running in a different context to the Windows desktop and explorer from which you are trying to drag the icons. Page 93 of 96

94 Prompted for Credentials on Windows 2008 R2 Issue When attempting to access the web site, you are prompted for credentials. However, entering the credentials does not allow you access to the site. Cause The appropriate authentication method is not configured on the IIS Server. Resolution Ensure the Integrated Authentication Role Service is configured within IIS (see the Installation Requirements section) Open Internet Information Services (IIS) Manager Select the XIALinks Virtual Directory Double click Authentication in the right-hand window: Page 94 of 96

95 Ensure that Windows Authentication is the only enabled authentication method: Click the Providers... link in the right-hand pane and ensure that Negotiate and NTLM are configured: Page 95 of 96

96 The trust relationship failed Issue When starting the application, the following error is shown "Error testing Active Directory user or group 'account name' for application 'application name'. The trust relationship between the primary domain and the trusted domain failed." Cause The error can occur when there is a domain or forest trust in place on the network, however, the trust is not working correctly and a user account has been specified that either has no domain name or has the name of the faulty domain specified. Resolution Resolve the issues with the domain trust. or Modify the application causing the error and ensure that the domain name is specified - for example "DEMONSTRATION\usera" rather than simply "usera". Page 96 of 96