Sonatype Blog » tim

Working with Maven Repositories in m2eclipse

tim — Fri, 12 Mar 2010 14:23:49 +0000

m2eclipse 0.10.0 has a new view which allows you to manage Maven repositories. This Maven Repositories view allows you to:

Manage Local Repositories
Manage Global Repositories
Inspecting and Opening a POM from the Repository Browser
Modify the Indexing Settings – Enable Full Index or Min Index
Materialize Projects from a Repository (Assuming that they have the appropriate meta-data)

Important Note: If you need to search for dependencies by class name, you will need to select Enable Full Index for the central repository.

Watch this video for instructions on managing maven repositories.

Nexus Book Update: Nexus 1.5 Content and Community-driven Corrections

tim — Sat, 27 Feb 2010 15:48:06 +0000

The latest edition of Repository Management with Nexus, Edition 2.1, has been released. This edition includes new content about Nexus 1.5.0 Open Source and Enterprise LDAP. Edition 2.1 also contains almost 100 corrections which were driven by the community.

The following changes were introduced in Edition 2.1 in February, 2010:

Updated content for the Nexus 1.5.0 Release
- Updated Nexus Open Source version to 1.5.0 (NXBOOK-433)
- Updated Nexus Professional version to 1.5.0.2 (NXBOOK-434)
- Added information about the Open Source LDAP Feature to Section 1.2.1, “Nexus Open Source Features”. (NXBOOK-435)
- Added information about the Enterprise LDAP Feature to Section 1.3.1, “Nexus Professional Features”. (NXBOOK-437)
- Updated Section 1.4, “Choosing a Nexus Edition” to reflect the LDAP feature changes.
- Updated Chapter 2, Repository Management to reflect the LDAP feature changes.
- Added Section 7.6, “Enterprise LDAP Support”. (NXBOOK-436)
Througout Chapter 8, Nexus Procurement Suite there are alternating references to a strategy known both as the “Secured Development Repository” and the “Procured Development Repository”. To avoid confusion the strategy is now referred to as “Procured Development Repository”. (NXBOOK-420)
Removed the Nexus Plugins chapter. This chapter was incomplete and incorrect. Until we can commit to a larger survey of available Nexus plugin, it makes sense to remove this chapter. (NXBOOK-445)
Updated Figure 1.1, “Sonatype Nexus Feature Matrix” to include Nexus 1.5.0 features. (NXBOOK-421)
Section 3.4, “Running Nexus” contained a reference to a login dialog figure that has been removed. This reference has been removed. (NXBOOK-402)
Section 7.3, “Connection and Authentication” stated that the LDAP authentication user had to be a user with administrative rights to the LDAP server. This is incorrect, copy updated to state that the user simply needs to have privileges to read all users and groups. (NXBOOK-31)
Added labels to figures in Chapter 16, Artifact Bundles. All of these figures were missing proper labels. (NXBOOK-328)
Updated the copyright year.
Numerous updates to Chapter 9, Nexus Staging Suite
- Rewrote portions of Section 9.1, “Introduction” to make the introduction more straightforward for new users. (NXBOOK-423)
- Changed the “Installing Staging Suite” section to Section 9.2, “Using the Nexus Staging Suite”. Since the Nexus Staging Suite is bundled with Nexus Professional, it doesn’t make any sense to provide installation instructions. (NXBOOK-425)
- Made sure to reference that target created in Section 9.3.1, “Configuring a Staging Target” from Section 9.3.2, “Configuring Staging Profiles”. In the previous edition, we made no mention of the Sonatype Sample target when creating the staging profile. This change makes the section more direct, you define profiles to be activated when an artifact matches a repository target. (NXBOOK-429)
- Reordered the sections in Section 9.3, “Configuring Staging Profiles”. The previous edition started with role assignment. This doesn’t make sense in the workflow of defining a Staging repository because the act of defining a Staging Profile creates several new roles. (NXBOOK-428)
- Added “Close Staging Repository Rulesets” to Section 9.3.2, “Configuring Staging Profiles”. (NXBOOK-430)
- Fixed a label problem with Figure 9.3, “Enterprise Menu after Staging Suite Installation”. (NXBOOK-427)
- Added some lists to Section 9.3.3, “Adding the Staging Deployer Role” to clarify the staging roles. The previous edition lacked an explicit list of the roles created by a Staging Profile. (NXBOOK-426)
Fix typos through the book (most issues subtasks of NXBOOK-256 and NXBOOK-220)
- Fix a typo in Section 5.7, “Log Files and Configuration”. “Logs and Config Files is only visible” is now “The Logs and Config Files link is only visible” (NXBOOK-258)
- Fixed a typo in Section 2.1.3, “Getting Control of Dependencies”. “producing a application” is now “producing an application”. (NXBOOK-255)
- Fixed a typo in Section 9.6.2, “Defining Rulesets for Promotion”. “Nexus Professional was check” is now “Nexus Professional will check”. (NXBOOK-416)
- Fixed a spelling error in Section 9.5, “Uploading a Staged Deployment in Nexus”. “expose a button labelled” is now “expose a button labeled”. (NXBOOK-259)
- Fixed a typo in Section 5.5, “Uploading Artifacts”. “When you build makes use” is now “When your build makes use”. (NXBOOK-260)
- Fixed a typo in Section C.3, “Configuring Nexus to Serve SSL”. “this instructions” is now “these instructions”. (NXBOOK-261)
- Fixed a typo in Section C.3, “Configuring Nexus to Serve SSL”. “But, Jetty can easily” is now “Jetty can also”. (NXBOOK-262)
- Fixed a typo in Section A.7, “Configuring Artifactory Clients to Use Nexus”. “identifer” is now “identifier”. (NXBOOK-264)
- Fixed a typo in Section A.5.2, “Configuring Artifactory Repository Imports”. “Repostiores” is now “Repositories”. (NXBOOK-265)
- Fixed a sentence structure issue in Section A.1, “Introduction”. “using a web application which exposes” is now “using a web application, exposing”. (NXBOOK-266)
- Fixed a sentence structure issue in Section 5.5, “Uploading Artifacts”. Fixed a spelling error in same section. “labelled” is now “labeled”. (NXBOOK-269)
- Fixed a few typos in Section 9.3.2, “Configuring Staging Profiles”. (NXBOOK-271)
- Fixed a spelling error “LDAP Integeration” is now “LDAP Integration” in Figure 1.1, “Sonatype Nexus Feature Matrix”. (NXBOOK-408)
- Fixed typos in Section 1.3.1, “Nexus Professional Features”.
  - “integration” changed to “integrate”. (NXBOOK-403)
  - “to sign up for [an] account” (NXBOOK-404)
- Fixed a typo in Section 2.3, “What is a Repository Manager”. “Once you start [to] rely…” (NXBOOK-405)
- Fixed a typo in Section 3.2.2, “Installing Nexus Open Source”: “whenever” -> “wherever” (NXBOOK-406)
- Fixed an error in Section 3.4, “Running Nexus”. Section was pointing to the wrong location for wrapper.log. (NXBOOK-401)
- Fixed a mispelling in Section 18.3, “Creating a Complex Plugin”. “ApplicaitonEventMulticaster” -> “ApplicationEventMulticaster” (NXBOOK-365)
- Fixed a spelling error in Section 8.1, “Introduction”. “funnelled” is now “funneled”. (NXBOOK-274)
- Fixed a typo in Section 7.5.2, “Mapping External Roles to Nexus Roles”. “bring a up” is now “bring up”. (NXBOOK-275)
- Fixed a typo in Section 7.5.1, “Mapping Nexus Roles for External Users”. “To explore these two sets of user[s]” (NXBOOK-278)
- Fixed a typo in the title of Table 7.9, “Group Element Mapping Configuration for posixGroup”. “posixAccount” should be “posixGroup” (NXBOOK-31)
- Reworded the initial sentence of Section 2.2.3, “Addressing Resources in a Repository” for clarity. (NXBOOK-252)
- Reworded portions of Section 2.2.4, “The Central Maven Repository”. (NXBOOK-252)
- Removed the first sentence of Section 2.4.3, “Ease the Burden on Central”. (NXBOOK-249)
- Fixed a spelling error in Section 2.4.6, “Deploy 3rd Party Artifacts”. “hand-crafting” is now “handcrafting” (NXBOOK-248)
- Fixed a that/which in Section 2.4.6, “Deploy 3rd Party Artifacts”. (NXBOOK-248)
- Added a hyphen to “developer-managed” in Section 2.5.1, “Stage Zero: Before Using a Repository Manager”. (NXBOOK-247)
- Fixed several sentence structure issues in Section 2.5.1, “Stage Zero: Before Using a Repository Manager”, Section 2.5.1, “Stage Zero: Before Using a Repository Manager”, and Section 2.5.3, “Stage Two: Hosting a Repository Manager”. (NXBOOK-246)
- Fixed a sentence structure issue in Section 2.5.3, “Stage Two: Hosting a Repository Manager”. (NXBOOK-245)
- Fixed sentence structure issues in Section 2.5.4, “Stage Three: Continuous Collaboration” and Section 2.5.5, “Stage Four: Lifecycle Integration”. (NXBOOK-244 and NXBOOK-243)
- Fixed a sentence structure issue in Section 3.2.2, “Installing Nexus Open Source”. (NXBOOK-239)
- Fixed a that/which issue in Section 3.2.3, “Installing Nexus Professional”. (NXBOOK-238)
- Fixed a typo in Section 18.1.2, “Nexus Extension Points”. “descriptor with is” is now “descriptor which is”. (NXBOOK-363)

The following individuals provided valuable feedback resulting in fixes and changes in Edition 2.1:

Anders Hammar
Brian Demers

How to Contribute to the Maven Books

tim — Tue, 23 Feb 2010 09:28:21 +0000

Manfed Moser, the author of the newly released Android chapter in Maven: The Complete Reference, wrote a very quick step-by-step set of instructions for people interested in contributing to the Maven book. Read the whole post here: http://www.simpligility.com/2010/02/how-to-contribute-to-the-maven-books/

Here’s an excerpt:

The first thing you will have to do is get the source code – after all the books are open source licensed and freely available to anyone. The books are found on github at http://github.com/sonatype/ and in the case of the reference book at http://github.com/sonatype/maven-reference-en. With the excellent help on github you can just fork the repository and get your own copy going locally. My copy for example is at http://github.com/mosabua/maven-reference-en

Now thanks to the power of Maven and its conventions you get the book created as HTML website and PDF document by running, surprise, mvn clean install

Update to Maven Complete Reference: Flexmojos and Android (Edition 0.4)

tim — Fri, 19 Feb 2010 23:31:24 +0000

The latest edition of Maven: The Complete Reference, Edition 0.4, has been released. This edition updates the Flexmojos chapter to the latest FlexMojos 3.5.0 release and refreshes information about Flexmojos archetypes. We added an initial version of a chapter by Manfred Moser that walks through the process of using Maven to build Android applications. In addition to that we fixed some minor issues throughout the book that had been reported by the community.

A full list of changes in Edition 0.4:

