home *** CD-ROM | disk | FTP | other *** search
/ Chip 2005 May / CMCD0505.ISO / Software / Shareware / Programare / bugzero / WEB-INF / upgrade.txt < prev    next >
Text File  |  2004-05-21  |  6KB  |  143 lines
  1.                 How to upgrade Bugzero to a new version or edition
  2.  
  3.  
  4. First, download and unzip bugzero.zip to a temp directory, and then find the 
  5. VERSION NUMBER for both the old and the new bugzero (the version number is
  6. on the first line of the file bugzero/WEB-INF/release.txt).
  7.  
  8. If you are upgrading from a Five-User Edition to a Standard Edition of the same
  9. version number, the only thing you need to do is to replace the old bugzero.jar
  10. with the new one (in WEB-INF/lib).
  11.  
  12. If you are upgrading from a Try Edition to a Five-User or Standard Edition of the
  13. same version number, you need replace bugzero.jar as well as replace the folder 
  14. bugzero/jsp/admin.
  15.  
  16. If you are upgrading from a different version number and your installed version
  17. is 2.7 or later,  you need do the following (for earlier versions, please read
  18. the second part of this file).
  19.  
  20. IMPORTANT: 
  21.           If you choose to do the upgrade by coping files from the new version
  22.           to the installed one, you must make sure all the changed files are 
  23.           copied over. In particular, all the sql files must be copied over. In
  24.           fact, except for a few properties files, all files should be copied
  25.           over.
  26.  
  27. 0. It is always a good idea to backup your existing installation, that includes
  28.    the bugzero folder under the servlet container as well as the database tables.
  29.  
  30. 1. Make sure you are working on this new bugzero that you have unzipped (in
  31.    the temp directory). This new bugzero will be deployed at step 5 below 
  32.    (by replacing the old one).
  33.  
  34. 2. (Required) Run upgrade
  35.    This script is located under directory /WEB-INF/misc/upgrade, it takes in
  36.    an argument which is the installed running bugzero home path.
  37.  
  38.    This script does two things, one is to copy certain configuration files from
  39.    the installed Bugzero to the new one (this is why you need specify the old
  40.    Bugzero home), and the other one is to update the database schema (checkdb).
  41.    Files copied are: 
  42.  
  43.       1) db.properties
  44.       2) mail.properties
  45.       3) system.properties
  46.       4) email_subject
  47.       5) email_body
  48.       6) JDBC jar files (if applicable)
  49.  
  50.    You can manually copy these files and then run the script 'checkdb'.
  51.  
  52. 3. (Optional) Merge files:
  53.  
  54.       1) label.properties
  55.       2) messages.properties
  56.  
  57.    If you've made any changes inside these files in your existing Bugzero, then
  58.    you should include these changes to the corresponding new files (they are in 
  59.    WEB-INF/classes/conf).   
  60.   
  61. 4. (Optional) Merge JSP files.
  62.    If you've modified the jsp pages, you need merge the old ones with the new ones.
  63.  
  64. 5. (Required) Re-deploy Bugzero.
  65.    You need move the new bugzero folder to your servlet engine's
  66.    applications (webapps) folder. You should remove the existing one there first,
  67.    and perhaps remove the compiled jsp code. For example, for Tomcat,
  68.    the compiled files are located under tomcat's work/.../bugzero directory.
  69.  
  70.    You need restart your servlet engine.
  71.  
  72.    For some app servers, such as Websphere and iPlanet (SunOne),
  73.    you need re-package bugzero into bugzero.war, un-deploy the old one, and then
  74.    deploy the new war.
  75.  
  76.  
  77. Upgrading from version 2.6.x or earlier:
  78. ---------------------------------------
  79.  
  80. The group.properties file is no longer used after version 2.7. If you are upgrading
  81. from version 2.6.x or earlier, however, you need copy the file to WEB-INF/classes/conf
  82. before running the upgrade script. Also note that, for versions 2.4.x or earlier,
  83. you need change the line format by moving the group name (code) to the left hand side
  84. from the right hand side. For versions 2.5 or earlier, make all the group code
  85. lower case. Here is an example of the correct format:
  86.       group.admin=Administrator
  87.       group.dev=Developer
  88.  
  89.  
  90. Upgrading from version 2.2.1 or earlier:
  91. ---------------------------------------
  92.  
  93. The software was completely re-packaged since version 2.2.2. If you are upgrading
  94. from versions earlier than that, you need do some cleanup:
  95.  
  96. 1. Roll back the CLASSPATH modifications. For example, for Tomcat, edit file 
  97.    setclasspath.bat (or .sh) and remove all the BUGZERO_HOME, JDBC_DRIVER entries
  98.    there. They are no longer needed.
  99. 2. Remove bugzero.war in the servlet engine's applications (webapps) folder.  
  100. 3. Remove the compiled jsp code.
  101. 4. Instead of running the 'upgrade' script on step 2, you need copy these files
  102.    manually (they are in the data/conf and data/template), and then run 'checkdb'.
  103.  
  104.  
  105. Upgrading from version 1.3.2:
  106. ----------------------------
  107.  
  108. If you are upgrading from version 1.3.2 or earlier, then you need modify Bugzero's
  109. database schema. Specifically, you have to drop the column 'project_area' in the 
  110. 'project' table; and add a column 'area_order' of type int to the 'assignment'
  111. table. Manually fill this new column with numbers from 0 up for each 'project_id'
  112. and 'project_area'.
  113.  
  114.  
  115. Upgrading from version 1.3:
  116. --------------------------
  117.  
  118. If you are upgrading from version 1.3 or earlier, then you need modify Bugzero's
  119. database schema. Specifically, you have to rename all the 
  120. $PROJECT_constraints tables to $PROJECT_filter, and rename the two columns, 
  121. constraint_name and constraint_value to filter_name and filter_value respectively.
  122.  
  123.  
  124. IMPORTANT:
  125.  
  126. 0. If you got any errors from running upgrade, stop! You have to fix the problem
  127.    before continue.
  128.  
  129. 1. On Linux (Unix) OS, it is very often that an old java command is in your path.
  130.    Make sure you are using the right java (using java -version to find out).
  131.  
  132. 2. It is very often that, after upgrade, when you login, the pages are not displayed
  133.    properly. One cause of such a problem is that the jsp files are not re-compiled.
  134.    In such a case, you can either remove all the compiled jsp files, or use 'touch' to
  135.    update the timestamp of these files so that they can be re-compiled.
  136.    For example, in the case of Tomcat, the compiled jsp files are located under
  137.    the work dir (or sub dir), remove them and restart Tomcat.
  138.  
  139.  
  140. -------------------------------------------------
  141. Bugzero homepage: http://www.websina.com/bugzero/
  142. For questions:    mailto: dev@websina.com
  143.