Installation Manual

Download as pdf or txt
Download as pdf or txt
You are on page 1of 31

INSTALLATION MANUAL

HICO-GPD-XBR-IM
Legal Aspects: The content is solely provided for information purposes HiCo-ICS GmbH
and can be changed without notice. Contents of these pages may not be AUSTRIA | CZECH | GERMANY |
understood as warranty, obligation and condition on the part of HiCo. SWITZERLAND |CANADA
HiCo, the HiCo logo and all HiCo products, particularly HICO iPS.Suite®, Telefon: +43 (0)2682 704 61-00
HICO X-Browser®, HICO X-ContentSuite®, HICO X-ContentPortal®, E-Mail: [email protected]
HICO DeMoS® and HICO X-Publisher® are registered trade marks of http://www.hico.com
HiCo-ICS GmbH. All other products or company names are property of
their owner.

© 2021 HiCo-ICS GmbH. All rights reserved.


HICO X-Browser® Installation Manual

Table of Contents

1 Change Records and Highlights.............................................................................. 6


2 General Information................................................................................................... 6
2.1 Preliminary Remarks / Introduction.............................................................................. 6
2.2 General Conventions................................................................................................... 7
2.3 Maintenance and Support............................................................................................ 7
2.3.1 Application- & Product-Support Services in Operating Phase (APO).......................... 7
2.3.2 HICO Helpdesk............................................................................................................ 7
2.4 Legal and safety-related Information........................................................................... 7
2.5 Description of warnings................................................................................................ 8
3 System Requirements............................................................................................... 8
3.1 Hardware requirements............................................................................................... 9
3.1.1 Minimum hardware requirements................................................................................ 9
3.1.2 Recommended hardware requirements....................................................................... 9
3.1.3 HICO X-Browser®:APP(iOS)....................................................................................... 9
3.2 Software requirements................................................................................................. 9
3.2.1 Necessary software components................................................................................. 9
3.2.2 Supported operating systems...................................................................................... 9
3.3 Architectural Overview................................................................................................. 10
3.3.1 Architecture.................................................................................................................. 10
4 Installation.................................................................................................................. 10
4.1 Installation of the required COTS programs................................................................ 10
4.1.1 Installation COTS Programs........................................................................................ 10
4.2 Product Installation...................................................................................................... 10
4.2.1 Installation HiCo X-Browser......................................................................................... 10
4.2.2 Silent Installation HiCo X-Browser............................................................................... 17
5 After Installation......................................................................................................... 18
5.1 Putting into Service...................................................................................................... 18
5.1.1 Optional Configuration................................................................................................. 22
5.2 Common Configuration Recommendations................................................................. 25
5.2.1 Exceptions for the virus scanner.................................................................................. 25
5.3 Software Installation Test............................................................................................. 26
6 Software Deinstallation............................................................................................. 30

Date: 26.11.2021 Page 3 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
HICO X-Browser® Installation Manual

Index of Figures
Figure Title Page
Figure 1 Architecture HICO iPS.Suite........................................................................................ 10
Figure 2 Start of HICO X-Browser® installation......................................................................... 12
Figure 3 HICO X- Browser® installation directory...................................................................... 13
Figure 4 HICO X- Browser® installations type........................................................................... 14
Figure 5 HICO X- Browser® installation..................................................................................... 15
Figure 6 HICO X- Browser® installation closure........................................................................ 16
Figure 7 ConfigCenter - General................................................................................................ 19
Figure 8 Initialkonfiguration - Logging, Content und Auto Login................................................ 20
Figure 9 Installation of additional LoadData packages.............................................................. 23
Figure 10 Installation of customer specific configurations............................................................ 24
Figure 11 Initial configuration - Closure....................................................................................... 25
Figure 12 User- and Group Management.................................................................................... 28
Figure 13 Upload LoadData package.......................................................................................... 29
Figure 14 Navigation structure of a Publication........................................................................... 30
Figure 15 X- Browser Deinstallation............................................................................................. 30

Page 4 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
HICO X-Browser® Installation Manual

