FOSSology

{{toc}}

h1. Release Notes

This page maintains the FOSSology Project release notes, from the most recent release to the oldest release.

h2. 2.0 

Release Date: ESTIMATED beginning of May 2012

h3. New Features (WORK IN PROGRESS)

  * The scheduler has been redesigned and reimplemented to improve robustness.

  * Modular agents.  Agents can now have their own release stream.

  * Scan logs are now independent of the fossology scheduler log, and can be viewed using the GUI.

  * Nomos license additions and corrections.

  * Buckets can now select from a list of datasets.

  * bsam license scanner no longer installed by default.

  * Tagging can be done from Nomos and Buckets file browser.

  * Search by tag.

  * Tags are now listed in Nomos and Buckets file browser.

  * Nomos and Buckets reports can be filtered by tag.

  * New agents can rescan files.

h3. "Issues fixed in 2.0":http://www.fossology.org/projects/fossology/issues?set_filter=1&f%5B%5D=status_id&op%5Bstatus_id%5D=%3D&v%5Bstatus_id%5D%5B%5D=27&f%5B%5D=fixed_version_id&op%5Bfixed_version_id%5D=%3D&v%5Bfixed_version_id%5D%5B%5D=3&f%5B%5D=&c%5B%5D=tracker&c%5B%5D=status&c%5B%5D=priority&c%5B%5D=subject&c%5B%5D=assigned_to&c%5B%5D=author&c%5B%5D=category&c%5B%5D=fixed_version&c%5B%5D=created_on&group_by=status

h3. "Known Issues in 2.0":http://www.fossology.org/projects/fossology/issues?query_id=15

h2. Known Install Issues

Note for Rhel6 packages: FOSSology depends on the package php-process, which is not available from the default RHEL repository. You can download a copy from:

http://fossology.org/rpms/epel/testing/6/i386/php-process5.3.2-6.el6_0.1.i686.rpm

http://fossology.org/rpms/epel/testing/6/x86_64/php-process-5.3.2-6.el6_0.1.x86_64.rpm 

Or apply this update: https://rhn.redhat.com/errata/RHSA-2011-0195.html

If this is an upgrade, the proper way to upgrade FOSSology is to use <code>apt-get update; apt-get install fossology</code> after changing the sources.list file.  Using __apt-get upgrade fossology__ **will not work.**

The apache configuration may need to be modified (remove the old 1.x.x configuration from sites-available/default).  FOSSology now configures apache to use fossology.

The baseurl in the fossology.repo file for Fedora and RHEL releases is **incorrect**.  After fossology installation the above file should be edited to use one of the URL's below.

h2. Install Steps.

h3. Recommended steps for upgrading

# Change sources.list or the baseurl in the fossology.repo file (see below)

# Debian/Ubuntu: apt-get update; apt-get install fossology

   RHEL/Fedora: yum update; yum install fossology

# Shut down the scheduler: /etc/init.d/fossology stop

# Make adjustments in the apache2/httpd configuration as needed.

# Restart apache/http and postgresql so the new configurations take affect.

# Start the fossology scheduler: /etc/init.d/fossology start

FOSSology uses a new combined configuration file, called **fossology.conf**. Additional cleanup can be done in /etc/fossology.  The following old files can be removed:

* Depth.conf

* Hosts.conf

* Proxy.conf

* RepPath.conf

* Scheduler.conf

These files are no longer used by fossology and so can be safely removed.  Before removing them, determine what settings in those files should be in the new configuration **fossology.conf**.

h3. New Installs

# Configure apt or yum with one of the url's below.

# Read the INSTALL document for configuration of postgresql, php5 and apache/httpd. **(WHere is the INSTALL doc on the wiki? don't want them to have to check out source.....)**

# After the system is configured, install fossology.

# Restart apache/httpd and postgresql

h2. Unofficial FOSSology packages

Unofficial install packages on the following supported platforms & distros are now available (32 and 64 bit) for download and testing:

h3. RHEL/Centos:

http://fossology.org/releases/2.0.0-rc1/RHEL/6.x/6/

h3. Fedora 15:

http://fossology.org/releases/2.0.0-rc1/Fedora/15/

h3. Debian:

http://fossology.org/releases/2.0.0-rc1/Debian/squeeze/ 6.0 contrib

h3. Ubuntu:

10.04.3:

http://fossology.org/releases/2.0.0-rc1/Ubuntu/ 10.04 contrib

11.04:

http://fossology.org/releases/2.0.0-rc1/Ubuntu/ 11.04 contrib

11.10

