Nuxeo EP 5 How to create a virtualized continuous integration machine with VmWare and an Ubuntu Server 7.10 for compilation and integration of a Nuxeo Module Jean Marie PASCAL [email_address]

Install Ubuntu 7.10 Server (VmWare + OS Installation) Install mandatory continuous integration Install Continuum & Archiva Integrate a Nuxeo Module Project to SVN + Deployment to Archiva Module’s Continuous Integration Goals

Install Ubuntu 7.10 Server (VmWare + OS Installation)

Install mandatory continuous integration

Install Continuum & Archiva

Integrate a Nuxeo Module Project to SVN + Deployment to Archiva

Module’s Continuous Integration

Configuration Used Operating System : Windows XP SP2 Processor Intel Core 2 Duo Computer memory 2Gb (1Gb Minimum Required)

Operating System :

Windows XP SP2

Processor

Intel Core 2 Duo

Computer memory

2Gb (1Gb Minimum Required)

Pre-requisites Installation of VmWare (Server installation) Putty (Command lines) WinSCP (File Transfert) Install a development environment with Eclipse CF. Slideshow : Nuxeo 5 - Installation avec Eclipse CF. Screencast : Nuxeo 5 - Création d’un type de document Basic knowledge on Linux commands

Installation of

VmWare (Server installation)

Putty (Command lines)

WinSCP (File Transfert)

Install a development environment with Eclipse

CF. Slideshow : Nuxeo 5 - Installation avec Eclipse

CF. Screencast : Nuxeo 5 - Création d’un type de document

Basic knowledge on Linux commands

INTRODUCTION

Architecture IntegrationContinue Ubuntu Server 7.10 Apache Continuum 1.1 Apache Archiva 1.0.2 Apache Maven 2.0.9 MySQL 5.0.45 Sun JDK 1.6.0.03 Subversion SSH PC-Developpement Windows XP SP2 VmWare Workstation 5.5 Sun JDK 1.5.14 Eclipse 3.3 Apache Ant 1.7.0 Apache Maven 2.0.8 Jboss AS 4.05 MySQL GUI Tools Putty WinSCP

IntegrationContinue

Ubuntu Server 7.10

Apache Continuum 1.1

Apache Archiva 1.0.2

Apache Maven 2.0.9

MySQL 5.0.45

Sun JDK 1.6.0.03

Subversion

SSH

PC-Developpement

Windows XP SP2

VmWare Workstation 5.5

Sun JDK 1.5.14

Eclipse 3.3

Apache Ant 1.7.0

Apache Maven 2.0.8

Jboss AS 4.05

MySQL GUI Tools

Architecture 1 2 3 4 5 6

How to create a VMWare Virtual Machine Ubuntu 7.10 Installation and Configuration

Creating a Virtual Machine Clic on the picture to see a screencast

Clic on the picture to see a screencast

Ubuntu Installation Clic on the picture to see a screencast For more details about Ubuntu 7.10 Installation http://www.ubuntugeek.com/ubuntu-710-gutsy-gibbon-lamp-server-setup.html

Clic on the picture to see a screencast

For more details about Ubuntu 7.10 Installation

http://www.ubuntugeek.com/ubuntu-710-gutsy-gibbon-lamp-server-setup.html

Ubuntu configuration SSH installation Goal : Creating communication between Putty/Winscp Ubuntu VmWare Server. Type the command : sudo apt-get install ssh Keep your Server IP ifconfig

SSH installation

Goal : Creating communication between Putty/Winscp Ubuntu VmWare Server.

Type the command :

sudo apt-get install ssh

Keep your Server IP

ifconfig

Ubuntu configuration Verify your connexion with WinSCP Login

Verify your connexion with WinSCP

Login

Ubuntu configuration Verify your connexion with Putty Login

Verify your connexion with Putty

Login

Enabling Multiverse repositories Connect to your Ubuntu Server with putty : Open sources.list file sudo vi sources.list Add following lines : For more details about repositories : https://wiki.ubuntu.com/AlwaysEnableUniverseMultiverse?highlight=%28multiverse%29

Connect to your Ubuntu Server with putty :

Open sources.list file

sudo vi sources.list

Add following lines :

For more details about repositories :

https://wiki.ubuntu.com/AlwaysEnableUniverseMultiverse?highlight=%28multiverse%29

Updating your system Connect to your Ubuntu Server with putty : sudo apt-get update sudo apt-get upgrade For more details about apt-get command https://help.ubuntu.com/community/AptGet/Howto?action=show&redirect=AptGet