Index of Tables
Table Title Page
Table 1 Change Records and Highlights.................................................................................. 6
Table 2 Warnings...................................................................................................................... 8
Table 3 Known Failures............................................................................................................ 16
Table 4 General Settings.......................................................................................................... 19
Table 5 Logging and Content Settings...................................................................................... 21

Date: 26.11.2021 Page 5 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
1 - Change Records and Highlights
HICO X-Browser® Installation Manual

1 Change Records and Highlights


Table 1: Change Records and Highlights
Version number Date Author Changed sec- Reason of modification
tion
001 2015–04–06 Manfred Hage- — Initial version 6.0.0
nauer
002 2015–09–11 Manfred Hage- — Update to version 6.0.1
nauer
003 2016–06–06 Manfred Hage- — Update to version 6.0.2
nauer
004 2017–03–01 Manfred Hage- 3.2, 5.1 Update to version 6.1.0
nauer
005 2017–07–17 Christian Kraja- — Update to version 6.2.0
sits
006 2018–04–17 Manfred Hage- — Update to version 7.0.0
nauer
007 2019–05–27 Manfred Hage- — Update to version 8.0.0
nauer, Christian
Krajasits
008 2019–09–30 Christian Kraja- — Update to version 8.0.1
sits
009 2020–01–31 Christian Kraja- — Update to version 9.0.0
sits
010 2020–02–28 Christian Kraja- — Update to version 9.0.1
sits
011 2020–07–31 Christian Kraja- — Update to version 9.1.0
sits
012 2020–11–18 Christian Kraja- 2.4, 3.2, 3.3, Update to version 9.2.0
sits 4.2, 5.1
013 2021–11–26 Gebhard Maurer — Update to version 9.3.0

2 General Information

2.1 Preliminary Remarks / Introduction


This user manual contains all information required for the successful and efficient use of the HiCo
X-Browser® developed by HiCo-ICS GmbH. Possible questions arising during the work with the HiCo
X-Browser® should be answered with this simply and practically.
This user manual is structured into the following sections:
− General information and application recommendation
− Detailed description of the user interface and its functions
− Description of the search engine
− Description of the configuration center

The HiCo X-Browser® serves as multi-functional retrieval tool to represent electronic contents and
illustrations with an optimized user interface. It is developed with the primary goal of supplying the user

Page 6 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
2.2 - General Conventions
HICO X-Browser® Installation Manual

as fast as possible and efficiently with the required information and to process the latter by the most diverse
functions and linking forms in a user-friendly manner.

2.2 General Conventions


This document was written in accordance with the general creation guidelines of HiCo-ICS GmbH.

2.3 Maintenance and Support

2.3.1 Application- & Product-Support Services in Operating Phase (APO)


The Application- & Product-Support Services in Operating Phase (APO) department offers, additionally to
the offers for software maintenance, a wide range of support services and training programs. The portfolio
of solutions includes services for our own products and for partner products. It includes market-leading
technologies and complex client solutions.
The APO area is the company's most important success factor, due to sustained satisfaction of customers
because of full support, the availability of knowledgeable contact partners and a fast and high-quality
requests and problems management procedure.
The accomplishment of challenges by the APO is a cross-departmental procedure with central responsibility.
They actively involve all the necessary, organisational units in the company, mainly the product specialists
and processing units. Our customers also benefit from the dedicated Single Point of Contact (SPOC)
available on request and thus the communication and integration of external support organisations. Some
of the specified product manufacturers and partners of HICO are, for example, PTC Parametric Technology
Corporation and Tridion B.V.
Highly-motivated, qualified and certified employees ensure the services of the APO, and thus make sure that
the products that are used by customers have a maximum of security and quality.

2.3.2 HICO Helpdesk


The web interface of the HICO Helpdesk offers different options to our customers. With this it is possible to
send messages and receive documents through a document management system.
The HICO Helpdesk is accessible via the URL: https://support.hico.com.
It is also possible to reach the HICO Helpdesk through the HICO telephone hotline. This support is only
provided for customers with a Service Level Agreement (SLA).
The HICO telephone hotline number is 00800-70461450 and is available for our customers from Monday to
Thursday from 7:45 a.m. to 6:15 p.m. and Friday from 7:45 a.m. to 3:30 p.m (Central European Time —
CET).
When calling the HICO telephone hotline, our customers are connected to any of our HICO Call Centre
agents who give assistance to the customer in creating a new ticket.
The call centre agent then forwards this ticket to the dispatcher on duty, who makes an initial analysis of
the issues. The related 1st level helpdesk support also receives this ticket. If no solution can be found, the
dispatcher then decides, together with the customer, about the involvement of the escalation management
team.

