Bemeister Knowledge is the key

________________________________________________________________________________________
W-01: Complete the "Installation" wiki page. Make it a tutorial with a lot of screenshots completely describing what we did and how we did it. Foresee enough links to the useful resources (internal or external).
By Serge and Nic.
________________________________________________________________________________________

Test Environment

Step 1 Install JDK

Install JDK 1.5 update 16: http://java.sun.com/javase/downloads/index_jdk5.jsp

Step 2 MySQL 5.0

MySQL 5.0: http://dev.mysql.com/get/Downloads/MySQL-5.0/mysql-5.0.67-win32.zip/from...

Installation of MySQL 5.0 :

- Click Next >
- Select Typical and Click Next >
- Click Install >
- Click Next >
- Click Next >
- Leave 'Configure the MySQL Server now' checked and click Finish >

- Make sure the 'Include Bin Directory in Windows PATH' is checked

- Click Next >
- Create & comfirm a root password for your MySQL server

- Click Next >

- You can click Finish if all bullets are checked.

Step 3 Open Office

Open Office 2.4: (http://download.openoffice.org/2.4.2/other.html#en-US

Installation of OpenOffice :

Click Next >
Click Next >
Leave Complete Selected and Click > Next >
Click Next >
Click Install >

Click Finish >

Step 4 Alfresco

For production-like testing or initial investigation we will use Alfresco labs 3b. (http://wiki.alfresco.com/wiki/Installing_Labs_3#Windows_download_and_ins...).
The Mini Setup will do since we already have a JDK and we will download Open Office separately. For those who already have Open Office, that's one step less.

Installation of Alfresco :

choose your language and press Ok >

Click Volgende >
Click Volgende >
Click Volgende >
Click Volgende >

Select 'MySQL - Requires MySQL to be already installed and running' and click Volgende >

Enter the root password of your SQL-server and press Volgende >

Click Klaar >

Development Environment

Step 1 Eclipse

Eclipse Ganymede JEE edition (http://www.eclipse.org/downloads/)
Extract eclipse-jee-ganymede-SR1-win32 (where is free to choosse) and run Eclipse.exe to start the application.

- plugin: m2eclipse = maven integration (update site: http://m2eclipse.sonatype.org/update/)
- plugin: subclipse = svn integration (update site: http://subclipse.tigris.org/update_1.4.x)

Open eclipse, go to Help =) Software Updates =) tab Available Software and click add Site

Now you can enter the url of the location you want to use
fill in http://m2eclipse.sonatype.org/update/ & http://subclipse.tigris.org/update_1.4.x

Select the software that needs to be installed (see screenshot below) and press install

Now you should get a review of all that's been installed.

Click Next >
Accept the licence agreements and click Finish >

Now Eclipse will ask to restart the application,
When the aplication has been restarted,
it's possible he'll ask to edit the eclipse.ini file.
This file can be found in the root folder of the Eclipse installation folder.

edit eclipse.ini to let him use the right JDK

add

-vm
C:\Program Files\Java\jdk1.5.0_16\bin\javaw.exe

as shown on the screen below

Step 2 Maven

Maven 2 (http://maven.apache.org/download.html [2.0.9])

Download apache-maven-2.0.9-bin
Extract the content of apache-maven-2.0.9-bin to C:/maven

Go to Environment Variables in Windows and add a new system variable called M2_HOME.

So Variable name : M2_HOME
Variable value : C:/maven

Next, go to the already existing variable 'Path'.
You should add the next line to the value of 'path'-variable : ;%M2_HOME%\bin

If all the variables where edited correctly, you should get the following result when typing 'mvn' in the cli cmd.

Step 3 Alfresco libraries in local maven repo

Since Alfresco does not provide a public maven repo, we need to install the alfresco jars and sources ourselves in our local repo. Therefore a zip has already been prepared by your teacher. The only thing you need to do is unpack and run the install.bat or install.sh.

Step 4 SVN

SVN aanmaken:
- Open Eclipse
- Go to Window
- Open perspective
- Other

- select SVN Repository Exploring

Now you should be able to select SVN Repository on your right
The SVN-view will apear on the left
click the right-mouse-button in the view =) new =) Repository location

Then you can enter the following Url : https://forge.alfresco.com/svn/prod-select

- Select Accept Permanently

Eclipse will ask a username and password, you need to use your forge-account for this

When pressing Checkout, a local copy of the repository will be available in our Package Explorer

now we can update our Dependencies as shownon the screen below

Step 5 Database

Database aanmaken:
Open MySQL Command Line Client
Login with your root password.

Enter the following commands :

create database alf_jetty_ps;

grant all on alf_jetty_ps.* to 'alfresco'@'localhost' identified by 'alfresco' with grant option;
grant all on alf_jetty_ps.* to 'alfresco'@'localhost.localdomain' identified by 'alfresco' with grant option;

Step 6 Maven Run Configuration

- Open Eclipse
- Go to Run Configurations
- Then go to Maven build =) New_Configuration
- Edit the tabs as shown on the screenshots below :

if you don't give a alfresco.data.location, the default is the project-directory/alf_data_jetty.
e.g. C:\Documents and Settings\Administrator\workspace\product-space\alf_data_jetty

On windows machines, an extra entry webapp.log.dir can be specified to .\target
e.g. C:\Documents and Settings\Administrator\workspace\product-space\target

Next you'll need to add the jre 1.5 , click Installed JREs
Click Add
Select Standard VM
Enter C:\Program Files\Java\jre1.5.0_16 and select the JRE 1.5
click Finish

Execution Environment should be J2SE-1.5(jre1.6.0_06)

Enter the correct memory settings in the "VM arguments" textarea. Like below.
You can copy them from here:
-Xms256m
-Xmx512m
-XX:PermSize=128m

If you are running on Windows Vista, please consider another OS, but for now you need to add another VM argument pointing to an external "endorsed" directory.
-Djava.endorsed.dirs=C:\Alfresco\tomcat\endorsed\
This direcory needs to contain following jars: jaxb-api-2.1.jar, xalan.jar, serializer.jar

Click Run

Now Alfresco will start up, using Jetty Server [webcontainer]

Go to http://localhost:8080/alfresco and alfresco website will apeare.
Be sure to close all other local servers on your system.

Result:

Summary