Re: Please review control and templates for tryton-server
Mathias Behrle wrote:
>> I'm starting with comments on the templates and hoping to work up
>> towards MRs later - first I might need some help with understanding
>> them.
>
> Just tell me if you want to do MRs or if I should merge your proposed changes
> along the discussion.
It would take me a long time to work out the right git commands, so if
you're happy with diffs then I'll stick with them.
>>> Template: tryton-server-uwsgi/enable-cron
>>
>> (Somehow I've ended up doing these in slightly jumbled order.)
>>
>>> Type: boolean
>>> Default: false
>>> _Description: Configure cron for the Tryton server?
>>
>> The template name implies that the choice isn't whether they should be
>> left uncustomised, it's whether they should run at all. So:
>>
>> _Description: Set up Tryton server cron jobs?
>
> Indeed the Tryton server cron runs separately from the main server and it is
> this process that is set up. It is comparable to the system cron, but handles
> internally scheduled jobs for Tryton. So 'Set up Tryton server cron jobs?' is
> misleading, because the individual cron jobs have to be configured/activated
> separately in each database. Perhaps 'Set up a Tryton server cron process?'
In fact I would have said it isn't a *cron* process at all; to me,
"cron" means the system cron daemon, /usr/sbin/cron, whereas this is
some Tryton subsystem that has been unhelpfully given the same name,
rather as if it called its internal logging daemon "rsyslogd".
Looking it up I see that doing it this way lets Tryton store scheduled
tasks as database entries. The documentation says:
# Tryton provides a scheduler (aka cron) which can execute methods of
# models periodically at set intervals.
>>> There exist several Tryton server cron jobs that mainly run periodically
>>> some maintenance tasks on the database. They can be configured with the
>>> clients.
>>
>> Tryton server has several cron jobs that can be activated to perform
>> periodic maintenance on the database. They can be configured using the
>> Tryton clients.
>
> Perfect.
It might be if we were actually talking about cron jobs; since we
aren't it should say something like
Template: tryton-server-uwsgi/enable-cron
Type: boolean
Default: false
_Description: Enable the Tryton scheduler?
Tryton server has its own "cron" scheduler which can run periodic
database-maintenance tasks (configured using the Tryton clients).
Please specify whether it should be activated.
>> (I may be misinterpreting the second sentence.)
>>> .
>>> Note: Only one cron server should be enabled per database.
>>
>> Wait, is it really talking about Tryton running its own cron-daemon
>> *server*? That also seems to be what the package description implies,
>> but why on earth would anybody want to do that? (Is it maybe some
>> misleadingly named task-scheduling subprocess of the Tryton server?)
>> I'm going to assume for now that this should be something like
>>
>> Note: Only one maintenance cron job should be enabled per database.
>>
>> But maybe this is the kind of instruction that belongs in whatever
>> interface is going to be used to pick the ones that will run?
>
> It is indeed only one cron server that should be started per database.
> Otherwise tasks will run twice or conflict and interfere with each other.
I still don't understand it, then. This template is asking whether or
not a single thing should be activated; it doesn't give the user any
way of enabling more than one scheduler. So what advice is this note
trying to give me?
>>> Template: tryton-server-postgresql/db-admin-email
[...]
>>> Template: tryton-server-uwsgi/enable-workers
[...]
>
>>> If workers are configured those tasks (like e.g. the processing of sales,
>>> invoices or purchases) can be automatically performed by workers. They
>>> do not wait for completion in the clients thus removing the need of
>>> waiting and doing serialized steps.
>>
>> Well, obviously not waiting eliminates some waiting, but it's not
>> quite clear what's going on with the serialised steps... maybe:
>>
>> If enabled, the workers can automatically perform tasks such as the
>> processing of sales, invoices, or purchases without waiting for the
>> clients to finish, thus removing the need for serialisation.
>
> The serialized steps are mostly workflow steps that when called manually take
> some time to complete. Pushing those tasks to a worker doesn't block the client
> until the process has finished but allows to continue almost immediately. The
> serialized process is just handled by another process.
All in all I think it's clearer if it just stops at "without waiting
for the clients to finish". For a start it hides the fact that I
mis-localised "serialisation".
>>> Template: tryton-server-all-in-one/postal-code-countries
>>> Type: multiselect
>>> Choices: Afghanistan - AF, Albania - AL, Algeria - DZ, American Samoa - AS,
[...]
>>> Yemen - YE, Zambia - ZM, Zimbabwe - ZW, Åland Islands - AX
>>
>> Should all these get translations using the "__Choices" mechanism?
>
> No, I don't think so.
>
>> (Sorted from A to Å by official name, with the UK and Ukraine
>> confusingly using GB and UA? Oh well, I probably can't fix that.)
>
> There was some discussion about the best format for this list. And yes, we
> can't fix ISO country codes... ;)
Well, there's always the hope that one of them will disintegrate, and
it doesn't look as if it's going to be UA.
[...]
>> I nearly missed the package descriptions in the control file! The
>> content looks mostly good, though the short descriptions need work
>> and there's some inconsistent capitalisation - no time to go through
>> commenting now, I'll just attach a first-draft modified version.
Going through the diff:
> --- control 2022-09-14 12:15:34.570732971 +0100
> +++ control.jbr 2022-09-14 12:18:18.027995351 +0100
> @@ -67,7 +67,7 @@
> tryton-modules-all,
> tryton-server-doc
> Provides: ${API}
> -Description: Tryton Application Platform (Server)
> +Description: Tryton application platform - server
I'm making the synopses lowercase apart from the word "Tryton"
(keeping caps on "Tryton Application Platform" would also be
justifiable) and then using a dash instead of parentheses just because
that's the d-l-e standard style.
Likewise for:
> -Description: Tryton Application Platform (Server Documentation)
> +Description: Tryton application platform - server documentation
(There is client documentation somewhere too, right?)
[...]
> -Description: Tryton Application Platform (Tryton Server PostgreSQL)
> +Description: Tryton application platform - PostgreSQL integration
[...]
> -Description: Tryton Application Platform (Tryton Server uWSGI)
> +Description: Tryton application platform - uWSGI integration
(Or maybe s/integration/backend/? But I haven't changed that in this
revised diff.)
> Tryton is a high-level general purpose application platform. It is the base
> of a complete business solution as well as a comprehensive health and hospital
> information system (GNUHealth).
> .
> For production use it is recommended to run the Tryton server under a
> - wsgi backend instead of the simple werkzeug development server.
> + WSGI backend instead of the simple werkzeug development server.
(I've never been sure if there's a difference between running a server
*under* a backend and running it *on top of* a backend...)
Oh, and isn't it Werkzeug? Especially given that it *started* with
German Noun-Capitalisation...
> .
> - This package provides the integration of tryton-server with the uwsgi backend.
> + This package provides the integration of tryton-server with the uWSGI backend.
(I gather the u is for micro, but they've never written it as μ.)
> It offers also the possibility to configure and run workers and/or cron as
> uWSGI daemons.
My revised version makes this
It also offers the possibility of configuring and running workers and/or the
scheduler as uWSGI daemons.
> .
> The Tryton server can be accessed by the uWSGI and/or the HTTP protocol.
Even assuming it really means "HTTP" and not "HTTP(S)" this is probably
plural protocols:
The Tryton server can be accessed by the uWSGI and/or HTTP protocols.
> - For small sites that are not exposed to the internet this may already cover
> - your needs, otherwise have a look at package tryton-server-nginx to run
> + For small sites that are not exposed to the Internet this may already cover
> + your needs; otherwise have a look at the package tryton-server-nginx to run
> the uWSGI server behind a dedicated reverse proxy.
>
[...]
> -Description: Tryton Application Platform (Tryton Server Nginx)
> +Description: Tryton application platform - Nginx integration
(Again: s/integration/backend/?)
> Tryton is a high-level general purpose application platform. It is the base
> of a complete business solution as well as a comprehensive health and hospital
> information system (GNUHealth).
> .
> - While the uWSGI server as WSGI backend offers the possibility to serve http
> + While the uWSGI server as WSGI backend offers the possibility to serve HTTP
> content it is still preferable to expose the content produced by the Tryton
> - server via https with a dedicated web frontend like Nginx on top of a
> - robust wsgi application.
> + server via HTTPS with a dedicated web frontend like Nginx on top of a
> + robust WSGI application.
> Nginx has decent default security settings, is able to talk to WSGI
> - applications by the native WSGI protocol and also offers features like
> + applications by the native WSGI protocol, and also offers features like
> caching of dynamic content, load balancing, serving static resources.
That's mostly just fixing the capitalisation; here's a slightly more
rephrased version:
While the uWSGI server as WSGI backend offers the possibility of serving
HTTP content it is still preferable to expose the content produced by the
Tryton server via HTTPS with a dedicated web frontend like Nginx on top of
a robust WSGI application. Nginx has decent default security settings, can
talk to WSGI applications by the native WSGI protocol, and also offers
features like caching of dynamic content, load balancing, and serving
static resources.
(Does "serving static resources" really count as a "feature"?)
[...]
> -Description: Tryton Application Platform (Tryton Server All In One)
> +Description: Tryton application platform - metapackage
Assuming it *is* a metapackage... if it's full of setup wizards maybe
it should be something like
Description: Tryton application platform - full installation
> Tryton is a high-level general purpose application platform. It is the base
> of a complete business solution as well as a comprehensive health and hospital
> information system (GNUHealth).
> @@ -180,8 +180,8 @@
> Tryton server installation.
> It will provide
> - the guided configuration and creation of the PostgreSQL database
> - - the guided setup of an uWSGI backend
> - - the guided setup of a nginx frontend with the optional registration
> + - the guided setup of a uWSGI backend
> + - the guided setup of an Nginx frontend with the optional registration
> and setup of Letsencrypt certificates
> - a preconfigured PostgreSQL database prefilled with static data
> - like countries, currencies and postal codes ready for use
> + such as countries, currencies, and postal codes ready for use
Again this is mostly just recapitalised; but looking at it again I
find myself asking questions like "how do you configure something
before you've created it?" and "what's the difference between
guided configuration and guided setup?". Oh, and it's either
"letsencrypt" or "Let's Encrypt". Revised version:
[...] Tryton server installation. It provides
* guided creation of the PostgreSQL database;
* guided setup of a uWSGI backend;
* guided setup of an Nginx frontend with the optional registration and
setup of Let's Encrypt certificates;
* a preconfigured PostgreSQL database prefilled with static data such as
countries, currencies, and postal codes ready for use.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Source: tryton-server
Maintainer: Debian Tryton Maintainers <team+tryton-team@tracker.debian.org>
Uploaders: Mathias Behrle <mathiasb@m9s.biz>
Section: python
Priority: optional
Build-Depends: debhelper-compat (= 13),
dh-python,
init-system-helpers (>= 1.51),
po-debconf,
python3,
python3-bcrypt,
python3-dateutil,
python3-defusedxml,
python3-genshi,
python3-lxml,
python3-mock,
python3-passlib,
python3-pil,
python3-polib,
python3-relatorio (>= 0.7),
python3-setuptools,
python3-sphinx,
python3-sql,
python3-werkzeug,
python3-wrapt
Standards-Version: 4.6.1
Rules-Requires-Root: no
Vcs-Browser: https://salsa.debian.org/tryton-team/tryton-server
Vcs-Git: https://salsa.debian.org/tryton-team/tryton-server.git
Homepage: http://www.tryton.org/
Package: tryton-server
Architecture: all
Pre-Depends: ${misc:Pre-Depends}
Depends: adduser,
lsb-base,
python3-bcrypt,
python3-dateutil,
python3-defusedxml,
python3-genshi,
python3-lxml,
python3-pkg-resources,
python3-passlib,
python3-polib,
python3-relatorio (>= 0.7),
python3-sql,
python3-werkzeug,
python3-wrapt,
ucf,
${misc:Depends},
${python3:Depends}
Recommends: default-mta | mail-transport-agent,
libreoffice-calc,
libreoffice-writer,
postgresql,
python3-gevent,
python3-html2text,
python3-levenshtein,
python3-pil,
python3-psycopg2,
python3-pydot,
python3-weasyprint,
ssl-cert
Suggests: postgresql-client,
python3-sphinx,
tryton-client,
tryton-modules-all,
tryton-server-doc
Provides: ${API}
Description: Tryton application platform - server
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth). It is written in Python and uses PostgreSQL
as its preferred database engine.
.
This package contains the server.
Package: tryton-server-doc
Architecture: all
Section: doc
Depends: ${misc:Depends},
${sphinxdoc:Depends}
Description: Tryton application platform - server documentation
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth). It is written in Python and uses PostgreSQL
as its preferred database engine.
.
This package contains the documentation of the server in HTML format.
Package: tryton-server-postgresql
Architecture: all
Depends: ${API},
dbconfig-pgsql | dbconfig-no-thanks,
python3-psycopg2,
tryton-server,
ucf,
${misc:Depends}
Suggests: postgresql, autopostgresqlbackup
Description: Tryton application platform - PostgreSQL integration
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth).
.
The default database backend of the Tryton server is SQLite3, but for
production use PostgreSQL is the preferred and recommended database engine.
.
This package provides the integration of tryton-server with PostgreSQL.
Package: tryton-server-uwsgi
Architecture: all
Depends: ${API},
tryton-server,
ucf,
uwsgi-plugin-python3,
${misc:Depends}
Recommends: tryton-server-postgresql
Suggests: tryton-server-nginx
Description: Tryton application platform - uWSGI integration
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth).
.
For production use it is recommended to run the Tryton server under a
WSGI backend instead of the simple Werkzeug development server.
.
This package provides the integration of tryton-server with the uWSGI backend.
It offers also the possibility of configuring and running workers and/or the
scheduler as uWSGI daemons.
.
The Tryton server can be accessed by the uWSGI and/or HTTP protocols.
For small sites that are not exposed to the Internet this may already cover
your needs; otherwise have a look at the package tryton-server-nginx to run
the uWSGI server behind a dedicated reverse proxy.
Package: tryton-server-nginx
Architecture: all
Depends: ${API},
python3-certbot-nginx | nginx,
tryton-server-uwsgi,
ucf,
${misc:Depends}
Suggests: tryton-server-postgresql
Description: Tryton application platform - Nginx integration
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth).
.
While the uWSGI server as WSGI backend offers the possibility of serving
HTTP content it is still preferable to expose the content produced by the
Tryton server via HTTPS with a dedicated web frontend like Nginx on top of
a robust WSGI application. Nginx has decent default security settings, can
talk to WSGI applications by the native WSGI protocol, and also offers
features like caching of dynamic content, load balancing, and serving
static resources.
.
This package provides the integration of tryton-server-uwsgi with Nginx.
Package: tryton-server-all-in-one
Architecture: all
Depends: ${API},
python3-pycountry,
tryton-proteus,
tryton-server,
tryton-server-nginx,
tryton-server-postgresql,
tryton-server-uwsgi,
tryton-modules-country,
tryton-modules-currency,
${misc:Depends}
Recommends: tryton-client-doc,
tryton-modules-all,
tryton-server-doc
Description: Tryton application platform - metapackage
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth).
.
This package offers the complete guided production grade setup of a
Tryton server installation. It provides:
* guided creation of the PostgreSQL database;
* guided setup of a uWSGI backend;
* guided setup of an Nginx frontend with the optional registration and
setup of Let's Encrypt certificates;
* a preconfigured PostgreSQL database prefilled with static data such as
countries, currencies, and postal codes ready for use.
Template: tryton-server-all-in-one/postal-code-countries
Type: multiselect
Choices: Afghanistan - AF, Albania - AL, Algeria - DZ, American Samoa - AS, Andorra - AD, Angola - AO, Anguilla - AI, Antarctica - AQ, Antigua and Barbuda - AG, Argentina - AR, Armenia - AM, Aruba - AW, Australia - AU, Austria - AT, Azerbaijan - AZ, Bahamas - BS, Bahrain - BH, Bangladesh - BD, Barbados - BB, Belarus - BY, Belgium - BE, Belize - BZ, Benin - BJ, Bermuda - BM, Bhutan - BT, Bolivia Plurinational State of - BO, Bonaire Sint Eustatius and Saba - BQ, Bosnia and Herzegovina - BA, Botswana - BW, Bouvet Island - BV, Brazil - BR, British Indian Ocean Territory - IO, Brunei Darussalam - BN, Bulgaria - BG, Burkina Faso - BF, Burundi - BI, Cabo Verde - CV, Cambodia - KH, Cameroon - CM, Canada - CA, Cayman Islands - KY, Central African Republic - CF, Chad - TD, Chile - CL, China - CN, Christmas Island - CX, Cocos (Keeling) Islands - CC, Colombia - CO, Comoros - KM, Congo The Democratic Republic of the - CD, Congo - CG, Cook Islands - CK, Costa Rica - CR, Croatia - HR, Cuba - CU, Curaçao - CW, Cyprus - CY, Czechia - CZ, Côte dIvoire - CI, Denmark - DK, Djibouti - DJ, Dominica - DM, Dominican Republic - DO, Ecuador - EC, Egypt - EG, El Salvador - SV, Equatorial Guinea - GQ, Eritrea - ER, Estonia - EE, Eswatini - SZ, Ethiopia - ET, Falkland Islands (Malvinas) - FK, Faroe Islands - FO, Fiji - FJ, Finland - FI, France - FR, French Guiana - GF, French Polynesia - PF, French Southern Territories - TF, Gabon - GA, Gambia - GM, Georgia - GE, Germany - DE, Ghana - GH, Gibraltar - GI, Greece - GR, Greenland - GL, Grenada - GD, Guadeloupe - GP, Guam - GU, Guatemala - GT, Guernsey - GG, Guinea - GN, Guinea-Bissau - GW, Guyana - GY, Haiti - HT, Heard Island and McDonald Islands - HM, Holy See (Vatican City State) - VA, Honduras - HN, Hong Kong - HK, Hungary - HU, Iceland - IS, India - IN, Indonesia - ID, Iran Islamic Republic of - IR, Iraq - IQ, Ireland - IE, Isle of Man - IM, Israel - IL, Italy - IT, Jamaica - JM, Japan - JP, Jersey - JE, Jordan - JO, Kazakhstan - KZ, Kenya - KE, Kiribati - KI, Korea Democratic Peoples Republic of - KP, Korea Republic of - KR, Kuwait - KW, Kyrgyzstan - KG, Lao Peoples Democratic Republic - LA, Latvia - LV, Lebanon - LB, Lesotho - LS, Liberia - LR, Libya - LY, Liechtenstein - LI, Lithuania - LT, Luxembourg - LU, Macao - MO, Madagascar - MG, Malawi - MW, Malaysia - MY, Maldives - MV, Mali - ML, Malta - MT, Marshall Islands - MH, Martinique - MQ, Mauritania - MR, Mauritius - MU, Mayotte - YT, Mexico - MX, Micronesia Federated States of - FM, Moldova Republic of - MD, Monaco - MC, Mongolia - MN, Montenegro - ME, Montserrat - MS, Morocco - MA, Mozambique - MZ, Myanmar - MM, Namibia - NA, Nauru - NR, Nepal - NP, Netherlands - NL, New Caledonia - NC, New Zealand - NZ, Nicaragua - NI, Niger - NE, Nigeria - NG, Niue - NU, Norfolk Island - NF, North Macedonia - MK, Northern Mariana Islands - MP, Norway - NO, Oman - OM, Pakistan - PK, Palau - PW, Palestine State of - PS, Panama - PA, Papua New Guinea - PG, Paraguay - PY, Peru - PE, Philippines - PH, Pitcairn - PN, Poland - PL, Portugal - PT, Puerto Rico - PR, Qatar - QA, Romania - RO, Russian Federation - RU, Rwanda - RW, Réunion - RE, Saint Barthélemy - BL, Saint Helena Ascension and Tristan da Cunha - SH, Saint Kitts and Nevis - KN, Saint Lucia - LC, Saint Martin (French part) - MF, Saint Pierre and Miquelon - PM, Saint Vincent and the Grenadines - VC, Samoa - WS, San Marino - SM, Sao Tome and Principe - ST, Saudi Arabia - SA, Senegal - SN, Serbia - RS, Seychelles - SC, Sierra Leone - SL, Singapore - SG, Sint Maarten (Dutch part) - SX, Slovakia - SK, Slovenia - SI, Solomon Islands - SB, Somalia - SO, South Africa - ZA, South Georgia and the South Sandwich Islands - GS, South Sudan - SS, Spain - ES, Sri Lanka - LK, Sudan - SD, Suriname - SR, Svalbard and Jan Mayen - SJ, Sweden - SE, Switzerland - CH, Syrian Arab Republic - SY, Taiwan Province of China - TW, Tajikistan - TJ, Tanzania United Republic of - TZ, Thailand - TH, Timor-Leste - TL, Togo - TG, Tokelau - TK, Tonga - TO, Trinidad and Tobago - TT, Tunisia - TN, Turkey - TR, Turkmenistan - TM, Turks and Caicos Islands - TC, Tuvalu - TV, Uganda - UG, Ukraine - UA, United Arab Emirates - AE, United Kingdom - GB, United States - US, United States Minor Outlying Islands - UM, Uruguay - UY, Uzbekistan - UZ, Vanuatu - VU, Venezuela Bolivarian Republic of - VE, Viet Nam - VN, Virgin Islands British - VG, Virgin Islands U.S. - VI, Wallis and Futuna - WF, Western Sahara - EH, Yemen - YE, Zambia - ZM, Zimbabwe - ZW, Åland Islands - AX
_Description: Postal codes
Please select all countries for which postal codes should be imported.
This allows the address management system to offer automatic completion
features.
.
Note: The availability of codes depends on their existence on geonames.org.
Template: tryton-server-postgresql/db-admin-password
Type: string
_Description: Initial admin password for Tryton:
A superuser account named "admin" will be created for the Tryton database.
Please specify the password that this account should require for the initial
login.
.
If it is left empty a random password will be used. You can reset this
password from the command line with
.
$ sudo -u tryton trytond-admin -c /etc/tryton/trytond.conf --password -d <your_database_name>
.
Note: The initialization of the database may take some time; please be patient.
Template: tryton-server-postgresql/db-admin-email
Type: string
Default: root@localhost
_Description: Email address for the admin user:
Please specify a valid email address that should receive administrative
messages from the Tryton server.
Template: tryton-server-uwsgi/enable-workers
Type: boolean
Default: false
_Description: Set up Tryton server workers?
Some Tryton server tasks can be performed asynchronously in the
background by workers in a task queue.
.
If enabled, the workers can automatically perform tasks such as the
processing of sales, invoices, or purchases without waiting for the
clients to finish, thus removing the need for serialisation.
Template: tryton-server-uwsgi/enable-cron
Type: boolean
Default: false
_Description: Enable the Tryton scheduler?
Tryton server has its own "cron" scheduler which can run periodic
database-maintenance tasks (configured using the Tryton clients).
Please specify whether it should be activated.
--- control 2022-09-14 12:15:34.570732971 +0100
+++ control.jbr 2022-09-14 14:16:49.072265302 +0100
@@ -67,7 +67,7 @@
tryton-modules-all,
tryton-server-doc
Provides: ${API}
-Description: Tryton Application Platform (Server)
+Description: Tryton application platform - server
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth). It is written in Python and uses PostgreSQL
@@ -80,7 +80,7 @@
Section: doc
Depends: ${misc:Depends},
${sphinxdoc:Depends}
-Description: Tryton Application Platform (Server Documentation)
+Description: Tryton application platform - server documentation
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth). It is written in Python and uses PostgreSQL
@@ -97,7 +97,7 @@
ucf,
${misc:Depends}
Suggests: postgresql, autopostgresqlbackup
-Description: Tryton Application Platform (Tryton Server PostgreSQL)
+Description: Tryton application platform - PostgreSQL integration
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth).
@@ -116,21 +116,21 @@
${misc:Depends}
Recommends: tryton-server-postgresql
Suggests: tryton-server-nginx
-Description: Tryton Application Platform (Tryton Server uWSGI)
+Description: Tryton application platform - uWSGI integration
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth).
.
For production use it is recommended to run the Tryton server under a
- wsgi backend instead of the simple werkzeug development server.
+ WSGI backend instead of the simple Werkzeug development server.
.
- This package provides the integration of tryton-server with the uwsgi backend.
- It offers also the possibility to configure and run workers and/or cron as
- uWSGI daemons.
- .
- The Tryton server can be accessed by the uWSGI and/or the HTTP protocol.
- For small sites that are not exposed to the internet this may already cover
- your needs, otherwise have a look at package tryton-server-nginx to run
+ This package provides the integration of tryton-server with the uWSGI backend.
+ It offers also the possibility of configuring and running workers and/or the
+ scheduler as uWSGI daemons.
+ .
+ The Tryton server can be accessed by the uWSGI and/or HTTP protocols.
+ For small sites that are not exposed to the Internet this may already cover
+ your needs; otherwise have a look at the package tryton-server-nginx to run
the uWSGI server behind a dedicated reverse proxy.
Package: tryton-server-nginx
@@ -141,18 +141,18 @@
ucf,
${misc:Depends}
Suggests: tryton-server-postgresql
-Description: Tryton Application Platform (Tryton Server Nginx)
+Description: Tryton application platform - Nginx integration
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth).
.
- While the uWSGI server as WSGI backend offers the possibility to serve http
- content it is still preferable to expose the content produced by the Tryton
- server via https with a dedicated web frontend like Nginx on top of a
- robust wsgi application.
- Nginx has decent default security settings, is able to talk to WSGI
- applications by the native WSGI protocol and also offers features like
- caching of dynamic content, load balancing, serving static resources.
+ While the uWSGI server as WSGI backend offers the possibility of serving
+ HTTP content it is still preferable to expose the content produced by the
+ Tryton server via HTTPS with a dedicated web frontend like Nginx on top of
+ a robust WSGI application. Nginx has decent default security settings, can
+ talk to WSGI applications by the native WSGI protocol, and also offers
+ features like caching of dynamic content, load balancing, and serving
+ static resources.
.
This package provides the integration of tryton-server-uwsgi with Nginx.
@@ -171,17 +171,16 @@
Recommends: tryton-client-doc,
tryton-modules-all,
tryton-server-doc
-Description: Tryton Application Platform (Tryton Server All In One)
+Description: Tryton application platform - metapackage
Tryton is a high-level general purpose application platform. It is the base
of a complete business solution as well as a comprehensive health and hospital
information system (GNUHealth).
.
This package offers the complete guided production grade setup of a
- Tryton server installation.
- It will provide
- - the guided configuration and creation of the PostgreSQL database
- - the guided setup of an uWSGI backend
- - the guided setup of a nginx frontend with the optional registration
- and setup of Letsencrypt certificates
- - a preconfigured PostgreSQL database prefilled with static data
- like countries, currencies and postal codes ready for use
+ Tryton server installation. It provides:
+ * guided creation of the PostgreSQL database;
+ * guided setup of a uWSGI backend;
+ * guided setup of an Nginx frontend with the optional registration and
+ setup of Let's Encrypt certificates;
+ * a preconfigured PostgreSQL database prefilled with static data such as
+ countries, currencies, and postal codes ready for use.
--- tryton-server-all-in-one.templates 2022-09-14 12:15:39.782505328 +0100
+++ tryton-server-all-in-one.templates.jbr 2022-09-13 18:15:29.028146382 +0100
@@ -1,9 +1,9 @@
Template: tryton-server-all-in-one/postal-code-countries
Type: multiselect
Choices: Afghanistan - AF, Albania - AL, Algeria - DZ, American Samoa - AS, Andorra - AD, Angola - AO, Anguilla - AI, Antarctica - AQ, Antigua and Barbuda - AG, Argentina - AR, Armenia - AM, Aruba - AW, Australia - AU, Austria - AT, Azerbaijan - AZ, Bahamas - BS, Bahrain - BH, Bangladesh - BD, Barbados - BB, Belarus - BY, Belgium - BE, Belize - BZ, Benin - BJ, Bermuda - BM, Bhutan - BT, Bolivia Plurinational State of - BO, Bonaire Sint Eustatius and Saba - BQ, Bosnia and Herzegovina - BA, Botswana - BW, Bouvet Island - BV, Brazil - BR, British Indian Ocean Territory - IO, Brunei Darussalam - BN, Bulgaria - BG, Burkina Faso - BF, Burundi - BI, Cabo Verde - CV, Cambodia - KH, Cameroon - CM, Canada - CA, Cayman Islands - KY, Central African Republic - CF, Chad - TD, Chile - CL, China - CN, Christmas Island - CX, Cocos (Keeling) Islands - CC, Colombia - CO, Comoros - KM, Congo The Democratic Republic of the - CD, Congo - CG, Cook Islands - CK, Costa Rica - CR, Croatia - HR, Cuba - CU, Curaçao - CW, Cyprus - CY, Czechia - CZ, Côte dIvoire - CI, Denmark - DK, Djibouti - DJ, Dominica - DM, Dominican Republic - DO, Ecuador - EC, Egypt - EG, El Salvador - SV, Equatorial Guinea - GQ, Eritrea - ER, Estonia - EE, Eswatini - SZ, Ethiopia - ET, Falkland Islands (Malvinas) - FK, Faroe Islands - FO, Fiji - FJ, Finland - FI, France - FR, French Guiana - GF, French Polynesia - PF, French Southern Territories - TF, Gabon - GA, Gambia - GM, Georgia - GE, Germany - DE, Ghana - GH, Gibraltar - GI, Greece - GR, Greenland - GL, Grenada - GD, Guadeloupe - GP, Guam - GU, Guatemala - GT, Guernsey - GG, Guinea - GN, Guinea-Bissau - GW, Guyana - GY, Haiti - HT, Heard Island and McDonald Islands - HM, Holy See (Vatican City State) - VA, Honduras - HN, Hong Kong - HK, Hungary - HU, Iceland - IS, India - IN, Indonesia - ID, Iran Islamic Republic of - IR, Iraq - IQ, Ireland - IE, Isle of Man - IM, Israel - IL, Italy - IT, Jamaica - JM, Japan - JP, Jersey - JE, Jordan - JO, Kazakhstan - KZ, Kenya - KE, Kiribati - KI, Korea Democratic Peoples Republic of - KP, Korea Republic of - KR, Kuwait - KW, Kyrgyzstan - KG, Lao Peoples Democratic Republic - LA, Latvia - LV, Lebanon - LB, Lesotho - LS, Liberia - LR, Libya - LY, Liechtenstein - LI, Lithuania - LT, Luxembourg - LU, Macao - MO, Madagascar - MG, Malawi - MW, Malaysia - MY, Maldives - MV, Mali - ML, Malta - MT, Marshall Islands - MH, Martinique - MQ, Mauritania - MR, Mauritius - MU, Mayotte - YT, Mexico - MX, Micronesia Federated States of - FM, Moldova Republic of - MD, Monaco - MC, Mongolia - MN, Montenegro - ME, Montserrat - MS, Morocco - MA, Mozambique - MZ, Myanmar - MM, Namibia - NA, Nauru - NR, Nepal - NP, Netherlands - NL, New Caledonia - NC, New Zealand - NZ, Nicaragua - NI, Niger - NE, Nigeria - NG, Niue - NU, Norfolk Island - NF, North Macedonia - MK, Northern Mariana Islands - MP, Norway - NO, Oman - OM, Pakistan - PK, Palau - PW, Palestine State of - PS, Panama - PA, Papua New Guinea - PG, Paraguay - PY, Peru - PE, Philippines - PH, Pitcairn - PN, Poland - PL, Portugal - PT, Puerto Rico - PR, Qatar - QA, Romania - RO, Russian Federation - RU, Rwanda - RW, Réunion - RE, Saint Barthélemy - BL, Saint Helena Ascension and Tristan da Cunha - SH, Saint Kitts and Nevis - KN, Saint Lucia - LC, Saint Martin (French part) - MF, Saint Pierre and Miquelon - PM, Saint Vincent and the Grenadines - VC, Samoa - WS, San Marino - SM, Sao Tome and Principe - ST, Saudi Arabia - SA, Senegal - SN, Serbia - RS, Seychelles - SC, Sierra Leone - SL, Singapore - SG, Sint Maarten (Dutch part) - SX, Slovakia - SK, Slovenia - SI, Solomon Islands - SB, Somalia - SO, South Africa - ZA, South Georgia and the South Sandwich Islands - GS, South Sudan - SS, Spain - ES, Sri Lanka - LK, Sudan - SD, Suriname - SR, Svalbard and Jan Mayen - SJ, Sweden - SE, Switzerland - CH, Syrian Arab Republic - SY, Taiwan Province of China - TW, Tajikistan - TJ, Tanzania United Republic of - TZ, Thailand - TH, Timor-Leste - TL, Togo - TG, Tokelau - TK, Tonga - TO, Trinidad and Tobago - TT, Tunisia - TN, Turkey - TR, Turkmenistan - TM, Turks and Caicos Islands - TC, Tuvalu - TV, Uganda - UG, Ukraine - UA, United Arab Emirates - AE, United Kingdom - GB, United States - US, United States Minor Outlying Islands - UM, Uruguay - UY, Uzbekistan - UZ, Vanuatu - VU, Venezuela Bolivarian Republic of - VE, Viet Nam - VN, Virgin Islands British - VG, Virgin Islands U.S. - VI, Wallis and Futuna - WF, Western Sahara - EH, Yemen - YE, Zambia - ZM, Zimbabwe - ZW, Åland Islands - AX
-_Description: Import of postal codes
- Please select all countries for which postal codes should be imported
- .
- Preconfigured postal codes offer automatic completion features in the address management.
+_Description: Postal codes
+ Please select all countries for which postal codes should be imported.
+ This allows the address management system to offer automatic completion
+ features.
.
Note: The availability of codes depends on their existence on geonames.org.
--- tryton-server-postgresql.templates 2022-09-14 12:15:38.650554691 +0100
+++ tryton-server-postgresql.templates.jbr 2022-09-13 18:17:48.612737129 +0100
@@ -1,22 +1,20 @@
Template: tryton-server-postgresql/db-admin-password
Type: string
_Description: Initial admin password for Tryton:
- The Tryton database will be populated with an initial superuser, named 'admin',
- and the password you provide here will be used as the initial password
- of this superuser. This password will be required for the first login.
+ A superuser account named "admin" will be created for the Tryton database.
+ Please specify the password that this account should require for the initial
+ login.
.
- If left empty a random password will be used. You can reset this password
- from the command line with
+ If it is left empty a random password will be used. You can reset this
+ password from the command line with
.
$ sudo -u tryton trytond-admin -c /etc/tryton/trytond.conf --password -d <your_database_name>
.
- Note: The initialization of the database may take some time, please be patient.
+ Note: The initialization of the database may take some time; please be patient.
Template: tryton-server-postgresql/db-admin-email
Type: string
Default: root@localhost
_Description: Email address for the admin user:
- This email address receives all kind of administrative messages for the
- admin user.
- .
- The value should be a FQDN (Full Qualified Domain Name).
+ Please specify a valid email address that should receive administrative
+ messages from the Tryton server.
--- tryton-server-uwsgi.templates 2022-09-14 12:15:37.266615099 +0100
+++ tryton-server-uwsgi.templates.jbr 2022-09-14 13:06:17.760470171 +0100
@@ -1,20 +1,19 @@
Template: tryton-server-uwsgi/enable-workers
Type: boolean
Default: false
-_Description: Configure workers for the Tryton server?
- Some Tryton server tasks may be performed in the background
- asynchronically by workers in a task queue.
+_Description: Set up Tryton server workers?
+ Some Tryton server tasks can be performed asynchronously in the
+ background by workers in a task queue.
.
- If workers are configured those tasks (like e.g. the processing of sales,
- invoices or purchases) can be automatically performed by workers. They
- do not wait for completion in the clients thus removing the need of
- waiting and doing serialized steps.
+ If enabled, the workers can automatically perform tasks such as the
+ processing of sales, invoices, or purchases without waiting for the
+ clients to finish, thus removing the need for serialisation.
Template: tryton-server-uwsgi/enable-cron
Type: boolean
Default: false
-_Description: Configure cron for the Tryton server?
- There exist several Tryton server cron jobs that mainly run periodically some
- maintenance tasks on the database. They can be configured with the clients.
- .
- Note: Only one cron server should be enabled per database.
+_Description: Enable the Tryton scheduler?
+ Tryton server has its own "cron" scheduler which can run periodic
+ database-maintenance tasks (configured using the Tryton clients).
+ Please specify whether it should be activated.
+
Reply to: