Repository Management with Nexus
Capabilities are features of Nexus and Nexus plugins that can be configured by a user in the generic administration view accessible in the left hand navigation menu Administration under Capabilities.
In many cases you will not need to configure anything in Capabilities unless explicitly instructed to do so by the Sonatype support team. Execute any capability changes with caution, potentially backing up your configuration before proceeding.
Nexus Professional ships with a number of capabilities pre-installed and allows you to enable/disable them. An example capability is Outreach Management displayed in Figure 6.23, “Capabilities Management Interface with the Outreach Management Details Visible”. The capabilities management interface supports adding new capabilities by pressing the New button, copying a selected capability from the list by pressing the Duplicate button and deleting a selected capability with the Delete button. Pressing the Refresh button updates the list of capabilities. The list of capabilities can be filtered with the search input box in the header of the list and sorted by the different columns by pressing a column header. The list uses the following columns:
- The status column does not have a title. Enabled capabilities have a green checkmark added on top of a blue icon. Disabled capabilities use a greyed out icon.
- the specific type of the capability
- optionally the wider context the capability belongs to
- optionally the repository the specific capability is configured for
- a description of the capability
- user created notes about the capability
Every capability can be inspected and configured by selecting it in the list and using the tabs underneath the list.
The Summary tab displays the Type of the capability as well as optionally the Description, the Category and the Repository. The Notes field can be used to provide a descriptive text about the capability or any other notes related to is and can be persisted by pressing the Save button.
The Settings tab allows you to activate or deactivate the capability with the Enabled checkbox. Below this checkbox each capability type has specific additional configuration parameters available. Pressing the help icon beside the input field or checkbox reveals further information about the specific parameter. Once you have complete the configuration it can be, you should not forget to press the Save button.
The Status tab displays a text message that details the status of the capability and any potential problems with the configuration. Depending on the capability the reasons can vary widely. For example the Secure Central capability requires Nexus to run on a JVM with specific security features and an error message with indicate, if the JVM is not suitable and an error message regarding this will be displayed.
The About tab displays a descriptive text about the purpose of the capability.
Creating a new capability by pressing the New button will display a new form allowing you to configure the capability in a dialog. The Type drop down allows you to decide what capability to create and a selection changes the rest of the available information and configuration in the dialog. You can configure if the capability should be enabled with the Enabled checkbox. Once you have completed the configuration, press Add and the capability will be saved and appear in the list.
Many of the built-in capabilities and plugins can be configured in the Capabilities administration section, but also in other more user friendly, targetted user interface sections. E.g. the user token feature administrated by using the interface available via the User Token menu item in the Security left hand menu as well as by editing the user token capability. Other capabilities are internal to Nexus functionality and sometimes managed automatically by the responsible plugin. Some optional configuration like e.g. the branding plugin configuration for the icon in the top left hand corner of the user interface header is only done in the capabilities administration.