Before You Begin

System Requirements

Before beginning migration, verify that the following system requirements are met.

A fully-configured Artifactory instance. For more information on installing Artifactory, see Installing Artifactory.
The Artifactory host machine must have enough space to handle the temp cache directory of Nexus Migrator if the Nexus Repository uses the S3 blob store. The minimum required space is calculated as: largest file size × number of threads. For example, if the largest file in the repository is 300 MB and the number of threads in the Artifactory machine is 4, the minimum space requirement for the temp cache directory is 1200 MB.
Script execution is enabled in Nexus Repository Manager. For more information, refer to Nexus Repository Manager Documentation.
📘
Enabling script execution requires restarting the Nexus server.
A warning appears in Nexus Repository Manager after you enable script execution. Run the migration tool from the Nexus Repository Manager host machine.
Verify that the following directories exist on the Nexus Repository Manager host machine:
- $datadir/etc and $datadir/blob for Nexus 3.
- $datadir/conf and $datadir/storage for Nexus 2.
The user who runs the migration must have root privileges.
This is optional. For Nexus 3, if you are running the tool from an external machine, execute the following command:
```
export SKIP_MIGRATION_FILESYSTEM_CHECK=true
```
To configure, set the URL to:
```
http://<private ip>:<port>
```
If a context path is configured for the Nexus server, use:
```
http:<private ip>:<port>/<context-path>
```
📘
Nexus 2 does not support this feature as the tool relies completely on filesystem data.

Prerequisites

Install Docker (version 20 or later) in the machine that hosts Nexus Repository Manager.
The user in the Artifactory machine and the Nexus Repository Manager machine must have administrator privileges.

Working with Artifactory on self-signed SSL certificates

If your Artifactory is set up with self-signed SSL certificates, create the following directory and copy the certificates into it.

mkdir -p <working directory>/migration/security/certs