Added a new chapter: Chapter 14, Android Application Development with Maven. (MVNREF-135)
Updated the Flexmojos version to 3.5.0 in Chapter 13, Developing with Flexmojos. (MVNREF-127)
- Added some clarification to Section 13.2.1, “Referencing a Repository with the Flex Framework” that suggests adding the flexmojos repository to an existing Nexus installation.
- Reorganized Section 13.2.1.2, “Proxying Sonatype’s Flexmojos Repository with Nexus”. Added level four headings to group content into more easily understood chunks with respect to Nexus configuration.
- Fixed minor typos throughout Chapter 13, Developing with Flexmojos.
- Updated all of the Flexmojos Maven Archetypes with most recent pom.xml content. Changes affected Section 13.3.1, “Creating a Flex Library”, Section 13.3.2, “Creating a Flex Application”, and Section 13.3.3, “Creating a Multi-module Project: Web Application with a Flex Dependency”.
- Removed the warnings in the multi-module project exampe in Section 13.3.3, “Creating a Multi-module Project: Web Application with a Flex Dependency”. There used to be a problem with the archetype module dependencies, this has been fixed in the recent Flexmojos releases.
Section 5.5.1, “Common Environments” was incorrect. The property defined in ~/.m2/settings.xml was not activating the profile defined in a project’s POM. This seciton has been corrected. (MVNREF-124)
Fixed a code overflow in Section 7.1.4, “Setting Execution Specific Parameters”. (MVNREF-118)
Fixed unescaped property references and a code overflow in Example 3.1, “The Super POM”. (MVNREF-117)

The following contributors provided invaluable feedback and contributions:

Emmanuel Hugonnet provided the issue report that prompted the update of the Flexmojos chapter to version 3.5.0.
Benjamin Bentmann reported an inconsistency in Section 5.5.1, “Common Environments”.
Manfred Moser was added as a primary author for contributing Chapter 14, Android Application Development with Maven.

Nexus Scheduled Jobs: Video Walkthrough of Major Features

tim — Thu, 18 Feb 2010 09:00:07 +0000

The following demonstration video was shown in the Sonatype booth at last month’s Jfokus 2010 in Stockholm, Sweden. This video provides a quick walkthrough of the major features in Nexus Scheduled Jobs.

Highlights of this demonstration:

Time (M:SS)	Note
0:29	Managing Nexus Scheduled Jobs
0:32	Creating a New Scheduled Job
0:58	Configuring Task Settings
1:23	Job Email Notification
1:32	Configuring a Job’s Schedule
1:32	Configuring a Job’s Schedule
1:55	Manual Execution of a Task
2:15	Available Task Types
2:31	Schedule Recurrence Options
2:45	Scheduling a Job using a CRON Expression
2:59	Monthly Scheduling
3:03	Weekly Scheduling
3:13	Daily Scheduling
3:21	Hourly Scheduling
3:31	Task Type: Scheduled Backups
3:39	Task Type: Scheduled Remote Index Downloads
3:49	Task Type: Emptying the Trash
3:57	Task Type: Evicting Unused Proxy Artifacts
4:05	Task Type: Expiring Repository Caches
4:10	Task Type: Publishing Indexes
4:19	Task Type: Purging Nexus Timeline
4:25	Task Type: Rebuilding Maven Metadata
4:29	Task Type: Reindexing Repositories
4:37	Task Type: Removing Snapshots
4:43	Task Type: Synchronizing Shadow Repository
4:49	Task Type: Mirror an Eclipse Update Site

Nexus System Feeds and Log Files: Video Walkthrough of Major Features

tim — Wed, 17 Feb 2010 09:00:50 +0000

The following demonstration video was displayed in the Sonatype booth at last month’s Jfokus 2010 in Stockholm, Sweden. This video provides a quick walk through of the System Feed and Log file UI available in Nexus.

Hightlights of this video:

Time (M:SS)	Note
0:26	Viewing System Feeds
0:37	Browsing System Changes
0:49	Accessing Nexus RSS Feeds
1:03	Viewing Nexus System Files
1:19	Tailing Log Files from the Nexus UI
1:32	Log4J Configuration
1:38	Latest Version Notification Configuration
1:44	Nexus Server Configuration
2:00	PGP Keyserver Configuration
2:08	Procurement Plugin Configuration
2:14	Security Configuration
2:34	Nexus Server configuration as XML

