Release Preparation

Notes for the release of Kvalobs as Open Source Software

Composition of release

NB internal links below

kvalobs http://cvs/cgi-bin/cvsweb/kvalobs/?only_with_tag=kvalobs-drift-1-0

kvalobs_metadata http://cvs/cgi-bin/cvsweb/kvalobs_metadata/

kvhqc http://cvs/cgi-bin/cvsweb/kvhqc/

kvhqc_apps http://cvs/cgi-bin/cvsweb/kvhqc_apps/

Also required

libpuTools http://cvs/cgi-bin/cvsweb/puglocal/src/libs/puTools/

The puTools library is to be released under subversion separately (i.e. shared with other projects such as Diana). puTools is already an open-source library under LGPL 2.1.

Overall project name

The software to be released as open source has been collectively termed “kvalobs” in discussions between met.no and smhi. However, the s/w comprises four parts: kavlobs, kvalobs_metadata, kvhqc and kvhqc_apps

It is proposed to group the software under one project name. Here are some suggestions:

kvalobs

kvnose [no:norge se:sverige]

kvoss [oss:open source software]

+Please email kvalobs-dev@met.no with your preference/proposal.

One advantage of this is that access to the group of s/w in subversion can be achieved by only setting access to a single folder.

Proposed structure under subversion

... using the project name kvoss only as an example ...

https://svn.met.no/kvoss
https://svn.met.no/kvoss/kvalobs/trunk
https://svn.met.no/kvoss/kvalobs/branches
https://svn.met.no/kvoss/kvalobs/tags
https://svn.met.no/kvoss/kvalobs_metadata/trunk
https://svn.met.no/kvoss/kvalobs_metadata/branches
https://svn.met.no/kvoss/kvalobs_metadata/tags
https://svn.met.no/kvoss/kvhqc/trunk
https://svn.met.no/kvoss/kvhqc/branches
https://svn.met.no/kvoss/kvhqc/tags
https://svn.met.no/kvoss/kvhqc_apps/trunk
https://svn.met.no/kvoss/kvhqc_apps/branches
https://svn.met.no/kvoss/kvhqc_apps/tags
i.e. in general
https://svn.met.no/project-group/project/trunk
/branch
/tags

Initial population

prepare the directories trunk, branches and tags under all projects

(kvalobs example) copy from cvs/kvalobs to svn.met.no/kvoss/kvalobs/trunk

also tagged copy to svn.met.no/kvoss/kvalobs/tags/kvalobs-oss-launch with --message “first release of project_name as open source software”

Gaining write access

Full access to subversion requires a user account to be set up by the subversion server system administrator. Proposal: This can be achieved by having an email address for request of account available on the project wiki pages. The address will be to a moderator (or group of moderators) who then inform system administrator that a new account is needed (forward email to system administrator).

+Email address for account administration to be set up.

Initial Revision.

Propose that the first versions opened on subversion are classified as a Beta-Version.

The s/w run at met.no is mature (and for kvalobs it is version 1.1.2.53 for example). The Beta Versioning is to indicate that steps are required to make the s/w more accessible for use in an open-source context. These steps may include:

Provision of a detailed installation guide

Removal of any specific met.no environment features (e.g. the kvalobs database has to be run by a user kvalobs)

Provision of an autoconf script or similar autobuild tools.

Licensing

All software, not already under license, to be placed under the GNU General Public License (GPL) http://www.gnu.org/copyleft/gpl.html.

In the repository the full license will be imported in the file COPYING e.g. svn.met.no/kvoss/kvalobs/trunk/COPYING

Propose to start with GPL v3. The reasoning is that this is the latest version. Note DIANA is currently using version 2 of GPL. PLEASE DISCUSS.

Example header:

/*
Kvalobs - Free Quality Control Software for Meteorological Observations
$Id: klfilterTest.java,v BETA September 24 2007
Copyright (C) 2007 met.no
Contact information:
Norwegian Meteorological Institute
Box 43 Blindern
0313 OSLO
NORWAY
email: kvalobs-dev@met.no
This file is part of KVALOBS
KVALOBS is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 3
of the License, or (at your option) any later version.
KVALOBS is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with KVALOBS; if not, write to the Free Software Foundation Inc.,
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/

And similar for kvalobs_metadata, kvhqc, etc.

See http://www.gnu.org/licenses/gpl-howto.html for other acceptable variations on the above header.

Copyright Handling

All code is now issued with “Copyright (C) 2007 met.no.” How will the evolution of the copyright be handled?

Shall we adopt a policy of “Contributor license agreement” or establish a project legal entity, and assign copyright to that?

Third party libraries

No known conflicts are known with respect to external libraries employed by kv projects.

E.g for kvalobs:

Package	License	Comment	Compatibility with kvalobs under GPL
OMNIORB	GPL	OK
Postgresql	BSD License	A modified BSD with no advertising clause	OK
Boost	BOOST license	OK
SQLlite	N/A	Public Domain	OK
QT	QT license	Open Source Edition	OK
puTools	LGPL	met.no product	OK
pkgconfig	GPL 2	OK

See http://www.gnu.org/philosophy/license-list.html (for some detail)

+Reviewers of this document please think if there are any other issues here.

Documentation

Full documentation trees already exist under cvs and therefore these will be copied to subversion and remain under configuration control. Documentation is also being placed into DokuWiki, this shall also be copied into the external wiki server for the project https://kvalobs.wiki.met.no/.

Bugzilla

Bugzilla for the project will be available at the DMZ: ???????????????. As a start existing bugs from the internal bugzilla and items not included in that list shall be copied into the shared bugzilla for the open source project.

The TODO list will be phased out since only a tool such as bugzilla is appropriate for managing anomaly reports in the open source project.

Kvalobs Wiki

Initial content being prepared:

This document

Mission statement

Description of policies for using subversion repository

Link to Project Bugzilla page

Details of group email tool

Details of discussion forum

Email for user access request

Proposal: expand the alias kvalobs-dev@met.no to also include smhi.se people now, so that we have one email for announcements etc.

Desirables

Automatic documentation builds by doxygen every week and stored in svn.

+Please add other ideas...

Procedure for CVS to SVN

Some steps for a smooth transition

all activity of the CVS repositories stops

Except for:

Scripts are run to add headers to all files, results checked and final commits made,

System administrator performs CVS to SVN migration,

Internal project team checks the integrity of new repository,

Launch of project is announced,

We all work from svn thereon!