Hide Forgot
Affects: Documentation (Ref Guide, User Guide, etc.), Compatibility/Configuration, Release Notes Date of First Response: 2008-10-01 21:24:46 project_key: SOA run.bat and run.conf have -Djava.awt.headless=true This prevents the groovy_gateway quickstart from running properly. It also prevents the HSQL Database Manager from running. You get to the HSQL DB Mgr from the JMX Console and selecting the startDatabaseManager MBean operation on a hypersonic datasource. Both of these tools are very useful for developers and the default configuration is supposed to be developer friendly. We should verify that the EAP has headless=true for the default configuration, if it does then we should push this bug over to EAP and document how to workaround it in SOA-P.
Headless was set for the embedded console https://jira.jboss.org/jira/browse/SOA-654 But - we're no longer shipping that console with 4.3 - does the enterprise console need this set also?
Link: Added: This issue is related to SOA-654
Sounds like we need to reopen 654 and move it to a later release date, and then undo the changes it caused for this release.
Assigning to J to spread the load.
it was originally added for https://jira.jboss.org/jira/browse/SOA-227 which implies that it is needed to allow linux services to run
The DB manager (in AS) is a swing app - https://jira.jboss.org/jira/browse/JBPAPP-180 - needs headless or the app can't open IF the AS server is run as Linux service. We (SOA-P 4.3 and the new enterprise console) cannot be headless. Seems like the best option is that we run without -headless for the new console and document the need for the headless setting for users that want the DB app? It cannot be both - right?
I'm checking EAP 4.3 now - it might only be set to headless in the RPM-based init script - Since in the RPMs, the server is by default a Linux service...
EAP 4.3: 1) From /etc/init.d/jbossas - as distributed in the RPMs: 159 # Set the awt.headless option 160 JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true" 161 export JAVA_OPTS 2) From EAP as distributed in .zip: [ldimaggi@ldimaggi bin]$ pwd /opt/EAP/jboss-eap-4.3/jboss-as/bin [ldimaggi@ldimaggi bin]$ grep -i headless * <no matches>
Proposition: We ship the startup script as is from EAP, so that the JON console is happy. And document the problem in SOA-227. 'Opinions anyone?
I think we should be consistent with EAP. if headless=true is associated with the default configuration then this means the hsql db manager will not be available and a developer will need to set headless=false to enable the db mgr and in our case the groovy-gateway. We'll just want to document that in the readme.txt of quickstarts\groovy_gateway at a minimum since this example won't work "out of the box".
Affects: Added: [Documentation (Ref Guide, User Guide, etc.), Compatibility/Configuration, Release Notes]
correct
Sorry - one more time: 1) The EMBEDDED console requires headless=true 2) The groovy_gateway quickstart requires headless=false 3) Running the SOA-P server as a Linux service requires headless=false for the HSQL DB manager swing GUI to work - note that the fix first called for in JBAPP-180 was for the server to display an understandable error message to the user if he tried to run the HSQL DB manager when the server was running as a Linux service - and running as headless 4) The ENTERPRISE console does not care as it runs its own server Our plan is to be consistent with SOA-P 4.2 and EAP (as packaged in RPMs) and ship headless=true and document (2) and (3) above now?
Link: Added: This issue is related to JBPAPP-180
Link: Added: This issue is related to SOA-227
I suggest adding text for the HSQL DB Mgr as a `Note' at the end of section 2.2 (Starting JBoss Enterprise SOA Platform) in the Getting Started Guide. Something like: The default setting for the SOA Platform is `java.awt.headless=true'. Change this to `java.awt.headless=false' in the run.conf or run.bat script, as appropriate, in order to run graphical applications on the server, such as the HSQLDB manager in the JMX console. I also suggest adding text about the groovy_gateway quickstart to section 3.4 (Running other Quickstarts) in the Getting Started Guide. Something like the following appended to the opening paragraph: Note also that the `groovy_gateway' quickstart will not run with the default setting of `java.awt.headless=true'. Change this to `java.awt.headless=false' in the run.conf or run.bat script, as appropriate.
Content added to Release Notes under Known Issues: 8.1. groovy_gateway Quickstart & HSQLDB Manager incompatible with 'headless' server The default configuration for the SOA Platform includes the setting java.awt.headless set to true. This is required for the embedded console to function. However both the groovy_gateway Quickstart and the Hypersonic database manager require that this value be set to false and will not work. If you require either of these items you can change this setting in run.conf, but doing this will disable the embedded console. Additional information: http://jira.jboss.org/jira/browse/SOA-906 Content added to Getting Started Guide under 3.4. Running other Quickstarts Warning The groovy_gateway Quickstart does not work when the server is running in 'headless' mode. The SOA Platform runs in this mode by default due to the requirements of other components. More details regarding this can be found in the known issues section of the SOA Platform Release Notes and online at http:// jira.jboss.org/jira/browse/SOA-906 .
Verified in 4.3CP01 CR2 release notes doc and Getting Started Guide here: https://svn.corp.jboss.com/repos/soa/branches/4.3/build-tools/docs/esb/