Church Historical Timeline Getting Started

Church Historical Timeline Index edit

There are many ways to help with the Church Historical Timelines project.

Want to help develop?

Check out trunk as a new Maven Project

Check out from subversion.png

If you are helping with development, you probably want to start working on code, or at least run the application on your own computer. There are several things that the Church Stack Team has set up to make that as painless as possible. Some of the harder-to-explain things are illustrated on the right.

  1. Agree to the contributors agreement.
  2. Become familiar with the Community Best Practices.
  3. Learn about the maven project setup.
  4. Install the LDS Tech IDE.
  5. Install the Oracle virtual machine. The Oracle VM allows developers to work together much more easily, without worrying about Oracle database configuration (at least mostly).
  6. Check out the project from the subversion repository. Choose "Checkout as Maven Project" and wait for a while...

So, how do you turn it on?

Initial Build

Maven clean install.png

If you have come this far, great job! But now that you have the development environment set up, how do you start the app? There are a few things that you need to do before you can run the app effectively. I have included pictures on how these tasks are done in the IDE, but they can all be done from the command line as well if you prefer.

  1. Start up the Oracle VM.
  2. Run Maven Clean Install on the root project. This will download all the Stack dependencies into your local maven repository as well as build the timelines application. The first time this is done it may take about 10 minutes or so...
  3. Start up the WAMulator. This is done with the timelines-wam project as shown in the picture.
  4. Start up the REST server.
  5. Start up the client server. It is possible to run the server and the client in the same Tomcat instance, but you may want to create separate Tomcat instances so you can run the client and the server independently.

If you were able to start all of that without any errors, try http://localhost:8080/timelines-ui/ in your web browser!

Start the WAMulator

Run wamulator.png

Independent Tomcat instances

Independent client and server.png

This page was last modified on 24 February 2011, at 23:24.

Note: Content found in this wiki may not always reflect official Church information. See Terms of Use.