Connect to your Ubuntu Server with putty :

sudo apt-get update

sudo apt-get upgrade

For more details about apt-get command

https://help.ubuntu.com/community/AptGet/Howto?action=show&redirect=AptGet

Modifying rights Modifying rights on installation folder Create « Integration » group sudo groupadd groupe_integration Add user « integrateur » to « Integration » group sudo usermod –a –G groupe_integration integrateur Modify right on folder /opt/ Sudo chown –R integrateur:groupe_integration /opt/ For more details about : https://help.ubuntu.com/community/AddUsersHowto

Modifying rights on installation folder

Create « Integration » group

sudo groupadd groupe_integration

Add user « integrateur » to « Integration » group

sudo usermod –a –G groupe_integration integrateur

Modify right on folder /opt/

Sudo chown –R integrateur:groupe_integration /opt/

For more details about :

https://help.ubuntu.com/community/AddUsersHowto

Installation of mandatory Software to accomplish continuous integration

JVM Installation Connect to your Ubuntu Server with putty : sudo apt-get install sun-java6-jdk

Connect to your Ubuntu Server with putty :

sudo apt-get install sun-java6-jdk

Define the environment variables Define the CLASSPATH & JAVA_HOME variable : vi /home/integrateur/.bashrc Add following lines at the end of the file Restart Putty Check the following message is displayed

Define the CLASSPATH & JAVA_HOME variable :

vi /home/integrateur/.bashrc

Add following lines at the end of the file

Restart Putty

Check the following message is displayed

MySQL installation Connect to your Ubuntu Server with putty : sudo apt-get install mysql-server For more details on mysql installation : https://help.ubuntu.com/community/JDBCAndMySQL?highlight=%28mysql%29

Connect to your Ubuntu Server with putty :

sudo apt-get install mysql-server

For more details on mysql installation :

https://help.ubuntu.com/community/JDBCAndMySQL?highlight=%28mysql%29

MySQL Installation Modifying rights to permit remote access sudo vi /etc/mysql/my.cnf Comment the line Edite this line Connect to MySQL with command lines sudo mysql –u root –p To prompt, execute this commands grant all privileges on *.* to 'root'@‘<ip.address>' with grant option; set password for 'root'@’<ip.address'=password(’<password>');

Modifying rights to permit remote access

sudo vi /etc/mysql/my.cnf

Comment the line

Edite this line

Connect to MySQL with command lines

sudo mysql –u root –p

To prompt, execute this commands

grant all privileges on *.* to 'root'@‘<ip.address>' with grant option;

set password for 'root'@’<ip.address'=password(’<password>');

MySQL Installation Restart Mysql sudo /etc/init.d/mysql restart Check yout installation mysql -u root -p <password>

Restart Mysql

sudo /etc/init.d/mysql restart

Check yout installation

mysql -u root -p <password>

MySQL GUI Tools Installation Download the last version of MySQL GUI Tools Ressource : Mysql GUI Tools Follow installation wizard instructions

Download the last version of MySQL GUI Tools

Ressource : Mysql GUI Tools

Follow installation wizard instructions

MySQL GUI Tools Installation Run MySQL Administrator Check your connexion

Run MySQL Administrator

Check your connexion

Maven Installation Download the last version of Maven Ressource : Maven.apache.org Upload this file to folder « /opt/ » with WinSCP Unzip the file tar –xvf apache-maven-2.0.9-bin.tar.gz

Download the last version of Maven

Ressource : Maven.apache.org

Upload this file to folder « /opt/ » with WinSCP

Unzip the file

tar –xvf apache-maven-2.0.9-bin.tar.gz

Define the environment variables Define MAVEN_HOME & PATH variables: vi /home/integrateur/.bashrc Add following lines at the end of the file Restart Putty Check your installation

Define MAVEN_HOME & PATH variables:

vi /home/integrateur/.bashrc

Add following lines at the end of the file

Restart Putty

Check your installation

Subversion Installation Connect to your Ubuntu Server with putty : Install SVN sudo apt-get install subversion Create an installation folder mkdir /opt/svn Go to this directory and create a new repository svnadmin create depot

Connect to your Ubuntu Server with putty :

Install SVN

sudo apt-get install subversion

Create an installation folder

mkdir /opt/svn

Go to this directory and create a new repository

svnadmin create depot

