Mailing-List: contact dev-help@geronimo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@geronimo.apache.org
Date: Fri, 17 Feb 2012 20:20:57 +0000 (UTC)
From: "Russell E Glaue (Commented) (JIRA)" <jira@apache.org>
To: dev@geronimo.apache.org
Message-ID: 
 <899856367.51840.1329510057447.JavaMail.tomcat@hel.zones.apache.org>
In-Reply-To: 
 <1505971840.48210.1329429300490.JavaMail.tomcat@hel.zones.apache.org>
Subject: [jira] [Commented] (GERONIMO-6275) Defining and Using
 org.apache.geronimo.server.dir versus org.apache.geronimo.home.dir in shell
 scripts
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


    [ https://issues.apache.org/jira/browse/GERONIMO-6275?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13210508#comment-13210508 ] 

Russell E Glaue commented on GERONIMO-6275:
-------------------------------------------

The patch geronimo-6275.patch modifies the shell scripts such that the following commands can now be used to start up a single Geronimo server instance, or Geronimo without an instance configuration. Run-time output follows to demonstrate start-up ability after modifications are applied from the patch.

- Tested with geronimo-tomcat7-javaee6-3.0-SNAPSHOT-20111220
- Windows batch files are also patched, and partially tested for syntax. But they need full testing on a Windows Geronimo Deployment.
- Geronimo server instance is setup as documented in https://cwiki.apache.org/confluence/display/GMOxDOC30/Running+multiple+Geronimo+instances
- Note the error message "Error in initialization script: /data/geronimo3/etc/shell.init.script (No such file or directory)" is caused because the Java code for Karaf looks for {karaf.home}/etc/shell.init.script instead of {karaf.base}/etc/shell.init.script.


Startup Geronimo server instance gserv1
{noformat:borderStyle=solid}
[ger@server /opt/geronimo3/gserv1]# env JAVA_HOME=/usr/jdk1.6.0 GERONIMO_SERVER=gserv1 ../bin/geronimo run
Using GERONIMO_HOME:   /opt/geronimo3
Using GERONIMO_SERVER: /opt/geronimo3/gserv1
Using GERONIMO_TMPDIR: /opt/geronimo3/gserv1/var/temp
Using JRE_HOME:        /usr/jdk1.6.0_25/jre
                                                          
     ______                       _                       
    / ____/___  _________  ____  (_)____ ___  ____        
   / / __ / _ \/ ___/ __ \/ __ \/ // __ `__ \/ __ \  
  / /_/ //  __/ /  / /_/ / / / / // / / / / / /_/ /       
  \____/ \___/_/   \____/_/ /_/_//_/ /_/ /_/\____/    

  Apache Geronimo (3.0-SNAPSHOT)

Hit '<tab>' for a list of available commands
and '[cmd] --help' for help on a specific command.
Hit '<ctrl-d>' or 'osgi:shutdown' to shutdown Geronimo.

Error in initialization script: /data/geronimo3/etc/shell.init.script (No such file or directory)
geronimo> Booting Geronimo Kernel (in Java 1.6.0_25)...
Starting Geronimo Application Server v3.0-SNAPSHOT
[****************************************] 100%  47s Startup complete                                         
  Listening on Ports:
    1150 0.0.0.0 CORBA Naming Service
    1199 0.0.0.0 RMI Naming
    1627 0.0.0.0 Derby Connector
    2101 0.0.0.0 OpenEJB SSL ORB Adapter
    4301 0.0.0.0 OpenEJB Daemon
    6982 0.0.0.0 OpenEJB ORB Adapter
    8109 0.0.0.0 Tomcat Connector AJP TomcatAJPConnector
    8180 0.0.0.0 Tomcat Connector HTTP BIO TomcatWebConnector
    8543 0.0.0.0 Tomcat Connector HTTPS BIO TomcatWebSSLConnector
   10099 0.0.0.0 JMX Remoting Connector
   61716 0.0.0.0 ActiveMQ Transport Connector

  Started Application Modules:
    EAR: org.apache.geronimo.plugins/console-tomcat/3.0-SNAPSHOT/car
    JAR: org.apache.geronimo.configs/mejb/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.configs/activemq-ra/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.configs/system-database/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.plugins.monitoring/agent-ds/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.plugins.monitoring/mconsole-ds/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.plugins/uddi-db/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.configs/remote-deploy-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.configs/uddi-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.configs/welcome-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins.monitoring/mconsole-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/activemq-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/debugviews-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/openejb-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/plancreator-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/plugin-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/sysdb-console-tomcat/3.0-SNAPSHOT/car

  Web Applications:
    /
    /activemq
    /console
    /console-base
    /debug-views
    /juddi
    /monitoring
    /openejb-server
    /plan-creator
    /plugin
    /remote-deploy
    /system-database

Geronimo Application Server started
{noformat}


Startup Geronimo server without a configured instance
{noformat:borderStyle=solid}
[ger@server /opt/geronimo3]# env JAVA_HOME=/usr/jdk1.6.0 bin/geronimo run
Using GERONIMO_HOME:   /opt/geronimo3
Using GERONIMO_SERVER: /opt/geronimo3
Using GERONIMO_TMPDIR: /opt/geronimo3/var/temp
Using JRE_HOME:        /usr/jdk1.6.0/jre
                                                          
     ______                       _                       
    / ____/___  _________  ____  (_)____ ___  ____        
   / / __ / _ \/ ___/ __ \/ __ \/ // __ `__ \/ __ \  
  / /_/ //  __/ /  / /_/ / / / / // / / / / / /_/ /       
  \____/ \___/_/   \____/_/ /_/_//_/ /_/ /_/\____/    

  Apache Geronimo (3.0-SNAPSHOT)

Hit '<tab>' for a list of available commands
and '[cmd] --help' for help on a specific command.
Hit '<ctrl-d>' or 'osgi:shutdown' to shutdown Geronimo.

geronimo> Booting Geronimo Kernel (in Java 1.6.0_25)...
Starting Geronimo Application Server v3.0-SNAPSHOT
[****************************************] 100%  67s Startup complete                                         
  Listening on Ports:
    1050 0.0.0.0 CORBA Naming Service
    1099 0.0.0.0 RMI Naming
    1527 0.0.0.0 Derby Connector
    2001 0.0.0.0 OpenEJB SSL ORB Adapter
    4201 0.0.0.0 OpenEJB Daemon
    6882 0.0.0.0 OpenEJB ORB Adapter
    8009 0.0.0.0 Tomcat Connector AJP TomcatAJPConnector
    8080 0.0.0.0 Tomcat Connector HTTP BIO TomcatWebConnector
    8443 0.0.0.0 Tomcat Connector HTTPS BIO TomcatWebSSLConnector
    9999 0.0.0.0 JMX Remoting Connector
   61616 0.0.0.0 ActiveMQ Transport Connector

  Started Application Modules:
    EAR: org.apache.geronimo.plugins/console-tomcat/3.0-SNAPSHOT/car
    JAR: org.apache.geronimo.configs/mejb/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.configs/activemq-ra/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.configs/system-database/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.plugins.monitoring/agent-ds/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.plugins.monitoring/mconsole-ds/3.0-SNAPSHOT/car
    RAR: org.apache.geronimo.plugins/uddi-db/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.configs/remote-deploy-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.configs/uddi-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.configs/welcome-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins.monitoring/mconsole-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/activemq-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/debugviews-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/openejb-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/plancreator-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/plugin-console-tomcat/3.0-SNAPSHOT/car
    WAR: org.apache.geronimo.plugins/sysdb-console-tomcat/3.0-SNAPSHOT/car

  Web Applications:
    /
    /activemq
    /console
    /console-base
    /debug-views
    /juddi
    /monitoring
    /openejb-server
    /plan-creator
    /plugin
    /remote-deploy
    /system-database

Geronimo Application Server started
{noformat}


> Defining and Using org.apache.geronimo.server.dir versus org.apache.geronimo.home.dir in shell scripts
> ------------------------------------------------------------------------------------------------------
>
>                 Key: GERONIMO-6275
>                 URL: https://issues.apache.org/jira/browse/GERONIMO-6275
>             Project: Geronimo
>          Issue Type: Sub-task
>      Security Level: public(Regular issues) 
>          Components: startup/shutdown
>    Affects Versions: 3.0-beta-1
>         Environment: Linux x86, Red Hat Enterprise Linux Server release 5.4 (Tikanga); Java JDK1.6.0_25
>            Reporter: Russell E Glaue
>            Assignee: Russell E Glaue
>            Priority: Minor
>              Labels: geronimo
>         Attachments: geronimo-6275.patch
>
>
> Related: GERONIMO-6270, GERONIMO-6175, GERONIMO-6174, GERONIMO-5987, GERONIMO-4229
> It would be easier to support multiple server instances of Geronimo if there is one shell variable that is used to reference the path on disk to the instance, proposed as GERONIMO_SERVER as opposed to the GERONIMO_HOME installation path. This issue tracks the discussion and modification of such a change.
> GERONIMO_SERVER defines:
> - GERONIMO_SERVER defaults to GERONIMO_HOME if no instances are specified
> - GERONIMO_SERVER is expanded to GERONIMO_HOME/GERONIMO_SERVER if GERONIMO_SERVER is a relative path
> - GERONIMO_SERVER defines org.apache.geronimo.server.dir
> In the java code there are the following properties:
> # org.apache.geronimo.home.dir - equivelant to GERONIMO_HOME shell variable
> # org.apache.geronimo.server.dir - proposed to be equivelant to GERONIMO_SERVER 
> The words "BASE" versus "HOME" appear a few times in the source. Once example is "karaf.home" and "karaf.base" properties. According to the code usage, it is aparant that these terms are assumed to mean these things:
> # HOME - path location on disk of read-only binaries and configuration
> # BASE - path location on disk of read-write configuration and data storage
> The term BASE is intended to point at a Geronimo Server Instance Base path. However, this has not been clearly defined, and has appeared to cause some misusage. Thus this and other issues lead to the removal of GERONIMO_BASE shell variable and org.apache.geronimo.base.dir java property in GERONIMO-4229 .
> Currently, to start a Geronimo Instance, the org.apache.geronimo.server.dir java property must be defined in the GERONIMO_OPTS variable. However, this prevents the Shell scripts from being able to know and use the path location to the Geronimo Server Instance.
> In particular, there are a few issues affected by a variable like this not being available.
> # Reported in GERONIMO-6174 - GERONIMO_TMPDIR is set in the shell/bat scripts as GERONIMO_HOME/var/tmp. In turn, the java property "java.io.tmpdir" is set to GERONIMO_TMPDIR (this is GERONIMO_HOME/var/tmp). Shouldn't GERONIMO_TMPDIR instead be set to a value provided by GERONIMO_SERVER/var/tmp ?
> -- affected scripts: client, deploy, geronimo, internalLauncher, jaxws-tools
> -- This can be argued to whether or not all Geronimo Server Instance should share a common temp directory.
> # Reported in GERONIMO-6174 - The java properties karaf.home and karaf.base are both being set to GERONIMO_HOME. When instead karaf.base should be set to a value held by GERONIMO_SERVER.
> -- affected scripts: client, geronimo, internalLauncher
> -- see resulting errors and reasoning in GERONIMO-6174
> # Not Reported - The java property java.util.logging.config.file is being set to GERONIMO_HOME/etc/java.util.logging.properties . It is intended to be an empty configuration file. This only causes a problem when using instances if GERONIMO_HOME/etc does not exist (it would not exist if GERONIMO_SERVER/etc is intended to be used).
> -- affected scripts: client, geronimo, internalLauncher
> # Not Reported - Logging startup output to GERONIMO_HOME/var/log/geronimo.out - Obviously if multiple instances are being started, this should be GERONIMO_SERVER/var/log/geronimo.out . Any error is silent if var/log/geronimo.out does not exist.
> -- affected scripts: geronimo
> # Not Reported - The register-service script does a grep and awk on GERONIMO_HOME/var/config/config-substitutions.properties to discover the portOffset . Obviously this will not work for multiple instances
> -- The register-service script does not take multiple instances into consideration at all
> -- affected scripts: register-service
> Solution:
> - Create a new shell variable GERONIMO_SERVER to hold the path location to the run-time server configuration, and leave GERONIMO_HOME to hold the path location to the Geronimo Installation Path.
> Arguments:
> - If GERONIMO_SERVER defaults to GERONIMO_HOME, then any installation not having multiple instances configured will not be affected.
> - This will not resolve the multiple instance support issue in Geronimo, GERONIMO-6270, but having this support in the shell scripts will get Geronimo much closer.
> - About half of the currently known issues (listed above) can be resolved with the addition of GERONIMO_SERVER as proposed.
> The remaining currently known issues will be:
> # GERONIMO-6174: the proper use of karaf.home versus karaf.base
> # GERONIMO-6270 SnapshotConfigXMLBuilder using the org.apache.geronimo.server.dir/var directory
> # GERONIMO-5987 and GERONIMO-6270: ActiveMQ using org.apache.geronimo.server.dir as the base for var rather than the current working directory the run-time server is in at startup
> # GERONIMO-6175: The Geronimo Repository using org.apache.geronimo.server.dir instead of org.apache.geronimo.home.dir

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira