Home    System Requirements    Basic Installation    Server Option Installation    Progress Report     Basic Manual   Server Option Manual

Basic Installation

  1. Download payrollbash.tar.gz.

  2. As "su" create user "payroll"
       /># adduser payroll
       /># passwd payroll

  3. Place payrollbash.tar.gz in "/home/payroll"

  4. Give ownership of file to "payroll"
       /># chown payroll /home/payroll/payrollbash.tar.gz


  5. Login as "payroll"

  6. Unzip the file
       /home/payroll>$ tar zxvf payrollbash.tar.gz

  7. You can put the files in another location (eg ./foo ) if you wish . Once you have unzipped the file from dir "foo" you will need to edit foo/bin/prbash. Amend the assignment line "dir=/home/payroll/payrollbash-1.xx" to "dir=/'full path'/foo/payrollbash-1.xx" where xx is the version number. This instruction manual will refer to /home/payroll as the default directory so substitute your directory accordingly.
    [I do however feel it would be a good idea to create a unique user "payroll" so that confidential information can be stored out of harms way and so that another person can be given the password if and as required.]

  8. You will now have 4 sub directories : "bin" "database" "manual" "tmp" within directory "payrollbash-1.xx".

  9. Place the "bin" directory in your PATH
      eg:/home/payroll> $ PATH=$PATH:/home/payroll/payrollbash-1.xx/bin
    and edit your .bash_profile so that the above is automatic upon login.

  10. Ensure that the file./bin/prbash is executable.

  11. type
      /home/payroll>$ prbash
    and you should be seeing the opening menu:

_____________________________________________________________________________



		 Soap plc : Payroll


		"1" "Prepare input:Overtime/Payments/Deductions"
		"2" "Process Monthly/Weekly Payroll"
		"3" "View Error Log"
		"4" "View Payslips"
		"5" "View Nominal Analysis"
		"6" "View Remittance Lists"
		"7" "View P11Dtax schedules"
		"8" "View P11Dni schedules"
		"9" "Period-end run down"
		"A" "Year-end run down"
		"B" "Edit Organisation database"
		"C" "Edit/Create payroll database"
		"D" "Edit/Create payment/deduction profiles"
		"E" "Run Health Check"
		"F" "Back-up to floppy"
		"G" "Manual"
		"q" "Quit

               Enter your choice : ->

_____________________________________________________________________________
....... if not type:    /home/payroll>$ echo $PATH    .... to check that step 9 was successful.

....... and

   /home/payroll>$ ls -al ./payrollbash-1.xx/bin    .... to check that prbash is executable.

If you see this screen .............

_______________________________________________________________________________

payrollBASH requires "bc" to be installed.

-- Hit any key to exit --

_______________________________________________________________________________


....... then you will have to install "bc" .....the gnu arbitary precision calculator .

Most distro's have it on one of their CD's but if not it is freely available off the net.

"bc" does all the non-integer calculations that "bash" can't handle .