2.4 Legal and safety-related Information


Department responsible for the content and issuance of this manual:
HiCo-ICS GmbH

Date: 26.11.2021 Page 7 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
2.5 - Description of warnings
HICO X-Browser® Installation Manual

TechLab .:. Thomas A. Edison Str. 2


7000 Eisenstadt Austria
Phone: +43 (0)2682 930 85 - 0
Fax: 43 (0)2682 930 85 - 700
Website: www.HICO.com
All rights reserved, especially the right to reproduction, distribution and translation. No part of this manual
must be edited, reproduced, distributed or published in whatsoever manner without written approval from
HiCo-ICS.
The software given in this manual is subject to changes. As a result, the functions and procedures given may
differ from the description in the manual.
Errors and omissions in the creation of this manual are reserved.
HiCo-ICS reserves the right to change the functions and procedures of the software given in this manual and
to adapt the technical conditions.
The user of this manual is responsible for making regular backups of the software and especially for
execution of the payload.

2.5 Description of warnings


This chapter provides information on the warnings used in this manual.

Table 2: Warnings
Symbol Description
Warning
A warning is a statement that alerts the user to the possibility of a system
failure, business problem, damaged data or other serious adverse reactions
associated with the use of the software.
Caution
A caution is a statement that alerts the user to the possibility of a business
problem or processing issues. It brings up an issue that the user would better
pay attention to, even if it’s not a system critical matter.
Note
A note is a helpful hint, sometimes a tip, to help the user work more efficient-
ly. Without a note, a user may lose precious time and get frustrated while
trying to understand why something is not working.

3 System Requirements

Page 8 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
3.1 - Hardware requirements
HICO X-Browser® Installation Manual

3.1 Hardware requirements

3.1.1 Minimum hardware requirements

− x64-based processor with a minimum of 2 GHz


− 4 GB computer memory
− 50 GB free hard drive space, in accordance with the size and number of publications

3.1.2 Recommended hardware requirements

− x64-based processor with a minimum of 3 GHz


− 8 GB computer memory
− 100 GB free hard drive space, in accordance with the size and number of publications

3.1.3 HICO X-Browser®:APP(iOS)

− Apple iPad with 2 GB memory


− 32 GB free capacity, in accordance with the size and number of publications

3.2 Software requirements


HICO tests the application exclusively with the web browsers listed below.
Any problems occurring on other web browsers can therefore only be handled
within the scope of the “Customer specific Application and Product Support”
(“Solution Support”).

Based on the current performance tests, HICO recommends the usage of the
web browser “Google Chrome” for the given application. If other web browsers
are used, a loss of performance may be encountered.

3.2.1 Necessary software components

− Standard Web Browser with the following features (HTML5, CSS3, SVG, Cross-Window Messaging).
These Web Browser are tested:
● Google Chrome (80 or higher)
● Mozilla FireFox (78 or higher)
● Microsoft Edge (80 or higher)

3.2.2 Supported operating systems

− Microsoft Windows 8.1 (64-Bit)


− Microsoft Windows 10 (64-Bit)
− Apple iOS 13 or higher for HICO X-Browser®:APP(iOS)

Date: 26.11.2021 Page 9 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
3.3 - Architectural Overview
HICO X-Browser® Installation Manual

3.3 Architectural Overview

3.3.1 Architecture
The architecture picture below shows the communication paths of the installed HICO products, also including
the HICO X-Browser® v9:

Fig. 1: Architecture HICO iPS.Suite

4 Installation

4.1 Installation of the required COTS programs

4.1.1 Installation COTS Programs

4.1.1.1 Required COTS Programs


There are currently no COTS programs required for the installation of the HICO X-Browser®.

4.2 Product Installation

4.2.1 Installation HiCo X-Browser

Page 10 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
4.2 - Product Installation
HICO X-Browser® Installation Manual

1 The current HICO X-Browser® Version 9.2.0 is a MINOR version of the


underlying application.

Due to the extensive technical changes in the HICO X-Browser® Version


9.0.0, only existing installations of the HICO X-Browser® Version 9.x.x
can be upgraded. An upgrade from other previous versions of the HICO
X-Browser® (e.g.: HICO X-Browser® v8.x) is not possible.

The screenshots below may differ depending on versions, version number


displayed should be seen as an example!

Start the Setup EXE file from the "Software" directory on the installation source medium.
Afterwards the dialog window shown below appears. If necessary, an upgrade note can also
be displayed if the HICO X-Browser® is already installed.
The product version is defined in Major (first digit position, i.E.: 9.1.0) and
Minor (digits starting from second position, e.g.: 9.1.0).
Please note that officially only an update from ONE minor version (i.E.: from
9.0 to 9.1) to another will be supported!

In general the HICO X-Browser® Setup supports an automatic update from the last installed
application version. In this case, all necessary migration steps are performed by the setup
itself. This type of installation is always easier and can be carried out if no changes to the
configuration are to be made (i.e: Installation paths and settings remain the same as in the
previous version).
If this is not desired for various reasons, a new installation with prior uninstallation of the old
application is recommended. Choosing this type of installation nevertheless means that all
configuration settings have to be done from scratch, as the current setup no longer has any
references to the old installation.

Date: 26.11.2021 Page 11 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
4.2 - Product Installation
HICO X-Browser® Installation Manual

Fig. 2: Start of HICO X-Browser® installation

2 Clicking the "Next" button and accepting the terms of the licence and the conditions of the
software maintenance gets you for selecting the installation directory.

Page 12 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
4.2 - Product Installation
HICO X-Browser® Installation Manual

Fig. 3: HICO X- Browser® installation directory

3 Then you can choose between 2 options, which type of installation you want for the HICO
X-Browser®:Service:

Date: 26.11.2021 Page 13 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
4.2 - Product Installation
HICO X-Browser® Installation Manual

Fig. 4: HICO X- Browser® installations type

Option Description
Installation as Service (Default)
The X-Browser®:Service will be installed and configured for running as
a service in the system. This is a convenient way allowing a (automatic)
Start of the application and all users can immediately access the applica-
tion just after starting the computer.
(Access rights and correct firewall settings provided of course)
Installation as Application (for
distribution only) The X-Browser®:Service is available after installation and configuration
can be done via an application link. This means, it is necessary to start
this link for using the application (This may be a useful option, in case
when using the application from a single user). Regardless to this, all
users may use the application after starting the service.
(Access rights to the service and the application data provided)

This type of installation is mainly used for distribution via


USB stick or CD/DVD.

Page 14 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
4.2 - Product Installation
HICO X-Browser® Installation Manual

4 Afterwards the inputs have to be confirmed with the button "Install" in the following dialog box
to start the installation. If the inputs shall be adapted once again a return to the previous dialog
boxes for settings is possible with the button "Back".

Fig. 5: HICO X- Browser® installation

5 After the installation was made faultlessly, the final dialog box appears. With the button "Close"
you leave the setup and the browser is ready for use.

For using the HICO X-Browser® it is necessary to configure the application.


The configuration can be done with the HICO X-Browser®:ConfigCenter —
see Chapter 5.1

The HICO X-Browser®:ConfigCenter will be started immediately after


the installation for a mandatory initial configuration. (recommended),
Afterwards, it can be restarted at any time via the program shortcut that
has been created during the installation.

Date: 26.11.2021 Page 15 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
4.2 - Product Installation
HICO X-Browser® Installation Manual

Fig. 6: HICO X- Browser® installation closure

Table 3: Known Failures


Fault Solution
Following Entry can be found in the log-file of the Please see also: https://blogs.msdn.mi-
HICO X-Browser® Service: crosoft.com/dataaccesstechnologies/2015/07/16/re-
port-manager-system-invalidoperationexception-this-
System.TypeInitializationException: The type initial- implementation-is-not-part-of-the-windows-platform-
izer for 'Lucene.Net.Store.FSDirectory' threw an ex- fips-validated-cryptographic-algorithms/
ception. ---> System.SystemException: System.Re-
flection.TargetInvocationException: Exception has The reason can be the configuration for "FIPS". This
been thrown by the target of an invocation. ---> must be set to DISABLED (0)!
System.InvalidOperationException: This implemen-
tation is not part of the Windows Platform FIPS
validated cryptographic algorithms.

