Installation – Linux

Placement

  • If you are using Windows, go to Installation – Windows. This page is for Linux users only.
  • Download the Linux application file using the DOWNLOAD menu at the top of this web page
  • Unzip the downloaded file ( command-line: gunzip filename )
  • The application runs as a self-contained user installation, not system wide. Root access is not required
  • Create a new directory in which to keep the installation and copy the file to this empty directory – all working files will be created there. A fresh directory should be used each tax year commencing 6th April.
  • Change the permissions on the file ( command-line: chmod 770 filename

Running the application

  • Change to the directory containing the application ( command-line: cd directoryname )
  • Run it from there ( command-line: . /appname )
  • The app creates a new database file if one is not present in the run-location.
  • Avoid running the app from a different location once the tax year has been started, without also copying the database file to the new location. Otherwise a fresh (empty) database will be created in the new location and it will be back to square one.
  • For convenience, create a desktop launcher (shortcut) to start the application. Methods will vary according to the Linux distribution and window-manager in use.
  • AW-APPS Payroll runs on the latest stable versions of Debian and Ubuntu. If difficulty is encountered with other Linux distributions, please contact admin@aw-apps.co.uk with relevant details.

Document system

  • Reports are created in PDF format. Your system needs to have the Evince document viewer installed. Please check your package manager to see if Evince is already present and if not, you should install it.
  • Testing With at least one company appearing in the company-selector (top left), the document system can be tested by choosing Reports-Company-TaxPayableRecord from the top menu-bar. If the report opens on screen, all is well.

P45 forms (optional)

  • The PDF Toolkit pdftk needs to be installed using your package manager
  • the skeleton pdf file awappsp45.pdf needs to be downloaded from aw-apps.co.uk and extracted to the installation directory.

After installation

Installing Updates – current tax year

To update an existing aw-apps payroll installation to the latest version:

  • Download the latest version of the Linux application file using the DOWNLOAD menu at the top of this web page
  • Place the downloaded file in the existing Installation Folder.
  • Unzip the downloaded file ( command-line: gunzip newfilename )
  • Delete the old application file ( command-line: rm oldfilename )
  • Change the permissions on the new file ( command-line: chmod 770 newfilename )
  • If there is a desktop launcher (shortcut) in use, edit its properties to show the new application filename.
  • Continue as normal but using the new application file. Check that the new version number appears at the top.

Installing Updates – new tax year

To update an existing aw-apps payroll to a new tax year:

  • Create a backup copy of the old tax year installation folder
  • Download the latest version of the Linux application file using the DOWNLOAD menu at the top of this web page
  • Place the downloaded file in a newly created Installation Folder.
  • Unzip the downloaded file ( command-line: gunzip newfilename )
  • Change the permissions on the new file ( command-line: chmod 770 newfilename )
  • Create a fresh desktop launcher (shortcut) if required.
  • Continue as normal but using the new application file. Check that the new version number and tax year appear at the top.
  • When the application runs for the first time in the new tax year, it will ask if you wish to import data from the old tax year, giving a fresh record for each existing employee. Click OK to do this, then select the folder containing the installation for the old tax year. Otherwise a new empty database will be created with no employees. If this happens accidentally, delete everything in the new year folder apart from the downloaded application file before starting the application again from scratch.