[MRM-1119]

o document upgrade process from 1.1 to 1.2 (changes in search implementation)

git-svn-id: https://svn.apache.org/repos/asf/archiva/trunk@757115 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/archiva-docs/src/site/apt/adminguide/standalone.apt b/archiva-docs/src/site/apt/adminguide/standalone.apt
index 0ae7dd031a4436de928d121893df2c12805c75d1..bb07193cd56441f95c35f0e6c25d17ab2fc5c946 100644 (file)
--- a/archiva-docs/src/site/apt/adminguide/standalone.apt
+++ b/archiva-docs/src/site/apt/adminguide/standalone.apt
@@ -165,7 +165,14 @@ Installing Standalone Distribution of Apache Archiva
    be re-created. So you need to delete the <<<data/databases/archiva>>> directory, delete the <<<.index>>> directories of your respective repositories, and execute the repository and database scanners after
    starting Archiva.
 
-   The repository data is portable across versions, and multiple versions can be configured to look at the same repositories (though not run simultaneously). 
+   The repository data is portable across versions, and multiple versions can be configured to look at the same repositories (though not run simultaneously).
 
+* Upgrading Archiva from 1.1 to 1.2
+
+   Because of the changes in the search implementation in 1.2, a few additional steps need to be performed when upgrading Archiva from 1.x to
+   1.2. Since the format of the index has changed in 1.2, the old index directory (which is located at <<</path/to/repo/.index>>> by default) needs to
+   be removed. And in order for the artifacts in the repository to be indexed again, the last modified date of the artifacts need to be updated.
+   To do this, just execute <<find [REPOSITORY_DIRECTORY_NAME] | xargs touch>> at the base directory where the repository resides. Execute the repository
+   scanning so that the new index will be generated.