The Source for Java Technology Collaboration


WINDOWS INSTALLATION OF MIFOS PACKAGE

Step One: install the PREREQUISITE SOFTWARE specifically java, mySQL and java-container software
  • Order matters here (to some extent, so please follow these)
  • Create a directory (aka a folder) on the C drive. So that you now have c:\bin ready for later steps.
  • DOWNLOAD and install Java 2 SE JDK 5 from http://java.sun.com/javase/downloads/index.jsp
    • On the page, this will appear as JDK 5.0 Update X
    • where x is the most recent update (currently Update 9)
    • chose JDK please NB: Not Java EE and not NetBeans and definitely NOT the sourcecode for JDK
    • The file should be either "jdk-1_5_0_0x-windows.zip" or ""jdk-1_5_0_09-windows-i586-p.exe" (offline or online should work)
    • Follow the defaults.
  • DOWNLOAD Jetty (the container) http://prdownloads.sourceforge.net/jetty/jetty-6.0.1.zip?download and then unpack to a directory (please choose c:\bin\ that you set up earlier)
    • At the end of the unpacking (aka unzipping or extracting), there should be a directory c:\bin\jetty6.0.1\ with several subdirectories
  • DOWNLOAD mySQL5.0 http://dev.mysql.com/downloads/mysql/5.0.html (Community Server)
    • scroll down the page and choose Windows (x86)
    • unpack the setup.exe to a convenient place --> more on step Three

Step Two: Configure environmental settings AND Validate that Java and Jetty are working
  • When in doubt, follow instructions on software download sites
  • Select Advanced Tab on System Properties Window (hint: right click on myComputer)
  • Add JAVA_HOME path (usually something like c:\program files\Java\jdk1.5.0_09) to the system environmental variables
    • This means click add on system variables, name is JAVA_HOME value is c:\program files\java\JDK1.5.0_09. (or _10 if update 10)
  • Validate that Jetty is referring to Java and therefore working
    • Refer to the README file that comes with the Jetty Zip file. It includes this statement c:/java -jar start.jar which you run from a DOS window
    • If you didn't follow that last statement, open a DOS command line window, cd to c:\bin\jetty6.0.1 and then type java -jar start.jar in the DOS window
    • If installed properly, then it should return a page at http://localhost:8080/test/ (in your browser)
    • Sometime during the setup, you might get a security warning. Allow the application to run - i.e. Unblock * Hit control-C to end the runtime of Jetty

Step Three: set up mySQL as a service and start it
  • Install mySQL from Zip file (extract and run setup)
  • Follow wizard defaults mostly
  • Make this a developer db
  • DSS/OLAP optoin
  • Best support for multi-lingualism
  • Make this a windows service
  • Set root password to mysql (if you set it to anything else you MUST note that down - there is NO WAY to reset)
  • FInish and then open mySQL command line from the Programs>mySQL.
  • If you don't get a mysql prompt after entering the password, then verify the service is running
    • Service running? Go to Control Panel: Administrative Tools> Services. (scroll down to mysql)
    • Password lost - uninstall mysql entirely, delete the data folder under mysql directory, start step over.

Step Four: Download war file and mySQL setup scripts
  • From sourceforge mifos downloads
  • (or java.net whichever seems newer)
  • Expand Zip file
  • Create c:/bin directory and c:/bin/sql directory
  • Move mifos.war file to c:/bin/jetty6.0.1/webapps (existing directory)
  • Copy all files ending in .sql to c:/bin/sql

Step Five: Run mySQL scripts
  • Use "Programs>mySQL." and select "command line mysql"
  • If that is not there, then open dos window
  • At c:\ prompt, type mysql -b -u root - p
  • password default is mysql
  • At mysql> prompt type source c:/bin/loadmifosdb.sql;
  • if you get an error it might mean you have not loaded the scripts in the correct location.

Step Six: Start the Jetty Server - run Mifos
  • Make sure you have moved mifos.war file to the webapps directory under the Jetty installation directory
  • Open DOS window and cd to the jetty location (cd c:/bin/jetty6.0.1)
  • At the dos C:/ prompt, type java -jar start.jar;

Step Seven: Open browser and point to http://localhost:8080/mifos

Step Eight: Load sample data and run
  • Halt the jetty engine
  • Open the mysql command window and load the data
    • mysql> source c:/bin/sql/loadsampledb.sql
    • err: need to reload the sampleDB
  • Restart the Jetty Server (step six)

Topic InstallMifosPackage . { Edit | Ref-By | Printable | Diffs r7 < r6 < r5 < r4 < r3 | More }
 XML java.net RSS

Revision r7 - 03 Jan 2007 - 23:21:15 - Main.jkingdon
Parents: WebHome > MIFOS > KickStart > InstallMifos