Required Conditions
Action / Condition Data module/Technical publication
None

Page 16 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
4.2 - Product Installation
HICO X-Browser® Installation Manual

4.2.2 Silent Installation HiCo X-Browser

4.2.2.1 General information on silent installation


The silent installation can be started with launcher (*.exe) in 3 ways:
− Directly via the launcher by letting the parameters pass through (setup.exe /s /V" /s for silent, /V is the
pass-through parameter for msiexec)
− After an extraction for the administrative installation (setup.exe /a, subsequently select a path, /a starts
an administrative installation)
− After a manual extraction via msiexec (start setup.exe, copy setup.msi out of the temporary folder)
Basic and universally valid parameters for msiexec are:
− /qn - "No User Interface", no dialogues and user interactions are displayed;
− /log path/to/logfile - if desired, writes an MSI logfile;
− INSTALLDIR - standard variable for the destination location. Unless otherwise specified, this is the
target path;
− ADDLOCAL=[list of components] - installs only the specified components.
− PATH_OR_PROPERTY="VALUE" - sets the path/the property "PATH_OR_PROPERTY" to the value
"VALUE". If VALUE contains spaces, the inverted commas are required. If this possibility is used
together with the direct start via the setup launcher, the inverted commas must be invalidated with a
backslash: PATH_OR_PROPERTY=\"VALUE\"

4.2.2.2 Parameters for the silent installation

Parameters Description
INSTALLDIR Target folder for the installation (required, standard:
%PROGRAMFILES%\HICO\XBrowser)
ADDLOCAL Specifies which components are to be installed. (For
possible components refer to following Table)

Components:

Component Description
ServiceHost This feature causes that the HICO X-Browser® will
be configured as a central system service and can
be managed under services. This Feature has to be
set alternating with ApplicationHost and is the default
set.
ApplicationHost This feature causes that the HICO X-Browser® will
be configured as a local service (manual Start). This
Feature is alternating with ServiceHost.

4.2.2.3 Examples
Example for a silent installation (Service)
HICO_X-Browser_PRO_v9.1.0.exe /s /V”/qn INSTALLDIR=\”H:\HiCo\X-Browser\””

Date: 26.11.2021 Page 17 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
5 - After Installation
HICO X-Browser® Installation Manual

− The HICO X-Browser ® is installed in "H:\HiCo\X-Browser".


− A central service will be configured (visible in Management/Services).

Example for a silent installation (Local)


HICO_X-Browser_PRO_v9.1.0.exe /s /V”/qn ADDLOCAL=ApplicationHost"
− The HICO X-Browser® is installed in standard directory “C:\Program Files\HICO\XBrowser”.
− The ADDLOCAL statement defines, that there will be no system service configured for the application
and the service must therefore be started via its own link under Programs/HiCo.

5 After Installation

5.1 Putting into Service


The configuration of the application HICO X-Browser® can be done with the configuration tool HICO X-
Browser® :ConfigCenter. This application is automatically started as the last step of the setup. Alternatively,
it can also be started using the link at about “C:\Program Files\HICO\XBrowser”.
After starting the ConfigCenter, the necessary parameters can be set. In principle the following sections are
available
− General
− Logging
− Settings to Content
− Settings to “Auto Login”

Wherever possible on the application side, default values are already set. All other values — especially the
connection to the database or the paths to the designated storage and the log directory —must be filled
accordingly by the administrator.
In the following, corresponding screenshots of the ConfigCenter and explanations of the displayed fields can
be found.

Page 18 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
5.1 - Putting into Service
HICO X-Browser® Installation Manual

Fig. 7: ConfigCenter - General

Table 4: General Settings


