Upload
vunguyet
View
213
Download
0
Embed Size (px)
Citation preview
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:
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"
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
Log in using the default admin credentials: admin/admin123
3.1. CHANGE ADMIN PASSWORD
Security > Change password
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
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
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