diff --git a/app_netdata.md b/app_netdata.md index 3729e63b..f9ab8e53 100644 --- a/app_netdata.md +++ b/app_netdata.md @@ -14,16 +14,16 @@ disrupting their core function._ **Customization brought by the package:** * grant MySQL statistics access via a `netdata` user -* nginx root log statistics via putting `netdata` user in the `adm` group +* NGINX root log statistics via putting `netdata` user in the `adm` group * Dovecot statistics via giving access to Dovecot stats stocket to `netdata` user (works only with Dovecot 2.2.16+) **Further recommendations:** We don't allow YunoHost packages to make sensible changes to system files. So here are further customizations you can make to allow more monitoring: -* Nginx: +* NGINX: * requests/connections: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#nginx) to enable `/stab_status` (for example by putting the `location` section in `/etc/nginx/conf.d/yunohost_admin.conf` - * weblogs: you can monitor all your nginx weblogs for errors; follow [these recommendations](https://github.com/firehol/netdata/tree/master/python.d#nginx_log) -* phpfpm: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#phpfpm) + * weblogs: you can monitor all your NGINX weblogs for errors; follow [these recommendations](https://github.com/firehol/netdata/tree/master/python.d#nginx_log) +* PHP-FPM: follow [these recommandations](https://github.com/firehol/netdata/tree/master/python.d#phpfpm) ## Features @@ -50,15 +50,15 @@ We don't allow YunoHost packages to make sensible changes to system files. So he - **Extensible**
you can monitor anything you can get a metric for, - using its Plugin API (anything can be a netdata plugin, - BASH, python, perl, node.js, java, Go, ruby, etc) + using its Plugin API (anything can be a NetData plugin, + BASH, Python, Perl, Node.JS, Java, Go, Ruby, etc.) - **Embeddable**
it can run anywhere a Linux kernel runs (even IoT) and its charts can be embedded on your web pages too - **Customizable**
- custom dashboards can be built using simple HTML (no javascript necessary) + custom dashboards can be built using simple HTML (no JavaScript necessary) - **Zero configuration**
auto-detects everything, it can collect up to 5000 metrics @@ -112,18 +112,18 @@ This is a list of what it currently monitors: - **IPv4 networking**
bandwidth, packets, errors, fragments, - tcp: connections, packets, errors, handshake, - udp: packets, errors, + TCP: connections, packets, errors, handshake, + UDP: packets, errors, broadcast: bandwidth, packets, multicast: bandwidth, packets - **IPv6 networking**
bandwidth, packets, errors, fragments, ECT, - udp: packets, errors, - udplite: packets, errors, + UDP: packets, errors, + UDP-Lite: packets, errors, broadcast: bandwidth, multicast: bandwidth, packets, - icmp: messages, errors, echos, router, neighbor, MLDv2, group membership, + ICMP: messages, errors, echos, router, neighbor, MLDv2, group membership, break down by type - **Interprocess Communication - IPC**
@@ -171,7 +171,7 @@ This is a list of what it currently monitors: - **Apache and lighttpd web servers**
`mod-status` (v2.2, v2.4) and cache log statistics, for multiple servers -- **Nginx web servers**
+- **NGINX web servers**
`stub-status`, for multiple servers - **Tomcat**
@@ -193,13 +193,13 @@ This is a list of what it currently monitors: multiple servers, each showing: operations, hit rate, memory, keys, clients, slaves - **mongodb**
- operations, clients, transactions, cursors, connections, asserts, locks, etc + operations, clients, transactions, cursors, connections, asserts, locks, etc. - **memcached databases**
multiple servers, each showing: bandwidth, connections, items - **elasticsearch**
- search and index performance, latency, timings, cluster statistics, threads statistics, etc + search and index performance, latency, timings, cluster statistics, threads statistics, etc. - **ISC Bind name servers**
multiple servers, each showing: clients, requests, queries, updates, failures and several per view metrics @@ -225,10 +225,10 @@ This is a list of what it currently monitors: multiple servers, each showing: clients bandwidth and requests, servers bandwidth and requests - **HAproxy**
- bandwidth, sessions, backends, etc + bandwidth, sessions, backends, etc. - **varnish**
- threads, sessions, hits, objects, backends, etc + threads, sessions, hits, objects, backends, etc. - **OpenVPN**
status per tunnel diff --git a/contributordoc.md b/contributordoc.md index 72f4b1bb..000be174 100644 --- a/contributordoc.md +++ b/contributordoc.md @@ -16,7 +16,7 @@ * [Scripts](packaging_apps_scripts) * [Arguments management](packaging_apps_arguments_management) * [Arguments format](packaging_apps_arguments_format) - * [Nginx configuration](packaging_apps_nginx_conf) + * [NGINX configuration](packaging_apps_nginx_conf) * [Multi-instance](packaging_apps_multiinstance) * [Helpers](packaging_apps_helpers) * [Trap usage](/packaging_apps_trap) diff --git a/contributordoc_fr.md b/contributordoc_fr.md index d52744e4..3c812fa4 100644 --- a/contributordoc_fr.md +++ b/contributordoc_fr.md @@ -16,7 +16,7 @@ * [Scripts](/packaging_apps_scripts) * [Gestion des arguments](/packaging_apps_arguments_management) * [Format des arguments](/packaging_apps_arguments_format) - * [Configuration nginx](/packaging_apps_nginx_conf) + * [Configuration NGINX](/packaging_apps_nginx_conf) * [Multi-instance](/packaging_apps_multiinstance) * [Fonctions utiles](/packaging_apps_helpers) * [Utilisation de 'trap'](/packaging_apps_trap) diff --git a/dns_subdomains.md b/dns_subdomains.md index dbdf2492..b6112c6c 100644 --- a/dns_subdomains.md +++ b/dns_subdomains.md @@ -21,7 +21,7 @@ then you can access `agenda.mydomain.com`, `blog.mydomain.com` and `rss.mydomain ### Install an application on a subdomain -To install an application on a subdomain in YunoHost, for example `blog.mydomain.com`, the configuration is done in the administration panel. One first add the subdomain to the available domains list. The creation of a subdomain in YunoHost will create the corresponding configuration files for Nginx (the web server used in YunoHost). +To install an application on a subdomain in YunoHost, for example `blog.mydomain.com`, the configuration is done in the administration panel. One first add the subdomain to the available domains list. The creation of a subdomain in YunoHost will create the corresponding configuration files for NGINX (the web server used in YunoHost). Then, in the applications>install panel, one follows the classic installation process by choosing the desired subdomain as domain (for example `blog.mydomain.com`). One needs to choose the path `/` (in place of `/wordpress` for example). A warning message will appear telling that it won't be possible to install other application to this subdomain. After validation, the installation starts. diff --git a/dns_subdomains_fr.md b/dns_subdomains_fr.md index 132ffe18..a8c6181a 100644 --- a/dns_subdomains_fr.md +++ b/dns_subdomains_fr.md @@ -20,7 +20,7 @@ permet d’avoir un `agenda.mondomaine.fr`, un `blog.mondomaine.fr` etc… ### Installer une application sur un sous-domaine -Pour installer une application sur un sous-domaine, par exemple `blog.mondomaine.fr`, dans YunoHost, tout se fait via la partie administration. On ajoute tout d’abord le sous-domaine à la liste des domaines disponibles. La création d’un sous-domaine dans YunoHost créera les fichiers de configuration correspondants pour Nginx (le serveur web de YunoHost). +Pour installer une application sur un sous-domaine, par exemple `blog.mondomaine.fr`, dans YunoHost, tout se fait via la partie administration. On ajoute tout d’abord le sous-domaine à la liste des domaines disponibles. La création d’un sous-domaine dans YunoHost créera les fichiers de configuration correspondants pour NGINX (le serveur web de YunoHost). Puis dans la partie installation d’une application, on installe l’application de façon traditionnelle en choisissant ce sous-domaine comme domaine (par exemple `blog.mondomaine.fr`) et en indiquant comme chemin `/` (et non `/wordpress` qui est le chemin par défaut). On a alors un message d’avertissement indiquant qu’on ne pourra plus installer d’applications sur ce sous-domaine. On valide. Ça s’installe. diff --git a/faq.md b/faq.md index 48517168..19ec5b7a 100644 --- a/faq.md +++ b/faq.md @@ -125,7 +125,7 @@ Medium answer: Apps were packaged in .deb in the past. It was a nightmare. We're

Turns out, YunoHost apps packaging holds a subtly different purpose than traditional packaging like .deb. Debian packages fulfill the low-level purpose of installing files, commands, programs and services on the system. It is often your duty to configure them properly, simply because there is no standard server setup. Typically, web apps requires a lot of configuration because they rely on a web server and a database (and the single sign-on).

-

YunoHost manipulates high-level abstractions (apps, domains, users, ...) and defines a standard setup (Nginx, Postfix, Metronome, SSOwat, ...) and, because of this, can handle the configuration for the user.

+

YunoHost manipulates high-level abstractions (apps, domains, users...) and defines a standard setup (NGINX, Postfix, Metronome, SSOwat...) and, because of this, can handle the configuration for the user.

If you still think it's possible to handle everything by fiddling with .deb packages, see previous answers.

diff --git a/faq_de.md b/faq_de.md index a2640231..f7939b58 100644 --- a/faq_de.md +++ b/faq_de.md @@ -102,7 +102,7 @@ Mittellange Antwort: Früher wurden die Apps in .deb gepackt. Was für ein Albtr

Es hat sich herausgestellt, dass das Packen für YunoHost einen leicht anderen Zweck erfüllt als das Erstellen klassischer Pakete wie .deb. Debian Pakete haben nur den Anspruch Dateien, Befehle, Programme und Dienste auf dem System zu installieren. Es bleibt oft an Ihnen diese richtig zu konfigurieren, weil es einfach keinen standardisierte Server-Konfiguration gibt. Typischerweise erfordern Web-Apps einen sehr hohen Konfigurationsaufwand, weil sie auf dem Webserver und einer Datenbank (und dem single sign-on) aufbauen.

-

YunoHost richtet Konzepte auf höchster Ebene ein (Apps, Domain-Namen, Benutzer, ...) und definiert eine standardmäßige Einrichtung (Nginx, Postfix, Metronome, SSOwat, ...) und kann deshalb die Konfiguration für den Anwender übernehmen.

+

YunoHost richtet Konzepte auf höchster Ebene ein (Apps, Domain-Namen, Benutzer...) und definiert eine standardmäßige Einrichtung (NGINX, Postfix, Metronome, SSOwat...) und kann deshalb die Konfiguration für den Anwender übernehmen.

Wer trotzdem glaubt, man könne deb Pakete dazu bringen, all dies zu leisten, möge sich die vorherige Antwort anschauen.

diff --git a/faq_fr.md b/faq_fr.md index 5b9d49ca..c033332f 100644 --- a/faq_fr.md +++ b/faq_fr.md @@ -115,7 +115,7 @@ Réponse moyenne : Par le passé, les apps étaient gérées via des .deb. C’

Il se trouve que l’objectif des paquets d’application YunoHost est subtilement différent de celui des paquets traditionnels (comme les .deb de Debian) qui remplissent le rôle d’installer des éléments bas-niveau tels que des fichiers, commandes, programmes ou services sur le système. Il est à la charge de l’administrateur de les configurer ensuite proprement, simplement parce qu’il n’existe pas d’environnement standard. Typiquement, les applications web requièrent beaucoup de configuration car elles ont besoin de s’interfacer avec un serveur web et une base de données (et le système de connexion unique / SSO).

-

YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et définit un environnement standard (Nginx, Postfix, Metronome, SSOwat…) et, grâce à cela, peut gérer la configuration à la place de l’administrateur.

+

YunoHost manipule des abstractions haut-niveau (apps, domaines, utilisateurs…) et définit un environnement standard (NGINX, Postfix, Metronome, SSOwat...) et, grâce à cela, peut gérer la configuration à la place de l’administrateur.

Si vous restez persuadé que l’on peut néanmoins bricoler les paquets .deb pour gérer tout cela, voir les réponses précédentes.

diff --git a/packaging_apps.md b/packaging_apps.md index 898d7a74..36a34f65 100644 --- a/packaging_apps.md +++ b/packaging_apps.md @@ -31,8 +31,8 @@ Since YunoHost has a unified architecture, you will be able to guess most of the Arguments management -### Nginx configuration -Nginx configuration +### NGINX configuration +NGINX configuration ### Multi-instance Multi-instance diff --git a/packaging_apps_fr.md b/packaging_apps_fr.md index 4f30edff..19f7e69c 100644 --- a/packaging_apps_fr.md +++ b/packaging_apps_fr.md @@ -33,8 +33,8 @@ Comme les instances de YunoHost possèdent une architecture unifiée, vous serez Gestion des arguments -### Configuration Nginx -Configuration Nginx +### Configuration NGINX +Configuration NGINX ### Multi-instance Multi-instance @@ -50,7 +50,7 @@ Dans de nombreuses situations, vous pouvez vouloir indexer un fichier de log pou Il est possible de spécifier la date de début en commençant le nom de fichier par la date `YYYYMMDD-HHMMSS`. -Exemple de fichier de log d'indexation: +Exemple de fichier de log d'indexation : ```bash log_path: /chemin/vers/le/fichier.log ``` diff --git a/packaging_apps_multiinstance.md b/packaging_apps_multiinstance.md index 03bc6680..54b3b970 100644 --- a/packaging_apps_multiinstance.md +++ b/packaging_apps_multiinstance.md @@ -6,7 +6,7 @@ Multi-instance is application capacity to be installed several times. #### Scripts When YunoHost installs the application, it passes `$YNH_APP_INSTANCE_NAME` var to the script, set to value `id__n` with the application `id` coming from the manifest and `n` being an integer incremented each time a new instance of the application is installed. -**E.g.** in the roundcube script, database is called `roundcube`, the install directory `roundcube` and the [Nginx configuration](/packaging_apps_nginx_conf) `roundcube`. This way, the second instance of roundcube will not conflict with the first one, and will be installed in the `roundcube__2` database, in the `roundcube__2`directory, and with the `roundcube__2` Nginx configuration. +**E.g.** in the Roundcube script, database is called `roundcube`, the install directory `roundcube` and the [NGINX configuration](/packaging_apps_nginx_conf) `roundcube`. This way, the second instance of Roundcube will not conflict with the first one, and will be installed in the `roundcube__2` database, in the `roundcube__2`directory, and with the `roundcube__2` NGINX configuration. Retrieve app identifier (including the multi-instance id): ```bash diff --git a/packaging_apps_multiinstance_fr.md b/packaging_apps_multiinstance_fr.md index 58a6809b..b6c72f1d 100644 --- a/packaging_apps_multiinstance_fr.md +++ b/packaging_apps_multiinstance_fr.md @@ -6,7 +6,7 @@ Le multi-instance est la capacité d’une application à être installée plusi #### Scripts Lorsque YunoHost installe l’application, il passe au script dans la variable `$YNH_APP_INSTANCE_NAME` la valeur `id__n` avec l’identifiant de l’application `id` provenant du manifeste et `n` un nombre incrémentée à chaque nouvelle instance de l’application. -**Par exemple** : dans le script roundcube, il faut nommer la base de données `roundcube`, le dossier d’installation `roundcube` et la [configuration Nginx](/packaging_apps_nginx_conf) `roundcube`. De cette manière, la seconde installation de roundcube ne rentrera pas en conflit avec la première, et sera installée dans la base de données `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration Nginx `roundcube__2`. +**Par exemple** : dans le script Roundcube, il faut nommer la base de données `roundcube`, le dossier d’installation `roundcube` et la [configuration NGINX](/packaging_apps_nginx_conf) `roundcube`. De cette manière, la seconde installation de Roundcube ne rentrera pas en conflit avec la première, et sera installée dans la base de données `roundcube__2`, dans le répertoire `roundcube__2`, et avec la configuration NGINX `roundcube__2`. Récupération de l'identifiant de l'app (incluant l'id multi-instance) : diff --git a/packaging_apps_nginx_conf.md b/packaging_apps_nginx_conf.md index 7756793f..c25587de 100644 --- a/packaging_apps_nginx_conf.md +++ b/packaging_apps_nginx_conf.md @@ -1,7 +1,7 @@ -# Nginx configuration -This tutorial aim to help setup Nginx configuration for application packaging. +# NGINX configuration +This tutorial aim to help setup NGINX configuration for application packaging. -#### Nginx configuration +#### NGINX configuration Configuration must be in `conf/nginx.conf`. We must use **FastCGI** or a **proxy_pass** following the application: * **FastCGI** is used with PHP applications: ```nginx @@ -44,15 +44,15 @@ sed -i "s@YNH_EXAMPLE_PATH@$path@g" ../conf/nginx.conf sed -i "s@YNH_EXAMPLE_PORT@$port@g" ../conf/nginx.conf sed -i "s@YNH_EXEMPLE_DOMAIN@$domain@g" ../conf/nginx.conf ``` -We must move that configuration file in Nginx configuration, then reload Nginx configuration: +We must move that configuration file in NGINX configuration, then reload NGINX configuration: ```bash cp ../conf/nginx.conf /etc/nginx/conf.d/$domain.d/$app.conf sudo service nginx reload ``` -If Nginx won't restart, it's possible that this configuration file isn't right. +If NGINX won't restart, it's possible that this configuration file isn't right. #### Remove script -We must remove Nginx configuration of this application, then reload Nginx configuration: +We must remove NGINX configuration of this application, then reload NGINX configuration: ```bash rm -f /etc/nginx/conf.d/$domain.d/$app.conf sudo service nginx reload diff --git a/packaging_apps_nginx_conf_fr.md b/packaging_apps_nginx_conf_fr.md index 1f512cc3..3ed41f19 100644 --- a/packaging_apps_nginx_conf_fr.md +++ b/packaging_apps_nginx_conf_fr.md @@ -1,7 +1,7 @@ -# Configuration Nginx -Ce tutoriel a pour but d’aider à la mise en place d’une configuration Nginx pour le packaging d’application. +# Configuration NGINX +Ce tutoriel a pour but d’aider à la mise en place d’une configuration NGINX pour le packaging d’application. -#### Configuration Nginx +#### Configuration NGINX La configuration doit être mise dans `conf/nginx.conf`. Il s’agira d’utiliser **FastCGI** ou un **proxy_pass** suivant l’application : * **FastCGI** est utilisé dans les applications PHP : ```nginx @@ -44,15 +44,15 @@ sed -i "s@YNH_EXAMPLE_PATH@$path@g" ../conf/nginx.conf sed -i "s@YNH_EXAMPLE_PORT@$port@g" ../conf/nginx.conf sed -i "s@YNH_EXEMPLE_DOMAIN@$domain@g" ../conf/nginx.conf ``` -Il faut ensuite déplacer ce fichier de configuration dans la configuration de Nginx, puis recharger la configuration de Nginx : +Il faut ensuite déplacer ce fichier de configuration dans la configuration de NGINX, puis recharger la configuration de NGINX : ```bash cp ../conf/nginx.conf /etc/nginx/conf.d/$domain.d/$app.conf sudo service nginx reload ``` -Si Nginx ne redémarre pas, il se peut que le fichier de configuration ne soit pas correct. +Si NGINX ne redémarre pas, il se peut que le fichier de configuration ne soit pas correct. #### Script de suppression -Il s’agit de supprimer la configuration Nginx pour cette application, puis de recharger la configuration de Nginx : +Il s’agit de supprimer la configuration NGINX pour cette application, puis de recharger la configuration de NGINX : ```bash rm -f /etc/nginx/conf.d/$domain.d/$app.conf sudo service nginx reload diff --git a/torhiddenservice.md b/torhiddenservice.md index 44a93a1b..5c1fc0ca 100644 --- a/torhiddenservice.md +++ b/torhiddenservice.md @@ -43,7 +43,7 @@ If you want to avoid being redirected to the SSO portal at login, you can deacti #access_by_lua_file /usr/share/ssowat/access.lua; ``` -### Restart nginx +### Restart NGINX ```bash service nginx restart ``` diff --git a/torhiddenservice_fr.md b/torhiddenservice_fr.md index f5d7e4e0..a546f680 100644 --- a/torhiddenservice_fr.md +++ b/torhiddenservice_fr.md @@ -42,7 +42,7 @@ Si vous voulez éviter d’être redirigé vers le portail à la connexion pour #access_by_lua_file /usr/share/ssowat/access.lua; ``` -### Vérifier que l'on a pas fait d'erreurs dans la configuration de Nginx +### Vérifier que l'on a pas fait d'erreurs dans la configuration de NGINX ```bash nginx -t ``` diff --git a/torhiddenservice_it.md b/torhiddenservice_it.md index 2ba76834..155c4250 100644 --- a/torhiddenservice_it.md +++ b/torhiddenservice_it.md @@ -43,7 +43,7 @@ Se non vuoi essere rediretto al portale SSO al login puoi disattivare SSOwat spe #access_by_lua_file /usr/share/ssowat/access.lua; ``` -### Riavvia nginx +### Riavvia NGINX ```bash service nginx restart ``` diff --git a/use_case_non-profit_organisations.md b/use_case_non-profit_organisations.md index b270a885..923d5e21 100644 --- a/use_case_non-profit_organisations.md +++ b/use_case_non-profit_organisations.md @@ -68,7 +68,7 @@ Out of the box YunoHost provide: * A system of application * A web interface * A command-line interface (CLI): Moulinette -* A web server: Nginx +* A web server: NGINX * A DNS server: Dnsmasq * A database: MariaDB * A backup system diff --git a/use_case_non-profit_organisations_ca.md b/use_case_non-profit_organisations_ca.md index a700c6fe..2766213c 100644 --- a/use_case_non-profit_organisations_ca.md +++ b/use_case_non-profit_organisations_ca.md @@ -68,7 +68,7 @@ YunoHost de base ofereix: * Un sistema d'aplicacions * Una interfície web * Una interfície per línia de comandes (CLI): Moulinette -* Un servidor web: Nginx +* Un servidor web: NGINX * Un servidor DNS: Dnsmasq * Una base de dades: MariaDB * Un sistema de còpies de seguretat diff --git a/use_case_non-profit_organisations_fr.md b/use_case_non-profit_organisations_fr.md index ea76cb60..b398bc1f 100644 --- a/use_case_non-profit_organisations_fr.md +++ b/use_case_non-profit_organisations_fr.md @@ -67,7 +67,7 @@ YunoHost fournit immédiatement: * Un système d'application * Une interface web * Une interface de ligne de commande (CLI): Moulinette -* Un serveur Web : Nginx +* Un serveur Web : NGINX * Un serveur DNS : Dnsmasq * Une base de données: MariaDB * Un système de sauvegarde diff --git a/use_case_non-profit_organisations_oc.md b/use_case_non-profit_organisations_oc.md index a717505d..c90a4314 100644 --- a/use_case_non-profit_organisations_oc.md +++ b/use_case_non-profit_organisations_oc.md @@ -67,7 +67,7 @@ YunoHost provesís sul pic: * Un sistèma d'aplicacion * Una interfàcia web * Una interfàcia en linha de comanda (CLI) : Moulinette -* Un servidor Web : Nginx +* Un servidor Web : NGINX * Un servidor DNS : Dnsmasq * Una basa de donadas : MariaDB * Un sistèma de salvagarda