Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Equinox p2 Repository Mirroring"
(→Running the Mirroring Tools) |
|||
| Line 27: | Line 27: | ||
-source Insert Source URL (e.g. <nowiki>http://download.eclipse.org/eclipse/updates/3.4milestones/</nowiki>) | -source Insert Source URL (e.g. <nowiki>http://download.eclipse.org/eclipse/updates/3.4milestones/</nowiki>) | ||
-destination Insert Destination URL (e.g. file:/tmp/3.4milestonesMirror/) | -destination Insert Destination URL (e.g. file:/tmp/3.4milestonesMirror/) | ||
| − | |||
| − | + | By adding the argument '''-emptyRepository''', all installable units in the target destination will be removed before the mirroring is performed. | |
===Mirroring Artifacts=== | ===Mirroring Artifacts=== | ||
| Line 39: | Line 38: | ||
-source Insert Source URL (e.g. <nowiki>http://download.eclipse.org/eclipse/updates/3.4milestones/</nowiki>) | -source Insert Source URL (e.g. <nowiki>http://download.eclipse.org/eclipse/updates/3.4milestones/</nowiki>) | ||
-destination Insert Destination URL (e.g. file:/tmp/3.4milestonesMirror/) | -destination Insert Destination URL (e.g. file:/tmp/3.4milestonesMirror/) | ||
| − | |||
| − | + | By adding the argument '''-emptyRepository''', all artifacts in the target destination will be removed before the mirroring is performed. | |
| − | Adding the argument '''-verbose''' will enable verbose error reporting and logging. | + | Adding the argument '''-verbose''' will enable verbose error reporting and logging. This will write errors to the <eclipse workspace>/.metadata/.log file. |
Adding the argument '''-ignoreErrors''' will ensure the mirror application does not fail in the event of an error. Note: while using this argument the mirror application may complete without errors but the destination repository may not include all artifacts from the source repository. | Adding the argument '''-ignoreErrors''' will ensure the mirror application does not fail in the event of an error. Note: while using this argument the mirror application may complete without errors but the destination repository may not include all artifacts from the source repository. | ||
Revision as of 10:10, 21 November 2008
Contents
Introduction
p2 manages all of its data in repositories. There are two types of repos, artifact and metadata.
p2 artifact repositories can hold many different forms of the same artifact. For example, a JAR artifact may exist as
- a canonical (unmolested) JAR
- a compressed JAR (assuming the original was not compressed)
- a pack200 JAR
- a delta relative to another version of the artifact
- ...
p2 metadata repositories describe inter-component dependencies and identify artifacts to install.
The Repository Mirroring application can be used to mirror artifact and metadata repositories. In addition, users can do selective mirroring of artifacts or metadata either to create a more specific mirror (e.g. only mirror latest code) or merge content into an existing mirror.
This example demonstrates how to mirror a repository using the repository mirror application available in the equinox p2 tools.
Running the Mirroring Tools
Currently, the mirror application is split into two different applications: one for artifacts and one for metadata.
Mirroring Metadata
To make an exact mirror of a metadata repository, use the following arguments. Note that if the target repository does not exist, a new repository is created with the same properties as the source.
-application org.eclipse.equinox.p2.metadata.repository.MirrorApplication -source Insert Source URL (e.g. http://download.eclipse.org/eclipse/updates/3.4milestones/) -destination Insert Destination URL (e.g. file:/tmp/3.4milestonesMirror/)
By adding the argument -emptyRepository, all installable units in the target destination will be removed before the mirroring is performed.
Mirroring Artifacts
To make an exact mirror of an artifact repository, use the following arguments. Note that if the target repository does not exist, a new repository is created with the same properties as the source.
-application org.eclipse.equinox.p2.artifact.repository.MirrorApplication -source Insert Source URL (e.g. http://download.eclipse.org/eclipse/updates/3.4milestones/) -destination Insert Destination URL (e.g. file:/tmp/3.4milestonesMirror/)
By adding the argument -emptyRepository, all artifacts in the target destination will be removed before the mirroring is performed.
Adding the argument -verbose will enable verbose error reporting and logging. This will write errors to the <eclipse workspace>/.metadata/.log file.
Adding the argument -ignoreErrors will ensure the mirror application does not fail in the event of an error. Note: while using this argument the mirror application may complete without errors but the destination repository may not include all artifacts from the source repository.