continuum-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From wsm...@apache.org
Subject svn commit: r735194 - in /continuum/trunk/continuum-docs: ./ src/site/apt/installation/upgrade.apt
Date Sat, 17 Jan 2009 01:11:57 GMT
Author: wsmoak
Date: Fri Jan 16 17:11:57 2009
New Revision: 735194

URL: http://svn.apache.org/viewvc?rev=735194&view=rev
Log:
[CONTINUUM-2013] Update documentation on upgrading from 1.2.x to 1.3.1

Modified:
    continuum/trunk/continuum-docs/   (props changed)
    continuum/trunk/continuum-docs/src/site/apt/installation/upgrade.apt

Propchange: continuum/trunk/continuum-docs/
------------------------------------------------------------------------------
--- svn:ignore (original)
+++ svn:ignore Fri Jan 16 17:11:57 2009
@@ -5,3 +5,4 @@
 *.iml
 *.ipr
 *.iws
+*.tmproj

Modified: continuum/trunk/continuum-docs/src/site/apt/installation/upgrade.apt
URL: http://svn.apache.org/viewvc/continuum/trunk/continuum-docs/src/site/apt/installation/upgrade.apt?rev=735194&r1=735193&r2=735194&view=diff
==============================================================================
--- continuum/trunk/continuum-docs/src/site/apt/installation/upgrade.apt (original)
+++ continuum/trunk/continuum-docs/src/site/apt/installation/upgrade.apt Fri Jan 16 17:11:57
2009
@@ -7,106 +7,66 @@
  Sep 10 2008
  ------
 
-Upgrade
+Upgrading Continuum
 
-* Goal
+    This document will help you upgrade Continuum from 1.2.x to 1.3.x.
 
-    When upgrading Continuum, it could have some database model changes. This tool exports
data from old database model and imports the data into the new database model.
+    When upgrading Continuum, it could have some database model changes. The Data Management
tool exports data from the
+    old database model and imports the data into the new database model.
 
