[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: [RFR] templates://zabbix/{zabbix-agent.templates,zabbix-frontend-php.templ ates}



Christian Perrier wrote:
> Your review should be sent as an answer to this mail.

[...templates look fine...]

>  Package: zabbix-agent
>  Architecture: any
>  Depends: ${shlibs:Depends}, ${misc:Depends}, adduser, logrotate, ucf
> -Description: software for monitoring of your networks -- agent
> - Zabbix is an all-in-one 24x7 free monitoring solution for both
> - commercial and non-commercial use. 
> +Description: network monitoring software - agent

"Software" doesn't add anything; I'd suggest recycling "solution"
from the following line (it's still meaningless, but at least it's a
solidly anglophone buzzword).
 
> + Zabbix is an all-in-one 24x7 free monitoring solution.
> 
> "for both commercial and non-commercial use" has no meaning when
> software is provided in Debian. So, let's dropped that part copied
> from upstream (I think).

Also, the "free" part isn't true (Debian CD distributors can charge
what they like), "all-in-one" needs a recount, and "24x7" seems to
be insinuating that other monitoring daemons take Sundays off.
Maybe that's why this one's called Zabbatix. 

> - Zabbix can be installed on any UNIX platform. It acts as server that 
> + It acts as server that 
>   monitors client systems running on different platforms as well as other
> - Network devices. The Software can be used for:
> + network devices. Among many features, it can be used for:
> 
> Ditto for "on any UNIX platform"

I think the implied warning that you won't find a client to install
on the MS Windows machines in your mixed network is worth keeping.
Hang on, though... the URL for the online documentation is
"http://www.zabbix.com/downloads/ZABBIX Manual v1.6.pdf" (note the
spaces), so surely... yes, there _are_ clients for NT4.0 through to
Vista.  Looks like this blurb is 110% vacuous hype.

    Zabbix is a server/client network monitoring system with many features.
    It can be used for:

> +  - high level monitoring of IT Services
                                   s       ;
> +  - centralised monitoring of your servers and applications;
               z
> +  - monitoring of SNMP-enabled devices;
> +  - performance monitoring (process load, network activity, disk
> +    activity, memory usage, OS parameters etc.);
> +  - data visualization.

Suddenly it's all worth keeping.
 
> Standardized enumeration....

Leading "o" bulletpoints must be so annoying for lusophones!

- This package provides all binaries which are needed to integrate
- a System as zabbix client.
> + This package provides all binaries which are needed on an host
> + monitored by a Zabbix server.

Only binaries?  There are shell scripts in these packages too, so
I'd suggest rehousing another displaced word here:

    This package provides the software needed to integrate a host as a Zabbix
    client.

>  Package: zabbix-server-mysql
> -Description: software for monitoring of your networks -- server
[...]
> - This Package provides all binaries which are needed to run an
> - Zabbix Server. The Server collects all Informations of your Zabbix 
> - Client Systems and stores them in an DBMS. This Package is compiled
> - with MySQL support.
> +Description: network monitoring software - server with MySQL backend
> 
> Make it clear that this server flavor supports MySQL. This way, the
> package description is different from the one of the PostgreSQM flavor.
> 
> + This package provides all binaries which are needed to run a
> + Zabbix server. The server collects informations from Zabbix
> + clients and stores them in a database.

Information has no plural.  (I'd say "data", but not right next to
the word "database".)

> + This package supports MySQL as database backend for Zabbix.

I'm not keen on the approach with two "This package" paragraphs, so
I'd merge this into the third line of the above.

    This package provides the software needed to integrate a host as a Zabbix
    server. It collects information from Zabbix clients and stores it in a
    MySQL database back-end.

The hyphenated versions of "front/back-end" get about ten times as
many Google hits.  But that hyphen makes the short descriptions
(especially the proxy server one below) dangerously long.  Can we
trim it to "network monitoring solution - server (using MySQL)"?

>  Package: zabbix-frontend-php
[...]
> + This package provides the PHP frontend to the Zabbix server.
> + It allows displaying informations collected from client by
> + using graphs.

Move that plural ending onto the clients.  Also, throw out the
repeated name of the programming language and replace it with the
information it's trying to hint at: this is a web interface.

    This package provides a web-browsable front-end to the Zabbix server, which
    can display graphs of the data collected from clients. 

> +Description: network monitoring software - proxy server with PostgreSQL backend
> 
> Other changes are all inline with the "standard" server packages.
> 
> However, something important seems to be missing: what the hell is a
> "proxy server"? Nothing in the description is giving a clue about
> it. What's the difference with a "standard" server. These are
> questions that need to be addressed in the packages descriptions, IMHO.

