MustGather: Read first for all Apache Geronimo Components

Collecting MustGather data early, even before opening the PMR, helps IBM® Support quickly determine if:

1. Symptoms match known problems (rediscovery).
   
2. There is a non-defect problem that can be identified and resolved.
   
3. There is a defect that identifies a workaround to reduce severity.
   
4. Locating root cause can speed development of a code fix.

	Gathering general information
	Submitting information to IBM Support

1. Copy the following configuration information to a text file:
   
   • Include version of Apache Geronimo, as well as listing installed patches.
     
     
   • Locate InstallDir/config-store/index.properties file. Also find the configId and corresponding index number for the application.
     
     Copy files in the folder under InstallDir/config-store with the same name as that of the index number. Click here for more information
     
     
2. Locate the InstallDir/var/log/server-log4j.properties file. Set the value of log4j.rootCategory to "DEBUG, CONSOLE, FILE".
   
   
3. If you are experiencing a problem in a specific component, please find the related LOG4J categories in InstallDir/var/log/server-log4j.properties file, then set appropriate log level to generate output that shows where the problem occurs.
   
   By default, all the categories have the "WARN" log level. Typically, changing the log level to "DEBUG" will provide useful information for problem determination.
   
   
4. Restart the Application Server and recreate the problem.
   
   
5. Collect the following data:
   • InstallDir/var/catalina/logs/*.log
   • InstallDir/var/derby/*.log
   • InstallDir/var/log/*.log
   • InstallDir/var/log/*.properties
   • InstallDir/var/txlog/*
     
     
6. Bundle the above information. We suggest using zip or tar.
   
   
7. Follow the directions for submitting information to IBM Support (below).
   
   

1. An unique index number is created for the application being deployed.
   
   
2. An entry is made by the server in InstallDir/config-store/index.properties file.
   
   
3. The entry will be in form of configId=index_number. Thus, if the configId of the
   application being deployed is org.apache.geronimo.MyApplication and the index number created for the application is 10, then the entry in the file would be org.apache.geronimo.MyApplication=10
   
   
4. A folder, with the name same as index number, is created in InstallDir/config-store directory.
   
   
5. Server creates a .ser file which is serialized state of the application, in the folder which is created in the Step4.