1.0 Download the binary distribution

The ProjectBrowser is included as part of the Hackystat Binary service distribution, which can be downloaded from the Hackystat Downloads page.

In general, you should always update all of your services at the same time, since there may be dependent updates across multiple services in any given release.

2.0 Update your projectbrowser.properties file

For details, see the projectbrowser.properties page.

3.0 Bring up the service

To run the service, invoke 'java -jar -Xmx512M projectbrowser.jar'. You should see something like the following:

philip-johnsons-computer-2:~/hackystat-integration/hackystat-ui-wicket johnson$ java -Xmx512M -jar projectbrowser.jar
Loading ProjectBrowser properties from: /Users/johnson/.hackystat/projectbrowser/projectbrowser.properties
1 [main] INFO org.mortbay.log - Logging to org.slf4j.impl.SimpleLogger(org.mortbay.log) via org.mortbay.log.Slf4jLog
47 [main] INFO org.mortbay.log - jetty-8.1.421
178 [main] INFO org.mortbay.log - NO JSP Support for /projectbrowser, did not find org.apache.jasper.servlet.JspServlet
Loading ProjectBrowser properties from: /Users/johnson/.hackystat/projectbrowser/projectbrowser.properties
04/21 21:24:00  ProjectBrowser Properties:
                projectbrowser.sensorbase.host = http://dasha.ics.hawaii.edu:9876/sensorbase
                projectbrowser.dailyprojectdata.host = http://dasha.ics.hawaii.edu:9877/dailyprojectdata
                projectbrowser.telemetry.host = http://dasha.ics.hawaii.edu:9878/telemetry
                projectbrowser.logging.level = INFO
                projectbrowser.wicket.configuration =deployment
                projectbrowser.application.logo =
                projectbrowser.application.name = Hackystat ProjectBrowser
                projectbrowser.hostname = localhost
                projectbrowser.context.root = projectbrowser
                projectbrowser.port = 9879
                projectbrowser.sensordata.itemsperpage = 100
                projectbrowser.admin.email = johnson@hawaii.edu
471 [main] INFO org.apache.wicket.Application - [ProjectBrowserApplication] init: Wicket extensions initializer
476 [main] INFO org.apache.wicket.protocol.http.WebApplication - [ProjectBrowserApplication] Started Wicket version 8.1.421 in deployment mode
491 [main] INFO org.mortbay.log - Started SocketConnector@0.0.0.0:9879
 
http://localhost:9879/projectbrowser is now running. Press return to stop server.

4.0 Verify your installation

Once the system is running, bring up the home page. It should indicate that the sensorbase, dailyprojectdata, and telemetry services were all successfully contacted with a line at the bottom of the screen that says "Contacted:", followed by the service names. If any service was not contacted, the bottom line will include "Not contacted", along with those services it failed to contact.