Configuration File
The file specified contains all application-specific settings and is prefilled by
default during installation.
The referenced file should only be changed after consultation with HICO!
Base Adresses / URLs
Specifies the HTTP address(es) under which the application should be
accessible.
In general, the URL http://localhost:8585/ shall be filled here!
The port itself is free to choose, but it has to be available (=free) on the
system used.
Storage Directory
The base directory for the data storage. All important files to the application
are stored here in a predefined file structure.
The path C:\ProgramData\HiCo\XBrowser\Storage should be entered
here as default value. If the specified directory does not exist, it is automati-
cally created by the ConfigCenter.

Date: 26.11.2021 Page 19 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
5.1 - Putting into Service
HICO X-Browser® Installation Manual

Table 4: General Settings


License file
Specifies the path to the license file of the application.
This value is prefilled by default and should only be changed after consulta-
tion with HICO.
Interval of recurring processes
(minutes) The entered value defines the time interval after which recurring processes
are started.
The Default value for this Option is set to 60 minutes.

The "Database" settings are filled by default and should never be changed. Therefore the corresponding
values are not described here.

Fig. 8: Initialkonfiguration - Logging, Content und Auto Login

Page 20 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
5.1 - Putting into Service
HICO X-Browser® Installation Manual

Table 5: Logging and Content Settings


Log Directory
Specifies the path to the directory of the internal protocols.
The files stored here provide important information in case of errors.
As default value the path C:\ProgramData\HiCo\XBrowser\Logs should
be entered here. If the specified directory does not exist, it is automatically
created by the ConfigCenter.
Log Level
This parameter specifies how much log information should be recorded.
The value should be set in cooperation with the HICO support team.
The Default value for this Option is set to Warning.
ATI Confirmation Mode
This setting specifies whether "mandatory ATIs" need to be confirmed only
once by the users.
By default, the ATIs must be confirmed every time after a new log-in.
The Default value for this Option is not activated.
WCN Confrm Level
This setting specifies whether ”Warnings, Cautions and Notes" need to be
confirmed .
The Default value for this Option is Never. This means that Warnings,
Cautions and Notes do not have to be confirmed, as it was the standard
behaviour before the introduction of this option.
Maximum number of package
files Here the administrator can specify how many "old" versions of each pack-
age are to be kept. This parameter is available to limit the space if operat-
ing with very large LoadData packets.
The Default value for this Option is set to 2 (which means that 2 versions
will be kept for each installed package).
Check Document Hash
This parameter specifies whether the user should be informed if the appli-
cation detects that selected data modules of the LoadData Package have
been modified.
The Default value for this Option is set to activated.
Enable Auto Login
This parameter specifies whether currently unregistered users may use the
application or if they have to be redirected to the login page.
If the "Enable Auto Login" option is set to activated, any user can call
up the application and is automatically registered in the user directory. This
means that when the application detects that a user is logging in for the
first time, a corresponding user is automatically created inside the HICO
X-Browser in the background. Furthermore, the permissions defined in the
"Auto Login" section are assigned to this user.
The Default value for this Option is set to deactivated.

Date: 26.11.2021 Page 21 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
5.1 - Putting into Service
HICO X-Browser® Installation Manual

Table 5: Logging and Content Settings


Enable Auto Login — prede-
fined User permissions If the option "Enable Auto Login" is set to activated, specific default
permissions can be assigned to new users
The extended rights for "Administrator", "DeMoS Manager", "Package
Manager" and "Change Manager" are available. If one or more of these
options is set, newly created users will have these permissions by default.
If none of the options are activated, new users will be created without
extended permissions.

5.1.1 Optional Configuration


After completion of the mandatory steps, subsequent optional steps are possible if the corresponding data
is available.
If no corresponding data has been found by the setup, these optional steps are skipped. The corresponding
forms are then skipped and not displayed to the user at all.

5.1.1.1 Installation of additional LoadData packages

If there is a folder IETPLoadData inside the HICO X-Browser® Setups directory, it will be searched for
additional LoadData packets (ZIP files). All found files will be displayed to the user and afterwards installed
when the application is started.

Page 22 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
5.1 - Putting into Service
HICO X-Browser® Installation Manual

Fig. 9: Installation of additional LoadData packages

5.1.1.2 Installation of customer specific configurations

If a file customer.zip is found in the directory of the HICO X-Browser® Setup folder, the containing data will
be used for customer-specific adaptations of the application. The found file is displayed to the user and the
adjustments it contains are processed when the application is started..

