Skip to main content Skip to complementary content

Configuring Sonatype Nexus

After installing Sonatype Nexus, you need to create and configure the required repositories in Nexus. You can start Nexus configuration either by using the .init file in Talend Administration Center Zip file or manually.

Before you begin

Download and install Sonatype Nexus. For more information, see the official Download page.

Configuring Nexus with the Talend Administration Center Zip file

After the installation of Nexus, you can use the Zip file provided with Talend Administration Center to configure your instance.

Procedure

  1. Unzip the Talend Administration Center Zip file, then unzip the Artifact-Repository-Nexus-VA.B.C.D.E archive file.
  2. Inside the Artifact-Repository-Nexus-VA.B.C.D.E archive file, the migration-A.B.C folder contains the migration script as well as a .properties file.
  3. Copy the <NewNexusInstallationDirectory>\migration-A.B.C folder to the location of your choice.
  4. Open the migration-A.B.C\nexus.properties file and check the URL, port, and login connection information. Also check the version format. Update these parameters if needed and save your changes.
  5. Launch Nexus.
  6. Log into the Sonatype Nexus Repository Web application. In the nexus.properties file, you can find the application URL. After the first connection, it is strongly recommended to change the default credentials of the default administrator account.
  7. Browse to the migration-A.B.C folder and execute the following command: java -jar <nexus-init-A.B.C.jar> in which <nexus-init-A.B.C.jar> corresponds to the .jar file name that is in the migration-A.B.C folder. For example: java -jar nexus-init-8.0.1.jar.

Results

Refresh Nexus website, in the Users tab, you can see the following users:
  • talend-custom-libs-admin (password: talend-custom-libs-admin): this user is used in Talend Administration Center Configuration > User Libraries group. Talend Studio gets the configuration information from Talend Administration Center to upload and download third-party libraries.
  • talend-updates-admin (password: talend-updates-admin): this user is used in Talend Administration Center Configuration > Software Update group. Talend Administration Center downloads the patch from Talend Update Server and use this account to upload the patch to Nexus. Talend Studio can download the patch from Nexus without credentials.
In the Roles tab, you can see the following roles:
  • talend-updates-admin
  • talend-updates-read-only
  • talend-custom-libs-admin
  • talend-custom-libs-snapshot-read-only
  • talend-custom-libs-release-read-only
In the Repositories tab, you can see the following repositories:
  • talend-custom-libs-release
  • talend-custom-libs-snapshot
  • talend-updates

What to do next

Once the Nexus repository is installed and launched, you can go to the Configuration page of Talend Administration Center and add the configuration settings for the created repositories. For more information, see Setting up Software Update parameters, Setting up the artifact repository parameters, and Setting up the user library location.

Configuring Nexus manually

You can create the roles, users, and repositories manually.

Procedure

  1. Start by running Nexus.
  2. Go to the Sonatype Nexus Repository Manager interface.
  3. Under the Users tab, create the following users:
    • talend-updates-admin: this user is used in Talend Administration Center Configuration > Software Update group. Talend Administration Center downloads the patch from Talend Update Server and uses this account to upload the patch to Nexus. Talend Studio can download the patch from Nexus without credentials.
    • talend-custom-libs-admin: this user is used in Talend Administration Center Configuration > User Libraries group. Talend Studio gets the configuration information from Talend Administration Center to upload and download third-party libraries.
    1. Click Create local user.
    2. Write talend-updates-admin as the ID and fill the other required fields.
    3. Go to the Roles sub-section and add talend-updates-admin to the Granted list.
    4. Click Create local user.
    5. Create the user with the talend-custom-libs-admin ID.
    6. Go to the Roles sub-section and add talend-custom-libs-admin to the Granted list.
    7. Open the admin user.
    8. Add the nx-admin role to the Granted list.
    9. Open the anonymous user.
    10. Add the nx-anonymous, talend-custom-libs-release-read-only, talend-custom-libs-snapshot-read-only and talend-updates-read-only roles to the Granted list.
      Information noteImportant: The anonymous user is not secure and not used in Talend Administration Center or Talend Studio. It is recommended to disable the anonymous user in Nexus.
  4. Go to the Repositories tab to create the following repositories:
    • talend-updates
    • talend-custom-libs-snapshot
    • talend-custom-libs-release
    1. Click Create repository.
    2. Select maven2 (hosted) from the list.
    3. Name your repository talend-updates.
    4. Under the sub-section version policy, select Release.
    5. Click Create repository to save your changes.
    6. Create another maven2 (hosted) repository named talend-custom-libs-snapshot.
    7. Under the sub-section version policy, select snapshot.
    8. Click Create repository to save your changes.
    9. Create the last maven2 (hosted) repository and name it talend-custom-libs-release.
  5. Under the sub-section version policy, select Release.
  6. Go to the Roles tab, click Create role > Nexus role and create the following roles with the following privileges added to the Given list:
    Option Description
    Role ID Privileges
    talend-updates-admin

    nx-repository-view-maven2-talend-updates-add

    nx-repository-view-maven2-talend-updates-browse

    nx-repository-view-maven2-talend-updates-edit

    nx-repository-view-maven2-talend-updates-read

    nx-script-*-run

    talend-updates-read-only

    nx-repository-view-maven2-talend-updates-read

    nx-repository-view-maven2-talend-updates-browse

    nx-script-*-run

    talend-custom-libs-admin

    nx-repository-view-maven2-talend-custom-libs-release-add

    nx-repository-view-maven2-talend-custom-libs-release-browse

    nx-repository-view-maven2-talend-custom-libs-release-edit

    nx-repository-view-maven2-talend-custom-libs-release-read

    nx-repository-view-maven2-talend-custom-libs-snapshot-add

    nx-repository-view-maven2-talend-custom-libs-snapshot-browse

    nx-repository-view-maven2-talend-custom-libs-snapshot-edit

    nx-repository-view-maven2-talend-custom-libs-snapshot-read

    nx-script-*-run

    talend-custom-libs-snapshot-read-only

    nx-repository-view-maven2-talend-custom-libs-snapshot-browse

    nx-repository-view-maven2-talend-custom-libs-snapshot-read

    nx-script-*-run

    talend-custom-libs-release-read-only

    nx-repository-view-maven2-talend-custom-libs-release-browse

    nx-repository-view-maven2-talend-custom-libs-release-read

    nx-script-*-run

What to do next

Once the Nexus repository is installed and launched, you can go to the Configuration page of Talend Administration Center and add the configuration settings for the created repositories. For more information, see Setting up Software Update parameters, Setting up the artifact repository parameters, and Setting up the user library location.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!