Skip to content

Basic Installation Guide

This section guides you through the basic setup of TISGraph with the KISTERS WISKI integration.

The following sections cover more advanced topics like OAuth setup or access to the SSH management console of the underlying osgi-runner container.

Prerequisites

  1. A working WISKI Server setup.
  2. wiskidataccess API Java files:
    • wiskidataaccess-interface-7.4.13-SR11.jar
    • wiskidataaccess-bundle-7.4.13-SR11.jar
  3. ITEG Installation files:
    • osgi-runner-4.4.4-1-setup-x64.exe
    • tisgraph-1.2.2-setup.exe

The previously used bundles-pkg-x.y.z-setup.exe is not used anymore and will be uninstalled by current tisgraph-installers.

Basic Installation

java-17 Installation

A working java-17 installation is needed in order to install osgi-runner/TISGraph.

You can install openjdk-17 from the Eclipse Adoptium Project download site

If you prefer to use java-17 as shipped with KISTERS WISKI, make sure to add the following keys to you registry.

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\JRE]
"CurrentVersion"="17"

[HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\JRE\17]
"JavaHome"="D:\\kisters\\wiskiservermanager\\java"

The lines above might be copied to a wiski-java-17.reg file and execute in order to give the following result in regedit.exe:

final java-17 registry keys

osgi-runner Installation

After installing java-17 you can execute osgi-runner-3.x.y-z-setup-x64.exe in order to install ITEG's OSGi container.

Important During the installation, a random password for the administrative user osgi is generated and shown. Please store this password in a safe place, it used lateron for configuring the application.

If you upgrade from an older installation, the default karaf user with password karaf will be retained.

The installer installs service called clazzes.org osgi-runner, which might be started/stopped on the command line by

net start osgi-runner
net stop osgi-runner

In order to make the WISKI certificate configuration folder accessible to wiskidataaccess, you have to add the java option

-Dkisters.water.server.config=<path>

using the osgi-runnerw.exe executable as shown in the following screenshot:

osgi-runner properties

The option -Doracle.net.tns_admin is only necessary for oracle-based installations.

wiskidatacess Bundles Installation

After installing osgi-runner you must copy the files

    wiskidataaccess-interface-7.4.13-SRxx.jar
    wiskidataaccess-bundle-7.4.13-SRxx.jar

to the deploy folder of the osgi-runner installation before actually installing TISGraph.

TISGraph Installation

Finally, you can execute tisgraph-1.2.x-setup.exe in order to install the TISGraph application.

The component and JDBC driver options to be selected are show in the following screenshot:

Installation of TISGraph Bundles

For Oracle or Postgresql based installations, select the likewise drivers instead of the MSSQL option.

The chemshapes option is only used for WQM-Users who need Piper or Schöller diagrams.

Basic TISGraph configuration

Direct your browser to http://localhost:8081/tisgraph/admin/admin.html, sign on with the user osgiand the generated password from the osgi-runner installation. For migrated installations, use username karaf with password karaf.

The shown wizard let's you configure the connection to the WISKI server and the database connection.

Afterwards, direct your browser to http://localhost:8081/tisgraph/