Printing the OpenADR_InstallationGuide pdf instructions is highly recommended to ease the install process.
This guide is has been tested with Microsoft Windows Server 2003 32 bit edition and Windows 7 Professional 64 bit edition.
Windows 7 64 bit users will download and use the same 32 bit versions of the server components outlined in this guide.
Also it is suggested to use the 7zip utility (instead of windows built-in unzip) to correctly and accurately extract the needed jar files and or folders from downloaded zip archives.
(Windows 32 bit) http://sourceforge.net/projects/sevenzip/files/7-Zip/9.20/7z920.exe/download
(Windows 7-64 64 bit) http://downloads.sourceforge.net/sevenzip/7z920-x64.msi
Download (as .zip file) OpenADR toolkit.
Download and Install J2EE SDK and Java SE JRE.
Download and Install OracleXE database.
Configure OpenADR Database Schema.
Download and Install Tomcat 6 Web Application Server.
Download and Install 3rd Party Java Libraries to “requiredLibraries” Directory.
Download and Install Basic Eclipse IDE program.
Build and Execute OpenADR Programs.
Installation complete
Download (as .zip file) OpenADR toolkit.
Extract the OpenADRToolkit_Ver_0_0_1.zip toolkit into C:\ directory using 7-Zip – also it is recommended to use 7-Zip to open the remaining downloaded zip files in this quickstart guide:
(right-click on OpenADRToolkit_Ver_0_0_1.zip > 7-Zip > extract files > extract to: > C:\ )
Download and Install Java SE JRE and J2EE SDK.
Download the "Java SE JRE" (aka Java SE Runtime Environment 6 Update XX with filename equal or similar to jre-6u26-windows-i586.exe or jre-7-windows-i586.exe )
http://www.oracle.com/technetwork/java/javase/downloads/index.html
… so that other OpenADR components will find the java runtime as the J2EE install's version is a in a non-standard location
Also download and Install the "Java EE" JDK + Java EE Bundle (aka Java Platform, Enterprise Edition with JDK) - with filename equal or similar to java_ee_sdk-6u2-jdk-windows.exe or java_ee_sdk-6u3-jdk7-windows.exe
Download and Install OracleXE database components. (You might need to create an account on the oracle website to do so...)
http://www.oracle.com/technetwork/database/express-edition/downloads/102xewinsoft-090667.html
server - OracleEX.exe and client - OracleXEClient.exe – also take note the password you chose (to be re-used below)
Configure OpenADR Database Schema.
Log out and then back-in to have the the Oracle Express programs including the SQLplus utility - used in this next step - available via the command shell
Next configure the database. Open a command shell :
Windows XP / Server 2003 - (start > run > cmd) for windows xp / 2003
Windows 7 / 7-64 - (start > All Programs > Accessories > right-click on “Command Prompt” > Run As Administrator)
and "cd" to the directory containing the database initialization scripts
"cd C:\OpenADR_Toolkit\config\database\OracleXEconfig"
login to the database using the SQLplus command line utility by cutting and pasting the following into the windows command shell
"C:\oraclexe\app\oracle\product\10.2.0\server\BIN\sqlplus.exe"
(modify as necessary to match the exact version you installed)
enter username "system" and the password used during the oraclexe install
then enter
@O2ADRCreation.sql
to setup the initial tables. Once that process is complete - type "quit" and
then re login to the database using SQLplus by repasting
"C:\oraclexe\app\oracle\product\10.2.0\server\BIN\sqlplus.exe" - this time using
"o2adr" as both the username and password.
now complete the database setup by entering commands while in the SQLplus utility
@O2ADRRegistry.sql
and then subsequently
@O2ADRRegistrySequences.sql
Verify database tables setup by browsing to http://127.0.0.1:8080/apex - login as o2adr / o2adr
- you are supposed to see table names such as BLACKOUTDATETIME CONTACTINFORMATION DRASCLIENT ... VALIDDRISSUEDATTIME
Download and Install Tomcat 6 Web Application Server.
http://mirror.atlanticmetro.net/apache/tomcat/tomcat-6/v6.0.33/bin/apache-tomcat-6.0.33.exe
Select 8180 instead of 8080 as the Tomcat ( HTTP/1.1 Connector) port address, and note the admin password (stored in C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf\tomcat-users.xml)
Tomcat automatically starts. To restart tomcat (start > (my) computer (right-click) > manage > services and applications > services > Apache Tomcat 6 > start )
Download and Install the following (11) 3rd Party Java Libraries to the respective folders inside “C:\OpenADR_Toolkit\requiredLibraries”
Use the 7zip utility mentioned above to open zip archives reliably
beanutils
http://apache.mirrors.redwire.net//commons/beanutils/binaries/commons-beanutils-1.8.3-bin.zip
commons-beanutils-1.8.3.jar -> ...requiredLibraries\beanutils
cxf
http://archive.apache.org/dist/cxf/2.3.3/apache-cxf-2.3.3.zip
apache-cxf-2.3.3\lib\* -> ...requiredLibraries\cxf
dozer
http://sourceforge.net/projects/dozer/files/dozer/5.3.2/dozer-5.3.2.jar/download
dozer-5.3.2.jar -> ...requiredLibraries\dozer
hibernate
hibernate-distribution-3.6.2.Final -> ...requiredLibraries\hibernate
httpclient
http://archive.apache.org/dist/httpcomponents/commons-httpclient/binary/commons-httpclient-3.1.zip
commons-httpclient-3.1\commons-httpclient-3.1.jar -> ...requiredLibraries\httpclient
http://archive.apache.org/dist/commons/codec/binaries/commons-codec-1.4-bin.zip
commons-codec-1.4\commons-codec-1.4.jar -> ...requiredLibraries\httpclient
log4j
http://www.apache.org/dyn/closer.cgi/logging/log4j/1.2.16/apache-log4j-1.2.16.zip
log4j-1.2.16.jar -> ...requiredLibraries\log4j
NaturalCLI
Naturalcli-1.2.2.jar -> ...requiredLibraries\NaturalCLI
quartz
quartz-all-1.6.6.jar -> ...requiredLibraries\quartz
slf4j
slf4j-log4j12-1.6.1.jar -> ...requiredLibraries\slf4j
move requiredLibraries\cxf\slf4j-jdk14-1.6.1.jar -> requiredLibraries\slf4j
copy requiredLibraries\slf4j\slf4j-log4j12-1.6.1.jar -> requiredLibraries\cxf\
oracle_xe
copy C:\XEClient\jdbc\lib\ojdbc14.jar -> ...requiredLibraries\oracle_xe
Download and Install Basic Eclipse IDE program.
Extract “eclipse” folder to C:\ ; then start eclipse (double-click C:\eclipse\eclipse.exe) ;
Select workspace “C:\OpenADR_Workspace”
Using Eclipse, Import (and build) all three projects found in the “OpenADR_Workspace” directory:
From within eclipse go file > import > General > Existing Projects into Workspace
In the "Import" dialogue - select root directory: (hit browse button and navigate to C:\OpenADR_Workspace and press ok...) then hit "finish"
(The projects will import and then build automatically – if you find errors or warnings in the lower pane of eclipse most likely they are one of the downloaded 3rd party libraries – either the wrong file or a file in the wrong place directory wise. In any case try to make sure all the downloaded components are in correct places and re-attempt the build :
(Re)building OpenADRServer components:
Highlight “OpenADRServer “ in the Project Explorer and then from the menu : Project > Clean... > (select “Clean all projects” , “Start Build Immediately” and “Build only the selected projects”) > OK
the OpenADRServer then builds automatically. Once complete and without and red errors in the Markers pane the OpenADRCmdLineIface and OpenADRClient components can then be built by
Right-click OpenADRCmdLineIface > Build Project
Right-click OpenADRClient > Build Project
Build and deploy the .war files for Tomcat
In the Project Explorer pane on the left, double-click the OpenADRServer > presentation > build.xml file
Next in the newly appeared Outline pane on the left scroll-down and locate the green war, presentationWar, clean , deploy-war-tomcat and deploy-presentationWar-tomcat targets
Right-click > run as > Ant Build" the following targets one after another in the following order : "clean" , "war" , "presentationWar"
Then manually copy the .war files OpenAdr.war and OpenAdrGui.war from
C:\OpenADR_Workspace\OpenADRServer\build\
to
C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\
Installation Complete
Verify installation by visiting http://localhost:8180/OpenAdr and or http://localhost:8180/manager/html