home *** CD-ROM | disk | FTP | other *** search
/ Chip 2003 July / CMCD0703.ISO / Software / Freeware / Programare / bugzero / WEB-INF / upgrade.txt < prev    next >
Encoding:
Text File  |  2003-06-09  |  4.0 KB  |  93 lines
  1.           How to upgrade to a higher Bugzero version or to a paid version
  2.  
  3.  
  4. Upgrading is easy!
  5.  
  6. If you are upgrading from a 5-user to a full license of the same version number,
  7. the only thing you need to do is replace bugzero.jar.
  8.  
  9. If you are upgrading from a try license to a 5-user or full license of the same
  10. version number, you need replace bugzero.jar and replace the folder bugzero/jsp/admin.
  11.  
  12. If you are upgrading from a different version number, you need do the following:
  13.  
  14. 1. Download and unzip bugzero.zip (to any directory).
  15.  
  16. 2  Instead of run setup, you can copy db.properties and mail.properties
  17.    of the previous bugzero to the new bugzero/WEB-INF/classes/conf 
  18.    and the previous template/* to the new bugzero/WEB-INF/classes/template
  19.    Note that, if you currently installed versions 2.2.1 or earlier, these
  20.    files are in the folder bugzero/data (conf and template).
  21.  
  22. 3. Merge the label.properties file (bugzero/WEB-INF/classes/conf).   
  23.  
  24. 4. Merge the group.properties file (bugzero/WEB-INF/classes/conf). On version
  25.    2.5, the format for each line has been changed and the group name is now on
  26.    the left hand side.
  27.    
  28. 5. Copy the jdbc driver. If you use database other than Access or MySQL, you need
  29.    copy the corresponding jdbc driver to bugzero/WEB-INF/classes/lib.
  30.  
  31. 6. Run upgrade to update the database schema. This script is located under
  32.    bugzero/WEB-INF/misc/upgrade/.
  33.   
  34. 7. If you have modified the jsp pages, you need merge them with the new ones.
  35.  
  36. 8. Deploy the new bugzero and restart your servlet engine.
  37.    That means moving the new bugzero folder to your servlet engine's
  38.    applications (webapps) folder (there should be an existing one, remove it first);
  39.    or re-packaging bugzero into bugzero.war, un-deploy the existing one, and deploy
  40.    the new one (for WebSphere etc).
  41.  
  42.    Note that, you might want remove the compiled jsp code. For example, for Tomcat,
  43.    the compiled files are located under tomcat's work/.../bugzero directory.
  44.  
  45.  
  46. Upgrading from version 2.5 or earlier:
  47. --------------------------------------
  48.  
  49. Starting from version 2.6, the states and the group codes are case senstive in the
  50. workflow table (column w_name). Since all were converted to lowercase before, you
  51. need manually restore them to the actual case. If you do not, some of the workflow
  52. could be lost and you need make sure to add them back using the admin workflow form.
  53. Note that, the actual group codes are in the group.properties file, and both the 
  54. person table (colum group_code) and the workflow table (column w_name with w_type=3)
  55. should be matched with them.
  56.  
  57.  
  58. Upgrading from version 2.2.1 or earlier:
  59. ---------------------------------------
  60.  
  61. The software was completely re-packaged since version 2.2.2. If you are upgrading
  62. from versions earlier than that, you need do some cleanup:
  63.  
  64. 1. Roll back the CLASSPATH modifications. For example, for Tomcat, edit file 
  65.    setclasspath.bat (or .sh) and remove all the BUGZERO_HOME, JDBC_DRIVER entries
  66.    there. They are no longer needed.
  67. 2. Remove bugzero.war in the servlet engine's applications (webapps) folder.  
  68. 3. Remove the compiled jsp code.
  69.  
  70.  
  71. Upgrading from version 1.3.2:
  72. ----------------------------
  73.  
  74. If you are upgrading from version 1.3.2 or earlier, then you need modify Bugzero's
  75. database schema. Specifically, you have to drop the column 'project_area' in the 
  76. 'project' table; and add a column 'area_order' of type int to the 'assignment'
  77. table. Manually fill this new column with numbers from 0 up for each 'project_id'
  78. and 'project_area'.
  79.  
  80.  
  81. Upgrading from version 1.3:
  82. --------------------------
  83.  
  84. If you are upgrading from version 1.3 or earlier, then you need modify Bugzero's
  85. database schema. Specifically, you have to rename all the 
  86. $PROJECT_constraints tables to $PROJECT_filter, and rename the two columns, 
  87. constraint_name and constraint_value to filter_name and filter_value respectively.
  88.  
  89.  
  90. -------------------------------------------------
  91. Bugzero homepage: http://www.websina.com/bugzero/
  92. For questions:    mailto: dev@websina.com
  93.