http://fossology.org/releases/2.0.0-rc1/Ubuntu/ 11.10 contrib

h2. 1.4.1

Date: July 2011

  * Bug Fix release

h2. 1.4.0 

Date: April 2011

  * [[compare:licensediff|New Comparison tool]]. This allows one to focus on the differences between two file trees. For example, you might want to compare two versions of a package to see what licenses changed.

  * A new [[altui:alternateui|simplified User Interface]] AND the option to assign the “Simplified” or “Original” UI on a per user basis.  The Simplified UI is now the default for new users.

  * Implement [[tasks:authentication_using_siteminder|authentication using Siteminder]]

  * Improved [[quickstart|user documentation]]

  * [[upload_from_a_url|Multiple file upload from URL]]

  * Dramatic Improvements to the [[copyright:copyright_1.4.0|copyright agent]]

  * New FOSSology [[config:how_to_configure_the_fossology_site | website customization]].

  * Bugs addressed in this release: "1.4.0 Defect List":http://bugs.linux-foundation.org/buglist.cgi?query_format=advanced&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&target_milestone=1.3.1&target_milestone=1.4&product=FOSSology

  * If you have created bucket files or scripts, then you need to move your bucketpool directory from DATADIR to PROJECTSTATEDIR.  Admins can see where these locations are from the main menu Help > Debug > Global Variables.  If you don't use buckets, or all your buckets are by regexes in the database, then you can ignore this.

h2. 1.3.0 

Date: January 2011

*New!* FOSSology generated Ubuntu debs for Karmic, Lucid and Maverick.

The 'supported distros' matrix can be found [[download#supported_distro_s|here]].

New features and fixes in 1.3.0 include:

  * Groups.  Implemented user groups inside of fossology as an indirect but critical requirement for 1.3 because tagging (the real 1.3 requirement) is dependent on having groups to administer tag permission.

  * File Tagging.  The ability to attach a tag (short (max 32 character) tag, plus a long text) to a file or container.

  * Copyright agent replaced. A quick experiment showed that we get better results with simple heuristics rather than the old agent based on naive Bayes. 

  * Fixed a cp2foss authentication bug that prevented bucket agent from getting scheduled.

  * fixed unpack defects and made some improvements.

h3. Last Release for bsam agent 

After the 1.3.0 release the bsam and spec file agents will be removed from the product.  Existing bsam analysis will still be able to be viewed, but no new analysis by the bsam agent will be available.  The nomos agent is much faster and more accurate.  Users are encouraged to use the nomos license agent and to rescan their existing bsam uploads with nomos.

h3. Known Issues in 1.3.0 

  * Details for outstanding non-critical bugs can be found at our "bug tracking site":http://bugs.linux-foundation.org/buglist.cgi?query_format=advanced&bug_severity=major&bug_severity=normal&bug_severity=minor&bug_severity=trivial&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=FOSSology.

  * When upgrading from the previous version, you'll have to manually update the /etc/fossology/Scheduler.conf file to 

  # delete entries for pkgmettagetta

  # modify the entry for the copyright agent.  The copyright line in Scheduler.conf should look something like this (where <agent_hostname> should be replace with the actual hostname):

  agent=copyright host=<agent_hostname> | /usr/bin/ssh fossy@<agent_hostname> "/usr/lib/fossology/agents/copyright"

  * The 1.3.0 upgrade for a fossology instance with a large number of entries in the copyright table (millions) can take a several hours due to a change in data type.  (This was discovered while attempting to update a copyright table with >51 million records.)  If your installation appears to hang at "Applying database schema", then you may find it faster to use the following workaround to speed up the installation.  

Use the following ALTER command to change the datatype:

<pre>

  $ psql -U fossy -d fossology

Password for user fossy:

  Welcome to psql 8.3.12, the PostgreSQL interactive terminal.

  Type:  \copyright for distribution terms

       \h for help with SQL commands

       \? for help with psql commands

       \g or terminate with semicolon to execute query

       \q to quit

  fossology=> ALTER TABLE "public"."copyright" ALTER COLUMN "ct_pk" TYPE bigint;

</pre>

You can examine the size of your copyright table using this SELECT command:

<pre> 

   fossology=> Select count(*) from public.copyright;

    count

  ---------

   67366928

  (1 row)

</pre>

  * In order to unpack rar(>=RAR 3.x) file(s), you need to install rar(non-free) manually. In debian, you can install it through adding the non-free source, then apt-get install unrar. In centos and fedora, you can install it through adding the rpmfusion source, then yum install unrar.