Date: 18 December 2007 The initial public release of FOSSology.

Please refer to the README file contained in the fossology download for first time installation instructions.

If you are updating a fossology installation created with pre-release bits, please follow the update process below.

A freshly installed system cannot create a new folder in the UI on the first try. The second and subsequent attempts succeed.

The unpack agent extracts files from containers. A container is any kind of file that stores other files. unpack uses utilities, such as, tar, gzip, ar, rpm, zcat, etc. to perform the extraction. In cases where the container is corrupt or otherwise ill-formed, the utilities may fail to successfully extract. The unpack agent will report this as a warning and skip to the next container. The warnings can be safely ignored. An example of a failed extraction and subsequent unpack warning is:

WARNING pfile 1153340 Minor zip error... ignoring error.
LOG pfile 1153340 Minor zip error(2)... ignoring error.
WARNING pfile 1153340 Command bzcat failed
LOG pfile 1153340 WARNING Command bzcat failed:
/srv/fossology/repository//ununpack/0/916132eba75e9fcb069c7b6327f60b3b318ceef0. \
6ab7c5ecb2f03728c63644e4250bde34.656852992.dir/SRPMS/iscsi-initiator-utils- \
6.2.0.742-0.5.el5.src.rpm.unpacked.dir/iscsi-initiator-utils-drop-bad-events.patch

At peak processing times, the show jobs status window will display jobs in a ready or scheduled state for a long time (typically when processing many projects at once or large projects). This is normal behavior and dependent on the number and speed of the agents running.

The following messages are written to the log file each time the agent pkgmettagetta executes on 64 bit processors.

Loading `libextractor_exiv2' plugin failed:
/usr/lib/libextractor/libextractor_exiv2.so: cannot open shared object file:   
No such file or directory
Loading `libextractor_ole2' plugin failed: 
/usr/lib/libextractor/libextractor_ole2.so: cannot open shared object file:
No such file or directory
Loading `libextractor_ogg' plugin failed: 
/usr/lib/libextractor/libextractor_ogg.so: cannot open shared object file:
No such file or directory
Loading `libextractor_mpeg' plugin failed: 
/usr/lib/libextractor/libextractor_mpeg.so: cannot open shared object file:
No such file or directory

Perform the following steps to update and existing fossology database.

invoke psql as user fossy

psql -U fossy -d fossology

cut-n-paste the following lines at the fossology⇒ prompt:

alter table agent_lic_raw  add column lic_url text; 
alter table agent_lic_raw  add column lic_date timestamp with time zone; 
comment on column agent_lic_raw.lic_url is 'URL origin of the license'; 
comment on column agent_lic_raw.lic_date is 'when license text was captured'; 
alter table jobqueue  add column jq_elapsedtime integer default 0; 
alter table jobqueue  add column jq_processedtime integer default 0; 
alter table jobqueue  add column jq_itemsprocessed integer default 0; 
comment on column jobqueue.jq_elapsedtime is 'Elapsed secs working on jq'; 
comment on column jobqueue.jq_processedtime is 'sum of process times (secs) from all agents'; 
comment on column jobqueue.jq_itemsprocessed is 'sum of files processed by all agents';