Installation & Setup Document

Last reviewed May 26

th
2009
Version 1.1
Table of Content
Overview...........................................................................................3
Setup Database................................................................................3
Install IDE..........................................................................................3
Install Eclipse Plug-in......................................................................3
Setup Project....................................................................................4
Confguration....................................................................................5
2
Overview
The purpose of this docuent is to !ive the "asic steps that are re#uired to setup the
pro$ect in your deve%opent environent.
Setup Database
&nsta%% data"ase 'My()L * http+,,www.ys#%.co, -. ()L/o!
'http+,,www.we"yo!.co,en, - is the su!!ested data"ase 01& c%ient.
2reate data"ase naed 3ya%unid"4 without #uotes
5dd user 3ya%uniuser4 with password 3ya%unipswd4 to data"ase
Install IDE
&nsta%% 6c%ipse 3.2 'http+,,www.ec%ipse.or!,down%oads,- with My6c%ipse
6nterprise 7or8"ench 5.5.1 'http+,,www.yec%ipseide.co,-. 9ote+ I noticed
that Eclispe 3.3 with MyEclipse 6.5 is not compatible with ivy.
Install Eclipse Plug-in
2reate an update site for the p%u!*in 'The directions ay vary s%i!ht%y di:erent
dependin! on what version of 6c%ipse you are usin!. "ut the idea is the sae across
a%% 3.; re%eases. These directions are speci<c to 6c%ipse 3.2-.
&nsta%% the fo%%owin! p%u!*ins+
=%u!*in 9ae 1pdate (ite 7e"site
(u"c%ipse http+,,su"c%ipse.ti!ris.or!,update>1.0.
;
http+,,su"c%ipse.ti!ris.or!,
$ode http+,,www.technoetic.co,ec%ipse,up
date
http+,,$ode.sourcefor!e.ne
t,
(e%ect elp ! Software "p#ates ! $in# an# Install. (e%ect Searc% for
new features to install. 2%ic8 &e't.
2%ic8 the &ew (emote Site "utton. 0ive the update site a nae of your
choice. such as the nae of the p%u!*in. and type in the update site 1?L .
2%ic8 O). 5 new update site wi%% "e added to the %ist.
2hec8 the update site that you want to update fro 'you ay se%ect ore
than one@-. 2%ic8 $inis%
3
&f the update site has severa% irrors '%i8e the 6c%ipse update site- se%ect the
irror you wish to update fro. 2%ic8 O).
=ress the A "utton ne;t to the p%u!*in you want to insta%%. This wi%% %ist a%%
possi"%e features you can insta%%. (e%ect the features that you want to insta%%.
2%ic8 &e't.
/ou wi%% need to accept the ters of the %icense a!reeent's- of the feature's-
that you are insta%%in!. 2%ic8 &e't.
5 %ist of feature's- you are insta%%in! wi%% "e provided. 2%ic8 $inis% to start the
insta%%.
/ou wi%% need to verify the features that you insta%%ed. 2%ic8 Install or Install
*ll to <nish the insta%%ation.
/ou wi%% now "e as8ed to restart the wor8"ench. 2%ic8 +es.
Setup Project
Launch 6c%ipse
,in#ow B S%ow -iew B S-& (epositor.
?i!ht c%ic8 in the %eft pane%. se%ect &ew B (epositor. /ocation
6nter https://myalumni.googlecode.com/svn/trunk/myalumni as the 1?L.
?i!ht c%ic8 on repository %ocation in the %eft pane% and se%ect 3Checkout4
(e%ect radio "utton 3heck out as a pro!ect con"gured using the #ew $ro!ect
%i&ard4
(e%ect radio "utton 3'ead (evision4
2%ic8 Cinish and the 9ew =ro$ect wiDard coes up.
(e%ect 3%eb $ro!ect4
2%ic8 9e;t and the 2reate a 7e" =ro$ect wiDard coes up.
6nter the fo%%owin! va%ues
i0 =ro$ect 9ae+ m.alumni
ii0 (ource Co%der+ src
iii0 7e" root fo%der+ web
iv0 2ontect root 1?L+ 1m.alumni
v0 E266 (peci<cation Leve%+ 23EE 405
vi0 E(TL (upport+ unc%ec6e#
2%ic8 Cinish
5fter the pro$ect is created. ri!ht c%ic8 on the 3ya%uni4 pro$ect and se%ect
properties
(e%ect 3Java Build Path4
(e%ect the 3Libraries4 ta"
2%ic8 on 3Add Jars4 "utton
(e%ect a%% the $ar <%es that are avai%a"%e after e;pandin! the ya%uni pro$ect.
even those in the su"fo%ders.
2%ic8 FG to add the
4
Configuration
Make sure to assign a value to the )ollowing keys
Hata"ase ',sprin!.properties-
IMy()L data"ase driver
o driverJco.ys#%.$d"c.Hriver
I the &= 5ddress where there data"ase resides
o d"ipJ%oca%host
I The nae of the data"ase
o d"naeJya%unid"
I The port which the data"ase is %istenin! on
o d"portJ3306
I Hata"ase 1sernae
o usernaeJya%uniuser
I Hata"ase =assword
o passwordJya%unipswd
I =ath to ys#%dup. 1sed for HK "ac8up
o d"pathJL=5TMB,LTFB,L()L H&?B,"in,
e.g /usr/local/mys*l/bin/
(yste =aths ',syste.properties-
The paths provided are to serve as e;ap%es.
o 5==.MFM6=5TM7<MYALUMNI_PAT!/76K*&9C,y5%uniMoe,
o 5V5T5?.C&L6=5TMJ<MYALUMNI_PAT!/up%oad,e"eravatars,
o LF0C&L6.C&L6=5TMJ<MYALUMNI_PAT!,76K*
&9CNNy5%uniMoeNN%o!NN
o K52G1=.C&L6=5TMJ<MYALUMNI_PAT!,76K*
&9C,y5%uniMoe,"ac8up,
#ote: %here +M,-./M#I0$-1'2 is the path to your applications home directory. E.g.
2+NNappserverNNapache*tocatNNwe"appsNNya%uniNN
5%so ree"er to use the forward sp%ash 3,4 for uni; paths and two "ac8 s%ash 3NN4
for windows type paths.
6ai% ',ai%.properties-
o mail0smtp0usernameJL1(6?95M6B
o mail0smtp0passwor#JL=5((7F?HB
o mail0smtp0%ostJstp.!ai%.co
o mail0smtp0#efault0fromJL6M5&L 5HH?6((B
Lo!!in! ',%o!4$.properties-
o log5j0appen#er0$I/E0$ileJLM/5L1M9&>MFM6!1log1m.alumni0log
5
%here +M,-./M#I0'3ME2 is the path to your applications home
directory. E.g. :44apache5tomcat44webapps44myalumni44%E65
I#744my-lumni'ome44log44myalumni.log
6