>From a quick skim through the Manual.pdf I'd say:

   Description: network monitoring solution - proxy (using PostgreSQL)
   [...]
   This package provides the software needed to integrate a host as a Zabbix
   proxy. It collects information from Zabbix clients and passes it to a
   server running a PostgreSQL database back-end.

-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
--- ../zabbix.old/debian/zabbix-agent.templates	2009-01-28 13:02:14.000000000 +0000
+++ debian/zabbix-agent.templates	2009-02-05 11:48:39.000000000 +0000
@@ -1,5 +1,5 @@
 Template: zabbix-agent/server
 Type: string
 _Description: Zabbix server host address:
- Please enter the host name or the address of the Zabbix server you 
+ Please enter the host name or IP address of the Zabbix server you
  want to connect to.
--- ../zabbix.old/debian/zabbix-frontend-php.templates	2009-01-28 13:02:16.000000000 +0000
+++ debian/zabbix-frontend-php.templates	2009-02-05 11:48:42.000000000 +0000
@@ -1,15 +1,20 @@
 Template: zabbix-frontend-php/reconfigure-webserver
 Type: multiselect
-_Choices: apache, apache-ssl, apache-perl, apache2
+Choices: apache, apache-ssl, apache-perl, apache2
 Default: apache, apache-ssl, apache-perl, apache2
-_Description: Webserver Reconfiguration:
- Zabbix supports any web server that php4 does, but this automatic
- configuration process only supports Apache. Please select which 
- apache version you want to configure the Zabbix frontend for.
+_Description: Web server to reconfigure for zabbix:
+ Zabbix supports any web server supported by PHP4, however only
+ Apache can be configured automatically. 
+ .
+ Please select which Apache version you want to configure the Zabbix
+ frontend for.
 
 Template: zabbix-frontend-php/restart-webserver
 Type: boolean
 Default: true
-_Description: Would you like to restart your webserver(s) now?
- Remember that in order to apply the changes your webserver(s) has/have to
- be restarted. 
+_Description: Restart the web server(s) now?
+ In order to apply the changes needed for Zabbix configuration, the
+ web server needs to be restarted.
+ .
+ Please choose whether you prefer doing it automatically now
+ or manually later.
--- ../zabbix.old/debian/control	2009-01-28 13:02:18.000000000 +0000
+++ debian/control	2009-02-05 12:13:18.000000000 +0000
@@ -11,26 +11,19 @@
 Package: zabbix-agent
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, adduser, logrotate, ucf
-Description: software for monitoring of your networks -- agent
- Zabbix is an all-in-one 24x7 free monitoring solution for both
- commercial and non-commercial use. 
- .
- Zabbix can be installed on any UNIX platform. It acts as server that 
- monitors client systems running on different platforms as well as other
- Network devices. The Software can be used for:
- .
-  o high level monitoring of IT Services
-  o centralised monitoring of your servers and applications
-  o monitoring of SNMP-enabled devices
-  o performance monitoring (process load, network activity, disk
-    activity, memory usage, OS parameters etc.)
-  o data visualization
+Description: network monitoring solution - agent
+ Zabbix is a server/client network monitoring system with many features.
+ It can be used for:
+ .
+  - high level monitoring of IT services;
+  - centralized monitoring of your servers and applications;
+  - monitoring of SNMP-enabled devices;
+  - performance monitoring (process load, network activity, disk
+    activity, memory usage, OS parameters etc.);
+  - data visualization.
  .
- and much more.
- .
- This package provides all binaries which are needed to integrate
- a System as zabbix client.
-
+ This package provides the software needed to integrate a host as a Zabbix
+ client.
 
 Package: zabbix-server-mysql
 Architecture: any
@@ -38,27 +31,20 @@
 Recommends: mysql-server (>= 4.0.16-2), snmpd
 Suggests: zabbix-frontend-php
 Conflicts: zabbix-server-pgsql
