Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Open your Environment Variables: Start Menu > Control Panel > System and Security > System > Advanced System Settings > Environment Variables.
  2. Create CATALINA_HOME variable:
    1. Under the System Variables section (the bottom of the two sections), click the New... button.
    2. For Variable Name, copy and paste this: CATALINA_HOME

    3. For Variable Value, Provide the tomcat path i.e C:\tomcat
    4. Click the OK button to get it created. 

  3. Create JAVA_HOME variable:
    1. Click the New... button again, under the User Variables section.
    2. For Variable Name, enter JAVA_HOME
    3. For Variable Value,Provide the Java path enter C:\Program Files\Java\jdk1.7.0_67
      NOTE: 
      i - If you are running 32-bit Windows 7, use this instead: C:\Program Files (x86)\Java\jdk1.7.0_67
      ii - Java jdk path "jdk1.7.0_67" will be with respect to the installed version and it may not be the same as mentioned in the above example. 

       
    4. Click the OK button.

  4. Edit PATH variable:
    1. In the System Variables section, scroll down to and select the Path variable.
    2. Click the Edit button just below.
       
    3. Click your mouse cursor into Variable Value box.  Using your keyboard's right-arrow or End key, move all the way to the far right of the current text in Variable Value.
    4. Add the following text onto the end of the existing Variable Value text:  ;C:\Program Files\Java\jdk1.7.0_67\bin
      NOTE: 
      i - There must be exactly one semi-colon between whatever is already in your PATH variable, and the new C:\Program Files\Java\jdk1.7.0_67\bin – don't add a semi-colon if your previous PATH already ended with a semi-colon.
      ii - Java jdk path "jdk1.7.0_67" will be with respect to the installed version and it may not be the same as mentioned in the above example. 

       
    5. Click the OK button

Create Mifos X log file

...

  1. Click Start Menu > All Programs > Accessories.
  2. Right click on Notepad and choose Run as administrator.
    Image Removed 
  3. A warning box will pop up, titled User Account Control.  Click the Yes button.

...

  1. In the Notepad menu, choose File > Save As.
    Image Removed 
  2. In the Save As box, navigate to your Tomcat > logs folder:
    1. Windows 7, 64-bit:  Computer > C drive > Program Files > Apache Software Foundation > Tomcat 7.0 > logs
      Image Removed 
    2. Windows 7, 32-bit:  Computer > C drive > Program Files (x86) > Apache Software Foundation > Tomcat 7.0 > logs
      Image Removed
       
  3. Change the File name to mifos-platform.log
  4. Click Save.
    Image Removed 



...

Tomcat 7.0 Setup

  1. Ensure the following libraries are in the [TOMCAT_HOME]/lib folder:
    1. tomcat-jdbc.jar

      If you are missing it use the following link to download: http://www.java2s.com/Code/JarDownload/tomcat-jdbc/tomcat-jdbc.jar.zip
    2. mysql-connector-java-5.1.22(You will need to download latest MySQL Connector/J Jar file fromhttp://dev.mysql.com/downloads/connector/j/)
      To download it you will need to make an Oracle account, after that run the downloaded file.

  2. Generate a new keystore using java keytool (if you havent already done this):
    1. Create keystore
      1. for Windows:
      2. for Unix:
    2. Update server.xml as in docs with the following command:


  3. Update tomcat configuration files for SSL
    1. Go to  [TOMCAT_HOME]/conf and open server.xml with notepad:
    2. Delete everything in it and copy-paste the following code:

      <?xml version='1.0' encoding='utf-8'?>
      <Server port="8005" shutdown="SHUTDOWN">
      <Listener className="org.apache.catalina.core.JasperListener" />
      <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
      <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
      <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
      
        <GlobalNamingResources>
             <Resource name="UserDatabase" auth="Container"
                    type="org.apache.catalina.UserDatabase"
                    description="User database that can be updated and saved"
                    factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
                    pathname="conf/tomcat-users.xml"
             />
      
             <Resource type="javax.sql.DataSource"
                  name="jdbc/mifosplatform-tenants"
                  factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
                  driverClassName="com.mysql.jdbc.Driver"
                  url="jdbc:mysql://localhost:3306/mifosplatform-tenants"
                  username="root"
                  password="[root mysql password]"
                  initialSize="3"
                  maxActive="10"
                  maxIdle="6"
                  minIdle="3"
                  validationQuery="SELECT 1"
                  testOnBorrow="true"
                  testOnReturn="true"
                  testWhileIdle="true"
                  timeBetweenEvictionRunsMillis="30000"
                  minEvictableIdleTimeMillis="60000"
                  logAbandoned="true"
                  suspectTimeout="60"
             />
        </GlobalNamingResources>
      
        <Service name="Catalina">
      
      <Connector protocol="org.apache.coyote.http11.Http11Protocol"
                 port="8443" maxThreads="200" scheme="https"
                 secure="true" SSLEnabled="true"
                 keystoreFile="/home/ubuntu/.keystore"
                 keystorePass="testmifos"
                 clientAuth="false" sslProtocol="TLS"
                 URIEncoding="UTF-8"
                 compression="force"
                 compressableMimeType="text/html,text/xml,text/plain,text/javascript,text/css"/>
      
            <Engine name="Catalina" defaultHost="localhost">
      
            <Realm className="org.apache.catalina.realm.LockOutRealm">
              <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
            </Realm>
      
            <Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">
      
                <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
                     prefix="localhost_access_log." suffix=".log"
                     pattern="%h %l %u %t &quot;%r&quot; %s %b" />
            </Host>
          </Engine>
        </Service>
      </Server>

       

    3. Press Ctrl + S or File>Save.
    4. Close Notepad.

       

    Note:- 
    Below mentioned are to be updated in the same server.xml
    i - Key store path should be updated like shown in example here:- keystoreFile="C:\Users\conflux9\.keystore" 
    ii - Key store password (which was provided while creating the key). Should also be updated like shown in example:- keystorePass="mif456"


  4. Dropping application into tomcat webapps folder

...