Repository Management with Nexus

22.2. Getting Started

This guide is based on the usage of Nexus Professional. A lot of the core features are available in Nexus Open Source as well and some examples are suitable to assess the open source version as well.

When Nexus has started just click the url in the wizard or go to http://localhost:8081/nexus in a browser window.

Note

This guide and the examples reference the Nexus URL http://localhost:8081/nexus. If you have chosen to use a different port during the installation of the trial e.g. 9081, simply change the URLs.

There are several directories you should be familiar with:

Nexus Installation Directory: This is where the Nexus application files are installed on your system. We refer to this as <nexus_install>.

Nexus Work Directory: This directory contains your specific Nexus instance configuration files. We refer to this as <nexus_work>.

Nexus Eval Guide Directory: This directory contains supporting sample project files and this document. We refer to this as <nexus_eval>.

Note

You can locate these directories by viewing the Nexus Control Panel.

In case something goes wrong and Nexus seems to be unavailable, you can examine the following 2 log files to diagnose problems.

<nexus_work>/logs/nexus-launcher.log
<nexus_work>/logs/nexus.log

Nexus tries to listen on port 8081. If you have another application listening on this port, Nexus will not be able to start.

You can change the port Nexus listens on. Open this file

<nexus_install>/conf/nexus.properties

Edit the line that looks like this:

application-port=8081

For example, to access Nexus on port 9090 instead, change the line to

application-port=9090

Save the file and restart Nexus.

22.2.1. Activating Your Nexus Trial

Once Nexus is started and you are accessing the user interface the first time, you will see the trial activation form. Provide your full name, email address, organization, and location, click on Submit Activation Request.

You will immediately receive an email from Sonatype with the subject “Your Nexus Professional Trial License”, which contains your trial license key. Paste this license key into the license field in the Nexus Professional user interface. Click Activate to activate your 14-day Nexus Professional Trial. Once your trial is activated you will be presented with the Nexus user interface.

22.2.2. Logging Into Nexus As An Administrator

After activating your Nexus install, you can log into Nexus as an administrator. Go to http://localhost:8081/nexus/ and click on the Login button in the upper right-hand corner of the interface.

figs/web/eval-login.png

Figure 22.1. Nexus User Interface With Login


The default administrator username is admin and password is admin123.

The Nexus Professional Trial evaluation guide assumes that you are logged in as an administrator.

22.2.3. Getting Started With Your Nexus Professional Evaluation

To make it easier to evaluate Nexus, we’ve created a set of projects to demonstrate the features of Nexus Open Source and Nexus Professional. These example projects are bundled with the trial installer for your convenience.

In addition they are available as the nexus-book-examples project on GitHub at https://github.com/sonatype/nexus-book-examples for you to download and inspect separately, if desired. The latest version of all the examples is available as a zip archive at https://github.com/sonatype/nexus-book-examples/archive/master.zip.

When you downloaded the trial distribution of Nexus Professional, your server is also preconfigured to demonstrate important features.

The Nexus trial distribution contains the following customizations:

  • Nexus has been preconfigured to download the search index from the Central Repository.
  • A Staging profile has been configured to demonstrate release management.
  • Procurement has been preconfigured so you can quickly define rules for the OSS components.
  • Nexus proxies NuGet Gallery so that you can quickly evaluate support for .NET development.