-Description: software for monitoring of your networks -- server
- Zabbix is an all-in-one 24x7, free monitoring solution for both
- commercial and non-commercial use. 
- .
- Zabbix can be installed on any UNIX platform. It acts as server 
- that monitors client systems running on different platforms as 
- well as other Network devices. The Software can be used for:
- .
-  o high level monitoring of IT Services
-  o centralised monitoring of your servers and applications
-  o monitoring of SNMP-enabled devices
-  o performance monitoring (process load, network activity, disk
-    activity, memory usage, OS parameters etc.)
-  o data visualization
- .
- and much more.
- .
- This Package provides all binaries which are needed to run an
- Zabbix Server. The Server collects all Informations of your Zabbix 
- Client Systems and stores them in an DBMS. This Package is compiled
- with MySQL support.
+Description: network monitoring solution - server (using MySQL)
+ Zabbix is a server/client network monitoring system with many features.
+ It can be used for:
+ .
+  - high level monitoring of IT services;
+  - centralized monitoring of your servers and applications;
+  - monitoring of SNMP-enabled devices;
+  - performance monitoring (process load, network activity, disk
+    activity, memory usage, OS parameters etc.);
+  - data visualization.
+ .
+ This package provides the software needed to integrate a host as a Zabbix
+ client. It collects information from Zabbix clients and stores it in a
+ MySQL database back-end.
 
 Package: zabbix-server-pgsql
 Architecture: any
@@ -66,105 +52,75 @@
 Recommends: postgresql, snmpd
 Suggests: zabbix-frontend-php
 Conflicts: zabbix-server-mysql
-Description: software for monitoring of your networks -- server
- Zabbix is an all-in-one 24x7, free monitoring solution for both
- commercial and non-commercial use. 
- .
- Zabbix can be installed on any UNIX platform. It acts as server 
- that monitors client systems running on different platforms as 
- well as other Network devices. The Software can be used for:
- .
-  o high level monitoring of IT Services
-  o centralised monitoring of your servers and applications
-  o monitoring of SNMP-enabled devices
-  o performance monitoring (process load, network activity, disk
-    activity, memory usage, OS parameters etc.)
-  o data visualization
- .
- and much more.
- .
- This Package provides all binaries which are needed to run an
- Zabbix Server. The Server collects all Informations of your Zabbix 
- Client Systems and stores them in an DBMS. This Package is compiled
- with PostgreSQL support.
+Description: network monitoring solution - server (using PostgreSQL)
+ Zabbix is a server/client network monitoring system with many features.
+ It can be used for:
+ .
+  - high level monitoring of IT services;
+  - centralized monitoring of your servers and applications;
+  - monitoring of SNMP-enabled devices;
+  - performance monitoring (process load, network activity, disk
+    activity, memory usage, OS parameters etc.);
+  - data visualization.
+ .
+ This package provides the software needed to integrate a host as a Zabbix
+ client. It collects information from Zabbix clients and stores it in a
+ PostgreSQL database back-end.
 
 Package: zabbix-frontend-php
 Architecture: all
 Depends: apache2 | httpd, php5, php5-mysql | php5-pgsql, php5-gd, ucf, dbconfig-common (>= 1.8.19), ${misc:Depends} 
 Recommends: zabbix-server-mysql | zabbix-server-pgsql, mysql-server (>= 4.0.16-2) | postgresql
-Description: software for monitoring of your servers -- php frontend
- Zabbix is an all-in-one 24x7, free monitoring solution for both
- commercial and non-commercial use. 
- .
- Zabbix can be installed on any UNIX platform. It acts as server 
- that monitors client systems running on different platforms as 
- well as other Network devices. The Software can be used for:
- .
-  o high level monitoring of IT Services
-  o centralised monitoring of your servers and applications
-  o monitoring of SNMP-enabled devices
-  o performance monitoring (process load, network activity, disk
-    activity, memory usage, OS parameters etc.)
-  o data visualization
- .
- and much more.
- .
- This Package provides the php Frontend to your Zabbix Server
- database, which displays the collected Informations of your
- Zabbix-Clients using graphs.
+Description: network monitoring solution - PHP front-end
+ Zabbix is a server/client network monitoring system with many features.
+ It can be used for:
+ .
+  - high level monitoring of IT services;
+  - centralized monitoring of your servers and applications;
+  - monitoring of SNMP-enabled devices;
+  - performance monitoring (process load, network activity, disk
+    activity, memory usage, OS parameters etc.);
+  - data visualization.
+ .
+ This package provides a web-browsable front-end to the Zabbix server, which
+ can display graphs of the data collected from clients.
 
 Package: zabbix-proxy-pgsql
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, fping, adduser, dbconfig-common (>= 1.8.19), logrotate
 Recommends: postgresql
 Conflicts: zabbix-proxy-mysql