How to Create a Simple Project in m2eclipse

tim — Wed, 17 Feb 2010 09:00:04 +0000

One of the most compelling features of m2eclipse is the ability to quickly generate new Maven projects using the New Maven project wizard. This post and the associated video demonstrate the steps to create a simple Maven project using the New Maven project wizard to select the Maven Quickstart archetype.

To create a simple project using the New Maven project wizard:

Select File > New Project. This should display the “New Project” dialog.
In the “New Project” Dialog, expand the Maven folder, and select “Maven Project”.
Click Next. The next screen provides options for customizing the location of your new Maven project. If you are storing the new project in your workspace, you can supply the directory on this page.
Click Next. The next screen lists all of the available Maven Archetypes, select the Maven Quickstart Archetype which should be listed under the group id “org.apache.maven.archetypes”.
Click Next. On the next screen, supply a Group Id, Artifact Id, and Version for your new project.
Click Finish and m2eclipse will use the Maven Quickstart Archetype to generate a new Maven project in your Eclipse workspace.

Note about 0.9.8 Workspace Incompatibility: If you are using m2eclipse 0.10.0 with a workspace that contains projects created under m2eclipse 0.9.8, you must remove the workspaceState.ser file. The workspaceState.ser file is located within the workspace directory in $workspacedir/.metadata/.plugins/org.maven.ide.eclipse/workspaceState.ser. If you remove this file, m2eclipse 0.10.0 will regenerate it as needed.

How to Install m2eclipse Core Components

tim — Tue, 16 Feb 2010 09:00:40 +0000

To install m2eclipse, use the following Eclipse update site to install the core of the m2eclipse plugin. This Core update site contains a single component: “Maven Integration for Eclipse (Required)”. When you install this component you will be installing all of the core Wizards, the POM Editor, Maven Repository integration, and Maven integration. This post provides a set of detailed instructions for installing m2eclipse 0.10.0.

m2eclipse Core Update Site: http://m2eclipse.sonatype.org/sites/m2e

IMPORTANT NOTE: You cannot upgrade from m2eclipse 0.9.8 or m2eclipse 0.9.9 to m2eclipse 0.10.0. If you are running m2eclipse 0.9.8 or 0.9.9 you must either uninstall m2eclipse from your Eclipse installation or start with a fresh installation of Eclipse.

To install this plugin in the Eclipse IDE:

Select Help > Install New Software. This should display the “Install” dialog.
Paste the Update Site URL into the field named “Work with:” and press Enter. Pressing Enter should cause Eclipse to update list of available plugins and components.
Choose the component listed under m2eclipse: “Maven Integration for Eclipse (Required)”.
Click Next. Eclipse will then check to see if there are any issues which would prevent a successful installation.
Click Next and agree to the terms of the Eclipse Public License v1.0.
Click Finish to begin the installation process. Eclipse will then download and install the necessary components.
Once the installation process is finished, Eclipse will ask you if you want to restart the IDE. Sonatype strongly recommends that you restart your IDE after installing m2eclipse.

Note about 0.9.8 Workspace Incompatibility: If you are using m2eclipse 0.10.0 with a workspace that contains projects created under m2eclipse 0.9.8, you must remove the workspaceState.ser file. The workspaceState.ser file is located within the workspace directory in $workspacedir/.metadata/.plugins/org.maven.ide.eclipse/workspaceState.ser. If you remove this file, m2eclipse 0.10.0 will regenerate it as needed.

m2eclipse Extras Update Site: http://m2eclipse.sonatype.org/sites/m2e-extras

Nexus Proxy Repositories: Video Walkthrough of Major Features

tim — Fri, 12 Feb 2010 09:00:43 +0000

The following, audio-less demonstration video was used at our booth at Jfokus 2010 in Stockholm, Sweden. It is a brief walkthrough of some of the major features of Nexus Proxy repositories. If you are evaluation Nexus, this is a chance to see Nexus UI in action.

