Installing Nexus 2 / Nexus 3
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.
The following instructions are for installing Nexus as a standalone server and integrating it with TeamForge.
- Log on to the Nexus server.
- Download
- Nexus 2.9.0 or later (CollabNet supports until Nexus 2.14.8 version) zip file, if you’re installing Nexus 2. For instructions, see Nexus 2 Installation.
- Nexus 3.14.0 zip file, if you’re installing Nexus 3. For instructions, see Nexus 3 Installation.
-
Unzip the content to a directory of your choice.
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>
).
<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.
- Open the command prompt and start Nexus.
-
Linux:
-
Change to
<nexus-install-directory>
.cd <nexus-install-directory>
-
This step is applicable only for Nexus 2. Add the following token in the
<nexus-install-directory>/conf/nexus.properties
file.nexus.ui.keepAlive=false
-
Start Nexus.
./bin/nexus start
-
-
Windows:
-
Change to
<nexus-install-directory>
.cd <nexus-install-directory>
-
This step is applicable only for Nexus 2. Add the following token in the
<nexus-install-directory>\conf\nexus.properties
file.nexus.ui.keepAlive=false
-
Start Nexus.
\bin\nexus start
-
-
-
Verify if Nexus is running by accessing the URL:
- For Nexus 2:
<nexus host name>:port/nexus/index.html
. - For Nexus 3:
<nexus host name>:port/index.html
.
Default port is 8081. In case you have multiple Nexus instances, modify the application-port property in
/<nexus-work-directory>/nexus/conf/nexus.properties
file for Nexus 2./<nexus-work-directory>/nexus3/etc/nexus.properties
file for Nexus 3.
- For Nexus 2:
- Stop Nexus.
- Linux:
./bin/nexus stop
- Windows:
\bin\nexus stop
- Linux:
Upgrade Nexus 2 to Nexus 3
This section discusses the migration and post migration steps of Nexus 2 to Nexus 3 migration.
-
Upgrade your Nexus 2 server to Nexus 3 following the instructions. See Upgrading Nexus.
-
Log on to the Nexus 3 server as a Site Administrator.
-
Click Realms from the Administration > Security menu.
-
Select TF Authentication Realm and TF Authentication Token Realm from the available list of realm.
Note: Both the TF Authentication Realm and TF Authentication Token Realm will get listed in the available list of realm, only if you have already installed the TeamForge-Nexus 3 plugin. For installing the TeamForge-Nexus 3 plugin, see Installing the TeamForge-Nexus 3 Integration Plugin. -
Add them to the list of active realm and click Save.
-
Copy
teamforgeProjectConfiguration
folder from Nexus 2 to Nexus 3.-
If you have installed Nexus 3 on the same server where Nexus 2 services are running:
cp -r <nexus-work-directory>/nexus/conf/teamforgeProjectConfiguration <nexus-work-directory>/nexus3/etc/
-
If Nexus 2 and Nexus 3 are installed on separate servers:
scp -r user@<nexus-work-directory>/nexus/conf/teamforgeProjectConfiguration user@<nexus-work-directory>/nexus3/etc/
-
-
Copy the values of the TIME_TO_HOLD_USER_CACHE and TIME_TO_HOLD_PERMISSION_CACHE properties from the Nexus 2
ctf_nexus.properties
file to that of Nexus 3.-
Location of the
ctf_nexus.properties
file in Nexus 2:<nexus-work-directory>/nexus/conf/
-
Location of the
ctf_nexus.properties
file in Nexus 3:<nexus-work-directory>/nexus3/etc/
-
-
Do this step on the TeamForge Application Server. Run the
nexus3_upgrade.sh
script with the required arguments (see below) from the root path of the binary application to update the repository path and the IAF server name of Nexus 2 (against the Binary database) with that of Nexus 3.sh /opt/collabnet/integrations/cn-binary/bin/nexus3_upgrade.sh nexus2_app_name nexus3_app_name nexus3_repo_host_url
where,
- nexus2_app_name: Integrated Application Framework (IAF) server name of Nexus 2
- nexus3_app_name: Integrated Application Framework (IAF) server name of Nexus 3
- nexus3_repo_host_url: Repository path of Nexus 3
-
Restart Nexus 3.
<nexus_3_app_dir>/bin/nexus restart
-
Delete the Nexus 2 application integrated with TeamForge.
-
Log on to TeamForge as a Site Administrator.
-
Select My Workspace > Admin.
-
Select Integrated Apps from the Projects menu.
-
Select the Binaries tab.
-
Select the Nexus 2 integrated app that you want to delete.
-
Click Delete or Force Delete.
-
Key points to note in TeamForge with Nexus 3








[]: