[jbpm-commits] JBoss JBPM SVN: r5318 - jbpm4/trunk/modules/userguide/src/main/docbook/en/modules.
do-not-reply at jboss.org
do-not-reply at jboss.org
Fri Jul 17 05:47:27 EDT 2009
Author: tom.baeyens at jboss.com
Date: 2009-07-17 05:47:27 -0400 (Fri, 17 Jul 2009)
New Revision: 5318
Modified:
jbpm4/trunk/modules/userguide/src/main/docbook/en/modules/ch01-Introduction.xml
Log:
added section 'reporting problems'
Modified: jbpm4/trunk/modules/userguide/src/main/docbook/en/modules/ch01-Introduction.xml
===================================================================
--- jbpm4/trunk/modules/userguide/src/main/docbook/en/modules/ch01-Introduction.xml 2009-07-17 08:55:20 UTC (rev 5317)
+++ jbpm4/trunk/modules/userguide/src/main/docbook/en/modules/ch01-Introduction.xml 2009-07-17 09:47:27 UTC (rev 5318)
@@ -56,4 +56,39 @@
</para>
</section>
+ <section>
+ <title>Reporting problems</title>
+ <para>When reporting a problem in the user forum or in our support portal, please
+ use the following snippet as a template:
+ </para>
+ <programlisting><emphasis role="bold">Environment:</emphasis>
+<emphasis role="bold"> - jBPM Version:</emphasis> which version of jBPM are you using?
+<emphasis role="bold"> - Database:</emphasis> which database and which version of that database
+<emphasis role="bold"> - JDK:</emphasis> which Java version are you using? use 'java -version' to find out
+<emphasis role="bold"> - Container:</emphasis> which Java version are you using? use 'java -version' to find out
+<emphasis role="bold"> - Configuration:</emphasis> is your jbpm.cfg.xml only importing files from the jbpm.jar
+ lib itself? or did you create a custom config file?
+<emphasis role="bold"> - Libraries:</emphasis> are you using the exact versions of the libs from inside the jbpm
+ distribution of the version that you're using? or did you change some of the libs?
+
+<emphasis role="bold">Process:</emphasis>
+past jPDL process here
+
+<emphasis role="bold">API:</emphasis>
+past the relevant code snippet that you use to invoke jBPM
+
+<emphasis role="bold">Stacktrace:</emphasis>
+past full stack trace here
+
+<emphasis role="bold">Debug logs:</emphasis>
+past debug logs here</programlisting>
+ <para>Clever readers will have noticed that some of these questions point to probably causes :-)
+ Especially tweaking the libs and configuration can easily lead to trouble. That's why
+ we have spend a great deal of effort to include default installations and a simplified
+ configuration mechanism with imports. Think twice before you start to customize
+ configurations beyond what is indicated in this userguide. Also think twice before
+ replacing libs with other versions.
+ </para>
+ </section>
+
</chapter>
More information about the jbpm-commits
mailing list