25.2. Getting Started

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

When the repository manager 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 URL http://localhost:8081/nexus. If you have chosen to use a different port during the installation of the trial simply change the URLs.

Below are several directories to know:

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

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

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 Control Panel.

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

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

The repository manager tries to listen on port 8081. If you have another application listening on this port, the repository manager will not be able to start. You can change the port the repository manager listens on. Open this file

<nexus_install>/conf/nexus.properties

Edit the line that looks like this:

application-port=8081

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

application-port=9090

Save the file and restart the repository manager.

25.2.1. Activating Your Nexus Repository Manager Trial

Once the repository manager 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 and click on Submit Activation Request.

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

25.2.2. Logging in as an Administrator

After activating your repository manager install, you can log into the user interface 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 25.1. Nexus Repository Manager User Interface with Login


The default administrator username is admin and password is admin123.

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

25.2.3. Getting Started with Your Nexus Repository Manager Evaluation

To make it easier to evaluate Nexus Repository Manager, we’ve created a set of projects to demonstrate the features of Nexus Repository Manager OSS and Nexus Repository Manager. 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 Repository Manager, your server is also preconfigured to demonstrate important features.

The trial distribution contains the following customizations:

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