Added headless jre capability by judovana · Pull Request #1308 · adoptium/installer

judovana · 2026-01-02T11:01:04Z

The PR itself is still not yet considered "ok", many testing ahead and many things to agree, but serves as example of both jre and jre-headless from one specfile:

rpmbuild -bb temurin-21-jre.spec
...
 rpm -q --requires .../rpmbuild/RPMS/x86_64/temurin-21-jre-21.0.9.0.0.10-1.x86_64.rpm 
/bin/sh
/bin/sh
/bin/sh
/usr/sbin/alternatives
alsa-lib(x86-64)
ca-certificates
dejavu-sans-fonts
fontconfig(x86-64)
glibc(x86-64)
libX11(x86-64)
libXext(x86-64)
libXi(x86-64)
libXrender(x86-64)
libXtst(x86-64)
rpmlib(CompressedFileNames) <= 3.0.4-1
rpmlib(FileDigests) <= 4.6.0-1
rpmlib(PayloadFilesHavePrefix) <= 4.0-1
rpmlib(PayloadIsXz) <= 5.2-1
zlib(x86-64)

rpmbuild -bb temurin-21-jre.spec --without headfull
...
 rpm -q --requires .../rpmbuild/RPMS/x86_64/temurin-21-jre-headless-21.0.9.0.0.10-1.x86_64.rpm
/bin/sh
/bin/sh
/bin/sh
/usr/sbin/alternatives
ca-certificates
glibc(x86-64)
rpmlib(CompressedFileNames) <= 3.0.4-1
rpmlib(FileDigests) <= 4.6.0-1
rpmlib(PayloadFilesHavePrefix) <= 4.0-1
rpmlib(PayloadIsXz) <= 5.2-1
zlib(x86-64)

I think many of the X dependencies are not necessary, as they should be autogenerated, but am not going to touch those:). Also note the name - something to confirm.

I'm not sure with alsa-libs and dejavu-sans-fonts but am sure with fontconfig dependence. For alsa and dejavu, they shoudl be probably suggests in newer RPMs, but as also older rpm without suggests/recommends is supported, then I think it would be better to leave them out. its easy to install them on top, but hard to remove if they are hard-coded.

I'm also not sure, how to init another pipeline. I would probably parametrize https://github.com/adoptium/installer/blob/master/linux/jre/redhat/src/main/packaging/build.sh to eb able to produce both headfull and --without headfull or enhance it so it produce both right away, rather then add any duplicates. Any hints or help on the "how this should be consumed", welcomed.

Also I guess I should be editing the https://github.com/adoptium/installer/tree/master/linux_new/jre/rhel/src/main/packaging and not this one.. But am not sure

judovana · 2026-01-02T11:01:50Z

linux/jre/redhat/src/main/packaging/temurin/21/temurin-21-jre.spec

@@ -1,13 +1,16 @@
-%global upstream_version 21.0.5+11
+%global upstream_version 21.0.9+10


This should not be there, but api did not yield the 5+11 for me today.

seems odd that this isn't already at the latest...

jiekang · 2026-01-02T14:54:38Z

Please link the pull request to the issue as described by the guide here:
https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue

Thank you!

jiekang · 2026-01-02T15:01:53Z

Also, the Linux installers are undergoing a rewrite where spec files are being generated on demand rather than individually maintained under the "linux_new" folder.

See:
https://github.com/adoptium/installer/tree/master/linux_new
https://github.com/adoptium/installer/blob/master/linux_new/generate_spec.py
https://github.com/adoptium/installer/tree/master/linux_new/jdk/rhel/src/main/packaging/temurin/25

I expect your changes will need to be done there. But it's nice to see how simple the spec macros are in order to add a headless package. I would add that as a comment to this PR so reviewer's can reference it.

judovana · 2026-01-02T15:30:49Z

resolves #917

judovana · 2026-01-02T15:34:12Z

Also, the Linux installers are undergoing a rewrite where spec files are being generated on demand rather than individually maintained under the "linux_new" folder.

See: https://github.com/adoptium/installer/tree/master/linux_new https://github.com/adoptium/installer/blob/master/linux_new/generate_spec.py https://github.com/adoptium/installer/tree/master/linux_new/jdk/rhel/src/main/packaging/temurin/25

I expect your changes will need to be done there. But it's nice to see how simple the spec macros are in order to add a headless package. I would add that as a comment to this PR so reviewer's can reference it.

