7
EUROPEAN COMMISSION DIRECTORATE-GENERAL FOR INFORMATICS ISA Integrated Collaborative Platform European Commission Sonatype Nexus install documentation Date: 25/07/2013 Version: 1.000 Authors: everis Revised by: Approved by: Public: Reference Number:

European Commission - Joinup · EUROPEAN COMMISSION ... LINKS ... Upload the joinup-nexus.war to /tomcat_setup using ftp 3. 3. FIRST TIME CONFIGURATION

Embed Size (px)

Citation preview

Page 1: European Commission - Joinup · EUROPEAN COMMISSION ... LINKS ... Upload the joinup-nexus.war to /tomcat_setup using ftp 3. 3. FIRST TIME CONFIGURATION

EUROPEAN COMMISSION DIRECTORATE-GENERAL FOR INFORMATICS ISA Integrated Collaborative Platform

European Commission

Sonatype Nexus install documentation

Date: 25/07/2013

Version: 1.000

Authors: everis

Revised by:

Approved by:

Public:

Reference Number:

Page 2: European Commission - Joinup · EUROPEAN COMMISSION ... LINKS ... Upload the joinup-nexus.war to /tomcat_setup using ftp 3. 3. FIRST TIME CONFIGURATION

TABLE OF CONTENTS

1. PREREQUISITES .................................................................................................................................... 3

1.1. Nexus work directory configuration......................................................................................................... 3

1.2. MySQL DataSource on Tomcat................................................................................................................. 3

2. INSTALLATION ...................................................................................................................................... 3

3. FIRST TIME CONFIGURATION................................................................................................................ 4

3.1. Change admin password .......................................................................................................................... 5

3.2. Server configuration ................................................................................................................................. 5

3.2.1. Configure the SMTP settings ................................................................................................................. 5

3.2.2. Security settings .................................................................................................................................... 6

3.2.3. Application server settings .................................................................................................................... 6

3.2.4. Default HTTP proxy settings .................................................................................................................. 7

3.2.5. Allow authenticated Application users to log in the User Interface ..................................................... 7

4. REPOSITORY CONFIGURATION ............................................................................................................. 8

4.1. Common ................................................................................................................................................... 8

5. LINKS .................................................................................................................................................... 8

1. PREREQUISITES

Tomcat 5.5 is installed MySQL 5 is installed MySQL Nexus security stored procedures

1.1. NEXUS WORK DIRECTORY CONFIGURATION

Add the following to setenv.sh

-Dplexus.nexus-work={DocumentRoot}/nexus

Where {DocumentRoot} is your DocumentRoot.

1.2. MYSQL DATASOURCE ON TOMCAT

Copy the MySQL JDBC driver to the tomcat common/lib folder http://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.17/mysql-connector-java-5.1.17.jar

Add the following xml element to the tomcat context.xml file

<Resource name="jdbc/drupal" auth="Container"

Page 3: European Commission - Joinup · EUROPEAN COMMISSION ... LINKS ... Upload the joinup-nexus.war to /tomcat_setup using ftp 3. 3. FIRST TIME CONFIGURATION

type="javax.sql.DataSource" maxActive="100" maxIdle="30" maxWait="10000" validationQuery="SELECT 1" testOnBorrow="true" username="********" password="********" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://your-site:3306/app_drupal " />

and fill in the following attributes

username password url

Restart Tomcat

2. 2. INSTALLATION

1. Download the web application (eg: nexus-drupal-realm-1.0.0-20120425.082314-1.war) from

https://joinup.ec.europa.eu/nexus/content/groups/public/eu/europa/ec/joinup/joinup/nexus-drupal-realm/1.0.0-SNAPSHOT/

2. Rename the file to joinup-nexus.war

3. Upload the joinup-nexus.war to /tomcat_setup using ftp

3. 3. FIRST TIME CONFIGURATION

Navigate to the Nexus console https://your-application/app-nexus/index.html

Page 4: European Commission - Joinup · EUROPEAN COMMISSION ... LINKS ... Upload the joinup-nexus.war to /tomcat_setup using ftp 3. 3. FIRST TIME CONFIGURATION

Log in using the default admin credentials: admin/admin123

3.1. CHANGE ADMIN PASSWORD

Security > Change password

Page 5: European Commission - Joinup · EUROPEAN COMMISSION ... LINKS ... Upload the joinup-nexus.war to /tomcat_setup using ftp 3. 3. FIRST TIME CONFIGURATION

More detailed information: http://books.sonatype.com/nexus-book/reference/install-sect-repoman-post-install.html#_step_1_change_the_administrative_password_and_email_address

3.2. SERVER CONFIGURATION

Administration > Server

3.2.1. Configure the SMTP settings

Hostname localhost

Port 25

More detailed information: http://books.sonatype.com/nexus-book/reference/configxn-sect-customizing-server.html

3.2.2. Security settings

Select "Drupal realm" and move it from the available realms to selected realms

Page 6: European Commission - Joinup · EUROPEAN COMMISSION ... LINKS ... Upload the joinup-nexus.war to /tomcat_setup using ftp 3. 3. FIRST TIME CONFIGURATION

More detailed information: http://books.sonatype.com/nexus-book/reference/configxn-sect-customizing-server.html#_security_settings

3.2.3. Application server settings

Force Base URL checked

More detailed information: http://books.sonatype.com/nexus-book/reference/configxn-sect-customizing-server.html#_application_server_settings

3.2.4. Default HTTP proxy settings

More detailed information: http://books.sonatype.com/nexus-book/reference/configxn-sect-customizing-server.html#config-default-http-proxy

Page 7: European Commission - Joinup · EUROPEAN COMMISSION ... LINKS ... Upload the joinup-nexus.war to /tomcat_setup using ftp 3. 3. FIRST TIME CONFIGURATION

3.2.5. Allow authenticated Application users to log in the User Interface

As admin, ensure the "Authenticated user Drupal" role exists in Security > Roles; if not, click Add "External Role Mapping" and fill the first form this way:

Realm: Drupal User Manager Role: Authenticated user Drupal

Click "Create Mapping".

The second form is automatically created with the following values:

Role Id: drupal_authenticated Name: Authenticated user Drupal Description: External mapping for Authenticated user Drupal (Drupal)

Click "Add" and check:

Nexus Anonymous Role Repo: All Repositories (Read) UI: Base UI Privileges Artifact Upload

Click "OK" then "Save".

4. REPOSITORY CONFIGURATION

4.1. COMMON

The parameter "Enable redeploy" should be activated in order to avoid having problems during a project deploymeent which contains subprojects. If one module is failing, the redeployement allows the user to redeploy the whole project. From the administration of both repositories (releases & snapshots), you can modify the value of the configuration.

5. LINKS

Nexus documentation: http://www.sonatype.com/resources/books/repository-management-with-nexus