Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

This guide gives you some handy hints to upgrade from an archiva 1.0.x instance to a version 1.1.x.

...

It also describes where settings in archiva 1.0.x are stored in archiva 1.1.x, which ones have to be kept, updated or removed.

How to Upgrade

See also: http://archiva.apache.org/docs/1.1.2/adminguide/standalone.html#Upgrading%20Archiva (replace 1.1.2 in that link with the version number you are upgrading to)

Warning

The following process kept all artifacts (as far as I can tell), but did not keep users for a 1.0.2 to 1.1.2 migration.

Keep your repositories content ({{${archiva.base}/data/repositories/*) and delete the .index directories of your respective managed repositories (if they exist- see previous section), and execute the repository and database scanners after starting Archiva.

Here are the steps:

1. Compress the (old archiva version)/data dir and extract it into the {{${archiva.base}/data dir.
2. Delete the new {{${archiva.base}/data/archiva/database dir (that you copied)
3. Search for *.index directories under {{${archiva.base}/data and remove any you find. In *nix this can be done like:

Code Block

cd {{$\{archiva.base\}/data
find . -name "*.index"
(make sure it only finds those that you want to delete)
find . -name "*.index" -exec rm -rf {} \;

4. Go to archiva and click on these to execute the repository and database scanners (note: this may be overkill):

  • Repository Scanning -> Update Consumers
  • Database -> Update Cron
  • Database -> Update Database Now
  • Database -> Update Consumers (click on this under all sections)
  • Repositories -> Scan Repository Now (click on this under all sections)

Archiva Settings

Archiva's configuration is loaded from the following files, in order of most precedent:

...

Description

Archiva 1.0.x settings

Archiva 1.1.x settings

jetty server hostname & http port

${archiva.base}/apps/archiva/conf/plexus.xml or ${archiva.base}/apps/archiva/conf/application.xml

${archiva.base}/conf/jetty.xml

...

Archiva 1.0.x

Archiva 1.1.x

Archiva Database

To be truncated

Archiva Users Database

To be kept

Standalone-specific

Scripts in ${archiva.base}/bin

Description

Archiva 1.0.x settings

Archiva 1.1.x settings

Start/Stop Script

${archiva.base}/bin/(platform-specific directory)/run.sh or run.bat

${archiva.base}/bin/archiva or archiva.bat

Miscellaneous

Description

Archiva 1.0.x settings

Archiva 1.1.x settings

Patch for Needed for MRM-227 and the utf8 mysql "bug"

${archiva.base}/apps/archiva/webapp/WEB-INF/classes/META-INF/plexus/application.xml

${archiva.base}/apps/archiva/webapp/WEB-INF/classes/META-INF/plexus/application.xml

Issues

  • Upgrading from v1.0.2 standalone to v1.1.2 standalone users were not kept (had to recreate)