hi! yes, I noted the j2 "specfiles". But there are still one specfile per jdk and while reading all that related .sh and .gradle, I have not grabbed which one is actually used (see the last paragraph of summary). So modyfing directly the "old" spec was more direct. And as you write - the change is nicely visible.

steelhead31

If this is functionality we want in the temurin releases, we'll need to update the version specific templates in the linux_new folder. If we definitely want this, Im happy to do these changes on this PR ahead of the january release cycle!

judovana · 2026-01-05T14:04:04Z

If this is functionality we want in the temurin releases, we'll need to update the version specific templates in the linux_new folder. If we definitely want this, Im happy to do these changes on this PR ahead of the january release cycle!

Can you plsae drop how to test the j2 changes? Also There is quite a lot to decide (I had moved the "decission" non technical discussion back #917 (comment) , before I noticed this comment)

I will mgrate it to j2 in menatime, as the chages are moreover identical.

steelhead31 · 2026-01-05T14:12:59Z

If this is functionality we want in the temurin releases, we'll need to update the version specific templates in the linux_new folder. If we definitely want this, Im happy to do these changes on this PR ahead of the january release cycle!

Can you plsae drop how to test the j2 changes? Also There is quite a lot to decide (I had moved the "decission" non technical discussion back #917 (comment) , before I noticed this comment)

I will mgrate it to j2 in menatime, as the chages are moreover identical.

To test this I create a test jenkins job, and amend the jenkinsfile so that it doesnt push packages to artifactory..

https://ci.adoptium.net/job/build-scripts/job/release/job/sfr-build-linux-package-modular/

Once all the changes are in, Im happy to run the above job against your fork/branch, theres a few changes needed to the jenkins file.. ( https://github.com/adoptium/installer/blob/master/linux_new/Jenkinsfile ) to comment out the jfrog upload..

Line 192

// jf 'rt u ${FILENAME} deb/pool/main/t/temurin-${RELNUM}/ --target-props=${DISTROLIST}deb.component=main;deb.architecture=${BUILDARCH} --flat=true'
Line 204

// jf 'rt u **/build/ospackage/${FILENAME} apk/alpine/main/${BUILDARCH}/ --flat=true'

Line 215

// jf 'rt u ${FILENAME} ${PACKAGEDIR}/ --flat=true'

And these too..

Lines 991 - 993

//                  build job: 'publish_linux_pkg_src', parameters: [
//                      string(name: 'TAG', value: params.TAG),
//                      string(name: 'FILENAME', value: ArchiveFileName)
somethi

Let me know if you want me to help test, the job in question is restricted in jenkins, but I've already got the above set up, would just need the changes above, and a small change in jenkins to point to your branch

judovana · 2026-01-05T15:30:02Z

I will mgrate it to j2 in menatime, as the chages are moreover identical.

To test this I create a test jenkins job, and amend the jenkinsfile so that it doesnt push packages to artifactory..

...

Let me know if you want me to help test, the job in question is restricted in jenkins, but I've already got the above set up, would just need the changes above, and a small change in jenkins to point to your branch

Yes, I will need help. I got lost already on " create a test jenkins job," :((( Will change the PR to aim the j2 files.
The j2 files do not have jdk8 - so "old" jdk8 specifies shold be affected?

Thanx a lot for all the hints!

steelhead31 · 2026-01-05T15:47:57Z

The JDK8 specfile templates(j2) should be here.. https://github.com/adoptium/installer/tree/master/linux_new/jre/rhel/src/main/packaging/temurin/8

If you make the template changes, I'll make the changes to the jenkinsfile on your branch for testing to build the headless packages, and then run some builds for jenkins.

Are these changes just for the RHEL based RPMs, or do the SLES ones require the same changes ?

judovana · 2026-01-05T16:14:02Z

The JDK8 specfile templates(j2) should be here.. https://github.com/adoptium/installer/tree/master/linux_new/jre/rhel/src/main/packaging/temurin/8

:face_palm:

If you make the template changes, I'll make the changes to the jenkinsfile on your branch for testing to build the headless packages, and then run some builds for jenkins.

yyy. Will give you note. TYVM!

Are these changes just for the RHEL based RPMs, or do the SLES ones require the same changes ?

Hmm. Good question. I was not thinking about suse for now. Although they should be easily adjsuted, I would wait with it for some seen interest, or at least as another changeset. I was actually wondering why there are two sets (rhel/suse) of specfiles... Note that the change is also applicable for debian and others. But would really wait untill there is some interest (unless it is provided as feature). If SLES is not suse, please correct me :)

karianna · 2026-01-05T22:33:40Z

linux/jre/redhat/src/main/packaging/temurin/21/temurin-21-jre.spec

 %global priority 2100

+# if rpmbuild  will be executed as `rpmbuild -bb ...spec --without headfull ...` then headless package will be generated
+%bcond_without headfull


I think it's headful not headfull

Thanx!! Will fix in next iteration

karianna · 2026-01-05T22:34:33Z

linux/jre/redhat/src/main/packaging/temurin/21/temurin-21-jre.spec

@@ -1,13 +1,16 @@
-%global upstream_version 21.0.5+11
+%global upstream_version 21.0.9+10


seems odd that this isn't already at the latest...

judovana · 2026-01-06T06:24:15Z

seems odd that this isn't already at the latest...

Thats becasue I edited unused .spec. The .j2 files should be edited instead. Will do once PMC accept it (or not do, once tey decline it)

steelhead31 · 2026-01-07T16:02:29Z

@judovana this has been discussed and agreed with the PMC, if you'd like to update the specfiles in this branch, im happy to contribute the jenkins changes, and build some test packages using my test jobs in jenkins, assuming everything goes ok we can then plan implementing it :)

judovana · 2026-01-08T11:03:57Z

@judovana this has been discussed and agreed with the PMC, if you'd like to update the specfiles in this branch, im happy to contribute the jenkins changes, and build some test packages using my test jobs in jenkins, assuming everything goes ok we can then plan implementing it :)

@steelhead31 Ok, moved the change to j2 file. Can you please ride your magic wheels? If we would be ok with the change, will spread it to 25,26,17,11 and 8.

I had added also an clumsy attempt to build jre and jre-headless in loop. WDYT? I feel slightly losst. Anything tried/advised will be highly appreciated.

steelhead31 · 2026-01-08T11:30:03Z

@judovana I'd remove the loop to build jre & jre-headless, I can handle this in the jenkinsfile for the automated production process :) .. I'll make some changes this afternoon and update you later

steelhead31 · 2026-01-08T11:33:34Z

In fact, I've already almost allowed for this in my jenkinsfile..

def packageTypes = ['jdk', 'jre']
now becomes
def packageTypes = ['jdk', 'jre', 'jre-headless']

judovana · 2026-01-08T12:00:53Z

Cool! Sure! ty!

judovana · 2026-01-08T12:03:53Z

Reverted. Once you are ready, please show me how the jre-headless evolve to --without headful later. Am extremely curios. TYVM

steelhead31 · 2026-01-08T12:16:32Z

Reverted. Once you are ready, please show me how the jre-headless evolve to --without headful later. Am extremely curios. TYVM

Thanks, I will do.. Im just evaluating where the best place to make the change is.. I suspect its actually going to be in the gradle, but once I've done a bit of investigating, I'll let you know.. Ive just contributed the change to prevent anything getting uploaded to anywhere it shouldnt, and I'll test that.. then have a look at which bit of the build needs tweaking

linux_new/jre/rhel/src/main/packaging/build.sh

linux_new/jre/rhel/src/main/packaging/temurin/21/temurin-21-jre.template.j2

linux_new/jre/rhel/src/main/packaging/build.sh

linux_new/jre/rhel/src/main/packaging/temurin/21/temurin-21-jre.template.j2

linux_new/jre/rhel/src/main/packaging/build.sh

linux_new/Jenkinsfile

judovana · 2026-01-19T07:57:50Z

@steelhead31 I had removed also policytool, which is gui application. It should not cause any troubles, but am looking forward for testing bits.

steelhead31 · 2026-01-19T08:36:43Z

I'll produce a couple of versions with this change, and let you have them later today

karianna · 2026-02-05T01:15:57Z

@steelhead31 looks like there was a conflict in that merge...

This reverts commit d1c46ca.

Co-authored-by: Martijn Verburg <martijnverburg@gmail.com>

%{name} is missing several audio and GUI libraries, and many dependencies. -The package is sufficient for most server operations and for experienced admins. -to get full functionality, use full JRE or SKD +The package is sufficient for most server based Java workloads +and for experienced admins. To get full functionality, use full JRE or JDK.

judovana · 2026-02-05T08:41:46Z

@karianna @steelhead31 Thanks! Rebased. If all the checks passes, and your review passes, it seems to be good to go.

steelhead31

Looks good!, based on the volume of testing we've carried out.. Im happy to merge this ahead of the upcoming release cycles in March/April.

judovana · 2026-02-05T09:00:12Z

Thanks! Looking forward to see it in action (and am just imagining what avalanche of troubles it will start O:) )

judovana · 2026-02-05T09:02:12Z

btw the hunk of

 echo "Disabled Uploads For Testing"

https://github.com/adoptium/installer/pull/1308/changes#diff-6b814d76bb7841eca9df868e074766d7e41088aadf2be7590628ea642a66e8ce still exists.

steelhead31 · 2026-02-05T10:10:48Z

btw the hunk of
 echo "Disabled Uploads For Testing"
https://github.com/adoptium/installer/pull/1308/changes#diff-6b814d76bb7841eca9df868e074766d7e41088aadf2be7590628ea642a66e8ce still exists.

Fixed!

karianna · 2026-02-07T22:29:26Z

/thaw

Pull Request unblocked - code freeze is over.

karianna · 2026-01-29T23:52:14Z

linux_new/jre/rhel/src/main/packaging/temurin/11/temurin-11-jre.template.j2

 Eclipse Temurin JRE is an OpenJDK-based runtime environment to execute
 applications and components using the programming language Java.
+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.


In that case, "many other dependencies"

linux_new/jre/rhel/src/main/packaging/temurin/11/temurin-11-jre.template.j2

karianna · 2026-02-07T22:50:48Z

linux_new/jre/rhel/src/main/packaging/temurin/11/temurin-11-jre.template.j2

+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.
+The package is sufficient for most server based Java workloads
+and for experienced admins. To get full functionality, use full JRE or JDK.


Suggested change

and for experienced admins. To get full functionality, use full JRE or JDK.

To get full functionality, use full JRE or JDK.

I had intentionally highlighted and for experienced admins because nearly all of the dependences are now stripped. On extremely clean system, java may not even start, or may die later. Although I had not found such a case, the rpm deps will not even complain, if you remove crucial dependence later.. To prevent this, the AutoReqProv: no would be necessary to switch to yes, which would require pretty hard business case. See the analyse in #917 (comment) and several comments bellow.

Will adjust the description as per suggestions if You will confirm.

Is it more a case of "admins experienced with Java workloads?"

karianna · 2026-02-07T22:50:54Z

linux_new/jre/rhel/src/main/packaging/temurin/11/temurin-11-jre.template.j2

 applications and components using the programming language Java.
+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.
+The package is sufficient for most server based Java workloads


Suggested change

The package is sufficient for most server based Java workloads

The package is sufficient for most server based Java workloads.

karianna · 2026-02-07T22:51:24Z

linux_new/jre/rhel/src/main/packaging/temurin/17/temurin-17-jre.template.j2

 applications and components using the programming language Java.
+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.
+The package is sufficient for most server based Java workloads


Suggested change

The package is sufficient for most server based Java workloads

The package is sufficient for most server based Java workloads.

karianna · 2026-02-07T22:52:10Z

linux_new/jre/rhel/src/main/packaging/temurin/21/temurin-21-jre.template.j2

+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.
+The package is sufficient for most server based Java workloads
+and for experienced admins. To get full functionality, use full JRE or JDK.


Suggested change

and for experienced admins. To get full functionality, use full JRE or JDK.

To get full functionality, use full JRE or JDK.

karianna · 2026-02-07T22:52:21Z

linux_new/jre/rhel/src/main/packaging/temurin/25/temurin-25-jre.template.j2

 applications and components using the programming language Java.
+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.
+The package is sufficient for most server based Java workloads


Suggested change

The package is sufficient for most server based Java workloads

The package is sufficient for most server based Java workloads.

karianna · 2026-02-07T22:52:28Z

linux_new/jre/rhel/src/main/packaging/temurin/25/temurin-25-jre.template.j2

+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.
+The package is sufficient for most server based Java workloads
+and for experienced admins. To get full functionality, use full JRE or JDK.


Suggested change

and for experienced admins. To get full functionality, use full JRE or JDK.

To get full functionality, use full JRE or JDK.

karianna · 2026-02-07T22:52:39Z

linux_new/jre/rhel/src/main/packaging/temurin/8/temurin-8-jre.template.j2

 applications and components using the programming language Java.
+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.
+The package is sufficient for most server based Java workloads


Suggested change

The package is sufficient for most server based Java workloads

The package is sufficient for most server based Java workloads.

karianna · 2026-02-07T22:52:45Z

linux_new/jre/rhel/src/main/packaging/temurin/8/temurin-8-jre.template.j2

+%if ! %{with headful}
+%{name} is missing several audio and GUI libraries, and many dependencies.
+The package is sufficient for most server based Java workloads
+and for experienced admins. To get full functionality, use full JRE or JDK.


Suggested change

and for experienced admins. To get full functionality, use full JRE or JDK.

To get full functionality, use full JRE or JDK.

karianna · 2026-02-07T22:54:45Z

OK, final set of nitpicks and an important question at the top

judovana commented Jan 2, 2026

View reviewed changes

jiekang requested a review from steelhead31 January 5, 2026 13:15

steelhead31 reviewed Jan 5, 2026

View reviewed changes

judovana mentioned this pull request Jan 5, 2026

add headless subpackage #917

Open

karianna reviewed Jan 5, 2026

View reviewed changes

judovana commented Jan 8, 2026

View reviewed changes

linux_new/jre/rhel/src/main/packaging/build.sh Show resolved Hide resolved

judovana commented Jan 8, 2026

View reviewed changes

linux_new/jre/rhel/src/main/packaging/temurin/21/temurin-21-jre.template.j2 Show resolved Hide resolved

judovana commented Jan 8, 2026

View reviewed changes

linux_new/jre/rhel/src/main/packaging/build.sh Show resolved Hide resolved

karianna reviewed Jan 8, 2026

View reviewed changes

judovana requested review from karianna and steelhead31 January 9, 2026 13:24

judovana and others added 18 commits February 5, 2026 09:33

Added headless capabilities

8b58588

Fixing GHAs - sometimes incompatible comment in requires

a12616a

headfull->headful

7b548ed

Moved the jre21 changes to j2 files

4f756b9

Building both jre variants (dummy attempt)

f6df063

Revert "Building both jre variants (dummy attempt)"

3cfef8e

This reverts commit d1c46ca.

sfr: Disable Package Uploads For JRE-headless testing

5b27bc2

Set altname depending on package type

29efba9

Build headful and headless jres

f34f6c6

Convert tabs to spaces.

ed1d64a

Fix Headless Build

8a46d2a

spellcheck

e024656

Co-authored-by: Martijn Verburg <martijnverburg@gmail.com>

Adjusted 11,17 and 25 to be headless capable

78cc1e8

Added jdk8 headless capability

066a59f

Removed policytool and libjsoundalsa.so from headless jre8 template

27b68bf

Improved description of headless subpackages

765510d

Remove Debugs And Align With Master

3e1d058

judovana force-pushed the optionalHeadlessPackage branch from d36a1a8 to 3e1d058 Compare February 5, 2026 08:40

steelhead31 approved these changes Feb 5, 2026

View reviewed changes

Remove debug mode

756f77b

karianna requested changes Feb 7, 2026

View reviewed changes

		@@ -1,13 +1,16 @@
		%global upstream_version 21.0.5+11
		%global upstream_version 21.0.9+10

	and for experienced admins. To get full functionality, use full JRE or JDK.
	To get full functionality, use full JRE or JDK.

	The package is sufficient for most server based Java workloads
	The package is sufficient for most server based Java workloads.

Uh oh!

Conversation

judovana commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jiekang commented Jan 2, 2026

Uh oh!

jiekang commented Jan 2, 2026

Uh oh!

judovana commented Jan 2, 2026

Uh oh!

judovana commented Jan 2, 2026

Uh oh!

steelhead31 left a comment

Choose a reason for hiding this comment

Uh oh!

judovana commented Jan 5, 2026

Uh oh!

steelhead31 commented Jan 5, 2026

Uh oh!

judovana commented Jan 5, 2026

Uh oh!

steelhead31 commented Jan 5, 2026

Uh oh!

judovana commented Jan 5, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

judovana commented Jan 6, 2026

Uh oh!

steelhead31 commented Jan 7, 2026

Uh oh!

judovana commented Jan 8, 2026

Uh oh!

steelhead31 commented Jan 8, 2026

Uh oh!

steelhead31 commented Jan 8, 2026

Uh oh!

judovana commented Jan 8, 2026

Uh oh!

judovana commented Jan 8, 2026

Uh oh!

steelhead31 commented Jan 8, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

judovana commented Jan 19, 2026

Uh oh!

steelhead31 commented Jan 19, 2026

Uh oh!

karianna commented Feb 5, 2026

Uh oh!

judovana commented Feb 5, 2026

Uh oh!

steelhead31 left a comment

Choose a reason for hiding this comment

Uh oh!

judovana commented Feb 5, 2026

Uh oh!

judovana commented Feb 5, 2026

Uh oh!

steelhead31 commented Feb 5, 2026

Uh oh!

karianna commented Feb 7, 2026

judovana commented Jan 2, 2026 •

edited

Loading