GWME-7.1.1-2 - OpenJDK

Problem

Groundwork currently provides the latest version of Oracle JDK7 (1.7.0u76). While functional, this version may be too old to meet the requirements for certain organizations. Groundwork is unable to update to Oracle JDK8 at this time due to incompatibilities with JBOSS Portal Platform. The OpenJDK-7 has been shown (under certain conditions) to work well with Groundwork and may help these organizations meet their requirements. At this time, Groundwork is unable to provide OpenJDK as an installation option due to various platform-specific dependency conflicts, although this is still under investigation.

Support Considerations

Groundwork is committed to ensuring that customers are able to meet their organizational requirements and we will strive to ensure that OpenJDK will work well for you. With that said, this approach has not been widely tested and is considered a feature that should only be pursued if there are no other good alternatives. At this time, we have conducted basic testing in the following environments and not observed any unexpected behavior:

GW Version Linux Version Java Version Status
7.1.0 Ubuntu 14.04 OpenJDK 1.7.0_121
Pass
7.1.1 Ubuntu 14.04 OpenJDK 1.7.0_121
Pass
7.1.0
Ubuntu 12.04
OpenJDK 1.7.0_121
Pass
7.1.1
Ubuntu 12.04
OpenJDK 1.7.0_121
Pass
7.1.0 Centos 6.7 OpenJDK 1.7.0_121 Pass
7.1.1 Centos 6.7 OpenJDK 1.7.0_121 Pass
7.1.0
SuSE 11sp4 OpenJDK 1.7.0_121
Pass
7.1.1
SuSE 11sp4
OpenJDK 1.7.0_121
Pass
7.1.0 SLES12-SP2 OpenJDK 1.7.0_121 Pass
7.1.1 SLES12-SP2 OpenJDK 1.7.0_121 Pass
7.1.0 RHEL 6.3 OpenJDK 1.7.0_121 Pass
7.1.1 RHEL 6.3 OpenJDK 1.7.0_121
Pass
7.1.0 RHEL 7 OpenJDK 1.7.0_121
Pass
7.1.1 RHEL 7 OpenJDK 1.7.0_121
Pass

In depth testing of various features with complex configuration scenarios are in progress but have yet to result in any failures or other system issues. 

Solution

TB 7.1.1-2 provides the changes necessary to a Groundwork 7.1.0 or 7.1.1 installation to use a separately installed JDK7 such as OpenJDK 1.7.0_121.

Installing

  1. Install desired JDK7 (e.g., OpenJDK 1.7.0_121)
  2. Download and run the install script:
    Name Size Creator Creation Date Comment  
    TB7.1.1-2_install 3 kB Ryan Graffy Feb 10, 2017 08:16 Updated for GWMON-12884  

Note for SSL:

For systems with SSL enabled following the procedures in the SSL Doc, the following change is necessary for this Technical Bulletin:

Step 15 calls for the following command:

keytool -import -file /usr/local/groundwork/apache2/conf/server.crt -alias myserver.mydomain.com -keystore /usr/local/groundwork/java/jre/lib/security/cacerts

The "/usr/local/groundwork/java" portion of the last argument must be changed to the location of the version of Java selected as a part of the Technical Bulletin installation. 

Ex: 

keytool -import -file /usr/local/groundwork/apache2/conf/server.crt -alias myserver.mydomain.com -keystore /usr/lib/jvm/java-7-openjdk-amd64/jre/lib/security/cacerts

where, "/usr/lib/jvm/java-7-openjdk-amd64/" is the new java path. 

Make this change when enabling SSL as a part of that defined procedure, or execute this updated command on a system with SSL already enabled prior to installation of the Technical Bulletin

Example

more /etc/issue

Welcome to SUSE Linux Enterprise Server 12 SP2  (x86_64) - Kernel \r (\l).

more /usr/local/groundwork/Info.txt

GroundWork Installation Report
==============================
Components Installed:
PostgreSQL ..... 9.4.1
Monitor    ..... 7.1.0-br391-gw2842
Product Info
=============
name= enterprise
version= 7.1.0
bitrock_build= br391
gw_build= gw2842
installer_name= groundworkenterprise-7.1.0-br391-gw2842-linux-64-installer.run
installation_date= 02/04/2017 08:07 AM

java -version

If 'java' is not a typo you can use command-not-found to lookup the package that contains it, like this:
    cnf java

chmod +x /home/ec2-user/install-jdk7-121.sh
/home/ec2-user/install-jdk7-121.sh

