Migration Tool Run in a Single Step

Run the migration "all" command once to complete config, repo creation, artifact migration, and security migration in a single execution.

  1. Run the following command to migrate all entities in a single step.

    ./jfrog-nexus-migrator-<version>.sh all
  2. Add the following Artifactory configuration information.

    • JFrog Platform Server Name: Identifier for the JFrog Platform server.
    • JFrog Platform URL: URL to access the JFrog Platform that contains the Artifactory instance.
    • JFrog Access Token: API token to access the JFrog Platform. You can leave the field as blank and provide username and password in the subsequent steps.
    • JFrog Username: The username of a user with administrator privileges.
    • JFrog Password or API key: The API key or the password.
  3. Enter the following configuration information for Nexus Server.

    • Nexus Working Directory
    • Nexus Repository Manager URL
    • Nexus Repository Manager Username
    • Nexus Repository Manager Password
    • Default Password for Artifactory Users

    Use the following guidance when entering the Nexus server details:

    • Nexus Working Directory: In the Nexus Repository Manager, navigate to Administration > System Information. The workingDirectory field provides the location of the Nexus Working Directory.
    • URL format: Enter the private IP of the Nexus server to improve performance, because the migration script runs on the same machine. Set the URL as http://<private ip>:<port>.
    • Context-path variant: If a context path is configured for the Nexus server, enter the URL as http://<private ip>:<port>/<context-path>.

    The default password for Artifactory users must adhere to the following rules.

    • Minimum of eight characters
    • Contain at least one number
    • Contain at least one lower case alphabet
    • Contain at least one upper case alphabet

The script fetches the configuration information from Nexus, creates corresponding repositories in Artifactory, migrates artifacts to Artifactory, and migrates security configuration to Artifactory. You can check the details of the artifacts and configuration migrated to Artifactory in the migration.log file, available in the working directory. The script creates YAML files and JSON files based on Nexus inside the folder, <working directory>/migration/nexus-migrator.

Check the migration.log file to verify migration status. The log details the migration status of repositories, artifacts, and security entities.