Date: 26.11.2021 Page 23 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
5.1 - Putting into Service
HICO X-Browser® Installation Manual

Fig. 10: Installation of customer specific configurations


The application is then started with the settings specified.

If incorrect settings are made or the permissions for installing all required components
(e.g: registration of the HICO X-ContentPortal® Windows Services) are not sufficient,
an error message will appear at this point!

Otherwise, the following final screen appears after completion of all activities:

Page 24 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
5.2 - Common Configuration Recommendations
HICO X-Browser® Installation Manual

Fig. 11: Initial configuration - Closure


By using the option "Open Client", the web interface of the application can be started directly after finishing
all preparations.

The HICO X-ContentPortal® can be used without any installed LoadData Packages
but the functionality that can be used is very limited. This means that only after an
Import of a LoadData Package — which has to be generated using a corresponding
“Export” in the HICO iLS.Suite® — a full usage of the application is available.

5.2 Common Configuration Recommendations

5.2.1 Exceptions for the virus scanner


In order not to limit the performance of the HICO applications too much, the respective Storage directories
should be excluded from scanning by the virus scanner.
The reason for this is that the LoadData packages can become quite large and therefore some files will be
written to the hard disk by the application during unpacking. If each of these files is checked by the virus
scanner, the import leads to significant losses in performance!
For example, HICO internal tests have shown, for example, that with active virus scanner, importing
a package takes about 10 minutes. The same package without an active virus scanner could be
imported in one minute. This means that an active virus scanner on the corresponding target directory
slows down the import by the factor of 10!

Date: 26.11.2021 Page 25 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
5.3 - Software Installation Test
HICO X-Browser® Installation Manual

In the HICO X-Browser the storage directory is created by default under the Path
C:\ProgramData\HiCo\XBrowser\Storage.
For the HICO X-ContentPortal and HICO DeMoS the corresponding path must always be specified
manually during installation.

5.3 Software Installation Test

Page 26 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
5.3 - Software Installation Test
HICO X-Browser® Installation Manual

1 In order to start the application HICO X-Browser®, you can either use the Desktop shortcut
HICO X-Browser® or directly go via a web-browser and the configured URL.

2 After entering the user data (the "Administrator" password can be retrieved from HICO Support),
the main menu will be displayed

3 Through the "User management", specific users and groups can be created. For details on this
procedure, please refer to chapter 3.4.3 of the user manual.

Date: 26.11.2021 Page 27 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
5.3 - Software Installation Test
HICO X-Browser® Installation Manual

Fig. 12: User- and Group Management

Page 28 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013
5.3 - Software Installation Test
HICO X-Browser® Installation Manual

4 After that, it is necessary to upload an exported package from HICO iLS.Suite® into the storage
of the HiCo X-Browser®.
For doing this, the activity “Add publication” must be started, either inside the processing
function “Packages => Import Package” or directly on the main page. Please note that for the
created user, a privilege on this package must be set.
More details can be found in the Usermanual, chapter 3.4.4.

Fig. 13: Upload LoadData package

5 Afterwards a login, using the new credentials should be done to the HiCo X-Browser®.

6 To finalize the Test, the publication structure for the uploaded package must be opened
and selection of some different nodes (modules) must be done. For the selected nodes the
corresponding content must be displayed inside of the content area — right to the structure —

Date: 26.11.2021 Page 29 of 31


Issue: 013 PMC-HICOCOR-2387N-00008-00_013-00_en-GB
6 - Software Deinstallation
HICO X-Browser® Installation Manual

whereby it must be ensured, selecting also some modules whose includes illustrations to also
examine their correct presentation.

Fig. 14: Navigation structure of a Publication

Required Conditions
Action / Condition Data module/Technical publication
None

6 Software Deinstallation
The deinstallation is called up via "Control Panel->Software":

Fig. 15: X- Browser Deinstallation


By clicking the button "Delete" a dialog appears for the confirmation of the deinstallation.
After a confirmation with "Yes" the software will be deinstalled.

Page 30 of 31 Date: 26.11.2021


PMC-HICOCOR-2387N-00008-00_013-00_en-GB Issue: 013

You might also like