===== Groundwork Patch 7.1.1-2 installer =====
This patch will allow you to have Groundwork use a
custom installed JDK7 instead of the included Oracle JDK7.
Please note that this script will stop/start Groundwork which
will result in a few minutes of downtime.
which: no java in (/sbin:/usr/sbin:/usr/local/sbin:/root/bin:/usr/local/bin:/usr/bin:/bin:/usr/games:/usr/lib/mit/bin)
ERROR: java required but not found

zypper install java-1.7.0-openjdk-devel

......

java -version

java version "1.7.0_121"
OpenJDK Runtime Environment (IcedTea 2.6.8) (suse-36.2-x86_64)
OpenJDK 64-Bit Server VM (build 24.121-b00, mixed mode)

/home/ec2-user/install-jdk7-121.sh

PATCH: TB7.1.1-2
USER: root
HOST: rg-xps.dev.local
INSTALL START: Tue Feb  7 11:22:44 EST 2017
==================================================
Determining JDK location...
System default JDK is at /usr/lib/jvm/java-7-openjdk-amd64
Use this? [Y/n] Stopping gwservices...
Stopping GroundWork Services: [   OK   ]
Backing up original JDK...
Setting JAVA_HOME to /usr/lib/jvm/java-7-openjdk-amd64 in /usr/local/groundwork/scripts/setenv.sh....
Starting gwservices...
Cleanup SNAPSHOT Libraries ...Checking for GroundWork Services:
    JBoss Portal Platform is not running
    Standalone Foundation is not running
    JOSSO server is not running
    svscan is not running
    dumblogs are not running
    supervise for JBoss Portal Platform is not running
    supervise for Standalone Foundation is not running
    Feeders are not running
    Notifications are not running
    nagios2collage_socket is not running
    nagios2collage_eventlog is not running
    fping_process is not running
    cacti_feeder is not running
    perfdata_scanner is not running
    gdma_spool_processor is not running
Starting GroundWork Services:
    Waiting for portal to be completely up and running:
	Portal controller is not available ...
	Portal controller is not available ...
	Portal is still starting ...
	Portal is still starting ...
	Portal is still starting ...
	Portal is now running.
    Waiting for sequential application deployments:
	Waiting for icefaces-push-server-1.8.2-P06-EE.war deployment:  .1234567
	Waiting for foundation-webapp.war deployment:  .123456789.1
	Waiting for legacy-rest.war deployment:  .12345
    Connecting to Foundation:
	Listener is ready to accept data feeds ...
	Listener services are available.
    Waiting for sequential application deployments:
	Waiting for groundwork-enterprise.ear deployment:  .12345678
	Waiting for portal-groundwork-base.war deployment:  .123456
	Waiting for portal-reportviewer.war deployment:  .123456
	Waiting for birtviewer.war deployment:  .123456789
	Waiting for cloudhub.war deployment:  .12345678
	Waiting for monarch.war deployment:  .12345
	Waiting for nagvis.war deployment:  .12345
	Waiting for nms-rstools.war deployment:  .123456789
	Waiting for monarch-export.war deployment:  .12345
	Waiting for nagios-app.war deployment:  .12345
	Waiting for nagvis_share.war deployment:  .12345
	Waiting for nedi.war deployment:  .12345
	Waiting for nms-cacti.war deployment:  .12345
	Waiting for performance.war deployment:  .12345
	Waiting for profiles.war deployment:  .12345
	Waiting for reports.war deployment:  .123456
    Waiting for parallel application deployments:
    Total portal startup time:          47.931 seconds.
    Total listener wait time:            0.004 seconds.
    Total war-file deployment time:    120.134 seconds.
    Total gwservices start-wait time:  168.069 seconds.
GroundWork Services start [   OK   ]
==================================================
INSTALL COMPLETE: Tue Feb  7 11:25:57 EST 2017

Uninstalling

  1. Download and run the uninstall script:
    Name Size Creator Creation Date Comment  
    TB7.1.1-2_uninstall 2 kB Ryan Graffy Feb 10, 2017 08:16 Updated for GWMON-12884  

Note that the uninstaller restores the use in GroundWork of the bundled Java 1.7. It does not uninstall the version of Java 1.7 121 or other that you placed into the operating system. Thus once the uninstaller has run you will have the system back to native GroundWork consistency. The log file in the common/var/patches directory contains the record of all installs and uninstalls as you do them.