Skip to end of metadata
Go to start of metadata

Only applicable to the BiZZdesign on-premise solution.

Problem

When starting the Team Server via Windows Services it starts up and after a couple of seconds the process stops again and nothing happens.

This issue usually occurs after an update when migrating from an older version of the Team Server to Team Server 4 '5 Nov 2019' (or higher). This new Team Server uses Java 11 (OpenJDK or Java 11). Any previous versions of the Team 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.


 Remove any previous versions of Java so you only have (Open) Java 11 installed

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.

 Set the order of the Java version via Windows Environment Variables to have Java 11 run as first

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.



 Specify the full path of Java.exe to the Team Server

To do this:

  1. Go to the ..\TeamServerHome\conf folder, and open the 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.
 Validate TLS connection when using PostgreSQL

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".

 Restart Windows and the Team Server

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

To do this:

  1. Uninstall the Team Server service by running the uninstallService.bat file (located in the TeamServerHome\bat folder).

  2. Restart Windows.

  3. Install the Team Server service again by running the installService.bat file.

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