Section Open-Prod
Manipulation du service Open-Prod
Les commandes ci-dessous permettent simplement de démarrer ou arrêter le service Open-Prod.
La commande openprod-status
permet d'interroger l’état du service et indique à l’utilisateur s'il est fonctionnel.
Ici, la machine nous indique que le service :
- est en mode running (en cours d’exécution),
- est « enabled », il sera démarré automatiquement lors du démarrage du système,
- qu’il a été démarré il y a 18h00,
- que la machine est configurée avec deux workers http et deux workers cron,
- utilise une certaine quantité de mémoire,
- travaille sur le fichier de configuration « /etc/openprod-home/openprod-server.conf ».
Le fichier de configuration "openprod-server.conf"
Présent dans la « home » de l’utilisateur l’ayant installé, l’ERP s’appuie sur ce fichier, lors du démarrage du service pour déterminer le contexte dans lequel il va être utilisé :
- Quels sont les modules Open-Prod déployés et ou les localiser ?
- Comment accéder aux bases de données et comment s’authentifier au SGBD ?
- Les limites systèmes qui vont être mises en œuvre dans le cadre de son utilisation :
- Le port d’écoute http sur lequel il répondra dans le navigateur :
- Le nombre de workers :
- Etc..
Ce fichier est crucial, et toute modification de ce fichier doit être précédée d’une copie préalable. Bien conscient que la manipulation d’un éditeur de texte (vi, nano, etc..), n’était pas des plus aisée pour la configuration, myfab a décidé de mettre à disposition plusieurs commande pour permettre à l’administrateur de modifier le fichier "openprod-server.conf" même s’il ne maitrise pas un éditeur de texte.
Attention, toute modification du fichier "openprod-server.conf" nécessite un redémarrage des services Open-Prod pour prendre en compte les modifications effectuées.
Manipulation du fichier "openprod-server.conf"
La commande openprod-config
permet la modification de certaines clés du fichier de configuration sans entrer en mode édition. Le programme propose la modification de la valeur de ces clés et demande à l’utilisateur de saisir la valeur qu’il souhaite mettre à jour.
Une sauvegarde du fichier est faite automatiquement pour le préserver avant sa modification :
Attention ! Cette préservation n’a pas pour but que de permettre à l’utilisateur de conserver temporairement les modifications qu’il vient de réaliser (et éventuellement de les annuler). Les différentes sauvegardes des ces modifications seront supprimées lors du prochain redémarrage du serveur.
L’utilisateur peut néanmoins, au travers de la command « diff », déterminer quelles modifications ont été faites depuis le dernier démarrage :
La commande master-password-config
a une double fonction :
- elle modifie le "master password" nécessaire à l’administration des bases de données dans l’ERP,
- elle modifie également le mot de passe PostgreSQL de l’utilisateur qu’utilise l’ERP avec lequel l’ERP s’authentifie.
Attention, ces deux commandes redémarrent automatiquement le service Open-Prod.
Quand le client désire crypter les flux entre le serveur Open-Prod et le client, il est nécessaire de passer la connexion en https. La commande https-config
permet donc de :
- Déployer le reverse proxy nginx sur le serveur Open-Prod,
- Créer un certificat autosigné sur le serveur,
- Configurer nginx avec ce certificat pour un accès à Open-Prod.
Le serveur Open-Prod sera alors accessible sur le port 8068 en http mais aussi sur le 443 en https.
Commande openprod-info
La commande permet d'afficher l’ensemble des informations de versions des Gits Open-Prod & Myfab.
Ceci a pour objectif de vérifier d’un seul coup d’œil l’état de mise à jour d’un serveur afin de pouvoir reproduire un serveur isopérimètre ou pour revenir en arrière suite à une montée de version en échec par exemple. La commande openprod-info
affiche dorénavant le détail de mise à jour des Gits présents sur le serveur et leur commit respectif.
Commande openprod-config-o365
Cette commande positionne les valeurs des clés « server_wide_modules » et « cors_domains » du fichier de configuration en vue du raccordement d’Open-Prod à OFFICE 365.
Il convient de toujours lancer les commandes openprod-config-jasper et postgres-config lorsque la base de données est disponible et le moins sollicité possible : le redémarrage des services peut entrainer l’interruption de traitements longs (cron, etc..). Cela permet de réduire le risque d'impact du bon fonctionnement de l'ERP.
Tachez toujours dans la mesure du possible, de réduire au maximum le nombre d’utilisateurs pouvant avoir accès à PostgreSQL depuis le réseau. De plus, une bonne connaissance du contexte réseau (VPN, adresse IP publique/locale, etc..) est nécessaire pour faire ce type de manipulation.