-Description: software for monitoring of your networks -- proxy
- Zabbix is an all-in-one 24x7, free monitoring solution for both
- commercial and non-commercial use.
- .
- Zabbix can be installed on any UNIX platform. It acts as server
- that monitors client systems running on different platforms as
- well as other Network devices. The Software can be used for:
- .
-  o high level monitoring of IT Services
-  o centralised monitoring of your servers and applications
-  o monitoring of SNMP-enabled devices
-  o performance monitoring (process load, network activity, disk
-    activity, memory usage, OS parameters etc.)
-  o data visualization
- .
- and much more.
- .
- This Package provides all binaries which are needed to run a
- Zabbix proxy. The Server collects all Informations of your Zabbix
- Client Systems and stores them in an DBMS. This Package is compiled
- with PostgreSQL support.
+Description: network monitoring solution - proxy (using MySQL)
+ Zabbix is a server/client network monitoring system with many features.
+ It can be used for:
+ .
+  - high level monitoring of IT services;
+  - centralized monitoring of your servers and applications;
+  - monitoring of SNMP-enabled devices;
+  - performance monitoring (process load, network activity, disk
+    activity, memory usage, OS parameters etc.);
+  - data visualization.
+ .
+ This package provides the software needed to integrate a host as a Zabbix
+ proxy. It collects information from Zabbix clients and passes it to a
+ server running a MySQL database back-end.
 
 Package: zabbix-proxy-mysql
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, fping, adduser, dbconfig-common (>= 1.8.19), logrotate
 Recommends: mysql-server (>= 4.0.16-2)
 Conflicts: zabbix-proxy-pgsql
-Description: software for monitoring of your networks -- proxy
- Zabbix is an all-in-one 24x7, free monitoring solution for both
- commercial and non-commercial use.
- .
- Zabbix can be installed on any UNIX platform. It acts as server
- that monitors client systems running on different platforms as
- well as other Network devices. The Software can be used for:
- .
-  o high level monitoring of IT Services
-  o centralised monitoring of your servers and applications
-  o monitoring of SNMP-enabled devices
-  o performance monitoring (process load, network activity, disk
-    activity, memory usage, OS parameters etc.)
-  o data visualization
- .
- and much more.
- .
- This Package provides all binaries which are needed to run a
- Zabbix proxy. The Server collects all Informations of your Zabbix
- Client Systems and stores them in an DBMS. This Package is compiled
- with MySQL support.
-
-
+Description: network monitoring solution - proxy (using PostgreSQL)
+ Zabbix is a server/client network monitoring system with many features.
+ It can be used for:
+ .
+  - high level monitoring of IT services;
+  - centralized monitoring of your servers and applications;
+  - monitoring of SNMP-enabled devices;
+  - performance monitoring (process load, network activity, disk
+    activity, memory usage, OS parameters etc.);
+  - data visualization.
+ .
+ This package provides the software needed to integrate a host as a Zabbix
+ proxy. It collects information from Zabbix clients and passes it to a
+ server running a PostgreSQL database back-end.
Template: zabbix-agent/server
Type: string
_Description: Zabbix server host address:
 Please enter the host name or IP address of the Zabbix server you
 want to connect to.
Template: zabbix-frontend-php/reconfigure-webserver
Type: multiselect
Choices: apache, apache-ssl, apache-perl, apache2
Default: apache, apache-ssl, apache-perl, apache2
_Description: Web server to reconfigure for zabbix:
 Zabbix supports any web server supported by PHP4, however only
 Apache can be configured automatically. 
 .
 Please select which Apache version you want to configure the Zabbix
 frontend for.

Template: zabbix-frontend-php/restart-webserver
Type: boolean
Default: true
_Description: Restart the web server(s) now?
 In order to apply the changes needed for Zabbix configuration, the
 web server needs to be restarted.
 .
 Please choose whether you prefer doing it automatically now
 or manually later.
Source: zabbix
Section: net
Priority: optional
Maintainer: Zabbix Maintainers <kobold-zabbix@debian.org>
Uploaders: Fabio Tranchitella <kobold@debian.org>, Michael Ablassmeier <abi@debian.org>
Build-Depends: debhelper (>= 5.0.0), libsnmp9-dev | libsnmp-dev, libmysqlclient15-dev, dpatch, automake1.9, po-debconf, libpq-dev, libcurl4-gnutls-dev, libldap2-dev,libiksemel-dev, libopenipmi-dev
Standards-Version: 3.8.0
Vcs-Svn: svn://svn.debian.org/svn/collab-maint/deb-maint/zabbix/trunk
Vcs-Browser: http://svn.debian.org/wsvn/collab-maint/deb-maint/zabbix/trunk/?op=log
 
