Alas, despite our best efforts, you may encounter unexpected problems while attempting to install and run a Hackystat server in your local environment. If you encounter problems, please feel free to email Philip Johnson (johnson@hawaii.edu) and the Hackystat development team will do their best to help you resolve your problem.
To make the resolution process as fast and effective as possible, we would like to ask that you provide the information below when you email us with your problem. You can copy the following questions into an email, delete the "Example answer(s)", and supply your own values.
What is your OS?
Example answers: Win XP Pro, Mac OS 10.4.2, SunOS 5.8
What is the result of running 'java -version'?
Example answer:
> java -version
java version "1.5.0_07"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_07-b3)
Java HotSpot(TM) Server VM (build 1.5.0_07-b3, mixed mode)
What is the result of running 'ant -version'?
Example answer:
> ant -version
Apache Ant version 1.6.5 compiled on July 16 2004
Run 'set' (or 'printenv') and show the output for the PATH, CATALINA_HOME, ANT_HOME, JAVA_HOME (and CATALINA_OPTS if set) environment variables:
Example answer:
> printenv
PATH=/fs/unsupported/jdk1.5.0_07/bin:/export/home/care2/pjohnson/public_hackystat/apache-ant-1.6.5/bin:/export/home/care2/pjohnson/public_hackystat/jakarta-tomcat-5.5.12/bin:.
JAVA_HOME=/fs/unsupported/jdk1.5.0_07
CATALINA_HOME=/export/home/care2/pjohnson/public_hackystat/apache-tomcat-5.5.12
CATALINA_OPTS=-Djava.awt.headless=true -Xmx200M
ANT_HOME=/export/home/care2/pjohnson/public_hackystat/apache-ant-1.6.5
Note that if the directory "Program Files" appears in any of these environment variables, that is likely to be your problem. See Section 8.4, “Build tools installation” for details.
Run 'dir' (or 'ls') and show the output for the public_hackystat directory:
> ls apache-ant-1.6.5 hackystat-standard-7.0.1205 hackystatdatadir apache-tomcat-5.5.12.tar apache-ant-1.6.5-bin.tar hackystat-standard-7.0.1205.zip apache-tomcat-5.5.12 tcshrc
Run 'startup' (or 'catalina.sh run') and show the Tomcat console output including the Hackystat startup messages. (Please replace the administrator password display with XXX.)
Example answer:
Jan 3, 2006 8:07:42 AM org.apache.coyote.http11.Http11Protocol init INFO: Initializing Coyote HTTP/1.1 on http-8080 Jan 3, 2006 8:07:42 AM org.apache.catalina.startup.Catalina load INFO: Initialization processed in 781 ms Jan 3, 2006 8:07:43 AM org.apache.catalina.core.StandardService start INFO: Starting service Catalina Jan 3, 2006 8:07:43 AM org.apache.catalina.core.StandardEngine start INFO: Starting Servlet Engine: Apache Tomcat/5.5.12 Jan 3, 2006 8:07:43 AM org.apache.catalina.core.StandardHost start INFO: XML validation disabled Jan 3, 2006 8:07:43 AM org.apache.catalina.core.StandardHost getDeployer INFO: Create Host deployer for direct deployment ( non-jmx ) Jan 3, 2006 8:07:43 AM org.apache.catalina.core.StandardHostDeployer install INFO: Processing Context configuration file URL file:C:\jakarta-tomcat-5.5.12\conf\Catalina\localhost\admin.xml Jan 3, 2006 8:07:43 AM org.apache.struts.util.PropertyMessageResources INFO: Initializing, config='org.apache.struts.util.LocalStrings', returnNull=true Jan 3, 2006 8:07:43 AM org.apache.struts.util.PropertyMessageResources INFO: Initializing, config='org.apache.struts.action.ActionResources', returnNull=true Jan 3, 2006 8:07:43 AM org.apache.struts.util.PropertyMessageResources INFO: Initializing, config='org.apache.webapp.admin.ApplicationResources', returnNull=true Jan 3, 2006 8:07:44 AM org.apache.catalina.core.StandardHostDeployer install INFO: Processing Context configuration file URL file:C:\jakarta-tomcat-5.5.12\conf\Catalina\localhost\balancer.xml Jan 3, 2006 8:13:35 AM org.apache.catalina.core.StandardHostDeployer install INFO: Processing Context configuration file URL file://C:/svn/hackyCore_Build/hackystat.xml 01/03 08:13:36 :::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 01/03 08:13:36 Hackystat: Initializing system. 01/03 08:13:36 Admin: johnson@hawaii.edu (XXX) 01/03 08:13:36 TimeZoneChanger: Server Time Zone = Hawaii Standard Time 01/03 08:13:36 TimeZoneChanger: No change needed 01/03 08:13:36 Users directory is: c:\public_hackystat\hackystatdataTMP\users 01/03 08:13:36 Startup Summary: SDTs: 1, Commands: 22, Sensors: 0, Users: 6 01/03 08:13:36 Version: 7.1.103 Buildtime: January 3 2006 08:07:56 01/03 08:13:36 :::::::::::::::::::::::::::::::::::::::::::::::::::::::::: SOAP Service Manager: Unable to read 'DeployedServices.ds': assuming fresh start
Once you've brought up Tomcat and waited until the Hackystat initialization message appeared, please show the output message you get (typically in another shell window) from running 'ant -q all.junit'.
Example answer:
C:\public_hackystat\hackystat-standard-7.0.1205\hackyCore_Build>ant -q all.junit
[echo] (09:37:19) Completed hackyCore_Kernel.junit.
[echo] (09:37:25) Completed hackyCore_Installer.junit.
[echo] (09:37:26) Completed hackyCore_Statistics.junit.
[echo] (09:37:34) Completed hackyCore_Report.junit.
[echo] (09:38:32) Completed hackySensor_Ant.junit.
[echo] (09:38:33) Completed hackySdt_Cli.junit.
[echo] (09:38:34) Completed hackySensor_Cli.junit.
[echo] (09:38:36) Completed hackySdt_ReviewActivity.junit.
[echo] (09:38:38) Completed hackySdt_ReviewIssue.junit.
[echo] (09:38:39) Completed hackySdt_BuffTrans.junit.
[echo] (09:38:40) Completed hackySensor_Vim.junit.
[echo] (09:38:42) Completed hackySensor_JBlanket.junit.
[echo] (09:38:42) Completed hackySensor_Office.junit.
[echo] (09:38:48) Completed hackySdt_Dependency.junit.
[echo] (09:38:50) Completed hackySensor_Pmd.junit.
[echo] (09:39:52) Completed all.junitReport
[echo] (09:39:52) Completed all.junit
BUILD SUCCESSFUL
Total time: 2 minutes 47 seconds
If your problem involves failing JUnit tests, please create a jar or zip file containing the contents of the hackyCore_Build/build/reports/junit directory, and provide a link below so that we can retrieve it and see the details of your JUnit errors:
Example answer: http://www.foo.edu/~jones/junit-errors.zip
Lastly, is there any other information you think might be relevant? Please include it here.