SVN Installation Edit svnserve.conf file vi /opt/svn/depot/svnserve.conf uncomment all lines beginning with # except the line with « authz-db » (Don’t forget to erase the first whitespace on the beginning) Edit passwd file vi /opt/svn/depot/passwd Add following lines Start svn daemon svnserve –d –r /opt/svn/depot

Edit svnserve.conf file

vi /opt/svn/depot/svnserve.conf

uncomment all lines beginning with # except the line with « authz-db »

(Don’t forget to erase the first whitespace on the beginning)

Edit passwd file

vi /opt/svn/depot/passwd

Add following lines

Start svn daemon

svnserve –d –r /opt/svn/depot

SVN Installation For more informations : https://help.ubuntu.com/community/Subversion http://svnbook.red-bean.com/ http://doc.ubuntu-fr.org/subversion

For more informations :

https://help.ubuntu.com/community/Subversion

http://svnbook.red-bean.com/

http://doc.ubuntu-fr.org/subversion

Continuum Installation

Continuum Installation Download the last version of Continuum Ressource : continuum.apache.org Upload this file to « /opt/ » directory with WinSCP Unzip it tar –xvf apache-continuum-1.1.tar.gz

Download the last version of Continuum

Ressource : continuum.apache.org

Upload this file to « /opt/ » directory with WinSCP

Unzip it

tar –xvf apache-continuum-1.1.tar.gz

Continuum Installation : Binding with MySQL Download the last version of MySQL Connector (jdbc) Ressource : MySQL Connector /J5.0 Unzip on your local machine Extract the file mysql-connector-java-5.0.8-bin.jar

Download the last version of MySQL Connector (jdbc)

Ressource : MySQL Connector /J5.0

Unzip on your local machine

Extract the file mysql-connector-java-5.0.8-bin.jar

Continuum Installation : Binding with MySQL Import (local) plexus-appserver-service-jetty-2.0-alpha-8.sar file living in /opt/continuum-1.1/services with WinSCP Use a tool like WinZip to add mysql-connector-java-5.0.8-bin.jar to this file on the directory lib Export this file to /opt/continuum-1.1/services with WinSCP

Import (local) plexus-appserver-service-jetty-2.0-alpha-8.sar file living in /opt/continuum-1.1/services with WinSCP

Use a tool like WinZip to add mysql-connector-java-5.0.8-bin.jar to this file on the directory lib

Export this file to /opt/continuum-1.1/services with WinSCP

Continuum Installation : Creating Database Connect to MySQL with GUI Tools Create a schema continuum and users Right-clic

Connect to MySQL with GUI Tools

Create a schema continuum and users

Continuum Installation : Creating a user Create Integrateur user

Create Integrateur user

Continuum Installation : Privilege on database Give all privileges to integrateur on continuum and users schemas

Give all privileges to integrateur on continuum and users schemas

Continuum Installation Edit /opt/continuum-1.1/conf/plexus.xml file Change datasources declaration for continuum and users

Edit /opt/continuum-1.1/conf/plexus.xml file

Change datasources declaration for continuum and users

Continuum Installation Edit /opt/continuum-1.1/conf/plexus.xml file Change jetty port to 8090

Edit /opt/continuum-1.1/conf/plexus.xml file

Change jetty port to 8090

Continuum Installation Connect to your Ubuntu Server with putty Run continuum sh /opt/continuum-1.1/bin/linux-x86-32/run.sh start Open a web browser Link : http://<IP.ServeurVM>:8090/continuum/

Connect to your Ubuntu Server with putty

Run continuum

sh /opt/continuum-1.1/bin/linux-x86-32/run.sh start

Open a web browser

Link : http://<IP.ServeurVM>:8090/continuum/

First Launch Complete the administrator form Next login

Complete the administrator form

Next login

First Launch By default, we keep the original configuration Continuum is now ready.

By default, we keep the original configuration

Continuum is now ready.

Daemon installation How to define a daemon to run continnum in each start Connect to your Ubuntu server with putty ln -s /opt/continuum-1.1/bin/linux-x86-32/run.sh /etc/init.d/continuum sudo update-rc.d -f continuum defaults 99

How to define a daemon to run continnum in each start

Connect to your Ubuntu server with putty

ln -s /opt/continuum-1.1/bin/linux-x86-32/run.sh /etc/init.d/continuum

sudo update-rc.d -f continuum defaults 99

Archiva Installation

Archiva Installation Download the last version of Archiva Ressource : archiva.apache.org Upload this file to /opt/ with WinSCP Unzip it tar –xvf apache-archiva-1.0.2.tar.gz

Download the last version of Archiva

