Journyx Timesheet

From SME Server
Revision as of 21:34, 6 July 2010 by Timn (talk | contribs)
PythonIcon.png Skill level: Medium
The instructions on this page require a basic knowledge of linux.


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 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.

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 Remote User Access contrib from 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 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. Direct link to Journyx Version7.8 for SME 7.4.

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 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

Important.png Note:
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.

Important.png Note:
You should change the default password for this user as soon as you first login.


Important.png Note:
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 for the installing user 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