TRUECHART Knowledge Base Live Search
Windows Server 2008 (R2) or later,
Java Runtime Environment (JRE) version 8 or later,
MySQL (version 5.7 or later) or Microsoft SQL Server (version 2008 or later)
Java Runtime Environment (JRE)
The minimum requirement for the Java Runtime Environment (JRE) is version 8.
We recommend using the latest Java 12 version (JRE 12).
Currently, Java 13 is not supported.
You will need the 64-bit JRE for TRUECHART you can download at http://www.oracle.com/technetwork/java/javase/downloads/index.html.
As the Qlik Sense® web server uses port 443 and the TRUECHART web service uses port 8080 (by default, can be changed during the installation process), it is suggested to set your firewall to allow these ports. (Inbound, TCP)
Qlik Sense Deployment
In case of direct deployment and usage with Qlik Sense no specific port needs to be open since the service communication then goes through Qlik Sense new broker server infrastructure. This requires that you’re not using the "cross-domain"-setting during the installation progress. Furthermore, you need to restart the Qlik Sense Service Dispatcher service for changes on the broker service take effect.
Qlik Sense Broker Service: acts as an interface to and an intermediary between services started by the Qlik Sense Service Dispatcher(QSD). The service is launched and managed by the Qlik Sense Service Dispatcher (QSD) when required. For more information see here.
For saving the Notation Manual and various TRUECHART-specific settings, a database is required. Currently, the following database systems are supported:
MySQL (from version 5.7 or later)
Microsoft SQL-Server (from Version 2008).
Since the Oracle database is no longer supported by TRUECHART version 3.2, we offer support for migration to a supported database system. Please contact us in case you need help.
The database does not need to be installed on the same machine as TRUECHART, but it has to be accessible from the installation server via IP/DNS. An in-advance-defined schema (a database) as well as a user with a corresponding authorization (min.
DELETE) should also be defined.
At present, it is not possible to obtain the database-user from an active directory, but rather has to be deposited locally in the particular database management system.
Windows 7 (x86_64) or higher is recommended to be used as an operating system.
At present TRUECHART-Menubar supports the browsers listed below:
Microsoft Internet Explorer 11
Microsoft Edge (latest version - v80, at the time of writing)
Mozilla Firefox (latest version – v73, at the time of writing)
Google Chrome (latest version – v80, at the time of writing)
iOS 11.2.2 or later
The indicated versions are the minimum conditions. In each case, the latest version is to be preferred.
TRUECHART4PowerBI is not supporting IE11 and "old" Edge (the version before chromium support) due to new real-time commenting.
Background: Due to the visibility restrictions for custom visuals in PowerBI it is technically not possible to create the necessary communication channel (WebSocket communication not possible)
We recommend using Google Chrome since this is the fastest available browser.
Installation / update process
To install the TRUECHART service, run the appropriate setup file for your BI system. Click Next at the bottom to start the installation:
Figure 1. The initial pane of the installation.
In the following step, you need to browse to your TRUECHART installation folder or enter the full qualified system pathname into the text field (1). The install directory is by default C:\Program Files\High Coordination.
Basically you can jump through the steps of the dialog by clicking Back (2) or Next (3). To abort the installation just click on the Cancel (4) Button at the bottom of the modal anytime.
Figure 2. TRUECHART installation folder
If you have already installed a version of TRUECHART into the selected folder an UPDATE process will be triggered. If you have not installed the TRUECHART service yet, a new INSTALLATION will be started.
(1) Cross-Domain: possibility to use different URLs for the service and the root system
(2) Use SSL: set SSL certificate (https) to use client-server communication (recommended)
(3) Service Host: set the host ("public" domain, IP address or machine name). Don't include a tralling slash "/".
(4) Service Path: set the name of the TRUECHART Service which is by default trueChartService. (Case sensitive)
(5) Service Port: set the port of the TRUECHART Service which is by default 8080
(6) Hub Host: set the host ("public" domain, IP address or machine name) of the BI system from which TRUECHART is delivered. Don't include a tralling slash "/".
(7) [Qlik Sense] Qlik Sense directory: browse or enter the full qualified system directory of the Qlik sense installation. The target directory is called 'Qlik'.
To run the TRUECHART service in cross-domain mode, you need to check the corresponding option (1). Now choose between SSL secured or none secured data exchange with clicking the Use-SSL checkbox (2). In case you have the Cross-domain (1) option unchecked an SSL secured connection is required. You can not change the activated Use-SSL (2) checkbox and need to apply an SSL certificate in the next dialog sequence step.
Figure 3. Cross-domain and installation location settings (install)
For some BI systems (like Microsoft Power BI) a custom TRUECHART resource path can be defined. This is the location from which TRUECHART itself is being loaded by the BI system. The default behavior is to load TRUECHART from the HighCoordination server.
SSL settings (optional)
To use an SSL secured HTTPs data exchange connection from the client to the TRUECHARTService, browse a valid .pfx, or .pem file by clicking Browse (1) or enter the full qualified system path of the file into the text field of the SSL certificate location (1) option.
Qlik Sense: If you do not select the Cross-domain option, you need to upload the Qlik Sense internal SSL certificate in the next step of the dialog, which can be exported from the QMC. Please find additional information here Exporting certificates through the QMC. Note that this will make the TRUECHARTService page "insecure" because the certificate is not intended for HTTP communication but rather for internal operations with the Qlik Service. (
Figure 4. SSL settings.
Certificate files must be used by a local directory. The use of network drives is currently not supported.
If a .pfx file is selected, a key file (2) and its password is not needed. In case you choose a pem file, browse to a key file with the browse button of the Keyfile (2) options or enter a full qualified system path of the file.
Figure 5. browse a SSL certificate file
If the key file needs a password, you will have to fill the password in Keyfile password (3). If the file is not password secured, just leave Keyfile password (3) blank.
The password of the key file is not validated. Entering the wrong keys here will cause problems with SSL connection even the service gets installed successfully.
The next step is to specify the settings for the underlying database. The user you specify needs to have the rights to do
DELETE on the database tables.
The database schema specified in Database (default:
hicoservicedb) needs to be created in advance.
Currently, it is not possible to obtain the database user from a user directory but rather has to be created locally in the particular database management system.
After that, you may define the information for the root user of the TRUECHART Management Console, i.e. First name, Last name, Username, and a Password:
Figure 6. Specify database configuration
Now that you provided all the necessary information, you may start the installation by clicking on Install.
Figure 7. Starting the installation.
After TRUECHART has been installed, you may get additional information on further actions to prepare TRUECHART for your BI system.
Please find here additional information for Installation of TRUECHART within Qlik Sense.
Figure 8. Finishing the installation.
If you also confirmed the user settings with Next >, the setup program collected all necessary information and you can start the installing process by clicking Install. Then wait until the process was fully completed and a new Explorer window is opened with the TRUECHART file for your BI system.
If you have installed TRUECHART for Qlik Sense, the ZIP-file (TRUECHART4Sense.zip) must be uploaded to the server via the management console (QMC - Extensions).
If there was a problem while installing TRUECHART, you may open the log file by clicking on Show Logs! . Also, consult the Troubleshooting section in this document.
During the installation, a
TRUECHART-Setup.log file is created in the same directory as the installation executable. Error messages during the installation process are saved in this file.
If the installer does not start.
- Please check if you have the correct Java version.
- Please check if the JAVA_HOME variable is set correctly.
C:\Program Files\Java\jdk1.8.0_172\bin - is incorrect. The path should not have the "\bin".
Client connections to the TRUECHART service fail
If the TRUECHART Service is available on the server itself via
localhost but external connection fails, make sure you have connections on the TRUECHART Service’s port configured as “allowed” in your firewall.
Domain and port setting issues
If you get the following error message, it is likely you selected a port that is already been used by another process:
Figure 9. Error message when the entered port is already used.
You may select a different port or contact your IT support.
Database setting issues
The most frequent error expresses itself as demonstrated in the following figure:
Figure 10. Error message indicating failed attempt to communicate with the database.
This can have different causes:
The host-address and/or the specified port are erroneous and the program cannot reach the database
The specified user does not exist or does not have the proper authorization
The specified user originates from an active directory
The password of the given user was wrongly spelled
The database entered does not exist or was wrongly spelled
Your database does not allow external access
The firewall settings from the database server prevent a successful connection
You can also find more detailed information on the origin of the error in the log-file, which was automatically generated during the installation process.
In case of this error contact your IT-Support resp. your database administrator, he can send you the required parameters and p.r.n. make further settings on the database server.
Additionally, you can consult our support for error diagnosis. Therefore please have your log-file prepared.
Download server logs
As of version v3.2, you have the possibility to directly download the log information from the server as a zip file in the TRUECHART Management Console. In the event of a fault, this information can be easily made available to the support of HighCoordination.
You can download the log files within the settings area.
Figure 11. The Log files section in the TRUECHART Management Console.
Here, you have the following three download options:
- Latest: Download all log files with the latest modification date
- Last 7 Days: Download all files that have been modified in the last 7 days.
- All: Download all existing log files
If you confirmed the settings for the domain/encryption with Next, carry on with the specifications for the database (see also section "Preparation").
No connection to the TRUECHART service when using SSL
When using SSL, after integrating a self-generated certificate from your BI system into the TRUECHART service, you may get a “No network connection” error message.
Figure 12. Error message indicating a problem with the connection to the TRUECHART service.
A quick workaround is to open the TRUECHART Management Console in another browser tab and add a security exception to your current session:
Figure 13. Adding a security exception in Internet Explorer. The process varies between different browsers.
To permanently solve this problem it is suggested to provide a valid, officially signed certificate (Class 4 and Class 3 SSL) to both your BI system and TRUECHART installation.
Switching from HTTP to HTTPS
The easiest method for changing TRUECHART from HTTP to HTTPS is to update TRUECHART on the same server. The only difference is that you will have to check Use SSL and located the certificate and key file in the next step.
In the database section of the installation, you have to uncheck Create tables and use the same database you have used before. After finishing the installation, you need to re-deploy the provided TRUECHART for your BI system.
To check the installation, switch to the overview of the Windows Services. There you should find an entry called TRUECHARTService. This service should also already been started.
Figure 14. The TRUECHARTService in the Windows Services overview.
You can then also check your database. There you should discover several tables in the previously prepared and empty database schema. All tables have the prefix “hico_” (for example: “hico_doc_documents”, with the exception of the table “sequence”).
If these tables are present, you can carry on with the license activation.
To activate the license, open the TRUECHART Management Console. To do so, use the URL you configured during the installation process. This could be on the server:
There you can see the following login page:
Figure 15. Login of the TRUECHART Management Console.
Here you enter the user name and the password you specified in the final step of the installation process. After that, you reach the overview. Navigate across the following points: “Server Configuration [#1] → License [#2]”:
Figure 16. The License information tab in the TRUECHART Management Console.
Take a note of your server-id and send it to our support. The best thing you can do is to copy the license key and afterward send it via e-mail to firstname.lastname@example.org. Prior to this you should already have received and confirmed a corresponding proposal by other means.
As soon as your license was registered (at best you register your installations with us in advance and make an appointment with our support so the lapse of time is reduced to a minimum), you receive a signature in the following form as a response:
Figure 17. Applying for the License.
Enter this signature into the field of the “Signature” [#3] and confirm it by clicking “Apply License” [#4]. In the field “Details” on the right side, you can then see your license information. This means the TRUECHART installation is activated and can now be fully used.
Creating a new user
To create a new user, open the TRUECHART Management Console at
http(s)://service-host:_service-port_/service-path as defined during the installation (default:
http://localhost:8080/TRUECHARTService) and after logging in, navigate to the User Administration page via the icon menu bar at the top and click on Create Local User below.
Figure 18. Creating a new user in the TRUECHART Management Console.
In the New User dialog enter the requested information about the new user as well as the desired permission group from the Permissions list and click on Save to create the user.
Figure 19. Editing an existing user in the TRUECHART Management Console.
Any user account can be altered afterward by clicking on edit in the Users list.
Using TRUECHART across multiple BI platforms
If you want to use TRUECHART across several BI systems (e.g. Qlik Sense and Excel) in parallel, you need a separate hostname for each BI system and a valid certificate for each host.
The certificate created in Qlik Sense cannot be used for other BI systems.
Then you have to update the server.xml file. You can find it at C:\Program Files\High Coordination\conf\server.xml.
Another important part is to move the SSL settings into the "SSLHostConfig" sections. The "hostName" is the domain to which the certificate applies. The important part is to add a "defaultSSLHostConfigName" which specifies the fallback if no hostname matches.
For further information take a look at https://tomcat.apache.org/tomcat-8.5-doc/ssl-howto.html.
If you plan to use different BI systems together with Qlik Sense, there should be at least two hostnames. One is specified through the Qlik Sense internal hostname and needs the Qlik Sense internal SSL certificate. The other one is required for all other BI systems which needs a valid SSL certificate for that hostname.
The hostname that is required for the Qlik Sense communication broker can be found in C:\ProgramData\Qlik\Sense\host.cfg as a base64 encoded string.
This process must be repeated every time you update TRUECHART.
In the future the process will be performed automatically by our installer.