Nuxeo5 - Continuous Integration

Slide 1: 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 jeanmarie.pascal@gmail.com

Slide 2: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 2

Slide 3: Configuration Used  Operating System :  Windows XP SP2  Processor  Intel Core 2 Duo  Computer memory  2Gb (1Gb Minimum Required) 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 3

Slide 4: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 4

Slide 5: INTRODUCTION

Slide 6: 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 Putty • SSH WinSCP 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 6

Slide 7: Architecture 3 4 1 6 2 5 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 7

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

Slide 9: Creating a Virtual Machine  Clic on the picture to see a screencast 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 9

Slide 10: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 10

Slide 11: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 11

Slide 12: Ubuntu configuration  Verify your connexion with WinSCP   Login  05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 12

Slide 13: Ubuntu configuration  Verify your connexion with Putty   Login  05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 13

Slide 14: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 14

Slide 15: 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?actio https://help.ubuntu.com/community/AptGet/Howto?acti 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 15

Slide 16: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 16

Slide 17: Installation of mandatory Software to accomplish continuous integration

Slide 18: JVM Installation  Connect to your Ubuntu Server with putty :  sudo apt-get install sun-java6-jdk 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 18

Slide 19: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 19

Slide 20: 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?h 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 20

Slide 21: 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>'); 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 21

Slide 22: MySQL Installation  Restart Mysql  sudo /etc/init.d/mysql restart  Check yout installation  mysql -u root -p <password> 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 22

Slide 23: MySQL GUI Tools Installation  Download the last version of MySQL GUI Tools  Ressource : Mysql GUI Tools   Follow installation wizard instructions 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 23

Slide 24: MySQL GUI Tools Installation  Run MySQL Administrator  Check your connexion 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 24

Slide 25: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 25

Slide 26: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 26

Slide 27: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 27

Slide 28: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 28

Slide 29: SVN Installation  For more informations :  https://help.ubuntu.com/community/Subversion  http://svnbook.red-bean.com/  http://doc.ubuntu-fr.org/subversion 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 29

Slide 30: Continuum Installation

Slide 31: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 31

Slide 32: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 32

Slide 33: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 33

Slide 34: Continuum Installation : Creating Database  Connect to MySQL with GUI Tools  Create a schema continuum and users Right-clic 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 34

Slide 35: Continuum Installation : Creating a user  Create Integrateur user 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 35

Slide 36: Continuum Installation : Privilege on database  Give all privileges to integrateur on continuum and users schemas 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 36

Slide 37: Continuum Installation  Edit /opt/continuum-1.1/conf/plexus.xml file  Change datasources declaration for continuum and users 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 37

Slide 38: Continuum Installation  Edit /opt/continuum-1.1/conf/plexus.xml file  Change jetty port to 8090 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 38

Slide 39: 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/ 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 39

Slide 40: First Launch  Complete the administrator form  Next login 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 40

Slide 41: First Launch  By default, we keep the original configuration  Continuum is now ready. 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 41

Slide 42: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 42

Slide 43: Archiva Installation

Slide 44: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 44

Slide 45: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 45

Slide 46: Archiva Installation : Creating Database  Connect to MySQL with GUI Tools  Create a schema archiva Right-clic 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 46

Slide 47: Archiva Installation: Privileges on database  Give all privileges to integrateur on archiva schema 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 47

Slide 48: Archiva Installation  Edit /opt/apache-archiva-1.0.2/conf/plexus.xml file  Change datasources declaration for archiva and users 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 48

Slide 49: Installation d’Archiva  Edit /opt/apache-archiva-1.0.2/conf/plexus.xml  Change jetty port to 8091 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 49

Slide 50: 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/ 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 50

Slide 51: First Launch  No Administrator form to complete !  It’s the same as Continuum  Login to admin 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 51

Slide 52: Archiva Administration  Add all « Proxy Connectors » to Nuxeo Respositories (releases) 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 52

Slide 53: Archiva Administration  Add all « Proxy Connectors » to Nuxeo Respositories (Snapshots) 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 53

Slide 54: Archiva Administration  Do the same operation defined in previous slides to have the same results as pictures below : 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 54

Slide 55: Deployment and continuous integration with a Nuxeo module Project

Slide 56: 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 ) ask Books nAnt T Mod ule My- o latio uxe pi S ource N Com Server JBoss 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 56

Slide 57: SVN : Add a project 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 57

Slide 58: Modifying POM  Open and edit pom.xml file  Add following lines under <properties>  Add following lines inside <build> brackets 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 58

Slide 59: Modifying POM  Add following lines after <scm> brackets 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 59

Slide 60: Editing settings.xml  Create or replace settings.xml in your .m2 directory  (Normally in C:Documents and Settings UserName.m2) 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 60

Slide 61: 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 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 61

Slide 62: Project Compilation  In log fils in your Eclipse console view check the existence of following lines  And of course at the end 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 62

Slide 63: Archiva : Verify project deployment  Make a search, in archiva graphical interface, with blogspot word.  Check the existence of your « snapshot project » 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 63

Slide 64: Continuum : Continuous Integration  Clic on the picture to see a screencast 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 64

Slide 65: 05/15/08 http://opensourceecm.blogspot.com/search/label/Nuxeo 65