The Linux version of the toolkit must be compiled from source code. The only requirement is the standard GNU/Linux toolchain consisting of make, gcc and ld. These are included with most Linux distributions but may require installation. On Debian based distributions, such as Ubuntu, they may be installed using apt-get. On RedHat distributions, such as Fedora, they may be installed using rpm. On SuSE based distributions, they may be installed using YaST2.

# cp plc-utils-x.x.x.tar.gz /home/mydir # cd /home/mydir # tar -vzxf plc-utils-x.x.x.tar.gz # cd plc-utils-x.x.x # make # sudo make install # sudo make manuals Decompress the archive and extract the contents with the tar utility. This will create a folder having the same basename as the archive such that one version will not over-write another. Consult the tar man page on your system for detailed instructions. Change directory to the appropriate folder. The main package folder contains a recursive Makefile that will compile and install all toolkit programs. If you do not want to compile and install all programs then change directory to the appropriate folder and run make from there. To compile binary files, type make. To install binary files, type sudo make install. To install man pages, type sudo make manuals. The package does not automatically install examples, scripts, applets or man pages. Anyone can compile and run the toolkit in their own folder but one must become a member of the sudo group and know the root password in order to install the toolkit. We recommend that you install the toolkit so that is accessible to everyone from anywhere on your file system. Programs are installed in folder /usr/local/bin and man pages are installed in folders /usr/share/man/man7. If these folders are not correct for your system, or if you want to install in other folders, then edit the folder names defined in the make.def file found in main toolkit folder or over-ride these definitions in subordinate makefiles.

Toolkit web pages are not automatically installed. To access toolkit documentation, point your browser to docbook/index.html and add the page to the browser bookmark or favorites list. If you are interested in how the toolkit has been implemented then do the same for page docbook/toolkit.html. The method described above is only recommended if you do not plan to move or remove toolkit folders. Otherwise, you can merely copy the entire contents of the toolkit docbook folder to another folder of your choice and point your browser to the new file locations. cp -rv docbook/* /home/mydir/toolkit

To uninstall installed programs and man pages on Linux, change to the main toolkit folder and type make uninstall. # cd /home/mydir/plc-utils-1.2.1 make uninstall