Package: zabbix-agent
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, adduser, logrotate, ucf
Description: network monitoring solution - agent
 Zabbix is a server/client network monitoring system with many features.
 It can be used for:
 .
  - high level monitoring of IT services;
  - centralized monitoring of your servers and applications;
  - monitoring of SNMP-enabled devices;
  - performance monitoring (process load, network activity, disk
    activity, memory usage, OS parameters etc.);
  - data visualization.
 .
 This package provides the software needed to integrate a host as a Zabbix
 client.

Package: zabbix-server-mysql
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, fping, adduser, dbconfig-common (>= 1.8.19), logrotate
Recommends: mysql-server (>= 4.0.16-2), snmpd
Suggests: zabbix-frontend-php
Conflicts: zabbix-server-pgsql
Description: network monitoring solution - server (using MySQL)
 Zabbix is a server/client network monitoring system with many features.
 It can be used for:
 .
  - high level monitoring of IT services;
  - centralized monitoring of your servers and applications;
  - monitoring of SNMP-enabled devices;
  - performance monitoring (process load, network activity, disk
    activity, memory usage, OS parameters etc.);
  - data visualization.
 .
 This package provides the software needed to integrate a host as a Zabbix
 client. It collects information from Zabbix clients and stores it in a
 MySQL database back-end.

Package: zabbix-server-pgsql
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, fping, adduser, dbconfig-common (>= 1.8.19), logrotate
Recommends: postgresql, snmpd
Suggests: zabbix-frontend-php
Conflicts: zabbix-server-mysql
Description: network monitoring solution - server (using PostgreSQL)
 Zabbix is a server/client network monitoring system with many features.
 It can be used for:
 .
  - high level monitoring of IT services;
  - centralized monitoring of your servers and applications;
  - monitoring of SNMP-enabled devices;
  - performance monitoring (process load, network activity, disk
    activity, memory usage, OS parameters etc.);
  - data visualization.
 .
 This package provides the software needed to integrate a host as a Zabbix
 client. It collects information from Zabbix clients and stores it in a
 PostgreSQL database back-end.

Package: zabbix-frontend-php
Architecture: all
Depends: apache2 | httpd, php5, php5-mysql | php5-pgsql, php5-gd, ucf, dbconfig-common (>= 1.8.19), ${misc:Depends} 
Recommends: zabbix-server-mysql | zabbix-server-pgsql, mysql-server (>= 4.0.16-2) | postgresql
Description: network monitoring solution - PHP front-end
 Zabbix is a server/client network monitoring system with many features.
 It can be used for:
 .
  - high level monitoring of IT services;
  - centralized monitoring of your servers and applications;
  - monitoring of SNMP-enabled devices;
  - performance monitoring (process load, network activity, disk
    activity, memory usage, OS parameters etc.);
  - data visualization.
 .
 This package provides a web-browsable front-end to the Zabbix server, which
 can display graphs of the data collected from clients.

Package: zabbix-proxy-pgsql
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, fping, adduser, dbconfig-common (>= 1.8.19), logrotate
Recommends: postgresql
Conflicts: zabbix-proxy-mysql
Description: network monitoring solution - proxy (using MySQL)
 Zabbix is a server/client network monitoring system with many features.
 It can be used for:
 .
  - high level monitoring of IT services;
  - centralized monitoring of your servers and applications;
  - monitoring of SNMP-enabled devices;
  - performance monitoring (process load, network activity, disk
    activity, memory usage, OS parameters etc.);
  - data visualization.
 .
 This package provides the software needed to integrate a host as a Zabbix
 proxy. It collects information from Zabbix clients and passes it to a
 server running a MySQL database back-end.

Package: zabbix-proxy-mysql
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, fping, adduser, dbconfig-common (>= 1.8.19), logrotate
Recommends: mysql-server (>= 4.0.16-2)
Conflicts: zabbix-proxy-pgsql
Description: network monitoring solution - proxy (using PostgreSQL)
 Zabbix is a server/client network monitoring system with many features.
 It can be used for:
 .
  - high level monitoring of IT services;
  - centralized monitoring of your servers and applications;
  - monitoring of SNMP-enabled devices;
  - performance monitoring (process load, network activity, disk
    activity, memory usage, OS parameters etc.);
  - data visualization.
 .
 This package provides the software needed to integrate a host as a Zabbix
 proxy. It collects information from Zabbix clients and passes it to a
 server running a PostgreSQL database back-end.

Reply to: