The first thing to do it to identify answer the following questions before installing onShore TimeSheet from the source distribution. If you are running Debian GNU/Linux there is an onshore-timesheet.deb available. We hope to support other Linux and Unix packaging systems in the future, such as RPM and Solaris' pkg files. Make sure there isn't a maintained package available for your system before installing onShore TimeSheet from the source distribution. If there isn't, begin by answering these questions:
Where do you want the application files installed? By default, the application is installed in /home/httpd/html/timesheet, but this can be overridden in the Makefile or on the command line. Red Hat, and likewise Caldera users are safe with this default but Solaris and other systems probably need to change the APPROOT variable, depending on your web server configuration. In addition, there is the variable for IMAGE_DIR for where the images should be accessed from (not currently implemented yet).
What is the document root for the application? This is the relative URL. By default, the variable for this, TIMESHEET_URL is set to /onshore-timesheet. Please remember, this is the path to the application from the document root as defined in your webserver's configuration files. /onshore-timesheet may actually be /usr/local/etc/httpd/htdocs/onshore-timesheet on the server. The same is true of the variable IMAGE_URL, which is set to /images. This can be set to wherever you put images under the document root of the web server (this is not currently implemented).
Where do you want the configuration file installed? On most unix filesystem layouts, /etc is considered the normal place to drop configuration files. By default, onShore TimeSheet will install the configuration file, timesheet.conf, in a subdirectory called etc under the above directory you chose as the application's root. A link can later be made to /etc/timesheet.conf or as you please. The Makefile can be modified to suit your preference by changing the CONFFILE variable.
What is the name of the user id that the HTTP server is running as? By default this is set to nobody but you can override this on the command line by changing the WWWUSER variable in the Makefile.
If you're not sure, check in Apache's httpd.conf for the User setting. Other web servers may set this variable in other ways.
Where can a Perl library be added so Perl can find it? By default, this is set to /usr/lib/perl5/site_perl but can be overridden by changing the PERLINC in the Makefile. If you are not sure what Perl's default INC path is set to, simply run this on the command line:
# perl -e 'print join "\n", @INC'
Before running 'make install' you need to make sure that PostgreSQL is running. On a Linux distribution that uses SysV style init scripts, Such as Debian and Solaris, the command to start will be along the lines of /etc/init.d/postgresql start. Red Hat puts init scripts under /etc/rc.d/init.d/
After the above is taken are of you can run 'make install' as the root user with the appropriate variables:
# make install