History

« Previous - Version 11/41 (diff) - Next » - Current version
Mark Donohoe, 04/30/2012 07:12 pm

Release Notes

Release Notes¶

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

2.0
Release Date: ESTIMATED beginning of May 2012¶

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.

Issues fixed in 2.0 ¶

Known Issues in 2.0 ¶

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 apt-get|yum update; apt-get|yum install fossology 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.

Install Steps.¶

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 file fossology.conf.

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

Unofficial FOSSology packages¶

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

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

1.4.1
Date: July 2011¶

Bug Fix release

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 user documentation
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
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.

1.3.0¶

Date: January 2011

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

The 'supported distros' matrix can be found 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.

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.

Known Issues in 1.3.0 ¶

Details for outstanding non-critical bugs can be found at our bug tracking site.
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=&lt;agent_hostname&gt; | /usr/bin/ssh fossy@&lt;agent_hostname&gt; "/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:

  $ 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;

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

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

  ---------

   67366928
  (1 row)

* 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.

FOSSology

Documentation

Release Notes¶

2.0 Release Date: ESTIMATED beginning of May 2012¶