note Version: 1 2008-01-25

Subject
Install Manual OPUS-College environment - WINDOWS
To ! Simons
CC o"us User #rou"
$rom
Moni%ue in &et Vel!
Mar'us Psc&ei!t (!ate) (!occo!euci)
move
This document is meant for the SYSTEM ADMINISTRATR and the DE!E"#ER
0$ %et insta&&-fi&es from the o'us co&&e(e )e*site
*ll +or most, install--iles in t&is !ocument can be -etc&e! -rom t&e o"us college .ebsite:
&tt"://...0o"uscollege0net/
#o to t&e menu: SUPPO1T
*lso u"!ate--iles in t&e -uture can be -etc&e! -rom t&is .ebsite0
1$ Ste' 1 + ,reate directories ,-./a0a and &o(-director1 and *ac2u'-director1
Create a !irector2 on C:34ava0 *ll t&e -ollo.ing installations .ill be !one into t&is !irector20
*lso create a log-!irector2 an! a bac'u"-!irector2:
C:34ava
C:34ava3logs
C:34ava3bac'u"s
N050 I- C:34ava alrea!2 e6ists7 create anot&er !irector2 t&at is uni%ue0 5ut "lease note t&at t&e
manual an! t&e a""lication assume t&at 2ou use C:34ava0 So it8s best to !o use t&is !irector20
2$ Ste' 2 - /D3 1$5 and confi(uration
2$1 Insta&& the /D3 and the /RE
/D3 4
Win!o.s installation:
Install t&e installation -ile into t&e base !irector2 C:34ava
9:;<=:>=:0!oc Pagina ? van 9: De"lo2Manual OPUS-Collegge
5i(ure 1- After acce'tin( the &icence6 chan(e the insta&&ation 'ath as sho)n in the
screenshot
5i(ure 2- Insta&&ation of /a0a Runtime En0ironment- ,han(e the insta&&ation 'ath as )e&&
9:;<=:>=:0!oc Pagina 9 van 9: De"lo2Manual OPUS-Collegge
2$2 Set 7indo)s en0ironment 0aria*&es
O"en t&e S2stem "ro"erties b2 clic'ing Start Menu @A Settings @A Control Panel @A S2stem0 T&en
c&oose t&e B*!vance!C tab an! select Bnvironment variablesC0 See : -or screens&ots0
5i(ure 8- 'en the En0ironment !aria*&es 9Start :; Settin(s :; ,ontro& #ane& :; S1stem<
T&e -ollo.ing environment variables s&oul! be a!!e!:
5ottom "art environment variables +S2stem variables,:
*!! t&e 4*V*DEOM an! 41DEOM variables:
JAVA_HOME C:\Java\jdk1.6.0_21
JRE_HOME C:\Java\jdk1.6.0_21\jre
Wit& t&e P*TE variable 2ou &ave to be care-ulF *DD t&e -ollo.ing to t&e P*TE7 but DON8T
1MOV *NGTEIN# O$ TE CU11NT P*TE:
Path ;%JAVA_HOME%\jre\bi;%JAVA_HOME%\jre\bi\!"iet
See $igure > -or screens&ots0
9:;<=:>=:0!oc Pagina : van 9: De"lo2Manual OPUS-Collegge
5i(ure =- Define the user and s1stem en0ironment 0aria*&es
2$8 E>tend "M ?ost 5i&e )ith @o'usd*A$
*!! Ho"us!b8 to 2our &ost-ile b2 going to t&e -ollo.ing !irector2:
C:3WINDOWS3s2stem:93!rivers3etc0 O"en t&e -ile &osts -or e!iting0
6ten! t&e line .it& local&ost +or a!! a ne. line .&en t&ere is no local&ost line, .it& t&e -ollo.ing:
127.0.0.1 localhost opusdb
Note: i- 2our !atabase is not on t&e same server as 2our .ebserver7 t&en !o not e6ten! t&e line
.it& ?9I0=0=0?7 but a!! a ne. line .it& t&e correct i0"0-a!!ress7 -or instance:
123.456.999.1 opusdb
8$ Ste' 8 + Insta&& Tomcat 4$0$> Ser0er
8$1 Insta&& the 7e* Ser0er
*"ac&e Tomcat: version ;0=09<0
Win!o.s installation:
Install t&e installation -ile into t&e !irector2 C:34ava a"ac&e-tomcat-;0=0-60
5i(ure 5- Insta&& a Tomcat ser0er *1 e>tractin( the Bi' fi&e
9:;<=:>=:0!oc Pagina > van 9: De"lo2Manual OPUS-Collegge
Gou can start t&e server b2 !ouble clic'ing C:34ava3a"ac&e-tomcat-;0=-63bin3startu"0bat
Gou can sto" t&e server b2 !ouble clic'ing C:34ava3 a"ac&e-tomcat-;0=-63bin3s&ut!o.n0bat
Gou can manage t&e memor2 t&e server .ill use b2 altering t&e C:34ava3 a"ac&e-tomcat-;0=-
63bin3catalina0bat -ile0 *lter t&e -ollo.ing line:
JAVA_OPTS=%JAVA_OPTS% !"...
C&ange it to:
JAVA_OPTS=%JAVA_OPTS% !#$%512& !"...
5i(ure 4- ,hoose the ,-./a0a director1 for e>traction
5i(ure C- 7hen startin( Tomcat6 choose Dn*&oc2 if 1ou (et this a&ert
9:;<=:>=:0!oc Pagina J van 9: De"lo2Manual OPUS-Collegge
5i(ure 8- If the Tomcat start )as 36 1ou shou&d see the &ine ESer0er startu' in >>> msE
5i(ure F- 'en 1our *ro)ser and (o to htt'-GG&oca&host-8080G or to htt'-GG12C$0$0$1-8080G - if
1ou see this screen then 1our Tomcat is runnin( correct&1
8$2 Set 7indo)s en0ironment 0aria*&es + ,ATA"INA ?ME
O"en t&e S2stem "ro"erties b2 clic'ing Start Menu @A Settings @A Control Panel @A S2stem0 T&en
c&oose t&e B*!vance!C tab an! select Bnvironment variablesC0 See $igure : -or screens&ots0
9:;<=:>=:0!oc Pagina ; van 9: De"lo2Manual OPUS-Collegge
5ottom "art environment variables +S2stem variables,:
C*T*KIN*DEOM C:34ava3a"ac&e-tomcat-;0=09<
=$ Ste' = + Insta&& Tomcat 4$0$> Ser0er as a ser0ice
In or!er to ma'e Tomcat start an! sto" .&en 2ou start an! sto" t&e server7 2ou &ave to install it as
a service0
$irst sto" t&e server t&roug&:
Ltomcat-server-!irA/bin/s&ut!o.n0bat
#o to t&e bin-!irector2 o- t&e tomcat-server an! -in! t&e service0bat -ile0 I- it is t&ere7 o"en a
comman! "rom"t0
#o .it& a comman! "rom"t to t&e bin-!irector2 insi!e t&e comman! "rom"t0 T&en t2"e:
Service0bat install
T&e tomcat-server is no. installe! as a service0
#o to t&e service-screen t&roug& Start Menu -A Program $iles -A *!ministrative Tools -A Services
$in! t&e H*"ac&e Tomcat8 service0 C&ange t&e status to Hautomatic80
T&en start t&e service0
5$ Ste' 5 + Insta&& #ost(res Dri0er into Tomcat 4$0$> Ser0er
Dri0er
PostgreSMK Driver: "ostgres%l-N0>-I=?0j!bc>0jar
T&e PostgreSMK-!river nee!s to be "ut in t&e a"ac&e-tomcat/server/ lib !irector20
Co"2 t&e -ile into t&is !irector20 T&en restart t&e a"ac&e tomcat server0
9:;<=:>=:0!oc Pagina I van 9: De"lo2Manual OPUS-Collegge
5i(ure 10- The 'ost(resH&-8$=-C01$Id*c=$Iar fi&e has to *e in the tomcat ser0er &i*rar1
director1
4$ Ste' 4 + Insta&& #ost(reSJ" 8$=$> Data*ase Ser0er
Data*ase
PostgreSMK: version N0>0>0?
Win!o.s installation:
Install t&e installation -ile b2 ste""ing t&roug& it0 $irst 2ou &ave to create an a!min-user0 T&e !e-ault
is "ostgres0 T&en 2ou &ave to "rovi!e a "ass.or!0 T&is can be an2 "ass.or!0 In t&e ne6t ste" 2ou
&ave to ma'e t&e !atabase user0 Ma'e sure 2ou create t&e -ollo.ing as 2our !atabase user:
User: "ostgres
Pass.or!: ?9:'o--ie
T&roug& i5atis t&e !atabase can be a""roac&e! trans"arantl20
9:;<=:>=:0!oc Pagina N van 9: De"lo2Manual OPUS-Collegge
5i(ure 11- Start the #ost(resH& insta&&ation *1 dou*&e c&ic2in( the 'ost(resH&-8$= insta&&er
'ac2a(e$ ,hoose the insta&&ation director1 to ,-./a0a.#ost(reSJ".8$=
9:;<=:>=:0!oc Pagina < van 9: De"lo2Manual OPUS-Collegge
5i(ure 12- The data director1 screen$
9:;<=:>=:0!oc Pagina ?= van 9: De"lo2Manual OPUS-Collegge
5i(ure 18- Set the 'ass)ord to K1282offieL$
9:;<=:>=:0!oc Pagina ?? van 9: De"lo2Manual OPUS-Collegge
5i(ure 1=- ,hoose &oca&e @En(&ish6 Dnited StatesA and &ea0e '&G'(sH& tem'&ate 1 chec2ed$
After)ards continue the )iMard usin( defau&t 0a&ues$
9:;<=:>=:0!oc Pagina ?9 van 9: De"lo2Manual OPUS-Collegge
9:;<=:>=:0!oc Pagina ?: van 9: De"lo2Manual OPUS-Collegge
9:;<=:>=:0!oc Pagina ?> van 9: De"lo2Manual OPUS-Collegge
5i(ure 1=- Dese&ect Stac2*ui&der and c&ic2 E5inishE
5i(ure 15- To test the #ost(resH& insta&&ation6 o'en '(Admin III from the Start Menu :;
#ost(resH& 8$=
9:;<=:>=:0!oc Pagina ?J van 9: De"lo2Manual OPUS-Collegge
5i(ure 14- Dou*&e c&ic2 on the E#ost(reSJ" Data*ase Ser0er 8$= 9&oca&host-5=82<E and enter
the 'ass)ord K1282offieL to connect to the data*ase ser0er$ If it )or2s6 it shou&d &oo2 &i2e
this screen$
C$ Ste' C - ,reate the data*ase
O"en "g*!min to connect to t&e server0 I- t&ere is no server create!7 create one manuall2:
Name: Post'()S*+ "atabas)s)(,)( -.4
Eostname: localhost
Maintenance !b: post'()s
User: post'()s
Pass.or!: 123.o//0)
Create in t&e o"usCollege !atabase in PostgreSMK as s&o.n in t&e screens&ots:
9:;<=:>=:0!oc Pagina ?; van 9: De"lo2Manual OPUS-Collegge
5i(ure 1C- Ri(ht c&ic2 on EData*asesE and choose ENe) data*ase$$$E
9:;<=:>=:0!oc Pagina ?I van 9: De"lo2Manual OPUS-Collegge
5i(ure 18- Enter the 0a&ues as sho)n in the 'icture to create the o'us,o&&e(e data*ase
9:;<=:>=:0!oc Pagina ?N van 9: De"lo2Manual OPUS-Collegge
5i(ure 1F- ,hoose data*ase Eo'us,o&&e(eE$
$irst 2ou !o t&e initial install o- t&e o"uscollege sc&ema an! t&e college mo!ule7 in t&e !irector2:
01stallat0o1_/0l)s_s)(,)(_ad$01s_V3.02databas)_sc(0pts
2ou .ill -in! all necessar2 -iles0
Ste" on t&e !atabase o"usCollege an! c&oose t&e icon SMK .it& t&e "encil0
T&is o"ens an s%l-%uer2-e!itor0 To a!! t&e language "ls%l to t&e !atabase 2ou -irst &ave to o"en
an! e6ecute t&e -ile 30_000_opuscoll)')_,)(s0o130_plp's3l.s3l
as -ollo.s:
"g*!min -A s%l e!itor -A -ile -A o"en -A searc& -or -ile belo. -A run
T&en ste" on t&e !atabase o"usCollege again an! rig&t-clic'0 C&oose restore an! go to t&e
-ollo.ing -ile:
30_001_opuscoll)')_,)(s0o130_cl)a1du$p.bac.up
I- 2ou encounter errors on t&is scri"t +as'ing -or user "gs%lN9,7 t&en !o t&e -ollo.ing:
Create Postgres%l login role: "gs%lN9
To -ill t&e !atabase .it& t&e !e-ault values -or initial institutions an! some loo'u" tables 2ou t&en
&ave to e6ecute:
30_005_opuscoll)')_,)(s0o130_cl)a101s)(t.s3l
9:;<=:>=:0!oc Pagina ?< van 9: De"lo2Manual OPUS-Collegge
Note: -or all insert-scri"ts 2ou &ave to ma'e sure t&e2 are in UT$-N0 I- t&e2 are not7 2ou can alter
t&em as -ollo.s:
Linux: Edit the fle with vim.
Type the following:
:set
You see all confguration, including:
fleencoding=latin
fleencodings=utf!",latin
To change the encoding, press E#TE$ and type the following:
:set fleencoding=utf!"
Then save the fle, it will now %e saved in the new encoding.
I- 2ou .ant to install some o- t&e mo!ules7 2ou s&oul! also e6ecute t&e s%l--iles .&ic& belong to
t&at s"eci-ic mo!ule:
9==-9<<-range: -ee
:==-:<<-range: sc&olars&i"
>==-><<-range: re"ort
J==-J<<-range: alumni
OOO-OOO-range: moPambi%ue
OOO-OOO-range: Pambia
Note: al.a2s e6ecute t&e -iles in ascen!ing or!er -ollo.ing t&eir numbers0
In t&e course o- t&e "roject t&ere .ill be ne. u"!ate--iles again0 Gou can e6ecute t&em -rom t&e
!irector2:
updat)_/0l)s_s)(,)(_ad$01s2
In t&e u"!ate -iles t&e same ranges o- numbers are being maintaine!7 so i- 2ou are not installing
an2 o- t&e mo!ules7 2ou !on8t &ave to install u"!ate -iles in t&e range o- t&ose mo!ules0
8$ Ste' C - De'&o1 the a''&ication
Ta'e t&e .ar -ile "rovi!e! b2 t&e !evelo"ers an! co"2 it into t&e a"ac&e-tomcat/.eba""s !irector20
T&e server .ill start to !e"lo2 t&e -ile imme!iatel20 I- t&is !oesn8t &a""en7 t&en restart t&e server0
*n initial .ar--ile is "rovi!e! in t&e installation !irector2 +.ar-ile3collegeQ-eeQre"ortQsc&olars&i",
9:;<=:>=:0!oc Pagina 9= van 9: De"lo2Manual OPUS-Collegge
5i(ure 20- ,o'1 the eSDRA$)ar fi&e into TomcatNs )e*a'' director1 to de'&o1 the
a''&ication
5i(ure 21- 'en 1our *ro)ser and (o to htt'-GG&oca&host-8080GeSDRA to see if the
de'&o1ment has *een successfu&
Note: i- 2ou nee! to reinstall t&e .ar--ile7 t&e best is to !o t&is t&roug& t&e Tomcat management
console0 5ut i- 2ou are !eleting t&e -iles t&emselves7 t&en !o not -orget to remove all t&ese:
9:;<=:>=:0!oc Pagina 9? van 9: De"lo2Manual OPUS-Collegge
/Ltomcat-!irA/.eba""s/eSU1*/ L an! all un!erl2ing !irectories A
/Ltomcat-!irA/.eba""s/eSU1*0.ar
/Ltomcat-!irA/con-/Catalina/local&ost/eSU1*06ml +automaticall2 generate! FF,
DATAOASE MAINTENAN,E
1$ ,reate the *ac2u' fi&e
To ma'e a bac'u"7 go to "g*!min7 select t&e !atabase +o"usCollege, an! c&oose B5ac'u"RC -rom
t&e Tools menu0 T&e o"tion &as to be HCOMP1SS80
T&en c&oose a location .&ere to save t&e -ile0 C&oose a -ilename -or t&e bac'u" -ile0
T&e e6tension .ill be 08bac'u"80
2$ Restore the *ac2u' fi&e
To restore t&e !atabase -rom 2our bac'u" -ile7 2ou nee! to !ro" t&e sc&ema -rom t&e !atabase:
select t&e sc&ema +o"uscollege, an! c&oose HD1OP Casca!e!8 -rom t&e Tools Menu0
T&en select t&e !atabase0 T&en select B1estoreRC -rom t&e Tools menu0 $in! t&e bac'u"--ile an!
e6ecute it7
8$ Ma2in( manua& *ac2u's of the data*ase
#o .it& a comman! "rom"t to t&e !irector2 .&ere Postgres is installe!0 T&en go to t&e bin-
!irector2:
C:34ava3PostgreSMK3N0>3bin
Eere 2ou -in! comman!s to !um" an! restore t&e !atabase: "gD!um"0e6e0 *n! t&e reverse action:
"gDrestore0e6e0
Gou can run t&ese comman!s -rom t&e comman!-line7 using t&e -ollo.ing o"tions0
T&e rig&t s2nta6 is:
"gD!um"0e6e -i -& local&ost -" J>:9 -U "ostgres -$ c -b -v -- SC:3java3bac'u"s3o"uscollege0bac'u"S
So"usCollegeS
Note- to &o(on to #ost(res 1ou need 1our data*ase-account 9the second account 1ou
created )hen creatin( the data*ase ser0er<6
See: PostgresDComman!s0!oc -or !etails about t&e s2nta60
#%PRESTRE
O- course 2ou can !o a restore .it& t&e Postgres a!min tool0 Gou can -ollo. t&e instructions above
an! t&en c&oose t&e location C:34ava3bac'u"s3 an! t&en t&e -ile "gD!um"Do"uscolleg0bac'u"0
Eo.ever7 i- 2ou .ant to c&oose 2our o.n o"tions on restoring7 t&en 2ou can !o t&is manuall20
T&ere-ore go .it& a comman! "rom"t to t&e !irector2 .&ere Postgres is installe!0 T&en go to t&e
bin-!irector2:
9:;<=:>=:0!oc Pagina 99 van 9: De"lo2Manual OPUS-Collegge
C:34ava3PostgreSMK3N0>3bin
Eere 2ou -in! comman! to restore t&e !atabase: "gDrestore0e6e0
Gou can run t&is comman! -rom t&e comman!-line7 using t&e -ollo.ing o"tions0
T&e rig&t !e-ault s2nta6 is:
"gDrestore0e6e -i -& local&ost -" J>:9 -U "ostgres -! So"usCollegeS -v
SC:3java3bac'u"s3o"uscollege0bac'u"S
See: PostgresDComman!s0!oc -or !etails about t&e s2nta60
=$ Ma2in( automatic *ac2u's of the data*ase
Gou can also ma'e a batc& job to run t&e bac'u" automaticall20
$irst co"2 t&e !irector2 tas's to C:34ava0 In t&e !irector2 2ou -in! a -ile H"gD!um"Do"uscollege0bat8
T&en create a !irector2 C:34ava3bac'u"s0
Gou can !ouble-clic' t&e bat--ile to e6ecute it an! see i- it .or's0
T&en go to C:3WINDOWS3Tas's0 Create a ne. tas'0 Call it HDum" O"usCollege80
T&en assign t&e tas' to t&e *!ministrator user o- t&e mac&ine an! give in t&e "ass.or! o- t&is user0
DO NOT assign t&e tas' to t&e "ostgres user7 since it &as not enoug& rig&ts to e6ecute t&e tas'0
+Note: Wit&in t&e batc&job t&e *!ministrator user gives t&e tas' to 2our "ostgres user0,
Gou can !o t&e same -or t&e restore job0 Gou can also -in! it in Htas's8: -ile
H"gD!um"Do"uscollege0bat80 Call t&e tas' H1estore O"usCollege80
9:;<=:>=:0!oc Pagina 9: van 9: De"lo2Manual OPUS-Collegge