We upgraded JAVA under ALM 12.6, changed Env. Variable, but ALM will not start
Question ID: 109691

WE ended up being forced by It to upgrade JAVA on our ALM server from JAVA 8 build 221 to JAVA 8 build 261.

Now, the ALM service starts, but going to the ALM URL, we get an HTTP ERROR 503 "Service Unavailable" page.

In the Wrapper.log, it looks like ALM starts, but we get an error in the Wrapper log has this error:

java.lang.IllegalArgumentException: Invalid version number: Version number may be negative or greater than 255

Could it really be complaining about a JAVA build number greater than 255?

What can we do?  What about using Open JDK instead?

Marked as spam
Posted by (Questions: 91, Answers: 5)
Asked on July 21, 2020 3:00 pm
Answers (3)
Private answer

As it turns out, this is caused by a report engine log-level setting down in a file "web.xml" the deployment webapps "application" (in our case, qcbin) WEB-INF folder:

Here are the steps to fix the problem:


Go into this file web.xml in C:ProgramDataMicro FocusALMwebappsqcbinWEB-INF


Change the following log level from "WARNING" to "OFF":


<!-- BIRT PARAM: Report engine log level. -->






Then STOP/START the service.

Marked as spam
Posted by (Questions: 4, Answers: 509)
Answered on July 23, 2020 2:35 pm
Private answer
It looks like some libraries specifically test that the JAVA minor build # is LESS than 255 and the latest Oracle JAVA 8 is 

Version 8 Update 261

I suggest you try working with a build less than 255.

I just tested this with ALM 12.6 and Java 8.261 (BUILD > 255) and it failed in my lab.
Then, I pointed to Java 8.221 (BUILD < 255) and it worked fine.

On a hunch, I also tried an open-source JAVA -- (https://adoptopenjdk.net/?variant=openjdk8&jvmVariant=hotspot)
And they are also at build 261 (OpenJDK8.261), AND it failed starting ALM the same way.

I tried OpenJDK8.252 (Java 8 build 252 equivalent) and their (NOT SUPPORTED for ALM by MicroFocus) JDK 11, and it worked.

*** CAREFUL!  Using a NEWER, unsupported JAVA 9, 10, 11 may not work completely as there are some deprecated classes ALM might need. -- You were warned! ***

FYI, ALM/QC 12.6 and 15.x only officially support JAVA 8 or Open JDK 8 -- specific BUILD numbers are not mentioned.

Perhaps you can get a variance to allow a build lower than 255.

In my recent answer, I explain WHY we really don't recommend changing JAVA after installation of ALM -- this is yet another reason.


Marked as spam
Posted by (Questions: 4, Answers: 509)
Answered on July 21, 2020 3:17 pm
Private answer

Please note:  If you are a user of LoadRunner Enterprise (LRE) (Performance Center) 12.6x with ALM 12.60 (patch 1 or 2) you are also effect by this java limitation

If you must upgrade the Java, it is mandatory to upgrade your LRE 12.6x to LRE 2020.x, as LRE 2020.x and high don't use Java.

Marked as spam
Posted by (Questions: 12, Answers: 384)
Answered on July 21, 2020 3:28 pm

Welcome back to "EyeOnTesting" brought to you by Orasi Software, Inc.

Scroll to Top