Skip to end of metadata
Go to start of metadata

Only applicable to the BiZZdesign on-premise solution.

Team Server is now called HoriZZon Server. While the new name is being implemented in the software and on the Support pages, the old name may still be visible in places until the process is completed. See also Team Server is now HoriZZon Server.

Problem

When starting the HoriZZon Server via Windows Services it starts up and after a couple of seconds the process stops again. As a result, the HoriZZon Server won't start.

This issue usually occurs after an update when migrating from an older version of the HoriZZon Server to HoriZZon Server 4 - 5 Nov 2019 (or newer). This new HoriZZon Server uses Java 11 (OpenJDK or Java 11). Any previous versions of the HoriZZon Server use Java 8. When you install a newer version of Java, Windows still uses the existing Java version (in this case Java 8).

Solution

There are several solutions available to resolve this issue. Choose the one that best fits your situation.


This approach is only applicable if there are no other applications running that requires this previous version of Java.

Completely remove all the older versions of Java from your machine via Add/Remove programs so that only Java 11 is left.

  1. Uninstall the Windows service by running uninstallServer.bat  in the Command prompt.

  2. Uninstall any older Java versions, or make sure that older versions of  java.exe  are not found on the PATH. For example, a  java.exe  could be found in the folder 'C:\Windows\System32'.

    If uninstalling older versions of Java is not desired, the full PATH to the  java.exe  can be specified in the  server.wrapper.conf  file (HoriZZonServerHome\conf), on the line  wrapper.java.command=java.exe.

  3. Install the service again by running installServer.bat in the Command prompt.

  4. Start the service by running startServer.bat.


This approach might affect other programs. Please take this into account before using this solution.

To do this:

  1. Open the Windows Start menu, type "environment", and in the result list click Edit environment variables for your account.



  2. In the System Properties window, click Environment Variables.

  3. In the Environment Variables window, under System variables, open the Path variable.



  4. Check if Java 11 is located above the older Java versions present in the list. If not, move Java 11 to the top.



To do this:

  1. Go to the ..\HoriZZonServerHome\conf folder, and open the server.wrapper.conf file.

  2. Change the following line:

    wrapper.java.command=java.exe

    to

    wrapper.java.command=C:/Program Files/ojdkbuild/java-11-openjdk-11.0.5-1/bin/java.exe

  3. Save the changes.

If you are using PostgreSQL, the trusted CA keystore for the Java 11 Runtime Environment does not contain the certificates required to  validate the TLS connection to the PostgreSQ server. You need to add the required certificates to the keystore.

To do this:

The keystore is a file called cacerts and is located in the lib/security directory of the Java installation. You can use keytool, part of the Java distribution, to manage the keystore, for example, to add a CA certificate cacert.crt to it:

keytool -importcert -file cacert.crt -keystore <path to lib/security/cacerts>

Typically the default password for the keystore is "changeit".

Sometimes, Windows will not register certain changes after the Java 11 installation. In those cases, a restart of Windows and the HoriZZon Server is required.

To do this:

  1. Uninstall the HoriZZon Server service by running the uninstallServer.bat file (located in the HoriZZonServerHome\bat folder).

  2. Restart Windows.

  3. Install the HoriZZon Server service again by running the installServer.bat file.

  4. Start the service by running the startServer.bat file.