These instructions do not take into account security issues. There are many possible
system configurations that can enhance security, none of which will be mentioned
here. System administration is beyond the scope of this document. These instructions
try to insure that you have a running program regardless of your system environment.
In all matters of system configuration I use debian standards, which may need to be
modified to work under other systems

The apache web server configuration files are usually located in the /etc/apache2
directory when using linux. I believe Windows uses the folder where apache is installed.
Trucklog has never been tested under the Windows web server as far as I know.

1) Enable cgi execution using the a2enmod command.

Load apache2 cgi_module (in debian: cgi.load)
Under debian use this command: a2enmod cgi

2) Enable directory access for the trucklog directory.

Either add these lines to the apache2 configuration file or add them to a
seperate configuration file and use the apache2 include command to load that file.
Debian has specific file system structures to handle this, which can be used or not.
The drive letter is for Windows installations only, remove it for linux.
Replace the path with the path to your DocumentRoot and append the name of
the folder containing all the trucklog files.

Configuration directive for Apache versions less than 2.4

<Directory C:/var/www/trucklog>
   Options +ExecCGI
   Order Allow,Deny
   Allow from All
   DirectoryIndex index.py
   AddHandler cgi-script.py
</Directory>

Configuration directive for Apache versions greater than or equal to 2.4

<Directory "C:/www/trucklog">
    Options +ExecCGI
    Require all granted
    DirectoryIndex index.py
    AddHandler cgi-script .py
</Directory>

For Linux/Unix make log conf and tmp directories writable by the Apache user.

a) Login as user root and set the directory permissions :

set all directories so that any user can cd to them
chmod 755 *
set the owner to the webserver user (www-data)
chown -R www-data *

b) As user root from the trucklog directory Set all .py files to be executable.

Windows typically does not require file/folder changes.

Make sure that all files/folders are set to read/write
.py files need to be executable
Windows10 may require specific permissions if installed system wide.

Install Python >= v3.5

Edit the first line in every trucklog file ending in '.py'
so that the path points to the python version 3 executable:
#! /usr/bin/python3

Download and install Python v3
Note where Python is installed, for example C:\Python3x.

Edit the first line in every trucklog file ending in '.py'
so that the path points to the python executable:
#! C:/Python3x/python.exe

Restart the Apache server.

Use this command: systemctl restart apache2
If that doesn't work, try: /etc/init.d/apache2 restart

The Apache installation comes with a gui to control the server.
Use that to restart the server.

Type http://localhost/trucklog/trucklog.py in your browser's address field.
Press the return key and you should see the trucklog home screen.
If not go back over these instructions to make sure you got it all right.

BROWSER SPECIFIC INSTRUCTIONS

******** Firefox was used for development and is recommended.
******** Set printer to print background colors.
******** Disable all printer header and footer text.