Re: [LCFC] templates://dbconfig-common/{dbconfig-common.templates}
Christian Perrier wrote:
> This is the last call for comments for the review of debconf
> templates for dbconfig-common.
Did I miss the first call? Oh well, my mail's working now.
> Template: dbconfig-common/dbconfig-reinstall
> Type: boolean
> Default: false
> _Description: Re-install database for ${pkg}?
^
Re-install or reinstall? The dpkg standard is no hyphen, as here.
v
> Since you are reconfiguring ${pkg}, you may also want to reinstall the
> database which it uses.
> .
> If you wish to re-install the database for ${pkg}, you should select
^
Likewise.
> Template: dbconfig-common/upgrade-backup
> Type: boolean
> Default: true
> _Description: Do you want to backup the database for ${pkg} before upgrading?
^
The noun is one word, the separable verb is two.
> Template: dbconfig-common/upgrade-error
[...]
> At this point, you have the option to retry or abort the operation.
> If you choose "retry", you will be prompted with all the configuration
> questions once more and another attempt will be made at performing the
> operation. "retry (skip questions)" will immediately attempt the operation
> again, skipping all questions. If you choose "abort", the operation will
> fail and you will need to downgrade, reinstall, reconfigure this package,
> or otherwise manually intervene to continue using it.
"Option" means one of the alternatives, not the situation where
alternatives are available (that's a "choice" - you can use "choice"
to mean "option", but not vice versa). But simpler just to drop
this preamble:
- At this point, you have the option to retry or abort the operation.
- If you choose "retry", you will be prompted with all the configuration
+ If at this point you choose "retry", you will be prompted with all the configuration
(Likewise in Template: dbconfig-common/install-error etc; it's more
urgent in dbconfig-common/remove-error, where the previous paragraph
has already detailed the two options available.)
> Template: dbconfig-common/missing-db-package-error
> Type: select
> Choices: abort, retry, ignore
> Default: abort
> _Description: Next step:
> To properly configure the database for ${pkg}, it is necessary
> that you also have ${dbpackage} installed. This can
> not be done automatically.
Huh? I thought automatically installing dependencies (or even
pre-dependencies) was just what APT was best at. Presumably what it
means is:
Configuring the database for ${pkg} requires the package ${dbpackage}
to be installed and configured first, which is not something that can be
checked for automatically.
> Template: dbconfig-common/pgsql/authmethod-admin
(and Template: dbconfig-common/pgsql/authmethod-user)
[...]
> With "password" authentication, a password will be passed to the server
> for use with some authentication backend (such as "md5" or "pam"). Note
> that the password is still passed in the clear across network-based
> connections if your connection is not configured to use SSL.
Network-based connections? That's a redundant "-based" if ever I
saw one.
> Template: dbconfig-common/pgsql/changeconf
> Type: boolean
> Default: false
> #flag:translate!:3
> _Description: Change PostgreSQL configuration automatically?
> It has been determined that the database installation for ${pkg}
> can not be automatically accomplished without making changes to
> the PostgreSQL server's access controls. It is suggested that this
> be done by dbconfig-common when the package is installed. If you
> would prefer that this be done manually (or not at all), please add
> the following line to the pg_hba.conf file:
> .
> ${pghbaline}
If I would prefer the fix done not at all, I should perform the fix?
Surely:
If instead you would prefer it done manually, the following line
needs to be added to your pg_hba.conf:
(Likewise Template: dbconfig-common/pgsql/revertconf, mutatis
mutandis.)
> Package: dbconfig-common
[...]
> Description: common framework for packaging database applications
> This package presents a policy and implementation for
> managing various databases used by applications included in
> Debian packages.
> .
> Features:
Given the form of the items this would make more sense as "It can:"
> - support MySQL, PostgreSQL, and sqlite based applications;
> - create databases and database users;
> - access local or remote databases;
> - upgrade/modify databases when upstream changes database structure;
> - remove databases and database users;
Repetitive. Say "create or remove" above.
> - generate config files in many formats with the database info;
> - import configs from packages previously managing databases on their own;
> - prompt users with a set of normalized, pre-translated questions;
> - handle failures gracefully, with an option to retry;
> - do all the hard work automatically;
> - work for package maintainers with little effort on their part;
> - work for local admins with little effort on their part;
> - comply with an agreed upon set of standards for behavior;
> - do absolutely nothing if it is the whim of the local admin;
that
> - perform all operations from within the standard flow of
> package maintenance (no additional skill is required of the local
management
> admin).
Package _maintenance_ is what package maintainers do, not something
the local database admin is required to get involved in.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- ../dbconfig-common.old/debian/dbconfig-common.templates 2007-06-23 14:50:35.000000000 +0100
+++ debian/dbconfig-common.templates 2009-01-28 12:51:07.000000000 +0000
@@ -8,7 +8,7 @@
configuration are asked with a priority such that they are
skipped for most systems.
.
- If you select this option, the default behaviour will be to prompt you
+ If you select this option, the default behavior will be to prompt you
with questions related to remote database configuration when you install
new packages.
.
@@ -17,15 +17,16 @@
Template: dbconfig-common/remember-admin-pass
Type: boolean
Default: false
-_Description: Keep "administrative" database passwords in debconf?
+_Description: Keep "administrative" database passwords?
By default, you will be prompted for all administrator-level database
passwords when you configure, upgrade, or remove applications with
- dbconfig-common. These passwords will not be stored in debconf for
+ dbconfig-common. These passwords will not be stored in the
+ configuration database (debconf) for
any longer than they are needed.
.
This behavior can be disabled, in which case the passwords will
- remain in the debconf password database. The debconf password
- database is protected by unix file permissions, though this is
+ remain in the database. That
+ database is protected by Unix file permissions, though this is
less secure and thus not the default setting.
.
If you would rather not be bothered for an administrative password
@@ -36,8 +37,8 @@
Type: boolean
Default: true
_Description: Configure database for ${pkg} with dbconfig-common?
- ${pkg} must have a database installed and configured before
- it can be used. If you like, this can be handled with
+ The ${pkg} package must have a database installed and configured before
+ it can be used. This can be optionally handled with
dbconfig-common.
.
If you are an advanced database administrator and know that you want
@@ -50,11 +51,11 @@
Template: dbconfig-common/dbconfig-reinstall
Type: boolean
Default: false
-_Description: Re-install database for ${pkg}?
+_Description: Reinstall database for ${pkg}?
Since you are reconfiguring ${pkg}, you may also want to reinstall the
database which it uses.
.
- If you wish to re-install the database for ${pkg}, you should select
+ If you wish to reinstall the database for ${pkg}, you should select
this option. If you do not wish to do so (if you are reconfiguring
the package for unrelated reasons), you should not select this option.
@@ -63,13 +64,13 @@
Default: true
_Description: Perform upgrade on database for ${pkg} with dbconfig-common?
According to the maintainer for this package, database upgrade
- operations need to be formed on ${pkg}. Typically this is due to
+ operations need to be performed on ${pkg}. Typically, this is due to
changes in how a new upstream version of the package needs to store
its data.
.
If you want to handle this process manually, you should
refuse this option. Otherwise, you should choose this option.
- During the upgrade a backup of your database will be made in
+ During the upgrade, a backup of the database will be made in
/var/cache/dbconfig-common/backups, from which the database can
be restored in the case of problems.
@@ -85,36 +86,34 @@
If you know that you do want to keep this database, or if you want
to handle the removal of this database manually, you should refuse
this option.
- .
- Otherwise, you should choose this option.
Template: dbconfig-common/database-type
Type: select
Choices: ${database_types}
_Description: Database type to be used by ${pkg}:
- ${pkg} can be configured to use one of many database types.
+ The ${pkg} package can be configured to use one of several database types.
Below, you will be presented with the available choices.
Template: dbconfig-common/purge
Type: boolean
Default: false
_Description: Do you want to purge the database for ${pkg}?
- If you no longer need the database for ${pkg}, this is your
- chance to remove them.
+ If you no longer need the database for ${pkg}, you can choose to
+ remove it now.
.
If you no longer have need of the data being stored by ${pkg}, you
- should choose this option. If you want to hold this data for another
- time, or if you would rather handle this process manually, you should
+ should choose this option. If you want to keep this data,
+ or if you would rather handle this process manually, you should
refuse this option.
Template: dbconfig-common/upgrade-backup
Type: boolean
Default: true
-_Description: Do you want to backup the database for ${pkg} before upgrading?
+_Description: Do you want to back up the database for ${pkg} before upgrading?
The underlying database for ${pkg} needs to be upgraded as part of the
- installation progress. Just in case, the database can be backed up
+ installation process. Just in case, the database can be backed up
before this is done, so that if something goes wrong, you can revert
- to the previous package version and repopulate your database.
+ to the previous package version and repopulate the database.
Template: dbconfig-common/password-confirm
Type: password
@@ -125,25 +124,24 @@
_Description: Password confirmation:
Template: dbconfig-common/passwords-do-not-match
-Type: note
-_Description: Passwords do not match.
- The passwords you supplied do not match. Please try again.
+Type: error
+_Description: Password mismatch
+ The password and its confirmation do not match.
Template: dbconfig-common/upgrade-error
Type: select
__Choices: abort, retry, retry (skip questions)
Default: abort
-_Description: Error upgrading database for ${pkg}. Retry?
- An error seems to have occurred while upgrading the database.
- If it's of any help, this was the error encountered:
+#flag:translate!:3
+_Description: Next step for database upgrade:
+ An error occurred while upgrading the database:
.
${error}
.
- Fortunately, there should be a backup of the database made just before
- the upgrade in ${dbfile}.
+ Fortunately, ${dbfile} holds a backup of the database, made just before
+ the upgrade.
.
- At this point, you have the option to retry or abort the operation.
- If you choose "retry", you will be prompted with all the configuration
+ If at this point you choose "retry", you will be prompted with all the configuration
questions once more and another attempt will be made at performing the
operation. "retry (skip questions)" will immediately attempt the operation
again, skipping all questions. If you choose "abort", the operation will
@@ -154,14 +152,13 @@
Type: select
__Choices: abort, retry, retry (skip questions), ignore
Default: abort
-_Description: Error installing database for ${pkg}. Retry?
- An error seems to have occurred while installing the database.
- If it's of any help, this was the error encountered:
+#flag:translate!:3
+_Description: Next step for database installation:
+ An error occurred while installing the database:
.
${error}
.
- At this point, you have the option to retry or abort the operation.
- If you choose "retry", you will be prompted with all the configuration
+ If at this point you choose "retry", you will be prompted with all the configuration
questions once more and another attempt will be made at performing the
operation. "retry (skip questions)" will immediately attempt the operation
again, skipping all questions. If you choose "abort", the operation will
@@ -174,20 +171,19 @@
Type: select
__Choices: abort, retry
Default: abort
-_Description: Error removing database for ${pkg}. Retry?
- An error seems to have occurred while removing the database.
+#flag:translate!:3
+_Description: Next step for database removal:
+ An error occurred while removing the database:
+ .
+ ${error}
.
For some reason it was not possible to perform some of the actions necessary
to remove the database for ${pkg}. At this point you have two options: you
can find out what has caused this error and fix it, or you can refuse
the offer for help removing the database (the latter implies you will
- have to remove the database manually). If it's of any help, this was
- the error encountered:
- .
- ${error}
+ have to remove the database manually).
.
- At this point, you have the option to retry or abort the operation.
- If you choose "retry", you will be prompted with all the configuration
+ If at this point you choose "retry", you will be prompted with all the configuration
questions once more and another attempt will be made at performing the
operation. "retry (skip questions)" will immediately attempt the operation
again, skipping all questions. If you choose "abort", the operation will
@@ -198,19 +194,16 @@
Type: select
Choices: abort, retry, ignore
Default: abort
-Description: Database package required.
- To properly configure the database for ${pkg}, it is necessary
- that you also have ${dbpackage} installed. Unfortunately, this can
- not be done automatically.
+_Description: Next step:
+ Configuring the database for ${pkg} requires the package ${dbpackage}
+ to be installed and configured first, which is not something that can be
+ checked for automatically.
.
If in doubt, you should choose "abort", and install ${dbpackage} before
continuing with the configuration of this package. If you choose "retry",
you will be allowed to choose different answers (in case you chose the
wrong database type by mistake). If you choose "ignore", then installation
will continue as normal.
- .
- (Note to translators: don't bother translating this message yet, as the
- text/wording is not stabilized)
Template: dbconfig-common/remote/host
Type: select
@@ -222,8 +215,8 @@
Template: dbconfig-common/remote/port
Type: string
_Description: Port number for the ${dbvendor} service:
- If the ${dbvendor} database on the remote host is running on a non-standard
- port, this is your opportunity to specify what it is. To use the
+ Please specify the port the ${dbvendor} database on the remote host is
+ running on. To use the
default port, leave this field blank.
Template: dbconfig-common/remote/newhost
@@ -231,7 +224,7 @@
_Description: Host running the ${dbvendor} server for ${pkg}:
Please provide the hostname of a remote ${dbvendor} server.
.
- Note: you must have already arranged for the administrative
+ You must have already arranged for the administrative
account to be able to remotely create databases and grant
privileges.
@@ -275,24 +268,24 @@
_Description: MySQL application password for ${pkg}:
Please provide a password for ${pkg} to register with the
database server. If left blank, a random password will be
- generated for you.
+ generated.
Template: dbconfig-common/mysql/admin-user
Type: string
Default: root
-_Description: Name of your database's administrative user:
- What is the name of the account with which this package should perform
- administrative actions? This user is the one which is able to create
+_Description: Name of the database's administrative user:
+ Please provide the name of the account with which this package should perform
+ administrative actions. This user is the one which is able to create
new database users.
.
For MySQL, this is almost always "root". Note that this is NOT the
- same as the UNIX login 'root'.
+ same as the UNIX login "root".
Template: dbconfig-common/mysql/admin-pass
Type: password
-_Description: Password of your database's administrative user:
- What is the password for the administrative account with which this
- package should create its MySQL database and user?
+_Description: Password of the database's administrative user:
+ Please provide the password for the administrative account with which this
+ package should create its MySQL database and user.
Template: dbconfig-common/pgsql/method
Type: select
@@ -308,7 +301,7 @@
Type: password
_Description: PostgreSQL application password for ${pkg}:
Please provide a password for ${pkg} to register with the database
- server. If left blank, a random password will be generated for you.
+ server. If left blank, a random password will be generated.
.
If you are using "ident" based authentication, the supplied password will
not be used and can be left blank. Otherwise, PostgreSQL access may
@@ -317,24 +310,26 @@
Template: dbconfig-common/pgsql/admin-user
Type: string
Default: postgres
-_Description: Name of your database's administrative user:
- What is the name of the account with which this package should perform
- administrative actions? This user is the one which is able to create
+_Description: Name of the database's administrative user:
+ Please provide the name of the account with which this package should perform
+ administrative actions. This user is the one which is able to create
new database users.
Template: dbconfig-common/pgsql/admin-pass
Type: password
_Description: Password of your database's administrative user:
- What is the password for the account with which this package should perform
- administrative actions? (For a normal Debian PostgreSQL installation,
+ Please provide the password for the account with which this package should perform
+ administrative actions.
+ .
+ For a standard PostgreSQL package installation,
a database password is not required, since authentication is done at the
- system level.)
+ system level.
Template: dbconfig-common/pgsql/authmethod-admin
Type: select
__Choices: ident, password
Default: ident
-_Description: Method for authenticating PostgreSQL administrator:
+_Description: Method for authenticating the PostgreSQL administrator:
PostgreSQL servers provide several different mechanisms for authenticating
connections. Please select what method the administrative user should use
when connecting to the server.
@@ -347,11 +342,11 @@
.
With "password" authentication, a password will be passed to the server
for use with some authentication backend (such as "md5" or "pam"). Note
- that the password is still passed in the clear across network-based
+ that the password is still passed in the clear across network
connections if your connection is not configured to use SSL.
.
- For a default Debian PostgreSQL installation running on the same host,
- you probably want "ident".
+ For a standard PostgreSQL package installation running on the same host,
+ "ident" is recommended.
Template: dbconfig-common/pgsql/authmethod-user
Type: select
@@ -369,61 +364,58 @@
.
With "password" authentication, a password will be passed to the server
for use with some authentication backend (such as "md5" or "pam"). Note
- that the password is still passed in the clear across network-based
+ that the password is still passed in the clear across network
connections if your connection is not configured to use SSL.
.
- For a default Debian PostgreSQL installation running on the same host,
- you probably want "ident".
+ For a standard PostgreSQL package installation running on the same host,
+ "ident" is recommended.
Template: dbconfig-common/pgsql/no-user-choose-other-method
Type: note
-_Description: Choose a different PostgreSQL connection method?
+_Description: PostgreSQL connection method error
Unfortunately, it seems that the database connection method you
have selected for ${pkg} will not work, because it requires the existence
of a local user that does not exist.
- .
- If you would like to reconfigure your application to use a different
- method, you should choose this option. If you know for certain that
- this method will work and you want to continue without changing
- your choice, you should refuse this option.
Template: dbconfig-common/pgsql/changeconf
Type: boolean
Default: false
+#flag:translate!:3
_Description: Change PostgreSQL configuration automatically?
It has been determined that the database installation for ${pkg}
can not be automatically accomplished without making changes to
- your PostgreSQL server's access controls. It is suggested that this
- be done by dbconfig-common when your package is installed. If you
- would prefer that this be done manually (or not at all), please add
- the following line to your pg_hba.conf:
+ the PostgreSQL server's access controls. It is suggested that this
+ be done by dbconfig-common when the package is installed. If
+ instead you would prefer it done manually, the following line needs
+ to be added to your pg_hba.conf:
.
${pghbaline}
Template: dbconfig-common/pgsql/revertconf
Type: boolean
Default: false
+#flag:translate!:3
_Description: Revert PostgreSQL configuration automatically?
As ${pkg} is now being removed, it may no longer be necessary to
- have an access control entry in your PostgreSQL server's configuration.
- While keeping such an entry will not break any software on your
+ have an access control entry in the PostgreSQL server's configuration.
+ While keeping such an entry will not break any software on the
system, it may be seen as a potential security concern. It is suggested
- that this be done by dbconfig-common when your package is removed. If you
- would prefer that this be done manually (or not at all), please remove
- the following line from your pg_hba.conf:
+ that this be done by dbconfig-common when the package is removed.
+ If instead you would prefer it done manually, the following line
+ needs to be removed from your pg_hba.conf:
.
${pghbaline}
Template: dbconfig-common/pgsql/manualconf
Type: note
-_Description: Please change /etc/postgresql/pg_hba.conf
+_Description: Modifications needed in /etc/postgresql/pg_hba.conf
To get the database for package ${pkg} bootstrapped you have
- to edit the configuration of your PostgreSQL server. You may be able to
+ to edit the configuration of the PostgreSQL server. You may be able to
find help in the file /usr/share/doc/${pkg}/README.Debian.
Template: dbconfig-common/pgsql/no-empty-passwords
-Type: note
-_Description: PostgreSQL does not support empty passwords.
+Type: error
+_Description: Empty passwords unsupported with PostgreSQL
Template: dbconfig-common/internal/reconfiguring
Type: boolean
--- ../dbconfig-common.old/debian/control 2008-09-08 17:37:58.000000000 +0100
+++ debian/control 2009-01-28 12:51:26.000000000 +0000
@@ -12,26 +12,25 @@
Depends: ucf (>= 0.28), ${misc:Depends}
Suggests: virtual-mysql-client | mysql-client | postgresql-client
Description: common framework for packaging database applications
- dbconfig-common presents a policy and implementation for
+ This package presents a policy and implementation for
managing various databases used by applications included in
Debian packages.
.
- dbconfig-common can:
- * support MySQL, PostgreSQL, and sqlite based applications
- * create databases and database users
- * access local or remote databases
- * upgrade/modify databases when upstream changes database structure
- * remove databases and database users
- * generate config files in many formats with the database info
- * import configs from packages previously managing databases on their own
- * prompt users with a set of normalized, pre-translated questions
- * handle failures gracefully, with an option to retry.
- * do all the hard work automatically
- * work for package maintainers with little effort on their part
- * work for local admins with little effort on their part
- * comply with an agreed upon set of standards for behaviour
- * do absolutely nothing if it is the whim of the local admin
- * perform all operations from within the standard flow of Debian
- package maintenance (no additional skill is required of the local
- admin)
+ It can:
+ - support MySQL, PostgreSQL, and sqlite based applications;
+ - create or remove databases and database users;
+ - access local or remote databases;
+ - upgrade/modify databases when upstream changes database structure;
+ - generate config files in many formats with the database info;
+ - import configs from packages previously managing databases on their own;
+ - prompt users with a set of normalized, pre-translated questions;
+ - handle failures gracefully, with an option to retry;
+ - do all the hard work automatically;
+ - work for package maintainers with little effort on their part;
+ - work for local admins with little effort on their part;
+ - comply with an agreed upon set of standards for behavior;
+ - do absolutely nothing if that is the whim of the local admin;
+ - perform all operations from within the standard flow of
+ package management (no additional skill is required of the local
+ admin).
Template: dbconfig-common/remote-questions-default
Type: boolean
Default: false
_Description: Will this server be used to access remote databases?
For the database types that support it, dbconfig-common includes support
for configuring databases on remote systems. When installing a package's
database via dbconfig-common, the questions related to remote
configuration are asked with a priority such that they are
skipped for most systems.
.
If you select this option, the default behavior will be to prompt you
with questions related to remote database configuration when you install
new packages.
.
If you are unsure, you should not select this option.
Template: dbconfig-common/remember-admin-pass
Type: boolean
Default: false
_Description: Keep "administrative" database passwords?
By default, you will be prompted for all administrator-level database
passwords when you configure, upgrade, or remove applications with
dbconfig-common. These passwords will not be stored in the
configuration database (debconf) for
any longer than they are needed.
.
This behavior can be disabled, in which case the passwords will
remain in the database. That
database is protected by Unix file permissions, though this is
less secure and thus not the default setting.
.
If you would rather not be bothered for an administrative password
every time you upgrade a database application with dbconfig-common,
you should choose this option. Otherwise, you should refuse this option.
Template: dbconfig-common/dbconfig-install
Type: boolean
Default: true
_Description: Configure database for ${pkg} with dbconfig-common?
The ${pkg} package must have a database installed and configured before
it can be used. This can be optionally handled with
dbconfig-common.
.
If you are an advanced database administrator and know that you want
to perform this configuration manually, or if your database has already
been installed and configured, you should refuse this option. Details on what
needs to be done should most likely be provided in /usr/share/doc/${pkg}.
.
Otherwise, you should probably choose this option.
Template: dbconfig-common/dbconfig-reinstall
Type: boolean
Default: false
_Description: Reinstall database for ${pkg}?
Since you are reconfiguring ${pkg}, you may also want to reinstall the
database which it uses.
.
If you wish to reinstall the database for ${pkg}, you should select
this option. If you do not wish to do so (if you are reconfiguring
the package for unrelated reasons), you should not select this option.
Template: dbconfig-common/dbconfig-upgrade
Type: boolean
Default: true
_Description: Perform upgrade on database for ${pkg} with dbconfig-common?
According to the maintainer for this package, database upgrade
operations need to be performed on ${pkg}. Typically, this is due to
changes in how a new upstream version of the package needs to store
its data.
.
If you want to handle this process manually, you should
refuse this option. Otherwise, you should choose this option.
During the upgrade, a backup of the database will be made in
/var/cache/dbconfig-common/backups, from which the database can
be restored in the case of problems.
Template: dbconfig-common/dbconfig-remove
Type: boolean
Default: true
_Description: Deconfigure database for ${pkg} with dbconfig-common?
Since you are removing ${pkg}, it's possible that you no longer
want the underlying database.
.
If you like, database removal can be handled with dbconfig-common.
.
If you know that you do want to keep this database, or if you want
to handle the removal of this database manually, you should refuse
this option.
Template: dbconfig-common/database-type
Type: select
Choices: ${database_types}
_Description: Database type to be used by ${pkg}:
The ${pkg} package can be configured to use one of several database types.
Below, you will be presented with the available choices.
Template: dbconfig-common/purge
Type: boolean
Default: false
_Description: Do you want to purge the database for ${pkg}?
If you no longer need the database for ${pkg}, you can choose to
remove it now.
.
If you no longer have need of the data being stored by ${pkg}, you
should choose this option. If you want to keep this data,
or if you would rather handle this process manually, you should
refuse this option.
Template: dbconfig-common/upgrade-backup
Type: boolean
Default: true
_Description: Do you want to back up the database for ${pkg} before upgrading?
The underlying database for ${pkg} needs to be upgraded as part of the
installation process. Just in case, the database can be backed up
before this is done, so that if something goes wrong, you can revert
to the previous package version and repopulate the database.
Template: dbconfig-common/password-confirm
Type: password
_Description: Password confirmation:
Template: dbconfig-common/app-password-confirm
Type: password
_Description: Password confirmation:
Template: dbconfig-common/passwords-do-not-match
Type: error
_Description: Password mismatch
The password and its confirmation do not match.
Template: dbconfig-common/upgrade-error
Type: select
__Choices: abort, retry, retry (skip questions)
Default: abort
#flag:translate!:3
_Description: Next step for database upgrade:
An error occurred while upgrading the database:
.
${error}
.
Fortunately, ${dbfile} holds a backup of the database, made just before
the upgrade.
.
If at this point you choose "retry", you will be prompted with all the configuration
questions once more and another attempt will be made at performing the
operation. "retry (skip questions)" will immediately attempt the operation
again, skipping all questions. If you choose "abort", the operation will
fail and you will need to downgrade, reinstall, reconfigure this package,
or otherwise manually intervene to continue using it.
Template: dbconfig-common/install-error
Type: select
__Choices: abort, retry, retry (skip questions), ignore
Default: abort
#flag:translate!:3
_Description: Next step for database installation:
An error occurred while installing the database:
.
${error}
.
If at this point you choose "retry", you will be prompted with all the configuration
questions once more and another attempt will be made at performing the
operation. "retry (skip questions)" will immediately attempt the operation
again, skipping all questions. If you choose "abort", the operation will
fail and you will need to downgrade, reinstall, reconfigure this package,
or otherwise manually intervene to continue using it. If you choose
"ignore", the operation will continue, ignoring further errors from
dbconfig-common.
Template: dbconfig-common/remove-error
Type: select
__Choices: abort, retry
Default: abort
#flag:translate!:3
_Description: Next step for database removal:
An error occurred while removing the database:
.
${error}
.
For some reason it was not possible to perform some of the actions necessary
to remove the database for ${pkg}. At this point you have two options: you
can find out what has caused this error and fix it, or you can refuse
the offer for help removing the database (the latter implies you will
have to remove the database manually).
.
If at this point you choose "retry", you will be prompted with all the configuration
questions once more and another attempt will be made at performing the
operation. "retry (skip questions)" will immediately attempt the operation
again, skipping all questions. If you choose "abort", the operation will
fail and you will need to downgrade, reinstall, reconfigure this package,
or otherwise manually intervene to continue using it.
Template: dbconfig-common/missing-db-package-error
Type: select
Choices: abort, retry, ignore
Default: abort
_Description: Next step:
Configuring the database for ${pkg} requires the package ${dbpackage}
to be installed and configured first, which is not something that can be
checked for automatically.
.
If in doubt, you should choose "abort", and install ${dbpackage} before
continuing with the configuration of this package. If you choose "retry",
you will be allowed to choose different answers (in case you chose the
wrong database type by mistake). If you choose "ignore", then installation
will continue as normal.
Template: dbconfig-common/remote/host
Type: select
Choices: ${hosts}
_Description: Host name of the ${dbvendor} database server for ${pkg}:
Please select the remote hostname to use, or select "new host" to
enter a new host.
Template: dbconfig-common/remote/port
Type: string
_Description: Port number for the ${dbvendor} service:
Please specify the port the ${dbvendor} database on the remote host is
running on. To use the
default port, leave this field blank.
Template: dbconfig-common/remote/newhost
Type: string
_Description: Host running the ${dbvendor} server for ${pkg}:
Please provide the hostname of a remote ${dbvendor} server.
.
You must have already arranged for the administrative
account to be able to remotely create databases and grant
privileges.
Template: dbconfig-common/db/dbname
Type: string
_Description: ${dbvendor} database name for ${pkg}:
Please provide a name for the ${dbvendor} database to be used by ${pkg}.
Template: dbconfig-common/db/app-user
Type: string
_Description: ${dbvendor} username for ${pkg}:
Please provide a ${dbvendor} username for ${pkg} to register with the
database server. A ${dbvendor} user is not necessarily the same as a
system login, especially if the database is on a remote server.
.
This is the user which will own the database, tables and other
objects to be created by this installation. This user will have
complete freedom to insert, change or delete data in the database.
Template: dbconfig-common/db/basepath
Type: string
_Description: ${dbvendor} storage directory for ${pkg}:
Please provide a path where the ${dbvendor} database file for ${pkg}
should be installed into.
.
The permissions for this directory will be set to match the permissions
for the generated database file.
Template: dbconfig-common/mysql/method
Type: select
__Choices: unix socket, tcp/ip
Default: unix socket
_Description: Connection method for MySQL database of ${pkg}:
By default, ${pkg} will be configured to use a MySQL server
through a local unix socket (this provides the best performance).
However, if you would like to connect with a different method, or to a
different server entirely, select an option from the choices below.
Template: dbconfig-common/mysql/app-pass
Type: password
_Description: MySQL application password for ${pkg}:
Please provide a password for ${pkg} to register with the
database server. If left blank, a random password will be
generated.
Template: dbconfig-common/mysql/admin-user
Type: string
Default: root
_Description: Name of the database's administrative user:
Please provide the name of the account with which this package should perform
administrative actions. This user is the one which is able to create
new database users.
.
For MySQL, this is almost always "root". Note that this is NOT the
same as the UNIX login "root".
Template: dbconfig-common/mysql/admin-pass
Type: password
_Description: Password of the database's administrative user:
Please provide the password for the administrative account with which this
package should create its MySQL database and user.
Template: dbconfig-common/pgsql/method
Type: select
__Choices: unix socket, tcp/ip, tcp/ip + ssl
Default: unix socket
_Description: Connection method for PostgreSQL database of ${pkg}:
By default, ${pkg} will be configured to use a PostgreSQL server
through a local unix socket (this provides the best performance).
However, if you would like to connect with a different method, or to a
different server entirely, select an option from the choices below.
Template: dbconfig-common/pgsql/app-pass
Type: password
_Description: PostgreSQL application password for ${pkg}:
Please provide a password for ${pkg} to register with the database
server. If left blank, a random password will be generated.
.
If you are using "ident" based authentication, the supplied password will
not be used and can be left blank. Otherwise, PostgreSQL access may
need to be reconfigured to allow password-authenticated access.
Template: dbconfig-common/pgsql/admin-user
Type: string
Default: postgres
_Description: Name of the database's administrative user:
Please provide the name of the account with which this package should perform
administrative actions. This user is the one which is able to create
new database users.
Template: dbconfig-common/pgsql/admin-pass
Type: password
_Description: Password of your database's administrative user:
Please provide the password for the account with which this package should perform
administrative actions.
.
For a standard PostgreSQL package installation,
a database password is not required, since authentication is done at the
system level.
Template: dbconfig-common/pgsql/authmethod-admin
Type: select
__Choices: ident, password
Default: ident
_Description: Method for authenticating the PostgreSQL administrator:
PostgreSQL servers provide several different mechanisms for authenticating
connections. Please select what method the administrative user should use
when connecting to the server.
.
With "ident" authentication on the local machine, the
server will check that the owner of the unix socket is allowed to connect.
.
With "ident" authentication to remote hosts, RFC 1413 based ident is
used (note this can be considered a security risk).
.
With "password" authentication, a password will be passed to the server
for use with some authentication backend (such as "md5" or "pam"). Note
that the password is still passed in the clear across network
connections if your connection is not configured to use SSL.
.
For a standard PostgreSQL package installation running on the same host,
"ident" is recommended.
Template: dbconfig-common/pgsql/authmethod-user
Type: select
__Choices: ident, password
_Description: Method for authenticating PostgreSQL user:
PostgreSQL servers provide several different mechanisms for authenticating
connections. Please select what method the database user should use
when connecting to the server.
.
With "ident" authentication on the local machine, the
server will check that the owner of the unix socket is allowed to connect.
.
With "ident" authentication to remote hosts, RFC 1413 based ident is
used (note this can be considered a security risk).
.
With "password" authentication, a password will be passed to the server
for use with some authentication backend (such as "md5" or "pam"). Note
that the password is still passed in the clear across network
connections if your connection is not configured to use SSL.
.
For a standard PostgreSQL package installation running on the same host,
"ident" is recommended.
Template: dbconfig-common/pgsql/no-user-choose-other-method
Type: note
_Description: PostgreSQL connection method error
Unfortunately, it seems that the database connection method you
have selected for ${pkg} will not work, because it requires the existence
of a local user that does not exist.
Template: dbconfig-common/pgsql/changeconf
Type: boolean
Default: false
#flag:translate!:3
_Description: Change PostgreSQL configuration automatically?
It has been determined that the database installation for ${pkg}
can not be automatically accomplished without making changes to
the PostgreSQL server's access controls. It is suggested that this
be done by dbconfig-common when the package is installed. If
instead you would prefer it done manually, the following line needs
to be added to your pg_hba.conf:
.
${pghbaline}
Template: dbconfig-common/pgsql/revertconf
Type: boolean
Default: false
#flag:translate!:3
_Description: Revert PostgreSQL configuration automatically?
As ${pkg} is now being removed, it may no longer be necessary to
have an access control entry in the PostgreSQL server's configuration.
While keeping such an entry will not break any software on the
system, it may be seen as a potential security concern. It is suggested
that this be done by dbconfig-common when the package is removed.
If instead you would prefer it done manually, the following line
needs to be removed from your pg_hba.conf:
.
${pghbaline}
Template: dbconfig-common/pgsql/manualconf
Type: note
_Description: Modifications needed in /etc/postgresql/pg_hba.conf
To get the database for package ${pkg} bootstrapped you have
to edit the configuration of the PostgreSQL server. You may be able to
find help in the file /usr/share/doc/${pkg}/README.Debian.
Template: dbconfig-common/pgsql/no-empty-passwords
Type: error
_Description: Empty passwords unsupported with PostgreSQL
Template: dbconfig-common/internal/reconfiguring
Type: boolean
Default: false
Description: for internal use.
Template: dbconfig-common/internal/skip-preseed
Type: boolean
Default: false
Description: for internal use.
Source: dbconfig-common
Section: admin
Priority: optional
Maintainer: Sean Finney <seanius@debian.org>
Build-Depends: debhelper (>= 4.0.0), debiandoc-sgml, po-debconf, gs, texlive-latex-recommended | tetex-bin, texlive-latex-extra | tetex-extra, texlive-fonts-recommended | tetex-extra
Standards-Version: 3.7.3
Vcs-Svn: svn://svn.debian.org/dbconfig-common/trunk/
Vcs-Browser: http://svn.debian.org/viewsvn/dbconfig-common/trunk/
Package: dbconfig-common
Architecture: all
Depends: ucf (>= 0.28), ${misc:Depends}
Suggests: virtual-mysql-client | mysql-client | postgresql-client
Description: common framework for packaging database applications
This package presents a policy and implementation for
managing various databases used by applications included in
Debian packages.
.
It can:
- support MySQL, PostgreSQL, and sqlite based applications;
- create or remove databases and database users;
- access local or remote databases;
- upgrade/modify databases when upstream changes database structure;
- generate config files in many formats with the database info;
- import configs from packages previously managing databases on their own;
- prompt users with a set of normalized, pre-translated questions;
- handle failures gracefully, with an option to retry;
- do all the hard work automatically;
- work for package maintainers with little effort on their part;
- work for local admins with little effort on their part;
- comply with an agreed upon set of standards for behavior;
- do absolutely nothing if that is the whim of the local admin;
- perform all operations from within the standard flow of
package management (no additional skill is required of the local
admin).
Reply to: