Package: gfsd
Version: 2.3.0-1
Severity: minor
Tags: patch l10n
> Description: Gfarm filesystem daemon
> A filesystem daemon for the Gfarm filesystem,
> which has been running on every filesystem node.
Something has been lost in translation there. Did you mean "has to
be running", perhaps?
Out of all the binary packages in the gfarm source package, at
present only gfarm-doc gives anything like enough information in its
package description to comply with Debian Policy 3.4:
# The description should describe the package (the program) to a
# user (system administrator) who has never met it before so that
# they have enough information to decide whether they want to
# install it.
At present a sysadmin who encounters gfsd isn't given enough clues
to deduce that an associated documentation package exists, and any
admins who guess are likely to get its name wrong. My patch adds
dependencies to make the connection apparent.
(Meanwhile in gfarm-clients, the man pages for gfchgrp, gfchmod,
gfchown, gffindxmlattr, gfgroup, gfln, gfmv, gfstat, gfuser,
gfxattr, and gfchgrp are in Japanese - I assume; there's also some
sort of charmap problem. It would be nice if they were available in
English; if not, they should at least live in the appropriate
/usr/share/man/XX directory.)
Okay, the main thing your package descriptions need is a boilerplate
paragraph explaining what Gfarm FS is. Let's see how much of it I
can get from the gfarm-doc description:
> The Gfarm filesystem is a distributed filesystem consisting of the
> local storage of commodity PCs. PCs in a local area network,
> compute nodes in a single cluster, multiple clusters in wide area,
> comprise a large-scale, high-performance shared network
> filesystem. The Gfarm filesystem solves performance and
> reliability problems in NFS and AFS by means of multiple file
> replicas. It not only prevents performance degradation due to
> access concentration, but also supports fault tolerance and
> disaster recovery.
Some of that's very informative; some of it's a bit garbled. What
else is there? The upstream front page:
> Gfarm file system is a next-generation network shared file system,
> which will be an alternative solution of NFS, and will meet a
> demand for much larger, much reliable, and much faster file system.
I'm not keen on this - "Next Generation" is a buzzword left over
from the 1980s, and the rest is only telling me what it isn't yet.
The upstream docs directory has:
> Gfarm is a reference implementation of the Grid Datafarm
> architecture designed for global petascale data-intensive
> computing. It provides Gfarm Grid file system that is a shared
> file system in cluster or Grid that can scale up to petascale
> storage, and realize scalable I/O bandwidth and scalable parallel
> processing.
This is slightly wobbly English, but it has some elements worth
keeping. So I would suggest the following boilerplate:
The Gfarm file system is designed to turn commodity PCs into nodes of
a distributed storage network, implementing the Grid Datafarm
architecture for global petascale data-intensive computing. It solves
performance and reliability problems in NFS and AFS by means of
multiple file replicas, and not only prevents performance degradation
due to access concentration, but also supports fault tolerance and
disaster recovery.
(This needs fact-checking to be sure I haven't mangled it!)
Then each package (especially the ones that turn PCs into nodes)
needs an explanation of its role. Suggested patch attached.
-- System Information:
Debian Release: squeeze/sid
APT prefers testing
APT policy: (990, 'testing'), (50, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.33.custom
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages gfsd depends on:
ii libc6 2.10.2-6 Embedded GNU C Library: Shared lib
ii libgfarm0 2.3.0-1 Runtime libraries for the Gfarm fi
ii libssl0.9.8 0.9.8m-2 SSL shared libraries
gfsd recommends no packages.
gfsd suggests no packages.
-- no debconf information
--
JBR
Ankh kak! (Ancient Egyptian blessing)
Source: gfarm
Section: net
Priority: extra
Maintainer: NIIBE Yutaka <[email protected]>
Build-Depends: quilt (>= 0.46-7~), debhelper (>= 7), autotools-dev, libssl-dev,
libldap2-dev, libpq-dev, postgresql
Standards-Version: 3.8.4
Uploaders: Osamu Tatebe <[email protected]>, Noriyuki SODA
<[email protected]>
DM-Upload-Allowed: yes
Homepage: http://datafarm.apgrid.org/
Package: gfarm-doc
Section: doc
Depends: ${misc:Depends}
Architecture: all
Description: Gfarm file system documentation
The Gfarm file system is designed to turn commodity PCs into nodes of
a distributed storage network, implementing the Grid Datafarm
architecture for global petascale data-intensive computing. It solves
performance and reliability problems in NFS and AFS by means of
multiple file replicas, and not only prevents performance degradation
due to access concentration, but also supports fault tolerance and
disaster recovery.
.
This package provides documentation for Gfarm.
Package: libgfarm0
Section: libs
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Suggests: gfarm-doc
Description: Gfarm file system runtime library
The Gfarm file system is designed to turn commodity PCs into nodes of
a distributed storage network, implementing the Grid Datafarm
architecture for global petascale data-intensive computing. It solves
performance and reliability problems in NFS and AFS by means of
multiple file replicas, and not only prevents performance degradation
due to access concentration, but also supports fault tolerance and
disaster recovery.
.
This package provides the shared library required for accessing
files via Gfarm.
Package: libgfarm-dev
Section: libdevel
Architecture: any
Depends: libgfarm0 (= ${binary:Version}), ${misc:Depends}
Suggests: gfarm-doc
Conflicts: libgfarm-dev
Description: Gfarm file system development files
The Gfarm file system is designed to turn commodity PCs into nodes of
a distributed storage network, implementing the Grid Datafarm
architecture for global petascale data-intensive computing. It solves
performance and reliability problems in NFS and AFS by means of
multiple file replicas, and not only prevents performance degradation
due to access concentration, but also supports fault tolerance and
disaster recovery.
.
This package provides the static library, header files, and man
pages required for Gfarm development.
Package: gfmd
Section: net
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Suggests: gfarm-doc, postgresql, slapd
Description: Gfarm file system metadata server
The Gfarm file system is designed to turn commodity PCs into nodes of
a distributed storage network, implementing the Grid Datafarm
architecture for global petascale data-intensive computing. It solves
performance and reliability problems in NFS and AFS by means of
multiple file replicas, and not only prevents performance degradation
due to access concentration, but also supports fault tolerance and
disaster recovery.
.
This package provides the Gfarm metadata server, which equips a
host to function as a server node managing file system metadata.
Package: gfsd
Section: net
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Suggests: gfarm-doc
Description: Gfarm file system daemon
The Gfarm file system is designed to turn commodity PCs into nodes of
a distributed storage network, implementing the Grid Datafarm
architecture for global petascale data-intensive computing. It solves
performance and reliability problems in NFS and AFS by means of
multiple file replicas, and not only prevents performance degradation
due to access concentration, but also supports fault tolerance and
disaster recovery.
.
This package provides the Gfarm file system daemon, which equips a
host to function as a storage node for the network.
Package: gfarm-client
Section: utils
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Suggests: gfarm-doc
Description: Gfarm file system clients
The Gfarm file system is designed to turn commodity PCs into nodes of
a distributed storage network, implementing the Grid Datafarm
architecture for global petascale data-intensive computing. It solves
performance and reliability problems in NFS and AFS by means of
multiple file replicas, and not only prevents performance degradation
due to access concentration, but also supports fault tolerance and
disaster recovery.
.
This package provides client utilities for Gfarm.
--- control.orig 2010-03-11 17:51:38.000000000 +0000
+++ control 2010-03-12 01:16:28.000000000 +0000
@@ -12,54 +12,98 @@
Section: doc
Depends: ${misc:Depends}
Architecture: all
-Description: Documentation for the Gfarm filesystem
- The Gfarm filesystem is a distributed filesystem consisting of the
- local storage of commodity PCs. PCs in a local area network, compute
- nodes in a single cluster, multiple clusters in wide area, comprise a
- large-scale, high-performance shared network filesystem. The Gfarm
- filesystem solves performance and reliability problems in NFS and AFS
- by means of multiple file replicas. It not only prevents performance
- degradation due to access concentration, but also supports fault
- tolerance and disaster recovery.
+Description: Gfarm file system documentation
+ The Gfarm file system is designed to turn commodity PCs into nodes of
+ a distributed storage network, implementing the Grid Datafarm
+ architecture for global petascale data-intensive computing. It solves
+ performance and reliability problems in NFS and AFS by means of
+ multiple file replicas, and not only prevents performance degradation
+ due to access concentration, but also supports fault tolerance and
+ disaster recovery.
+ .
+ This package provides documentation for Gfarm.
Package: libgfarm0
Section: libs
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: Runtime libraries for the Gfarm filesystem
- A library implementing interfaces for reading and writing
- files on the Gfarm, a reference implementation of the Grid Datafarm
+Suggests: gfarm-doc
+Description: Gfarm file system runtime library
+ The Gfarm file system is designed to turn commodity PCs into nodes of
+ a distributed storage network, implementing the Grid Datafarm
+ architecture for global petascale data-intensive computing. It solves
+ performance and reliability problems in NFS and AFS by means of
+ multiple file replicas, and not only prevents performance degradation
+ due to access concentration, but also supports fault tolerance and
+ disaster recovery.
+ .
+ This package provides the shared library required for accessing
+ files via Gfarm.
Package: libgfarm-dev
Section: libdevel
Architecture: any
Depends: libgfarm0 (= ${binary:Version}), ${misc:Depends}
+Suggests: gfarm-doc
Conflicts: libgfarm-dev
-Description: Development files for the Gfarm filesystem
- Header files and static library for Gfarm, a reference implementation
- of the Grid Datafarm
+Description: Gfarm file system development files
+ The Gfarm file system is designed to turn commodity PCs into nodes of
+ a distributed storage network, implementing the Grid Datafarm
+ architecture for global petascale data-intensive computing. It solves
+ performance and reliability problems in NFS and AFS by means of
+ multiple file replicas, and not only prevents performance degradation
+ due to access concentration, but also supports fault tolerance and
+ disaster recovery.
+ .
+ This package provides the static library, header files, and man
+ pages required for Gfarm development.
Package: gfmd
Section: net
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
-Suggests: postgresql, slapd
-Description: Gfarm metadata server
- The Gfarm filesystem metadata server for accessing
- filesystem metadata of the Gfarm filesystem.
+Suggests: gfarm-doc, postgresql, slapd
+Description: Gfarm file system metadata server
+ The Gfarm file system is designed to turn commodity PCs into nodes of
+ a distributed storage network, implementing the Grid Datafarm
+ architecture for global petascale data-intensive computing. It solves
+ performance and reliability problems in NFS and AFS by means of
+ multiple file replicas, and not only prevents performance degradation
+ due to access concentration, but also supports fault tolerance and
+ disaster recovery.
+ .
+ This package provides the Gfarm metadata server, which equips a
+ host to function as a server node managing file system metadata.
Package: gfsd
Section: net
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: Gfarm filesystem daemon
- A filesystem daemon for the Gfarm filesystem,
- which has been running on every filesystem node.
+Suggests: gfarm-doc
+Description: Gfarm file system daemon
+ The Gfarm file system is designed to turn commodity PCs into nodes of
+ a distributed storage network, implementing the Grid Datafarm
+ architecture for global petascale data-intensive computing. It solves
+ performance and reliability problems in NFS and AFS by means of
+ multiple file replicas, and not only prevents performance degradation
+ due to access concentration, but also supports fault tolerance and
+ disaster recovery.
+ .
+ This package provides the Gfarm file system daemon, which equips a
+ host to function as a storage node for the network.
Package: gfarm-client
Section: utils
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: Gfarm clients
- Client programs for the Gfarm, a reference implementation
- of the Grid Datafarm
+Suggests: gfarm-doc
+Description: Gfarm file system clients
+ The Gfarm file system is designed to turn commodity PCs into nodes of
+ a distributed storage network, implementing the Grid Datafarm
+ architecture for global petascale data-intensive computing. It solves
+ performance and reliability problems in NFS and AFS by means of
+ multiple file replicas, and not only prevents performance degradation
+ due to access concentration, but also supports fault tolerance and
+ disaster recovery.
+ .
+ This package provides client utilities for Gfarm.
