summaryrefslogtreecommitdiffstats
path: root/archiva-docs/src/site/apt/userguide/find-artifact.apt
blob: c807f1317d083d96b6849f30eb4c745b299cbd95 (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
 ------
 Identifying an Artifact
 ------

Identifying an Artifact

  Archiva indexes all of the artifacts that it discovers during the repository scanning process, storing information about their contents.
  This includes the checksum of the artifact, which can help to uniquely identify it within the repository.

  Archiva includes a feature that allows you to check for the existence of a given artifact in the repository by checksum. This is useful in
  identifying a JAR or other artifact located from an external source that does not contain any Maven or version information.

  To use this functionality, click the "Find Artifact" link in the left navigation.

  When the screen first loads, a Java applet that will allow you to create a local checksum of a given artifact is loaded. Since it is reading the
  content of the artifact from the filesystem, it will present a security dialog similar to the following:

[../images/find-artifact-security.png] Java Applet

  By trusting the applet, you can checksum files of any size locally and just upload the small checksum to the server. If you opt not to trust the
  applet, you must enter the checksum into the web form by hand.

  Once you have loaded the page, you have the choice of browsing for a local file to identify, or entering the checksum directly.

[../images/find-artifact.png] Find Artifact

  To find an artifact, perform the following steps:

  [[1]] Click <<Find Artifact>> in the left navigation menu.

  [[2]] On the opened page, you will see a file-upload field. Upload any JAR file (or other artifact) from your local file system. You must enter an exact filename. In general, you would use the Browse button for entering the filename.

  [[3]] Click Search.

  [[4]] The whole file is not uploaded, but the checksum is. It will search the remote repository for an exact match of the file you specified and display the result of the search.

  []
  
  Once you submit the form, Archiva will look to match the checksum:

  * If more than one artifact matches, a list of results is returned.

  * If a unique match is found, the individual artifact information page is returned.

  * If no match is found, a "no results" page is returned.

 []