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)

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:

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:

• ~/.m2/archiva.xml
• ${archiva.base}/conf/archiva.xml
• conf/archiva.xml in the Archiva installation

It will be automatically updated.

Custom security settings

Didn't change between 1.0.x and 1.1.x : ${archiva.base}/conf/security.properties

Logs & Memory Settings

Jetty settings

SMTP server settings

Databases

Internal databases

Retain data/databases/users directories and remove data/databases/archiva.

External databases

If your are using some external databases like mysql.

Drivers

Datasources

Instances

Standalone-specific

Scripts in ${archiva.base}/bin

Miscellaneous

Issues

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