Difference between revisions of "Journyx Timesheet"

From SME Server
Jump to navigationJump to search
m (No longer Open Source)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Level|Medium}}
+
{{Warning box| Please note that Journyx is no longer Open Source. Therefore SME Server will not support it}}
==Journyx Timesheet==
 
===Introduction===
 
Journyx is a Timesheet and Expenses application for tracking time, allocating resources and executing projects. It is free to use for up to 10 users. More info on the [http://www.journyx.com Journyx] website.
 
  
The application is designed to run within a users account, and has its own apache web server and postgres database. It cannot be installed as root, and the user name of the account under which it is installed becomes the installing administrative account. It is recommended to create a new specific standard user account specifically for Timesheet. Multiple instances of Timesheet can be run by creating multiple standard users and installing. The apache web server runs on a specific port configured during installation. This can be changed later.
+
Content archived. History preserved.
 
 
===Installation===
 
====User Account====
 
Create a standard user account in SME Server Manager panel, with a meaningful user name. Don't forget this user name becomes the administrative user for the application.
 
SME Server - Collaboration - Users - Add User Account
 
Account Name - '''jxtime'''
 
Fill in the rest of the information as applicable
 
Add
 
Reset Password
 
For ease of administration the newly created user needs to be able to login remotely, using putty or similar and get a command prompt. This is probably easiest achieved by installing the [http://www.dungog.net/wiki/Smeserver-remoteuseraccess Remote User Access] contrib from [http://www.dungog.net/wiki/Main_Page Dungog]. Then
 
SME Server - Security - Remote User Access
 
Modify the '''jxtime''' user
 
Shell Access - '''/bin/bash'''
 
Sudo Access - '''yes'''
 
RSSH+VPN Access - '''yes'''
 
Save
 
====Download and Unpack====
 
Download the application package from the [http://www.journyx.com/gendl3.html Download] page. You will have to register, but no hard sell. Save the package to the ''home'' directory of the new ''jxtime'' user. Choose the package for the latest version of Redhat available.
 
Login as the newly created ''jxtime'' user.
 
gunzip < JournyxTimesheet_78_Linux_i386_glibc_2.3_REDHAT9_to_RHAS4.tar.gz | tar xvf -
 
This should create a directory called ''jtime'' and unpack all of the files.
 
 
 
====Installation====
 
See the [http://www.journyx.com/support/78-unix_install.html install] page for further info
 
 
 
Run the installer
 
cd jtime
 
./jtinstall
 
During the install process you will be prompted for a port number on which the apache web server will run. This will default to 8784
 
{{Note box| Whatever port is selected the next two port numbers are also required, so make sure that all three consecutive ports are not in use}}
 
The application will be installed in another ''jtime'' sub-directory.
 
====Environment Setup====
 
In order to use the command line administrative tools, it is necessary to prime the user environment at login time
 
 
 
Login as the ''jxtime'' user
 
cd /home/e-smith/files/users/jxtime
 
Create and edit a ''.profile'' file with the following content
 
cd home/jtime/jtime/pi/bin
 
. ./setup
 
Save, Close and exit
 
 
 
Now when ever the ''jxtime'' user logs in they will be placed in the directory of the binary admin tools, with the correct environment variables set.
 
 
 
===Running===
 
The newly installed Timesheet application will be available at
 
http://yourdomain.tld:8784
 
Replace the port number with whatever you selected at installation
 
The initial login name and password will be
 
jxtime
 
jxtime
 
or whatever Account User Name you created above.
 
{{Note box|You should change the default password for this user as soon as you first login.}}
 
{{Note box|The application installs a cron job for the installing user that checks the service and restarts it if it is not running every ten minutes. This means that following a reboot there may be a delay of up to ten minutes before the application is available
 
If you want the application to start immediately at boot time then add the following line to /etc/rc.d/rc.local
 
su -c "cd /home/e-smith/files/users/'''jxtime'''/home/jtime/jtime/pi/bin ;. ./setup;wstop;wstart" '''jxtime'''
 
where the '''jxtime''' (bold) entries are the installing user name
 
The cron job can be found at
 
/var/spool/cron/jxtime
 
where jxtime is the installing user name}}
 
 
 
===Uninstall===
 
Login as the ''jxtime'' user
 
cd jtime/jtime
 
pi/bin/uninstall
 
Delete/Remove the ''jxtime'' user from Server Manager if required
 
 
 
----
 
[[Category:Howto]]
 

Latest revision as of 20:49, 1 May 2016

Warning.png Warning:
Please note that Journyx is no longer Open Source. Therefore SME Server will not support it


Content archived. History preserved.