- ------
- Upgrading Archiva
- ------
-
- ~~ Licensed to the Apache Software Foundation (ASF) under one
- ~~ or more contributor license agreements. See the NOTICE file
- ~~ distributed with this work for additional information
- ~~ regarding copyright ownership. The ASF licenses this file
- ~~ to you under the Apache License, Version 2.0 (the
- ~~ "License"); you may not use this file except in compliance
- ~~ with the License. You may obtain a copy of the License at
- ~~
- ~~ http://www.apache.org/licenses/LICENSE-2.0
- ~~
- ~~ Unless required by applicable law or agreed to in writing,
- ~~ software distributed under the License is distributed on an
- ~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- ~~ KIND, either express or implied. See the License for the
- ~~ specific language governing permissions and limitations
- ~~ under the License.
-
- Upgrading Archiva
-
- Upgrading Archiva is straightforward, particularly if the directions for separating the base from the installation
- are followed. You need to retain the following directories:
-
- * <<<conf>>> - the configuration files can be reused across different versions. Note that when the standalone
- version is used, <<<wrapper.conf>>> and <<<jetty.xml>>> may need to be replaced after upgrade and changes
- reapplied. See specific notes in the version details below.
-
- * <<<data>>> - all Archiva data. More specifically:
-
- * <<<data/repositories>>> is portable across versions (both forwards and backwards).
-
- * <<<data/databases/users>>> must always be retained as it contains the permissions and user information across
- versions, even if LDAP is being used for authentication.
-
- * <<<data/databases/archiva>>> exists for Archiva 1.3.x and below. This can be retained through upgrades, but
- can also be regenerated at any time. This no longer exists in Archiva 1.4+.
-
- []
-
- []
-
- The following describes instructions specific to upgrading between different versions.
-
- * Upgrading Archiva to 1.4+
-
- ** Metadata Repository
-
- ~~TODO: metadata repository description
-
- ** Java Package Changes and Library Changes
-
- All Java packages have changed from <<<org.apache.maven.archiva>>> to <<<org.apache.archiva>>> and have undergone
- significant changes. If you have written custom consumers, are using the XML-RPC client, or interfacing with other
- Java libraries the code will need to be adjusted.
-
- ** Configuration References
-
- If you had used the undocumented ability to modify <<<application.xml>>> to alter the configuration search path, note
- that in Archiva 1.4+ you must use the <<<org.apache.archiva>>> configuration search path instead of
- <<<org.apache.maven.archiva>>>.
-
- ** Updated Jetty configuration
-
- If you are using the Jetty standalone configuration with a custom
- <<<jetty.xml>>>, note that it has been upgraded to Jetty 7 as of Archiva 1.4-M2.
- You will need to recreate your customisations using the <<<jetty.xml>>> shipped
- with Archiva.
-
- In addition, you now need to ensure that a <<<temp>>> directory is created
- inside the Archiva application base directory (alongside <<<conf>>>, <<<data>>>
- and <<<logs>>>).
-
- * Upgrading Archiva to 1.2.2
-
- Since Archiva 1.2.2, the Jetty version has been upgraded to 6.1.19.
- If upgrading to Archiva 1.2.2 (or higher versions), there is a need to update the library contents listed in
- <<<ARCHIVA_BASE/conf/wrapper.conf>>> with the ones included in the new distribution if the <<<ARCHIVA_BASE>>>
- directory is separate from the installation.
-
|