Development
Table of Contents
pmGraph is under active development at Aptivate. Work is in progress to make it a more flexible and powerful tool, with advanced user-friendly graphing capabilities. Collaborators on the project are both welcome and important for further development. Please contact us if you'd like to get involved.
The project source code and downloadable installation file are freely available on sourceforge, and licensed under the GPL.
Required Tools
For development, we recommend that you use the following tools:
- Mysql server or other database like PostgreSQL
- Sun Java JDK 6.0 or higher (other JDKs such as GCJ cause problems with Tomcat)
- Apache Tomcat 5.5
- Eclipse (if in doubt, get the Java Developer edition)
- Sysdeo Tomcat plugin
- Subclipse
Steps to get developing in Eclipse
- If you don't have a database server like mySQL, install it
- Create a database where you want to store the data. There is a template for mysql in the sourceforge subrepository which contains also the script for user and grant permissions
- Install JDK, using for example a package
- Download and unpack Tomcat, but don't start it yet
- Install Eclipse and the plugins
- In Eclipse click on Window > Preferences > Tomcat
- Select the version of Tomcat you're using and the Tomcat home directory (your home directory + "tomcat" by default).
- Click OK
- Switch to the SVN Repository Exploring perspective (Window > Open Perspective > SVN Repository Exploring)
- Right-click in the left pane and add a new repository
- Enter the URL: https://pmgraph.svn.sourceforge.net/svnroot/pmgraph
- Now click 'Next' to check out as a project in the Workspace
- Expand the newly-created repository
- Right-click on the pmgraph folder within, and choose Checkout
- Switch back to the Java perspective
- Right-click on the pmGraph project in your workspace and choose Tomcat > Update Context Definition
- Expand the project, and the web/WEB-INF/src folder, and create a database.properties following as a template the database.dist.properties or the info about database.properties given in this website.
- Enter the details of your MySQL server in this file
- To be able to run the tests you should create a file called tests.properties using the tests.example.properties as a template. The port should match the one given in server.xml file in your local tomcat and the rest of the parameters should match the database and user you will be using for the tests.
- Start Tomcat within Eclipse (Tomcat > Start Tomcat)
- Browse to http://localhost:8080/pmgraph and check that the page and graph display properly (The port number has to match the one in the server.xml file)
- To fill the graph with some data run the tests. If you go to the URL http://localhost:8080/pmgraph/index.jsp?start=0&end=300000 you should be able to see a graph with 5 minutes of data.
Code Overview
Other resources
A list of known bugs, the release notes and an users forum can be found on the SourceForge site.
If you need more help, please contact us.
Back to the main page