WISPRInstallationandSetupInstructions RequiredSoftware 1. InstallJava(>1.5)fromhttp://java.sun.com/javase/downloads/index.jsp a. 1.5wasusedtodevelopwispr 2. InstallMavenfromhttp://maven.apache.org/ a. Clickinstallationinstructionsformoreinformationoninstalling maven 3. Installtomcatonserverorlocalmachinefromhttp://tomcat.apache.org/ (version5.5wasusedfordevelopment) a. Refertodocumentationforinstallationinstructions 4. InstallAntfromhttp://ant.apache.org/ a. Refertothemanualforinstallationinstructions 5. Installmysqlonserverorlocalmachinefromhttp://www.mysql.com a.

a. ClickDownloadsandselectMySQLCommunityServer Gettingthecode 1. DownloadtheWISPRsourcecode a. UsingSVN:svncohttps://svn1.ucalgary.ca/wispr Modifythebuild.propertiesfile 1. Locatethebuild.propertiesfileinwispr/trunk 2. Modifylog.file 3. ****Modifymysql.connection.url,mysql.connection.usrand mysql.connection.pass**** Modifythebuild.devshare.propertiesfile 1. Locatethebuild.devshare.propertiesfileinwispr/trunk/src/main/filters 2. Modifythesettingsfordebug 3. ****Modifymysql.connection.url,mysql.connection.usrand mysql.connection.pass**** Modifytheconfig.propertiesfile 1. Locatetheconfig.propertiesfilein wispr/trunk/src/main/resources/ca/ucalgary/commons/wispr 2. Changetheseparatorvaluedependingonserverplatform 3. ChangeEmailproperties 4. ChangethetimeZonevariable 5. Changelocalroottoreflectserverfilestructure a. Mustcreatepublicdirectoryonserverforfileupload/download 6. Changebaseurlforaccesstolocalrootfiles

 CreatetheDatabaseanduser 1. Usingmysql,createthedatabasewisprby: createdatabasewispr; 2. Createamysqluserby: grantallonwispr.*towispr_user@someserveridentifiedby'wispr'; seehibernate.cfg.xmlformoreinformation RunMVNInstall 1. Opencommandterminalandcdtowispr/trunk Run:mvninstallDmaven.test.skip=true Buildthedatabasetables Usingantwillrunthescriptslocatedinbuild.xml(locatedinwispr.trunk) 1. Openaterminaltouseant 2. cdintowispr/trunk a. runthecommand:antdb.create b. Verifythatthetableshavebeenaddedtothedatabase Note:ifdb.createdoesnotworkforsomereason,downloadamysqlDBdumpat http://webapps3.tlc.ucalgary.ca/wispr_install/wispr_dump17.03.2009.sql Adddefaultinformationtodatabase 1. Changeanydefaultinformationforapplication(suchascoursecontent, logbookquestions,anddefaultusers)inDatabaseUtils.java a. Defaultadminloginisusernameadminwithpasswordwisprs 2. Adddefaultdatabyrunningcommand:antdb.addSampleData(Thisstepis requiredasalldefaultcoursecontent,logbookcontentandadminusersmust beaddedtothedatabase) LDAPsettings IfLDAPauthenticationisbeingusedtheLDAPsettingscanbechangedin java/authentication/LdapVerification.java.Otherwise,WISPRaccountswillhaveto becreatedforeachuserusingtheusermanagementinterfaceasWISPRAdmin. DeployWISPRApplication 1. Locatethewispr.warfileinwispr/trunk/target 2. Copy.warfiletotomcat/webapps

 Ifworstcomestoworst,andnothingelseisworking 1. DownloadandunziptheprebuiltWISPRapplicationavailableat http://webapps3.tlc.ucalgary.ca/wispr_install/wispr2.0SNAPSHOT.zip 2. Modifytheconfig.propertiesfileasdescribedabove 3. Modifythehibernate.cfg.xmlfile(mysqlconnectionsettings) a. Changetheconnection.urlproperty b. Changetheconnection.usernameproperty c. Changetheconnection.passwordproperty 4. DownloadtheDBsqlfileathttp://webapps3.tlc.ucalgary.ca/wispr_install/ wispr_dump17.03.2009.sql a. ImportthesqlfileintoMySQLDB 5. PlacewebappinTomcatandstartTomcatservice Note:Atleastthismethodwillgetyoutheprebuiltwebappfiles,whichthencouldbe modified.Thisisalastresortandisnotguaranteedtowork.

3. Startorrestarttomcat 4. WISPRapplicationshouldnowberunning 5. CreateacustomURLoratveryleastasymboliclinktowispr2.0SNAPSHOT intomcat