Ressource : archiva.apache.org

Upload this file to /opt/ with WinSCP

Unzip it

tar –xvf apache-archiva-1.0.2.tar.gz

Archiva Installation : Binding with MySQL Import (locally) plexus-appserver-service-jetty-2.0-alpha-8.sar in /opt/apache-archiva-1.0.2/services directory with WinSCP Use a tool like WinZip to add mysql-connector-java-5.0.8-bin.jar file to this file on the directory lib Export this file to /opt/apache-archiva-1.0.2/services with WinSCP

Import (locally) plexus-appserver-service-jetty-2.0-alpha-8.sar in /opt/apache-archiva-1.0.2/services directory with WinSCP

Use a tool like WinZip to add mysql-connector-java-5.0.8-bin.jar file to this file on the directory lib

Export this file to /opt/apache-archiva-1.0.2/services with WinSCP

Archiva Installation : Creating Database Connect to MySQL with GUI Tools Create a schema archiva Right-clic

Connect to MySQL with GUI Tools

Create a schema archiva

Archiva Installation: Privileges on database Give all privileges to integrateur on archiva schema

Give all privileges to integrateur on archiva schema

Archiva Installation Edit /opt/apache-archiva-1.0.2/conf/plexus.xml file Change datasources declaration for archiva and users

Edit /opt/apache-archiva-1.0.2/conf/plexus.xml file

Change datasources declaration for archiva and users

Installation d’Archiva Edit /opt/apache-archiva-1.0.2/conf/plexus.xml Change jetty port to 8091

Edit /opt/apache-archiva-1.0.2/conf/plexus.xml

Change jetty port to 8091

Archiva Installation Connect to Ubuntu with Putty Run Archiva sh /opt/apache-archiva-1.0.2/bin/linux-x86-32/run.sh start Open a web browser Link : http://<IP.ServeurVM>:8091/archiva/

Connect to Ubuntu with Putty

Run Archiva

sh /opt/apache-archiva-1.0.2/bin/linux-x86-32/run.sh start

Open a web browser

Link : http://<IP.ServeurVM>:8091/archiva/

First Launch No Administrator form to complete ! It’s the same as Continuum Login to admin

No Administrator form to complete !

It’s the same as Continuum

Login to admin

Archiva Administration Add all « Proxy Connectors » to Nuxeo Respositories (releases)

Add all « Proxy Connectors » to Nuxeo Respositories (releases)

Archiva Administration Add all « Proxy Connectors » to Nuxeo Respositories (Snapshots)

Add all « Proxy Connectors » to Nuxeo Respositories (Snapshots)

Archiva Administration Do the same operation defined in previous slides to have the same results as pictures below :

Do the same operation defined in previous slides to have the same results as pictures below :

Deployment and continuous integration with a Nuxeo module Project

Eclipse : Workspace Nuxeo We start with the same workspace defined in my previous screencast about how to create a new document type. (CF. Nuxeo 5 - Création d’un type de document ) Module My-Books Source Nuxeo Server JBoss Compilation Ant Task

We start with the same workspace defined in my previous screencast about how to create a new document type.

(CF. Nuxeo 5 - Création d’un type de document )

SVN : Add a project

Modifying POM Open and edit pom.xml file Add following lines under <properties> Add following lines inside <build> brackets

Open and edit pom.xml file

Add following lines under <properties>

Add following lines inside <build> brackets

Modifying POM Add following lines after <scm> brackets

Add following lines after <scm> brackets

Editing settings.xml Create or replace settings.xml in your .m2 directory (Normally in C:Documents and Settings UserName.m2)

Create or replace settings.xml in your .m2 directory

(Normally in C:Documents and Settings UserName.m2)

Project Compilation Make source compilation and do the deployment with Maven in Eclipse Right-clic on your folder project Menu Run As… Maven Build… In Goals tabs : type deploy Run

Make source compilation and do the deployment with Maven in Eclipse

Right-clic on your folder project

Menu Run As…

Maven Build…

In Goals tabs : type deploy

Run

Project Compilation In log fils in your Eclipse console view check the existence of following lines And of course at the end

In log fils in your Eclipse console view

check the existence of following lines

And of course at the end

Archiva : Verify project deployment Make a search, in archiva graphical interface, with blogspot word. Check the existence of your « snapshot project »

Make a search, in archiva graphical interface, with blogspot word.

Check the existence of your « snapshot project »

Continuum : Continuous Integration Clic on the picture to see a screencast

Clic on the picture to see a screencast