Highlights of this demonstration reel:

Time (M:SS) Note

0:30 Browsing a Proxy repository’s Nexus Index – if you’ve configured your Nexus proxy repository to download a remote index, you can use the Browse Index tab to browse the contents of the remote repository.

0:42 Browsing artifact information

0:49 Browsing local storage

1:08 Browsing Artifact Metadata

1:19 Browsing Archive Contents (Nx Pro Only)

1:30 Proxy Repository Configuration screen walkthrough

2:21 Mirror configuration – selection which mirrors to download artifacts from. Nexus downloads security hashes and signatures from the canonical repository.

2:36 Repository Summary information panel

2:45 Browsing a remote repository with the Nexus RRB plugin.

Nexus Hosted Repositories: Video Walkthrough of Major Features

tim — Thu, 11 Feb 2010 09:00:12 +0000

This demonstration video was used at our booth at last month’s Jfokus 2010 in Stockholm, Sweden. It provides a quick, audio-less overview of some of the major features of Nexus Hosted repositories:

Highlights of this demonstration reel:

Time (M:SS) Notes

0:29 List of default hosted repositories. Nexus ships with three hosted repositories: releases, snapshots, and 3rd party.

0:45 Artifact Upload – Nexus allows you to upload artifacts or collections of related artifacts under the same GAV to a hosted repository.

1:30 Browsing storage – When you browse storage for a hosted repository, you are browsing the contents that are stored locally in the Nexus instance.

1:45 Browsing archives – this is a feature that is available in Nexus Professional. Just click on an archive under Browse Storage and Nexus will open up a Browse Archive tab.

1:57 Browsing the repository index – each repository in Nexus is associated with an index. This Nexus index allows tools like Nexus and m2eclipse to quickly locate artifacts in a repository.

2:05 Manipulating Artifact Metadata – you can modify, view, and search repository metadata that is associated with each repository artifact.

2:13 Custom Metadata – you can define your own custom metadata

2:40 Walkthrough of the Nexus Hosted Repository configuration options.

3:05 Defining available mirrors for Hosted Repositories

3:23 Hosted repository summary information

3:35 Searching custom metadata

Time (M:SS)	Note
0:30	Browsing a Proxy repository’s Nexus Index – if you’ve configured your Nexus proxy repository to download a remote index, you can use the Browse Index tab to browse the contents of the remote repository.
0:42	Browsing artifact information
0:49	Browsing local storage
1:08	Browsing Artifact Metadata
1:19	Browsing Archive Contents (Nx Pro Only)
1:30	Proxy Repository Configuration screen walkthrough
2:21	Mirror configuration – selection which mirrors to download artifacts from. Nexus downloads security hashes and signatures from the canonical repository.
2:36	Repository Summary information panel
2:45	Browsing a remote repository with the Nexus RRB plugin.

Time (M:SS)	Notes
0:29	List of default hosted repositories. Nexus ships with three hosted repositories: releases, snapshots, and 3rd party.
0:45	Artifact Upload – Nexus allows you to upload artifacts or collections of related artifacts under the same GAV to a hosted repository.
1:30	Browsing storage – When you browse storage for a hosted repository, you are browsing the contents that are stored locally in the Nexus instance.
1:45	Browsing archives – this is a feature that is available in Nexus Professional. Just click on an archive under Browse Storage and Nexus will open up a Browse Archive tab.
1:57	Browsing the repository index – each repository in Nexus is associated with an index. This Nexus index allows tools like Nexus and m2eclipse to quickly locate artifacts in a repository.
2:05	Manipulating Artifact Metadata – you can modify, view, and search repository metadata that is associated with each repository artifact.
2:13	Custom Metadata – you can define your own custom metadata
2:40	Walkthrough of the Nexus Hosted Repository configuration options.
3:05	Defining available mirrors for Hosted Repositories
3:23	Hosted repository summary information
3:35	Searching custom metadata