summaryrefslogtreecommitdiffstats
path: root/archiva-docs/src/site/apt/adminguide/legacy.apt
blob: 80270e962f7ade6ec2859bc65eff239b0c6b993b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 ------
 Apache Archiva legacy repository support configuration
 ------

~~ 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.                                                              

Apache Archiva legacy repository support configuration

  Archiva supports both Maven 1 and Maven 2 clients transparently when used as a proxy. The
  underlying managed repository can use either the default or legacy layout, and Archiva will
  convert the requested path to the expected internal format.
  
  However, due to the lack of structure in maven 1 "legacy" artifact request format, 
  Archiva must split the request path to discover artifactId, version and 
  classifier - and this is not always deterministic.
  The strategy used by Archiva has been tested on many existing artifacts in the public central
  repository, but users may require support for private artifacts or for 
  artifacts with classifiers.
  
  Since version 1.0.1, Archiva provides a legacy support configuration to the administrator. It
  is possible to register some custom legacy path and the expected artifact 
  reference. Archiva will check that the entered artifact reference matches
  the legacy path, to avoid corrupted data in repository.

[../images/legacy-support-list.png]

  For example:

    * Path: <<<jaxen/jars/jaxen-1.0-FCS-full.jar>>>
  
    * Group ID: <<<jaxen>>>
  
    * Artifact ID: <<<jaxen>>>
  
    * Version: <<<1.0-FCS>>>
  
    * Classifier: <<<full>>>
  
    * Type: <<<jar>>>

  This prevents the artifact incorrectly getting translated to a version of <<<1.0>>> and a classifier of <<<FCS-full>>>.
  
  Those custom legacy path are stored in the archiva.xml configuration file.
  By default, <<<jaxen-1.0-FCS-full>>> is registered, as it is used by some core
  Maven 1 plugins (however this is not the case if you upgraded from a previous
  version and retained your configuration file).

[../images/legacy-support-add.png]