Changes

"[http://ehour.nl eHour] is the open source webbased time tracking tool for companies and organizations who need accurate information on how much time is spend on projects by their people.  eHour makes the amount of time your people spend on projects visible and available as simple and user friendly as possible. eHour requires Java."

"[http://ehour.nl eHour] is the open source webbased time tracking tool for companies and organizations who need accurate information on how much time is spend on projects by their people.  eHour makes the amount of time your people spend on projects visible and available as simple and user friendly as possible. eHour requires Java."

==Forum discussion==

==Forum discussion==

5. Point your browser to 'http://yourserver:8000' and login with user/pass: admin:admin

5. Point your browser to 'http://yourserver:8000' and login with user/pass: admin:admin

{{Note box | If you want a 'clean' URL or a subdomain (e.g. http://timesheet.yourserver.com) instead of http://yourserver:8000 then please see the relevant section below.

{{Note box | If you want a 'clean' URL or a subdomain (e.g. http://timesheet.yourserver.com) instead of http://yourserver:8000 then please see the relevant section below.}}

==MySQL backend==

==MySQL backend==

A. Create a new MySQL database (e.g. ehour) (see [http://wiki.contribs.org/Useful_Commands#Create_a_Database_and_its_User here] how to)

A. Create a new MySQL database (e.g. ehour) (see [http://wiki.contribs.org/Useful_Commands#Create_a_Database_and_its_User here] how to)

B. Download the MySQL schema for ehour 1.4.1 [https://raw.githubusercontent.com/tedeling/ehour/master/eHour-persistence-mysql/src/sql/install/fresh.mysql.sql here]  

B. Download the MySQL schema for ehour 1.4.3 [https://raw.githubusercontent.com/tedeling/ehour/master/eHour-persistence-mysql/src/sql/install/fresh.mysql.sql here]  

C. Import the downloaded MySQL schema into the ehour database

C. Import the downloaded MySQL schema into the ehour database

After installation we need to provide the details of the virtual host to the contrib so it can create the virtual host. In this example we want the virtualhost to serve the sub domain ''https://timesheet.myserver.com'' and only provide access to the login page to valid SME users. This can be done with the following command:

After installation we need to provide the details of the virtual host to the contrib so it can create the virtual host. In this example we want the virtualhost to serve the sub domain ''https://timesheet.myserver.com'' and only provide access to the login page to valid SME users. This can be done with the following command:

  db domains set timesheet.collabis.nl domain Description "Timesheet" Content Primary \

  db domains set timesheet.myserver.com domain Description "Timesheet" Content Primary \

  Nameservers internet TemplatePath WebAppVirtualHost DocumentRoot /opt/ehour \

  Nameservers internet TemplatePath WebAppVirtualHost DocumentRoot /opt/ehour \

  RequireSSL enabled ProxyPassTarget http://127.0.0.1:8000/ Authentication Basic

  RequireSSL enabled ProxyPassTarget http://127.0.0.1:8000/ Authentication Basic

Followed by:

Followed by:

  signal-event webapps-update

  signal-event webapps-update

Your sub domain has been created but will not yet show eHour. We need to tell the eHour Jetty webserver that it needs to listen to 127.0.0.1. Since the eHour Jetty webserver is not part of SME Server, we need to adjust the jetty config file located at '''/opt/ehour/home/conf/jetty.xml''' to look like this:

Your sub domain has been created but will not yet show eHour. We need to tell the eHour Jetty webserver that it needs to listen to 127.0.0.1. Since the eHour Jetty webserver is not part of SME Server, we need to adjust the jetty config file located at '''/opt/ehour/home/conf/jetty.xml''' to look like this:

 

        <Call name="addConnector"> <Arg> <New class="org.eclipse.jetty.server.nio.SelectChannelConnector">                       <Set name="Host">127.0.0.1</Set> </New> </Arg> </Call>

<Call name="addConnector">

</nowiki>Where only '''<Set name="Host">127.0.0.1</Set>''' is added.

<Arg>

Then eHour needs to be restarted by:service ehour restartAnd give it a minute to restart. Then eHour will be available from https://timesheet.myserver.com.

<New class="org.eclipse.jetty.server.nio.SelectChannelConnector">

<Set name="Host">127.0.0.1</Set>

</New>

</Arg>

</Call>

 

Where only '''<Set name="Host">127.0.0.1</Set>''' is added.

 

Then eHour needs to be restarted by:

service ehour restart

and give it a minute (really, a full minute) to restart. Then eHour will be available from https://timesheet.myserver.com.

Once the sub domain is working, you may want to close off the original webaddress myserver.com:8000 by setting the access property to private: config setprop ehour access private

Once the sub domain is working, you may want to close off the original webaddress myserver.com:8000 by setting the access property to private: config setprop ehour access private

followed by:

followed by:

==Upgrade==

==Upgrade==

For any upgrade, please see the eHour documentation/wiki. Especially if there is an database schema update. So always make a backup of your mysql database before starting any upgrade.

For any upgrade, please see the [https://wiki.ehour.nl/display/DOCU/Upgrading+MySQL eHour documentation/wiki]. Especially if there is an database schema update. So always make a backup of your mysql database before starting any upgrade.

==Demo==

==Demo==