-    There are 2 databases that need to be converted, one for the builds and one for the users.
-    
-    <<Note>> If you are upgrading from 1.1 to 1.2, no upgrade tool is needed.
-    
-    Due the fix of {{{http://jira.codehaus.org/browse/CONTINUUM-1688}CONTINUUM-1688}} :
-    
-    * if you use mssql server : you have to uncomment lines in a file in the webapp (WEB-INF/classes/META-INF/plexus/application.xml)
(search mssql support).
-    
-    * if you use a 1.1 database you have to change manually the size of a column (in order
to have the fix) :
-    
-+------------------------------------------+    
--- command tested with derby database
-alter table CHANGESET alter column CHANGECOMMENT SET DATA TYPE varchar(8192)  
-+------------------------------------------+   
+* Upgrading from 1.2.x to 1.3.1
 
-* Download The Tool
+    There are 2 databases that need to be considered:  one for the builds and one for the
users.
 
-    The tool is a standalone jar that you can download from the central repo.
+    There were no changes in the users database from 1.2.x to 1.3.1, so you can simply point
Continuum 1.3.1 at your
+    existing user database.
 
-    You will need to download 2 versions of the tool, one for the export out of the old version
and one for the import into the new version:
+    The builds database has had model changes, and will need to be exported and imported.
 
-        * {{http://repo1.maven.org/maven2/org/apache/maven/continuum/data-management-cli/1.1-beta-3/data-management-cli-1.1-beta-3-app.jar}}
+    First, download the Data Management tools you will need.  The tool is a standalone jar
that you can download from the central repo.
 
-        * {{http://repo1.maven.org/maven2/org/apache/maven/continuum/data-management-cli/1.1-beta-4/data-management-cli-1.1-beta-4-app.jar}}
+    You will need to download two versions of the tool, one for the export out of the old
version and one for the import into the new version:
 
-        * {{http://repo1.maven.org/maven2/org/apache/maven/continuum/data-management-cli/1.1/data-management-cli-1.1-app.jar}}
-        
-        * {{http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.2/data-management-cli-1.2-app.jar}}
+        * {{http://repo1.maven.org/maven2/org/apache/maven/continuum/data-management-cli/1.2.x/data-management-cli-1.2.x-app.jar}}
 
-    The first version of this tool is 1.1-beta-2
+        * {{http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.3.1/data-management-cli-1.3.1-app.jar}}
 
-* Exporting Data from the old version
+    <<Note:>> The 1.2.2 and 1.2.3 released versions of this tool have a bug.
 You will need to use version 1.2.4 of the tool to export databases from those versions.
 
-    Follow these steps:
+    Next, follow these steps to export data from the old version
 
         * Stop the old version of continuum
 
-        * Export the build and user data from the old version using the jar for the old version:
+        * Execute this command to create the builds.xml export file
 
 +------------------------------------------+
-java -Xmx512m -jar data-management-cli-1.1-beta-4-app.jar -buildsJdbcUrl jdbc:derby:${old.continuum.home}/data/continuum/database
-mode EXPORT -directory backups
-java -Xmx512m -jar data-management-cli-1.1-beta-4-app.jar -usersJdbcUrl jdbc:derby:${old.continuum.home}/data/users/database
-mode EXPORT -directory backups
+java -Xmx512m -jar data-management-cli-1.2.x-app.jar -buildsJdbcUrl jdbc:derby:${old.continuum.home}/data/databases/continuum
-mode EXPORT -directory backups
 +------------------------------------------+
 
-* Importing Data to the new version
-
-    Follow these steps:
+    Then, follow these steps to import the data to the new version
 
-        * Start the new version continuum to create the new data model.
 
-        * Stop continuum
+        * Start the new version of Continuum to create the new data model, but do not configure
it.
 
-        * Run the specific steps for your version, described below
+        * Stop Continuum
 
-        * Import the build and user data into the new version using the jar for the new version:
+        * Execute this command to import the builds data from the xml file you created earlier:
 
 +------------------------------------------+
-java -Xmx512m -jar data-management-cli-1.1-app.jar -buildsJdbcUrl jdbc:derby:${new.continuum.home}/data/continuum/database
-mode IMPORT -directory backups
-java -Xmx512m -jar data-management-cli-1.2-app.jar -usersJdbcUrl jdbc:derby:${new.continuum.home}/data/users/database
-mode IMPORT -directory backups
+java -Xmx512m -jar data-management-cli-1.3.1-app.jar -buildsJdbcUrl jdbc:derby:${new.continuum.home}/data/databases/continuum
-mode IMPORT -directory backups
 +------------------------------------------+
+        
+        []
+ 
+        Finally, be aware that sometimes the NEXT_VAL values in the SEQUENCE_TABLE need to
be adjusted.
 
-        * <<NEXT_VAL values in SEQUENCE_TABLE must be checked before restarting continuum>>
-
-            * Normally, the SEQUENCE_TABLE is ok but in some cases the values are wrong.
-
-            * Before starting Continuum for the first time after the import, connect to the
db with a client like {{{http://squirrel-sql.sourceforge.net/}Squirrel SQL}} and check the
values in the <<NEXT_VAL>> column.
+            * Before starting Continuum for the first time after the import, connect to the
db with a client like {{{http://squirrel-sql.sourceforge.net/}Squirrel SQL}} and check the
values in the <<NEXT_VAL>> column of the SEQUENCE_TABLE.
 
             * Values must be greater than the max id value in each table.
 
             * For example, the next value of "org.apache.maven.continuum.model.Project" must
be greater than the greatest id in Project table.
 
-        * Start the new version of continuum.
-
-* Specific steps to do before import
-
-** 1.1 import
+        []
 
-    Before to import from an older version (before 1.1-beta-4 to 1.1 final, you must open
the builds.xml file under backup directory and remove all <<'testResults'>> tags.
-    You can remove them with the following XSL:
-
-+------------------------------------------+
-<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
-<xsl:output method="xml"/>
- <xsl:template match="testResult"/>
-  <xsl:template match="@*|node()">
-    <xsl:copy>
-      <xsl:apply-templates select="@*|node()"/>
-    </xsl:copy>
-  </xsl:template>
-</xsl:stylesheet>
-+------------------------------------------+
-
-    And you can run it with this command:
-
-+------------------------------------------+
-xsltproc copy.xsl builds.xml > fixed-builds.xml
-+------------------------------------------+
+        Now you can start your new version of Continuum.
+  
\ No newline at end of file



Mime
View raw message