Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Section
Column
Column
Panel
bgColorwhite

Locating the log file

Internal application messages are logged to the eHour log file. In case you run into an Internal System Error or any other anomaly, please include the log file in your forum posting.

 

To locate the log file you first have to change directory to the eHour Home Directory. In that directory there's a log directory holding the ehour.log file.

Panel
bgColorwhite

On Windows, how do I start and stop the standalone eHour?

eHour runs as a service and is started everytime Windows boots. To stop or start eHour, go to start -> run -> services.msc.

In the list of services, locate and double click eHour; use the start and stop buttons.

Panel
bgColorwhite

On Windows, how do I prevent standalone eHour from starting automatically?

To prevent eHour from starting automatically when Windows boots, go to start -> run -> services.msc.

In the list of services, locate and double click eHour; change the startup type to "Manual".

Section
Panel
bgColorwhite

On Windows, how do I start and stop the standalone eHour?

eHour runs as a service and is started everytime Windows boots. To stop or start eHour, go to start -> run -> services.msc.

In the list of services, locate and double click eHour; use the start and stop buttons.

Section
Column
Panel
bgColorwhite

On Windows, how do I prevent standalone eHour from starting automatically?

To prevent eHour from starting automatically when Windows boots, go to start -> run -> services.msc.

In the list of services, locate and double click eHour; change the startup type to "Manual".

Section
Column
Column
Panel
bgColorwhite

How can I change the default port (8000) standalone eHour listens on?

Edit the configuration file and change the ehour.standalone.port value.

On Windows you need to stop eHour before you can edit the configuration file.

 

Section
Panel
bgColorwhite

I have a lot of assignments and this breaks the timesheet form when running with Tomcat (6)

Apache Tomcat by default can handle a limited amount of data being sent by the browser. When you have a large timesheet (50+ assignments), you may be not able to submit hours on the timesheet as Tomcat will throw an error.

You can increase the amount of data Tomcat accepts by adding the following line to /usr/share/tomcat6/conf/catalina.properties:

org.apache.tomcat.util.http.Parameters.MAX_COUNT=10000
Panel
bgColorwhite

eHour is running out of memory (java.lang.OutOfMemoryError: Java heap space)

eHour is limited to use a specific amount of memory. In some cases this memory it may use is not enough and you will end up with out of memory errors in your logfile, either: java.lang.OutOfMemoryError: PermGen space or java.lang.OutOfMemoryError: Java heap space.

Luckily it's easy to fix. For the standalone version, navigate to the directory where eHour is installed en open the file ehour.vmoptions. Modify it so that it looks like (order is important!):

Code Block
-XX:MaxPermSize=128m
-Xmx512m
-DEHOUR_HOME=${installer:sys.installationDir} 

And restart eHour

 

If you deployed the WAR on Tomcat:

Windows: in your Tomcat's bin directory, create a file called setenv.bat with the following contents and restart Tomcat

Code Block
set JAVA_OPTS=-server -Xmx512m -XX:MaxPermSize=128m

 

Linux: in your Tomcat's bin directory, create a file called setenv.sh and make it executable with chmod 700 setenv.sh. Edit the contents of that file with the following and restart Tomcat:

Code Block
export JAVA_OPTS="-server -Xmx512m -XX:MaxPermSize=128m"