home *** CD-ROM | disk | FTP | other *** search
/ Chip 2003 July / CMCD0703.ISO / Software / Freeware / Programare / bugzero / WEB-INF / faq.txt next >
Encoding:
Text File  |  2003-05-21  |  17.3 KB  |  356 lines
  1.         Bugzero Frequently Asked Questions
  2.  
  3. General Questions:
  4.  
  5. Q: What are the system requirements?
  6. A: Bugzero utilizes your existing hardware and software, and can be integrated seamlessly
  7.    with your current Java/J2EE and database systems. It is cross-platform and can be 
  8.    installed on Windows, Unix (Linux), iSeries (AS/400), and Mac operating systems.
  9.    The server requires:
  10.      1. J2SE (JDK 1.3+)
  11.      2. A Java Servlet engine or J2EE application server such as
  12.         Tomcat, JBoss, WebLogic, WebSphere, Oracle 9iAS, iPlanet,
  13.         Orion Server, JRun, Resin, and others. Bugzero needs only the 
  14.         Servlet container, no EJB container is required. 
  15.      3. A backend database, such as MySQL, PostgreSql, 
  16.         Access, SQL Server, Oracle, DB2, and others.
  17.      4  An outgoing SMTP mail account (optional).
  18.  
  19.    Bugzero has to be installed on the same computer where the Servlet engine
  20.    and JDK is installed. On the other hand, the database and SMTP server can be
  21.    anywhere (either on the same computer or not).
  22.  
  23.    Bugzero is web-based, and so for end users, only a browser is required.
  24.  
  25. Q: What are the supported database systems?
  26. A: Bugzero supports MySQL, PostgreSql, Access, SQL Server, Oracle, DB2,
  27.    and PointBase. The following database systems are known to be currently in 
  28.    production use with Bugzero:  MySQL 3.23, PostgreSql 7.1, Access 97/2000,
  29.    SQL Server 7/2000, Oracle 8i, DB2 7.2, and Sybase ASE 12.0.
  30.  
  31.    If you use IBM iSeries (AS/400) DB2, you have to enable journaling for the database.
  32.    You can do that with CRTJRNRCV (Create Journal Receiver), CRTJRN (Create Journal),
  33.    and STRJRNPF (Start Journal Physical File).
  34.  
  35. Q: What are the supported J2EE or servlet containers?
  36. A: Theoretically, Bugzero should run on all the available J2EE or Servlet engines.
  37.    Bugzero has been tested on Tomcat 3.x and 4.x, JBoss 2.x and 3.0, 
  38.    WebLogic 6.x and 7.0, WebSphere 4.x and 5.0, Oracle 9iAS, 
  39.    iPlanet Web Server 6.0 and Application Server 6.5,
  40.    Orion Server 1.5.2, JRun 4, and Resin 2.1.4.
  41.    
  42.    Bugzero needs only a servlet container, an EJB container is not required.
  43.  
  44. Q: What are the supported Web browsers?
  45. A: Bugzero does not use Java Applet, Microsoft ActiveX, or any other Plugins.
  46.    Bugzero does need Javascript. It has been tested on the following browsers:
  47.    IE 5.x, IE 6.x, Mozilla 1.x, Phoenix 0.4+, Opera 6.0+, Netscape 4.7+. 
  48.  
  49.    Other browsers should also work, but they have not been officially tested.
  50.  
  51.    Please note that, when attaching a file, if the browser encoded the multipart
  52.    form data incorrectly, Bugzero will reject the data and you will see an error
  53.    message. This may occur for the following browsers:
  54.  
  55.      MSIE 5.01; Windows NT 5.0
  56.      Konqueror/3; Linux
  57.      Konqueror/3.0.0-10; Linux
  58.  
  59.    The following problems have been reported, but normally they cannot be
  60.    reproduced and they may never happen to you:
  61.  
  62.      With Netscape 4.79 on Solaris, the attachment page and the reports result
  63.      pages do not display correctly. Version 7.0 apparently works fine. 
  64.  
  65.      With Netscape 7.0, the graphic reports cannot be displayed if the Cache
  66.      property is set to "Every time I view the page", set it to "When the page
  67.      is out of date" solves the problem.
  68.  
  69.      With IE6, if the Bugzero host computer does not have a DOMAIN (i.e.,
  70.      WORKGROUP setup), then you may need use its IP address, instead of the
  71.      hostname, in the url.  Otherwise, IE6 may not allow cookies.
  72.  
  73. Q: Where to get the SQL Server 2000 JDBC driver?
  74. A: Because of licensing issues, we cannot package the driver. However, you 
  75.    can download it free from <a href="http://www.microsoft.com/sql/downloads/">www.microsoft.com</a>.
  76.  
  77.    Install it to any directory and find where these 3 jar files: msbase.jar,
  78.    mssqlserver.jar and msutil.jar are located.
  79.    During Bugzero's setup process, it will ask you the folder where they are located,
  80.    and the program will copy them to the Bugzero lib folder.
  81.  
  82. Q: Where to get the Oracle JDBC driver?
  83. A: Oracle JDBC driver comes with Oracle, the file is classes12.zip. For Oracle 8i,
  84.    the file is located in the folder ../Ora81/jdbc/lib. Please note that, for
  85.    oracle 8.16 or ealier, you need downloaded a updated version of classes12.zip.
  86.  
  87. Q: What jdbc driver should I use for DB2?
  88. A: The DB2 driver comes with the database, the file is db2java.zip under the
  89.    folder /SQLLIB/java. 
  90.    Note that, even if the database is on the same local machine, it is better
  91.    to use COM.ibm.db2.jdbc.net.DB2Driver, not COM.ibm.db2.jdbc.app.DB2Driver 
  92.    The url is jdbc:db2://database_hostname/bugzero_db, where database_hostname
  93.    can be localhost.
  94.  
  95. Q: Can Bugzero be installed in a virtual host environment?
  96. A: Yes. Bugzero is completely self-contained and can be installed in a virtual host
  97.    environment within a hosting company that supports Java servlet/jsp and database
  98.    access. You may want manually configure the database properties and upload the
  99.    entire bugzero package to your virtual host's application directory. You need
  100.    then run 'bugzero -admin passwd' to create the base tables. 
  101.  
  102. Q: Can I run Tomcat as an NT service for Bugzero (on windows)?
  103. A: Yes, you can. Bugzero is now completely self contained and does not
  104.    require any modifications of the classpath. So, to Bugzero, there is no
  105.    difference whether you launch tomcat with the NT service or with the command.
  106.  
  107. Q: What is the HTTP port number of my application server?
  108. A: The HTTP port number of an application server is configurable. Below is the 
  109.    default HTTP port numbers of some application servers:
  110.      Tomcat (JBoss): 8080 (see server.xml)
  111.      WebLogic: 7001 (see config.xml)
  112.      WebSphere: 9080 (server-cfg.xml)
  113.      Oracle 9iAS: 8888 (see default-web-site.xml)
  114.      iPlanet: 80 (see server.xml)
  115.      Orion Server: 80 (see default-web-site.xml)
  116.      JRun: admin (8000), default (8100), samples (8200) (see jrun.xml) 
  117.      Resin: 8080 (see resin.conf)
  118.  
  119. Q: How to deploy Bugzero on IBM WebSphere 4/5?
  120. A: You can deploy Bugzero with the WebSphere administration console. 
  121.    First, cd to the bugzero directory and type 'jar ../bugzero.war .'.
  122.    And then move the resulted bugzero.war to WebSphere's installableApps
  123.    directory and use the administration console to deploy bugzero.war.
  124.    
  125. Feature Related:
  126.  
  127. Q: How can I add more user groups?
  128. A: You can add group by editing the group.properties file in the data/conf folder.
  129.    Note that, group admin and guest are preloaded. 
  130.  
  131. Q: Can Bugzero cc email to people?
  132. A: Yes, there is a cc email field on the create and edit bug page. One can cc multiple
  133.    people. The email addresses should be seperated with ";".
  134.  
  135. Q: The hype-link in the bug notification email does not work.
  136. A: The link in the email is created based on the file /data/template/email_body.
  137.    You need modify this file by replacing 'http://localhost:8080' to the real url 
  138.    where Bugzero is deployed. After doing that, you need restart your servlet engine.    
  139.  
  140. Q: How can I always send notification email to the original submitter?
  141. A: You need modify edit.jsp by restoring the submitter email block in the file
  142.    (it was commented out by default).
  143.    For most of the cases, restart servlet container is not needed.  
  144.  
  145. Q: I do not have a smtp mail server, can I disable sending email?
  146. A: Yes, you can disable Bugzero sending email by setting (in the file mail.properties):
  147.    mail.mailer.disabled=true
  148.  
  149.    Please note that, by default, email notification is enabled and if you do not either
  150.    disable it or set up the mail account, you will notice some exceptions in the log
  151.    file. 
  152.  
  153. Q: Can I change the project name of an existing project?
  154. A: Yes. The project name which is actually seen by the end users is now different from
  155.    the project ID. While the ID of an existing project can not be changed, the name can
  156.    be changed at runtime by using the administration interface. The change will be seen
  157.    immediately to the end users.
  158.  
  159. Q: Does Bugzero accept bug reports submitted through email?
  160. A: Yes. Bugzero has an advanced parsing capability for inbound emails. Email bug 
  161.    submission can either modify an existing bug(s) or create a new bug. It has
  162.    a spam-filter and can also handle email attachment. 
  163.  
  164. Q: Can Bugzero be integrated with CVS source control system? 
  165. A: Yes. Bugzero can be integrated with CVS version control system through our email API.
  166.    You need configure your CVS such that the loginfo will be sent to an email address set
  167.    up for this purpose. Detail instruction is available upon request.
  168.  
  169.  
  170. Runtime Errors:
  171.  
  172. Q: The graphic report failed to be displayed and exceptions occurred.
  173. A: On Linux or Unix OS, an exception is thrown by the Java AWT toolkit when it
  174.    can not make a connection to an X11 server. The exception can be something like
  175.    "Can't connect to X11 window server using ':0.0' as the value of the DISPLAY variable".
  176.    
  177.    If your OS has graphics support, you need make sure that the local X11 is running,
  178.    and the DISPLAY variable is correctly set. 
  179.  
  180.    If you are on a unix server that does not provide a graphical user environment,
  181.    there are three alternatives:
  182.  
  183.    1. Sun JDK 1.4 Headless mode
  184.       If you are using JDK 1.4, then you can use the Headless graphics mode to launch 
  185.       the server, ie, you can add a java argument of -Djava.awt.headless=true.
  186.  
  187.       Note that, it seems the presense of X11 runtime libraries is still needed, that
  188.       is, an X11 environment must be installed into the system, but the X11 server 
  189.       itself need not be started. For example, for RedHat Linux, the minimum set
  190.       of X11 packages needed is:
  191.         * XFree86
  192.         * XFree86-libs
  193.  
  194.    2. Virtual X11 Frame Buffer (Xvfb)
  195.       For JDK 1.3, the headless mode is not available. If you do not have X11 sever,
  196.       you can install a lightweight Xvfb (XFree86-Xvfb package).
  197.       In your server launch script (such as tomcat.sh), add the following lines:
  198.  
  199.        if [ -f /usr/X11R6/bin/Xvfb ]; then
  200.           /usr/X11R6/bin/Xvfb :1 -screen 0 1x1x8 > /dev/null 2>&1 &
  201.        fi
  202.        export DISPLAY=:1.0
  203.  
  204.    3. Pure Java AWT (PJA) 
  205.       Another alternative is PJA. For more detail and to download the software, go to
  206.       http://www.eteks.com/pja/en/. 
  207.  
  208. Q: After I login, it takes me to the same page, what is going on?
  209. A: Bugzero uses session to store temporary data, you need enable 
  210.    'Allow per-session cookies (not stored)' for Bugzero to work.
  211.      For IE5, the Cookies section is under 
  212.             Tools menu - Internet Options - Security - Custom Level.
  213.      For IE6, it is under 
  214.             Tools menu - Internet Options - Privacy
  215.      For Netscape, it is under
  216.             Edit - Preferences - Advanced
  217.      For Mozilla, it is under
  218.             Edit - Preferences - Privacy & Security - Cookies
  219.  
  220.    Note that, for later versions of Bugzero, it should explicitly inform you so.
  221.  
  222. Q: When I switch project, it always fall back to the HOME page and display the
  223.    bug list of the previous project.
  224. A: This is a browser caching problem, check your browser's caching status.
  225.    For IE 5.5 or later: Tools - Internet Options - General - 
  226.                 Temporary Internet files - Settings
  227.                 and select "Automatically" or "Every visit to the page"
  228.    
  229.    For Netscape Versions 4 or later or Mozilla 1.x: 
  230.                 Edit - Preferences - Advanced - Cache,
  231.                 and select "When the page is out of date" or 
  232.                            "Every time ...".
  233.  
  234. Q: What is this COM.ibm.db2.jdbc.DB2Exception?
  235.    [IBM][JDBC Driver] CLI0616E  Error opening socket. SQLSTATE=08S01
  236. A: This happens if the DB2 JDBC Applet Server is not running. You need start
  237.    this service.
  238.  
  239. Q: What is this COM.ibm.db2.jdbc.DB2Exception?
  240.    [IBM][JDBC Driver] CLI0637E  QUERY cannot be found
  241. A: This is a known bug in the JDBC driver in DB2 PF5, it occurs when a SQL
  242.    statement contains TAB or new-line characters. You need upgrade the
  243.    JDBC driver.
  244.  
  245. Q: With MySQL, when attaching a file, I got 
  246.    java.lang.IllegalArgumentException:
  247.    Packet is larger than max_allowed_packet from server configuration of 1048576 bytes
  248. A: This happens when the file you are trying to attach has a size larger than the 
  249.    max packet size of your mysql server. You need set max_allowed_packet=12M
  250.    for [mysqld] (the default is 1M). The mysql configuration file is my.cnf.
  251.    Note that, after the modification, you need restart mysqld as well as your
  252.    servlet engine.
  253.  
  254. Q: Sybase, error when creating tables:
  255.    The column default_project in table person does not allow null values.
  256. A: With Sybase, by default, it may not allow null values in string columns 
  257.    (like VARCHAR, TEXT, etc). In that case, you will have the above error. The
  258.    solution is to change this default value for a database using "isql" by issuing
  259.    the following command:
  260.  
  261.    sp_dboption db_name, "allow nulls by default", true
  262.  
  263.    Here, "db_name" is your database name.
  264.  
  265. Q: Sybase, error when dropping tables:
  266.    ... command not allowed within multi-statement transaction. 
  267. A: If you encounter this error, issue the following commands at the Sybase command
  268.    line:
  269.  
  270.    use db_name
  271.    go
  272.    sp_dboption db, "ddl in tran", true
  273.    go
  274.  
  275.    Or, use "isql" to issue the following command:
  276.  
  277.    sp_dboption db_name, "ddl in tran", true
  278.  
  279.    Here, "db_name" is your database name.
  280.  
  281. Q: I am using Tomcat 4.1.14, when run Bugzero, sometimes I got a blank page.
  282.    What happened?
  283. A: This is an issue with Tomcat 4.1+ using the CoyoteConnector. The problem
  284.    can be fixed by replacing CoyoteConnector to HttpConnector. Specifically, in
  285.    tomcat's conf/server.xml file, you alter   
  286.    
  287.    <Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
  288.    ...
  289.    to
  290.    <Connector className="org.apache.catalina.connector.http.HttpConnector"
  291.    ...
  292.    You need restart Tomcat for the change to take effect.
  293.  
  294. Q: Is there a potential zip file classloading problem with Tomcat?
  295. A: Yes, if you add a zip file in the WEB-INF/lib folder, Tomcat may not load this zip
  296.    file into the classpath. The problem can be solved by renaming the zip extention to
  297.    jar (you do not need unzip and jar the file, just need rename it).
  298.  
  299.    The above could cause problems if you use Oracle or DB2 databases since both their
  300.    jdbc drivers are packaged into a zip file. If such a problem occurs, please rename
  301.    classes12.zip to classes12.jar or db2java.zip to db2java.jar.
  302.  
  303. Q: When login, I got the following exception:
  304.    java.lang.NoClassDefFoundError
  305.    at com.websina.bean.Person.login(Person.java)
  306. A: This is a very misleading error. The real cause of this is the log file 
  307.    bugzero.log is not writable (.../bugzero/WEB-INF/classes/log/bugzero.log).
  308.    This happens only on Unix/Linux OS where the owner of the application server
  309.    process is different from the log file owner. You need make this file writable to
  310.    this process owner and probably restart server.
  311.  
  312.    Before you get this error, when you first time log on to Bugzero from the
  313.    browser, you should get something like:
  314.    java.lang.ExceptionInInitializerError: java.lang.RuntimeException: 
  315.    .....log/bugzero.log (Access is denied)
  316.    at com.websina.util.log.Log.(Log.java) .....
  317.  
  318.    and subsequent login results NoClassDefFoundError. 
  319.  
  320. Q: What are these javamail Exceptions (NoSuchProviderException) and what is the cause?
  321. A: You may see Exceptions like these when Bugzero tries to send email notification:
  322.    javax.mail.NoSuchProviderException: smtp
  323.    or
  324.    javax.activation.UnsupportedDataTypeException: no object DCH for MIME type text/plain
  325.  
  326.    These error messages are produced by JavaMail and are completely misleading. 
  327.    The root casue of the error is a mis-matched pair of mail.jar and activation.jar or
  328.    a version confliction of these two jars. Bugzero packaged a version of mail.jar
  329.    and activation.jar, and if the servlet engine has its mail jars added in the system
  330.    classpath, problem may arise. A simple solution is to remove Bugzero's mail.jar
  331.    and activation.jar from the WEB-INF/lib directory.  
  332.  
  333. Miscellaneous:
  334.  
  335. Q: Which PostgreSQL binary data type can Bugzero use? 
  336. A: PostgreSQL has two binary data types, OID and bytea.
  337.    By default, Bugzero uses PostgreSQL bytea for its binary columns. This works only
  338.    for PostgreSQL 7.2 or later. For Version 7.1, you need modify the file db.properties
  339.    by setting postgresql.LONGBINARY to OID instead of bytea.
  340.  
  341. Q: Can the Microsoft SQL Server 2000 JDBC driver be used on SQL Server 7?
  342. A: The SQL Server 2000 JDBC driver downloaded from Microsoft supports only the
  343.    SQL Server 2000. If you use it on the SQL Server 7, you will get something like:
  344.    java.sql.SQLException: [Microsoft][SQLServer 2000 Driver for JDBC]This version of
  345.    the JDBC driver only supports Microsoft SQL Server 2000.  You can either upgrade
  346.    to SQL Server 2000 or possibly locate another version of the driver.
  347.  
  348.    If you cannot find a free JDBC driver for SQL Server 7, you can create a data source
  349.    (DSN) that points to your SQL Server 7 and then use the jdbc-odbc driver for the
  350.    DSN. But before you launch the Bugzero setup program, you need modify the file
  351.    db.properties. See comments inside the file.
  352.  
  353. -------------------------------------------------
  354. Bugzero homepage: http://www.websina.com/bugzero/
  355. For questions:    mailto: dev@websina.com
  356.