Set up Nexus

The following instructions are for installing Nexus Open Source version 2.9.0 or later as a stand-alone server and integrating it with TeamForge 8.1.

Nexus comes bundled with a Jetty instance that listens to all configured IP addresses on a host (0.0.0.0) and runs on port 8081 by default.

Installing Nexus is straightforward. Unzip the Nexus bundle in a directory and start Nexus.
Note: Though Nexus can be installed in Mac OS, CollabNet did not test Nexus integration in Mac OS.
  1. Log on to the Nexus server.
  2. Download the Nexus 2.9.0 or later zip file and unzip the content to a directory of your choice. See Installing Nexus. You can find two directories, a directory that contains Nexus installation files and folders (hereinafter referred to as <nexus-install-directory>) and a Nexus work directory (hereinafter referred to as <nexus-work-directory>).
    Important:
    • <sonatype-work> is the default Nexus work directory. As a notation, <nexus-work-directory> is used in place of <sonatype-work> in this document.
    • Make sure you have full access permissions on all Nexus folders.
  3. Open the command prompt and start Nexus.

    Linux:

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

    Windows:

    • cd <nexus-install-directory>
    • \bin\nexus start
    Verify if Nexus is running by accessing the URL: <nexus host name>:port/nexus/index.html.
    Tip: Default port is 8081. In case you have multiple Nexus instances, modify the application-port token in /<nexus-install-directory>/conf/nexus.properties file.
  4. Stop Nexus.

    Linux:

    • ./bin/nexus stop

    Windows:

    • \bin\nexus stop
  5. Download the CTF-Nexus-Integration-Plugin-2.0.zip file.
  6. Unzip the CTF-Nexus-Integration-Plugin-2.0.zip file.

    Linux:

    • cd <nexus-work-directory>/nexus/plugin-repository
    • unzip CTF-Nexus-Integration-Plugin-2.0.zip

    Windows: Use a utility such as WinRAR.

  7. Install the TeamForge-Nexus integration plug-in.
    • sudo java -jar <nexus-work-directory>/nexus/plugin-repository/CTF-Nexus-Integration-Plugin-2.0/util/installer.jar -enable
    • Enter the TeamForge user name, password and host URL when prompted.
    • The TeamForge-Nexus integration plug-in installer requests authentication from TeamForge and also imports the TeamForge SSL certificate (only self signed certificates) to the JVM keystore where Nexus is hosted.
    • The sudo command is required for the installer to access the cacerts file provided by JVM to import certificate. It is not necessary to run the installer with root privileges. Any system user who has access to cacerts can run the installer.
    • Once installation is complete, it may take a while for Nexus to start.
  8. Start Nexus.

    Linux:

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

    Windows:

    • cd <nexus-install-directory>
    • \bin\nexus start
  9. Once Nexus is up and running, upload the Nexus IAF descriptors to TeamForge.
    • java -jar <nexus-work-directory>/nexus/plugin-repository/CTF-Nexus-Integration-Plugin-2.0/util/installer.jar -installxml

    Enter the TeamForge admin user name, password and the Nexus integration URL when prompted.