FOSSology 2.1 Installation & Upgrades

This page has detailed installation instructions or links for all Fossology packages (and the source tarball).

It is important that the download page also be consulted to determine if the release/distro you are trying to install has been tested by FOSSology or the community.

Installation Cookbook

Use the table below to find the specific installation page for the Distro/Release you are installing. Has the download page been consulted to see if the release has been tested on the Distro of interest?

If you have any trouble installing from these packages, please write to our mailing list . The Debian packages tend to be much better tested than the rpm based packages since most of the developers use Debian.

FOSSology Install Links
Distro/Version FOSSology 2.1
Debian "Squeeze" Debian Install
Ubuntu 12.04 Ubuntu Install
Fedora 17 Installing FOSSology with RPM's
RHEL6.x Installing FOSSology with RPM's

Post Install

After installing FOSSology, the system still needs configuration to allow FOSSology to operate correctly.

The full instructions are available in the source install file FOSSology version 2.1 INSTALL file
To summarize, the following must be configured:

  • kernel parameters
  • Adjust postgresql configuration
  • Adjust PHP config (both apache and cli)
  • Adjust apache2 configuation (sites-available)

See the above INSTALL file for details.


Installation from source

Single system source install

The FOSSology source code ships with a text file called INSTALL. This file contains detailed instructions for how to perform an installation of FOSSology on nearly any system.

Multi-system source install

  1. Perform the steps above (for Single system source install) on the system that will run your scheduler/web/db services
  2. Perform steps up to 'make install' on each of the "agent" systems (i.e. systems that will run fossology jobs)
  3. run 'sudo fo-postinstall -a'

Continue with cluster-install.

Upgrading from the previous release of FOSSology

Upgrading FOSSology from a previously installed deb package

If you are upgrading FOSSology from a previously installed deb package, then follow these easy steps:

  • Stop the scheduler:
sudo /etc/init.d/fossology stop
  • Verify you have the correct entry in your /etc/apt/sources.list file: Debian Install
apt-get update; apt-get upgrade fossology
  • Examine the logfile for errors (/var/log/fossology/fossology.log). If there are no errors, you should see "STATUS: All scheduler agents are operational." at the end of the file.
  • Start the scheduler
sudo /etc/init.d/fossology start

You're done!

Upgrading FOSSology from a tarball

If you are upgrading FOSSology installation built from the previous release source using the newly released tarball follow these directions:

  • Stop the scheduler:
sudo /etc/init.d/fossology stop
  • Uncompress the fossology-<ver>.tar.gz file into a build directory and build.
tar -xzvf fossology-<ver>.tar.gz
cd fossology-<ver>
sudo make install
  • Run fo-postinstall to build the data base, data initialization (if any) and add the fossy user & fossy group.
sudo /usr/local/lib/fossology/fo-postinstall
  • Start the scheduler
sudo /etc/init.d/fossology start

You're done!

Upgrading from Older FOSSology Releases

You can use one of the following procedures to upgrade from 1.4.x to current release on Ubuntu. For Debian lenny just follow the instructions in Debian Install. NOTE the FOSSology team has not tested these procedures. The team believes they will work. They are similar to the procedure for upgrading from the previous release. The FOSSology team would like to hear from anyone who has tried these.

How to upgrade a single system install

For debian package installs:

# configure apt to point at the apt source of the new version for your distro version (may not even be needed depending on your situation)
# apt-get upgrade

For upstream installs:

All steps as root

# stop the scheduler using '/etc/init.d/fossology stop'
# remove the fossology software (but not data)
* If you still have the build tree from the current installed version do "make uninstall"
* IF you don't have the build tree from the current installed version OR your current version is <1.0.0 OR you are lazy, THEN run "utils/fo-cleanold". (DO NOT add any options to fo-cleanold, you are just trying to remove the software, not the data.)
# install the new version
* In the new source tree run "make;make install"
* run "/usr/local/lib/fossology/fo-postinstall"
# start the scheduler using '/etc/init.d/fossology start'


* If you messed up an upstream install and want to start over, fo-cleanold has flags you can use to do that, but they will DELETE DATA so make sure you know what you are doing. Run 'fo-cleanold --help' for more info.
* Upgrading from an upstream install to a package install or vise versa is possible, but tricky. It is recommended that you stick with one or the other.