Install 2 0
Version 7 (Paul Holland, 04/05/2012 08:28 pm) → Version 8/11 (Mark Donohoe, 04/30/2012 10:57 pm)
h1. FOSSology 2.0 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.
h1. 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 fossology@fossology.org. The Debian packages tend to be much better tested than the rpm based packages since most of the developers use Debian.
|_\2. FOSSology Install Links |
|_. Distro/Version |_. FOSSology 2.0 |
| *Debian "Squeeze"* | [[Debian_Install_2_0|Debian Install]] |
| *Ubuntu "Lucid"* | [[Ubuntu_Install_2_0|Ubuntu Install]] |
| *Ubuntu "Natty"* | [[Ubuntu_Install_2_0|Ubuntu Install]] |
| *Ubuntu "Oneiric"* | [[Ubuntu_Install_2_0|Ubuntu Install]] |
| *Fedora 15* | [[Installing_FOSSology_with_RPM's_2_0|Installing FOSSology with RPM's]] |
| *RHEL6.1* | [[Installing_FOSSology_with_RPM's_2_0|Installing FOSSology with RPM's]] |
h3. 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.0 INSTALL file":http://fossology.svn.sourceforge.net/viewvc/fossology/branches/fossology2.0/fossology/install/INSTALL.
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.
h1. Installation from source
h2. 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.
* "FOSSology version 2.0 INSTALL file":http://fossology.svn.sourceforge.net/viewvc/fossology/branches/fossology2.0/fossology/install/INSTALL
h2. Multi-system source install
# Perform the steps above (for Single system source install) on the system that will run your scheduler/web/db services
# Perform steps up to 'make install' on each of the "agent" systems (i.e. systems that will run fossology jobs)
# run 'sudo fo-postinstall -a'
Continue with "cluster-install":http://www.fossology.org/projects/fossology/wiki/Debian_Install_2_0. [[cluster-install|cluster specific configuration changes]].
h1. Upgrading from the previous release of FOSSology
h4. 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:
<pre>
sudo /etc/init.d/fossology stop
</pre>
* Verify you have the correct entry in your /etc/apt/sources.list file: "Debian Install":http://www.fossology.org/projects/fossology/wiki/Debian_Install_2_0 [[Debian Install | sources.list file entries]]
And then
<pre>
apt-get update; apt-get upgrade fossology
</pre>
* Check the scheduler configuration with:
<pre>
sudo /usr/lib/fossology/fossology-scheduler -t -L stdout
</pre>
* Examine the logfile for errors (/var/log/fossology/fossology.log). (/var/log/fossology/fossology.log) or stdout if -L stdout was used. If there are no errors, you should see "STATUS: All scheduler agents are operational." at the end of the file.
* Start the scheduler
<pre>
sudo /etc/init.d/fossology start
</pre>
You're done!
h4. 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:
<pre>
sudo /etc/init.d/fossology stop
</pre>
* Uncompress the fossology-<ver>.tar.gz file into a build directory and build.
<pre>
tar -xzvf fossology-<ver>.tar.gz
cd fossology-<ver>
make
sudo make install
</pre>
* Run fo-postinstall to build the data base, data initialization (if any) and add the fossy user & fossy group.
<pre>
sudo /usr/local/lib/fossology/fo-postinstall
</pre>
* Start Check the scheduler configuration with:
<pre>
sudo /etc/init.d/fossology start /usr/lib/fossology/fossology-scheduler -t -L stdout
</pre>
* Examine the logfile for errors (/var/log/fossology/fossology.log) or stdout if -L stdout was used. If there are no errors, you should see "STATUS: All scheduler agents are operational." at the end of the file.
* Start the scheduler
<pre>
sudo /etc/init.d/fossology start
</pre>
You're done!
h1. 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.
h4. How to upgrade a single system install
h5. 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
# PROFIT!!!!!!
h5. 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'
h5. NOTES:
* 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.
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.
h1. 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 fossology@fossology.org. The Debian packages tend to be much better tested than the rpm based packages since most of the developers use Debian.
|_\2. FOSSology Install Links |
|_. Distro/Version |_. FOSSology 2.0 |
| *Debian "Squeeze"* | [[Debian_Install_2_0|Debian Install]] |
| *Ubuntu "Lucid"* | [[Ubuntu_Install_2_0|Ubuntu Install]] |
| *Ubuntu "Natty"* | [[Ubuntu_Install_2_0|Ubuntu Install]] |
| *Ubuntu "Oneiric"* | [[Ubuntu_Install_2_0|Ubuntu Install]] |
| *Fedora 15* | [[Installing_FOSSology_with_RPM's_2_0|Installing FOSSology with RPM's]] |
| *RHEL6.1* | [[Installing_FOSSology_with_RPM's_2_0|Installing FOSSology with RPM's]] |
h3. 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.0 INSTALL file":http://fossology.svn.sourceforge.net/viewvc/fossology/branches/fossology2.0/fossology/install/INSTALL.
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.
h1. Installation from source
h2. 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.
* "FOSSology version 2.0 INSTALL file":http://fossology.svn.sourceforge.net/viewvc/fossology/branches/fossology2.0/fossology/install/INSTALL
h2. Multi-system source install
# Perform the steps above (for Single system source install) on the system that will run your scheduler/web/db services
# Perform steps up to 'make install' on each of the "agent" systems (i.e. systems that will run fossology jobs)
# run 'sudo fo-postinstall -a'
Continue with "cluster-install":http://www.fossology.org/projects/fossology/wiki/Debian_Install_2_0. [[cluster-install|cluster specific configuration changes]].
h1. Upgrading from the previous release of FOSSology
h4. 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:
<pre>
sudo /etc/init.d/fossology stop
</pre>
* Verify you have the correct entry in your /etc/apt/sources.list file: "Debian Install":http://www.fossology.org/projects/fossology/wiki/Debian_Install_2_0 [[Debian Install | sources.list file entries]]
And then
<pre>
apt-get update; apt-get upgrade fossology
</pre>
* Check the scheduler configuration with:
<pre>
sudo /usr/lib/fossology/fossology-scheduler -t -L stdout
</pre>
* Examine the logfile for errors (/var/log/fossology/fossology.log). (/var/log/fossology/fossology.log) or stdout if -L stdout was used. If there are no errors, you should see "STATUS: All scheduler agents are operational." at the end of the file.
* Start the scheduler
<pre>
sudo /etc/init.d/fossology start
</pre>
You're done!
h4. 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:
<pre>
sudo /etc/init.d/fossology stop
</pre>
* Uncompress the fossology-<ver>.tar.gz file into a build directory and build.
<pre>
tar -xzvf fossology-<ver>.tar.gz
cd fossology-<ver>
make
sudo make install
</pre>
* Run fo-postinstall to build the data base, data initialization (if any) and add the fossy user & fossy group.
<pre>
sudo /usr/local/lib/fossology/fo-postinstall
</pre>
* Start Check the scheduler configuration with:
<pre>
sudo /etc/init.d/fossology start /usr/lib/fossology/fossology-scheduler -t -L stdout
</pre>
* Examine the logfile for errors (/var/log/fossology/fossology.log) or stdout if -L stdout was used. If there are no errors, you should see "STATUS: All scheduler agents are operational." at the end of the file.
* Start the scheduler
<pre>
sudo /etc/init.d/fossology start
</pre>
You're done!
h1. 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.
h4. How to upgrade a single system install
h5. 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
# PROFIT!!!!!!
h5. 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'
h5. NOTES:
* 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.