Install or Upgrade the TeamForge—Nexus Integration Plugin

You must keep the following information handy before installing the TeamForge-Nexus integration plugin:

• Nexus absolute path: This is the path to the directory where you have Nexus installed. In other words, the path to the directory where you have your Nexus files unzipped. For example, /nexus-3.14.0-04-unix/sonatype-work/nexus3 (Nexus 3).
• TeamForge host URL: The URL to access TeamForge. For example, http://ctf.cloud.collab.net.
• TeamForge administrator user name and password.
• Nexus Application Name: The name given to your Nexus integration. In other words, the name found in the Nexus integrated application configuration file.
• Nexus Application Prefix: The prefix chosen for Nexus. In other words, the prefix found in the Nexus integrated application configuration file.
• Nexus URL: The fully qualified Nexus URL.

Install and Configure the TeamForge-Nexus 3 Integration Plugin

1. Log on to the Nexus server.
2. Stop Nexus if it’s running.
   • Linux:

     ./bin/nexus stop
     

   • Windows:

     \bin\nexus stop
     

3. Download the TeamForge—Nexus 3 integration plugin.

• If you are using Nexus 3.19.1 or 3.20.0: Download the CTF-Nexus-3-Integration-Plugin-3.2.52.zip file.
• If you are using Nexus 3.20.1, 3.21.0, 3.21.1 or 3.21.2: Download the CTF-Nexus-3-Integration-Plugin-3.3.53.zip file.
• If you are using Nexus 3.22.1: Download the CTF-Nexus-3-Integration-Plugin-3.3.54.zip file.
• If you are using Nexus 3.23.0: Download the CTF-Nexus-3-Integration-Plugin-3.3.55.zip file.

1. Unzip the CTF-Nexus-3-Integration-Plugin-3.x.xx.zip file.
   • Linux:

     cd <nexus-install-directory>/nexus/system
     unzip CTF-Nexus-3-Integration-Plugin-3.x.xx.zip
     

   • Windows: Use a utility such as WinRAR.
2. Install the TeamForge-Nexus 3 integration plugin.

   sudo java -jar <nexus-install-directory>/nexus/system/CTF-Nexus-3-Integration-Plugin-3.x.xx/installer.jar -enable
   

3. Enter the Nexus absolute path and TeamForge host URL when prompted.
4. Start Nexus.
   • Linux:

     cd <nexus-install-directory>
     ./bin/nexus start
     

   • Windows:

     cd <nexus-install-directory>
      \bin\nexus start
     

5. Log on to Nexus 3 as a Site Administrator.
6. Click Realms under the Security section on the Administration menu.
7. Select TF Authentication Realm and TF Authentication Token Realm from the available list of realms.

   

8. Add them to the list of active realms and click Save.

   

9. Once Nexus is up and running, upload the Nexus IAF descriptors to TeamForge.

   java -jar <nexus-install-directory>/nexus/system/CTF-Nexus-3-Integration-Plugin-3.x.xx/installer.jar -installxml
   

   Enter the TeamForge Host URL, TeamForge admin user name and password, Nexus application name, Nexus application prefix and Nexus URL when prompted.

Upgrade the TeamForge—Nexus 3 Integration Plugin

You must upgrade your TeamForge—Nexus 3 integration plugin to:

• CTF-Nexus-3-Integration-Plugin-3.2.52.zip:
  • If you are upgrading to TeamForge 20.0 (or later).
  • If you are upgrading to Nexus 3.19.1 or 3.20.0
• CTF-Nexus-3-Integration-Plugin-3.2.53.zip:
  • If you are upgrading to TeamForge 20.0 (or later).
  • If you are upgrading to Nexus 3.20.1, 3.21.0, 3.21.1 or 3.21.2
• CTF-Nexus-3-Integration-Plugin-3.2.54.zip:
  • If you are upgrading to TeamForge 20.0 (or later).
  • If you are upgrading to Nexus 3.22.1
• CTF-Nexus-3-Integration-Plugin-3.2.55.zip:
  • If you are upgrading to TeamForge 20.0 (or later).
  • If you are upgrading to Nexus 3.23.0

1. Download the TeamForge—Nexus 3 integration plugin.

• If you are using Nexus 3.19.1 or 3.20.0: Download the CTF-Nexus-3-Integration-Plugin-3.2.52.zip file.
• If you are using Nexus 3.20.1, 3.21.0, 3.21.1 or 3.21.2: Download the CTF-Nexus-3-Integration-Plugin-3.3.53.zip file.
• If you are using Nexus 3.22.1: Download the CTF-Nexus-3-Integration-Plugin-3.3.54.zip file.
• If you are using Nexus 3.23.0: Download the CTF-Nexus-3-Integration-Plugin-3.3.55.zip file.

1. Unzip the CTF-Nexus-3-Integration-Plugin-3.x.xx.zip file.
   • Linux:

     cd <nexus-install-directory>/nexus/system
     unzip CTF-Nexus-3-Integration-Plugin-3.x.xx.zip
     

   • Windows: Use a utility such as WinRAR.
2. Install the TeamForge-Nexus 3 integration plugin.

   sudo java -jar <nexus-install-directory>/nexus/system/CTF-Nexus-3-Integration-Plugin-3.x.xx/installer.jar -enable
   

3. Log on to Nexus 3 as a Site Administrator.
4. Click Realms under the Security section on the Administration menu.
5. Select TF Authentication Realm and TF Authentication Token Realm from the Active list of realms, move them to the Available list of realms and move them back to the Active list of realms.

Related Links

• Manage Binary Repositories
• TeamForge Binary Integration Overview
• Install Nexus
• TeamForge-Binary Integration FAQs

[]:

[]: