Frequently Asked Questions about HID web interface (HWI) setup and usage
------------------------------------------------------------------------

Q: I am getting an error when I press certain button on the HID web interface and the error is not informative. What should I do?

A: All of the errors (the full stack trace) are logged both by Tomcat and by HID web interface (HWI) if (set in $CLINICAL_HOME/conf/log4j.properties.template file.
To see the logs of Tomcat, check $TOMCAT_HOME/logs/catalina.out file. 

Q: I want to see more logs for debugging. What should I do?

A: In $CLINICAL_HOME/conf/log4j.properties.template file change the first line
from

	log4j.rootLogger=INFO, A1

to the following

	log4j.rootLogger=DEBUG, A1

run `ant' and restart tomcat afterwards.

Q: I am getting error messages when I try to login. Why?

A: Most probably a misconfiguration issue with users.xml file and/or database connectivity. As an advice, let ant create your users.xml file.  
Ant will check for an existing users.xml file, if it can not find one, it will interactively create one for you. During this interactive users.xml file creation section you can test your database connections also. Also an another convenience future of the users.xml file creator custom Ant Task is selection of the default answer (as indicated by [ ] characters) for multiple choice question by just
pressing enter instead of writing your choice.

Q: I am getting [ServletException in:/pages/common/header.jsp] Exception thrown by getter for property dbIDList of bean logonForm' error in the first screen

A: You don't have the mandatory admin web user in your users.xml file. Add the 'admin; web user to the users.xml (one admin web user per database) , shutdown
tomcat, run ant, and start tomcat.

Q: I want to use a different webapp name then default clinical (as specified
in $CLINICAL_HOME/build.properties file webapp.name property) and I am getting
broken images in assessment forms

A: Since to actual code is originally generated for the 'clinical' web app name
image and question notes popup window links will be broken if you use a different web app name. To overcome this problem (assuming you want to use 'test_clinical' instead of 'clinical' web app name)

cd to $CLINICAL_HOME/web/pages/assessment
and run
 find . -name "*.jsp" -exec perl -pi -e  's#/clinical/pages/assessment#/test_clinical/pages/assessment#g;' {} \;
 find . -name "*.jsp" -exec perl -pi -e  's#/clinical/images/notes#/test_clinical/images/notes#g;' {} \;
 find . -name "*.jsp" -exec perl -pi -e  's#/clinical/images/asterisk#/test_clinical/images/asterisk#g;' {} \;
 find . -name "*.jsp" -exec perl -pi -e  's#/clinical/images/spacer#/test_clinical/images/spacer#g;' {} \;

and run ant to redeploy (for JSP changes you don't need to restart the tomcat)








 
