HomeFinance: Quick Start Guide

This last part of the HomeFinance set up is a real quick guide to show you how to start the application once you have completed the installation guide.

You will have gone through the setup, which has been quite involved, and if you are anything like me, you will have forgotten how to start things up in order to get the application up and running! No worries…just follow the steps below.

1. Open XAMPP and start the MySql DB server

To get our HomeFinance application up and running, we are only interested in the MySQL database. 

  • Click Windows Start and scroll down to find the XAMPP folder, as below, and click XAMPP Control Panel:

2. Once in the “XAMPP Control Panel”, start MySql:
3. Open the Windows Command line and change the directory to where your app is:
  • Type in cd c:/homefinance-V02.00-SystTest/bin:
  • run the app homefinance -Dplay.http.secret.key=abcdefghijk:
4. Open a browser, such as Google and run the app:
  • Type in localhost:9000/login in the address bar and hit enter:
  • You should now see your HomeFinance application start:
5. Close the Application

To close the application, you just need to go back into the Windows Command prompt and:

  • Click the keys Ctrl and C simultaneously…twice!
  • Once you have done that, you will see:
  • You then need to click Y and the job will terminate

6. Trouble Shooting:

If you get the following error, then just follow the solution to get the app backup and running:

ERROR: 

This application is already running (or delete C:\homefinance-V02.00-Live\bin\RUNNING_PID file):

SOLUTION:

  • If your app is not already running, then what has probably happened is that your app has closed unexpectedly, leaving a file (RUNNING_PID) open.
  • You will need to delete the “RUNNING_PID” file in the directory below, then just run the command again as in number 3 above: