En cas d'erreur, le terminal ouvert pour le traitement reste ouvert afin d'afficher la raison de l'erreur. Tant qu'un message de succès ou d'erreur n'est pas affiché, le traitement suit son cours et il ne faut pas l'interrompre.
[](https://docs.myfab.fr/uploads/images/gallery/2022-09/image-1664361404719.png) A la fin du traitement, il est nécessaire de fermer le terminal et d'en lancer un nouveau pour bénéficier des modifications. #### 3. Première installation d'Open-Prod et des modules myFAB 1\. **MAJ scripts myhelp**. Lancer l'App-Manager avec la commande `app-manager`. L'ancer la commande 0 puis \* pour mettre à jour les scripts myhelp (sauf si ceux-ci vinnent juste d'être installés). [](https://docs.myfab.fr/uploads/images/gallery/2025-11/F7pimage.png) 2\. **Installation Open-Prod**. Lancer l'App-Manager avec la commande `app-manager`. L'ancer la commande 1 puis \* pour installer Open-Prod. [](https://docs.myfab.fr/uploads/images/gallery/2025-11/IfTimage.png) Fermer et relancer une connexion SSH comme demandé. Re lancer l'App-Manager avec la commande `app-manager`. Re l'ancer la commande 1 puis \* pour installer Open-Prod. Passer en sudo. L'installation se poursuit. [](https://docs.myfab.fr/uploads/images/gallery/2025-11/Babimage.png) Ne pas utiliser l'utilisateur Git open-Prod par défaut et renseigner le compte Git Open-Prod disponible dans notre [VaultWarden](https://vaultwarden.1life.fr/#/vault?search=Acc%C3%A8s%20GIT%20Objectif-pi%20%C2%A0pour%20app-manager) (rangé sous "Accès GIT Objectif-pi pour app-manager". Rensiegner User, email et mot de passe du Git Open-Prod. [](https://docs.myfab.fr/uploads/images/gallery/2025-11/nK3image.png) L'installation se poursuit avec le déploiement de paquets. Indiquer ensuite le nombre d'utilisateurs Opne-Prod qui vont travailler sur Open-Prod (pour le réglage automatique de certains paramètres : worker, mémoire, etc.). Si la détéection indique que l'environnement n'est pas taillé pour ce nombre d'utilisateurs un réglage manuel des paramètres va être réalisé en fin d'ainstallation. [](https://docs.myfab.fr/uploads/images/gallery/2025-11/Klwimage.png) L'installation se poursuit avec le déploiement de tous les paquets. Une fois l'ensemble de l'insallation réalisée un message indique l'URL pour se connecter à Open-Prod et la fin du traitement. [](https://docs.myfab.fr/uploads/images/gallery/2025-11/NBcimage.png) NOTA : l'installation d'Open-Prod se réalise par défaut en branche MASTER. Si une autre branche doit être utilisée, redémarrer le service Open-Prod (via `openprod-restart`), relancer une mise a jour Open-Prod via l'app-manager (toujours option 1). A la demande de changement de branche répondre OUI et indiquer la branche souhaitée. En fin de mise à jour redémarrer à nouveau le service Open-Prod avant de faire d'autres manipulations. Verifier que le service Open-Prod est fonctionnel avec `openprod-status` et via `openprod-info` que la bonne branche est utilisée. **Le 22/11/2025**. Pour la version 10.0.0.2 en branche intégration, corriger la dépendence encode\_pdf417 qui bloque le redémarrage du service quand on passe de Master à Intégration. [](https://docs.myfab.fr/uploads/images/gallery/2025-11/dlmimage.png) Arréter le service Open-Prod, lancer la commande ci-dessous, relancer le service Open-Prod et vérifier son statut. Tout doit être OK maintenant. Ce sujet est à corriger dans les scripts myfab (mauvaise gestion de app-manager au rechargement des dépendance quand on change de branche). ``` /etc/openprod_home/openprod10/venv3/bin/python3.10 -m pip install pdf417gen ``` #### 4. Première installation des modules myFAB 1\. **Installation modules myFAB**. Lancer l'App-Manager avec la commande `app-manager`. L'ancer la commande 2 puis \* pour installer les modules myFAB. Valider le traitement et laisser se dérouler l'installation. [](https://docs.myfab.fr/uploads/images/gallery/2025-11/co4image.png) **2.Vérifications**. Verifier l'ensemble des versions déployées avec `openprod-info` (cohérence branche, version, date). Vérifier l'accès à Open-Prod avec un navigateur via l'URL : http://\[ip ou nom environnement\] :8069. Open-Prod doit rerooter la connexion sur http://\[ip ou nom environnement\] :8069/web/database/selector et proposer de créer une nouvelle base. #### 5. Déploiement Jasper Server pour le reporting (V9 ou migration V9 vers V10 avec conservation Jasper) Si l'environnement est une V9, déployer Jasper Server via `app-manager` via l'option 4. Cette installation peiut être faite sur le même serveur qu'Open-Prod (cas à privillégier) ou sur un second environnement dédié à cette tache. Actuellement, le déploiement demande à forcer avant l'installation de Jasper l'installation d'une librairies phantomjs en version 2.1.1. Informations sur ce sujet : - - [https://tecadmin.net/install-phantomjs-on-ubuntu/](https://tecadmin.net/install-phantomjs-on-ubuntu/) - [https://github.com/ariya/phantomjs/issues/15449](https://github.com/ariya/phantomjs/issues/15449) Pour ce faire lancer les commandes ci-dessous. Si jamais le paquet n'est pas disponible le télécharger ici : ``` sudo apt-get install build-essential chrpath libssl-dev libxft-dev sudo apt-get install libfreetype6 libfreetype6-dev libfontconfig1 libfontconfig1-dev wget https://bitbucket.org/ariya/phantomjs/downloads/phantomjs-2.1.1-linux-x86_64.tar.bz2 sudo tar -xvjf phantomjs-2.1.1-linux-x86_64.tar.bz2 -C /usr/local/share/ sudo ln -sf /usr/local/share/phantomjs-2.1.1-linux-x86_64/bin/phantomjs /usr/local/bin export OPENSSL_CONF=/etc/ssl ``` Vérifier ensuite la version de Phantomjs ``` phantomjs --version ``` Vous pouvez maintenant installer Jasper avec `app-manager` , option 4 en suivant les consignes du script. La bonne installation de Jasper Server doit perrmettre d'accéder à la page de Tomcat et à la page de connexion de Jasper server vi les url ci-dessous : - - [http://\[ip-server\]:8080/](http://%5Bip-server%5D:8080/) ==> page Apache Tomcat/8.5.34 - [http://\[ip-server\]:8080/jasperserver/login.html](http://%5Bip-server%5D:8080/jasperserver/login.html) ==> page web de connexion à Jasper server (user = jasperadmin et pwd = jasperadmin) Il faut maintenant installer les bibliothèques de report dans Jasper Server en utilisant `app-manager` , option 5 (normalement le déploiement de Jasper les a déjà installées) et option 6 pour les report standrds myFAB. #### 6. Installation du gestionnaire d'impression CUPS Linux Le gestionnaire d'impression CUPS sous Linux est essantiel pour générer des impressions directes sur imprimante (sans téléchargement intermédiare du PDF dans le navigateur). Un simple déploiement du module sous Ubuntu est réalisé. Le reste du paramétrage (déclaration des imprimantes, paramétrage es drivers, paramétrage d'Open-Prod pour éditer directement sur imprimante, etc.) est à faire par le client ou son prestataire informatique en lien avec le consultant du déploiement 1Life. Lancer `cups-install` et laisser se dérouler l'installation. Controler l'accès à cups via un navigateur avec l'URL : http://\[ip ou nom environnement\] :631. La sélection du menu "Administration" de cups doit vous rerooter sur l'URL : https://\[ip ou nom environnement\]/admin et demander les crédential administrateur. #### 7. Vérifier l'accès aux services L'insemble des apllicatifs sont maintenant normalement accessibles via les différents ports. Si ce n'est pas le cas, vérifier que ces ports sont accessibles au travers du routage réseau avec un outil comme Nmap (Linux ou Windows). Ports de l'environnement :| **Port** | Service | Environnement concerné et outil |
| 22 | SSH | Ubuntu - accès d'administration distant Linux |
| 80 | Pgadmin | PostgreSQL - Client Graphique PostgreSQL |
| 8080 | HTTP | Jasper - Serveur Apache Tomcat Jasper |
| 8068 | HTTP | Open-Prod V9 - Accès client web OPP |
| 8069 | HTTP | Open-Prod V10- Accès client web OPP |
| 443 | HTTPS | Open-Prod- Accès client web OPP |
| 631 | Cups | Ubuntu -Serveur d'impression Linux |
| 5432 | PostgreSQL | PostgreSQL - Port PostgreSQL pour jaspestudio |
| 9090 | Cockpit | Ubuntu - Outil graphique d'administration Linux |
| 3389 | RDP | Ubuntu - Accès TSE à Linux |
**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. [](https://docs.myfab.fr/uploads/images/gallery/2023-06/image.png) 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. [](https://docs.myfab.fr/uploads/images/gallery/2023-04/image.png) #### **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.**
# Section Jasper ##### **Manipulation du service Jasper** Les commandes `jasper-start` et **`jasper-stop`** permettent simplement de gérer le démarrage et l'arrêt du service Jasper.  La commande `jasper-status` permet d'interroger l’état du service et indique à l’utilisateur s'il est fonctionnel.  [](https://docs.myfab.fr/uploads/images/gallery/2023-04/Q46image.png) ##### **Commande jasper-studio-install** Elle permet de déployer le programme Jasper Studio sur un environnement Ubuntu doté d’un interface graphique. L’utilisateur pourra donc créer et paramétrer ses rapports directement depuis le serveur en question. ##### **Commande jasper-mono-config** Elle permet de configurer le serveur Open-Prod pour qu’il accueille le programme Jasper. De plus, elle modifie le service Jasper afin de limiter les ressources qu’il peut prendre au détriment du service Open-Prod. Elle est exécutée automatiquement lors de l’installation d’Open-Prod par l’installation de Jasper si ce dernier détecte la présence d’Open-Prod sur le serveur. # Sécurisation de l’accès à PostgreSQL Un client peut souhaiter ouvrir un accès sur son PostgreSQL à partir d’un poste autre que celui du serveur (BI, requêtage, Jasper Studio, etc..). Afin de gérer ce type accès, une documentation complète est disponible sur le sujet : **[Procédure Technique 1Life - Configuration réseau jasper - formation](https://1life2013.sharepoint.com/:w:/r/sites/OPENPROD/Documents%20partages/Technique/O%20-%20Openprod%20-%20Aide%20et%20proc%C3%A9dures%20internes/Administration/Proc%C3%A9dure%20Technique%201Life%20-%20Configuration%20r%C3%A9seau%20jasper%20-%20formation.docx?d=wef3bc4e920c2408a9aa90ff6ebda0f5f&csf=1&web=1&e=apFJ3r)** Les commandes `openprod-config-jasper` & **`postgres-config`** ont été réécrites dans ce sens. ##### **Commande open-config-jasper** La commande `openprod-config-jasper` permet d'ouvrir l'accès de PostgreSQL à des utilisateurs externes (Power BI, Jasper Studio, etc...). Elle permet de prendre en compte une nouvelle adresse IP et ce, même si le serveur Jasper est installé sur le serveur Open-Prod (config mono serveur).  Au lancement de la commande, le programme détecte si Jasper est installé localement et propose d’autoriser une autre adresse IP. En répondant « N » à la question « Voulez-vous autoriser une autre adresse IP », le programme se contente de vérifier que le serveur Japser local a les bons droits dans les fichiers et se termine.  En répondant « O » à la question « Voulez-vous autoriser une autre adresse IP », le programme demandera de saisir l’adresse IP souhaitée et implémentera automatiquement le fichier pg\_hba.conf.  ##### **Commande postgres-config** Initialement prévue pour ouvrir tous sous-réseaux à l’accès PostgreSQL (0.0.0.0/0), la commande a été remaniée afin de limiter les accès sur PostgreSQL. Elle demande à présent le sous-réseau que l’on souhaite autoriser. Résultat : Dans la mesure du possible, tendre à réduire au maximum le nombre d’utilisateurs pouvant avoir accès à PostgreSQL depuis le réseau. Une bonne connaissance du contexte réseau (VPN, adresse IP publique/locale, etc..) du client reste nécessaire. Le client doit toujours avoir conscience que toutes IP définies dans ce fichier peut avoir accès à PostgreSQL en dehors de l’ERP.
# Section SQL ##### **Commande pgadmin4-install** Elle permet le déploiement du programme pgadmin4 sur le serveur Open-Prod. pgadmin4 sera accessible via le client graphique si le serveur est doté d’un GUI, ou en Web via apache.Attention, le déploiement de https-config invalide le port 80 du serveur Apache et empêche donc l’utilisation du mode web de pgadmin.
##### **Commande postgres-restart** Cette commande redémarre les services SGBD à la suite d’une modification de paramétrage. Elle provoque un arrêt (relativement court) des accès au SGBD et donc peut impacter le service Open-Prod : elle doit être lancée quand l’activité est minimum sur le serveur. Elle peut être utile à lancer quand le fichier pg\_hba.conf ou le postgresql.conf ont été modifiés (ouverture de port ou augmentation du nombre de connexions simultanées sur PostgreSQL).Attention, elle peut provoquer une brève interruption de service !
##### **Commande postgres-config** La commande permet de d'ouvrir l'accès à PostgreSQL à un sous-réseau déterminé, saisi sous la forme 192.168.10.0 :  Par exemple, cela peut donner le résultat suivant : **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.**
# Section myfab ##### **Commande myfab-sql-uninstall** Le contexte contenu dans le fichier openprod-server.conf embarque la liste des répertoires que l’ERP va scruter pour mettre à disposition des modules.  La commande permet notamment de nettoyer la base avant de la transmettre. Naturellement, ce nettoyage ne doit pas être fait sur le serveur de production mais sur un serveur/poste dédié à cet usage. Lors de son exécution, la commande vous demandera sur quelle base vous désirez faire disparaitre toute trace des modules « myfab ». ##### **Commande myfab-specif-config**  La commande permet d'activer un ou plusieurs modules spécifiques myfab. Le fichier "openprod-server.conf" est alors modifié avec ces nouvelles entrées. # Section Imprimantes ##### **Commande cups-install** La commande déploie le paquet Ubuntu cups (Common Unix Printing System) sur le serveur local. L’administration se fera via le web sur le port 631 du serveur sur lequel il est déployé. cups permet d'administrer les imprimantes présentes sur le réseau. Il est préférable de déployer cups sur le serveur Open-Prod directement, et ce même si on a un environnement dédié pour Jasper Server.
##### **Commande pdf-printer-install** Déploie une imprimante virtuelle PDF (pour tests). # Section divers ##### **Commande xrdp-config** Cette commande n’a plus qu’un intérêt limité dans la mesure où le GUI n’est plus installé par défaut. Toutefois, elle peut-être amenée à être utilisée sur des VM sur un poste utilisateur. Elle passe d’un accès TSE à Hyper-V (et vice versa) autorisant la copie de fichier au travers de l’interface graphique, par exemple. ##### **Commande myhelp-linux** Cette commande donne des informations sur les principales commandes système que les clients ou les consultants peuvent être amenés à utiliser sur les différents environnements.Cette commande est en cours de refonte, son fonctionnement va évoluer prochainement.
##### **Commande font-barcode-install** Cette commande était initialement destinée à être exécutée sur les premiers environnements clients installés pour mettre à disposition les différentes polices code-barres sur le serveur. L’installation des différentes polices est dorénavant réalisée lors de toute installation d’Open-Prod par myfab.  ##### **Commande hostname-config** Cette commande est utilisée pour mettre à jour le nom NETBIOS d’une machine Ubuntu (nom réseau par lequel la machine sera résolue par les autre membres du réseau). Cette commande est à utiliser avec précaution dans la mesure où : - Le serveur a pu être raccordé à un domaine, - D’autres membres du réseau peuvent « pointer » sur des ressources du serveur Ubuntu. La commande nécessite un redémarrage de la machine pour la prise en compte du nouveau nom.Commande très utile pour les consultants lorsqu’ils importent une VM (1Life) pour qu’il n’y ait pas deux machines sur le réseau qui portent le même nom. **Cette commande nécessite un haut niveau de privilège**.
Si la machine est intégrée dans un domaine, un compte d’administration de ce domaine sera requis…
##### **Commande ip-show** Elle permet à l’utilisateur de voir l’adresse IP actuelle de son environnement Open-Prod et le ou les services (ports) sur lesquels son environnement est joignable.  ##### **Commande shared-folder-config** Elle installe et configure les paquets samba nécessaires pour partager des dossiers sur un réseau (au besoin) et permet à l’utilisateur de créer un lecteur partagé sur le serveur, dans son espace Home qui sera accessible par les autres membres du réseau. Ceci est très utile quand on a des fichiers à mettre à disposition du serveur via le réseau, ou si l’on veut copier des fichiers depuis le sous-réseau présent sur le serveur Ubuntu.  Une fois exécutée, le lecteur partagé est directement accessible depuis le réseau :  ##### **Commande ged-remote-config** A l’inverse de la commande `shared-folder-config`, la commande `ged-remote-config` va déployer les paquets « cifs-utils » (au besoin) et permettre au serveur Ubuntu de connecter un lecteur réseau (sur un nas, un serveur de ficher, etc..) afin d’y stocker la GED d’Open-Prod quand cette dernière est trop volumineuse.L’administrateur devra fournir des identifiants permettant au serveur Ubuntu de s’authentifier sur le partage mis à disposition.
L’utilisateur devra renseigner : - Le nom de partage distant complet avec « / » et non « \\ », - Les code utilisateurs d’authentifications sur le lecteur réseau distant, - Les éventuelles options de montage souhaitées : ces dernières sont à adapter en fonction de la ressource distante. Si le montage échoue (droits, options, résolution, etc..), le programme s’arrêtera, sinon, il rentrera en mode « sql-update » afin de restructurer la ou les bases de données.  ##### **Commande git-config** Cette commande permet d'administrer les différents git présents sur le serveur. Il peut arriver de rencontrer ce message lors de l’exécution d’une commande MyFab :  Ceci indique que les identifiants git stockés sur le système sont erronés ou obsolètes. Sélectionner alors en premier lieu le git que vous désirez mettre à jour puis sélectionner « changer d’utilisateur », confirmer, puis ressaisir des identifiants valides.  Cette commande peut être utilisée aussi pour modifier le commit d’Open-Prod, par exemple : Toute modification du commit Open-Prod ou myfab doit être suivi d'une restructuration des bases de données à l'aide de la commande `sql-update`..
##### **Commande git1life-crt-config** Sur certain serveur, l’accès au git 1life ne pouvait pas être établi sans le déploiement de ce certificat # Résumé des commandes myhelp #### 1. Liste des commandes Comme décrit plus tôt, la commande **`myhelp`** regroupe et liste l'ensemble des commandes. Elles sont toute exécutables indépendamment en fonction de l'objectif du script. Parmi ces commandes on retrouve les catégories **Gestion des applications, Open-Prod, Jasper, SQL, myfab, Imprimantes et Divers**.| **Gestion des applications** | |
| `app-manager` | Outil de maintenance des applicatifs et de l'environnement myfab et Open-Prod |
| **Open-Prod** | |
| `openprod-start` | Démarre le service Open-Prod |
| `openprod-restart` | Redémarre le service Open-Prod |
| `openprod-stop` | Arrête le service Open-Prod |
| `openprod-status` | Donne le statut du service Open-Prod |
| `https-config` | Configure le https pour Open-Prod (certificat autosigné) |
| `openprod-config-jasper` | Configure Open-Prod pour accès Jasper |
| `openprod-config` | Configure Open-Prod (Worker, ...) |
| `openprod-config-o365` | Configure Open-Prod pour accès O365 |
| `openprod-info` | Informations sur Open-Prod (Version, ...) |
| **Jasper** | |
| `jasper-start` | Démarre le service Jasper |
| `jasper-stop` | Arrête le service Jasper |
| `jasper-status` | Donne le statut du service Jasper |
| `jasper-studio-install` | Installe Jasper Studio |
| `jasper-mono-config` | Configure Jasper pour exécution en mono-serveur |
| **SQL** | |
| `pgadmin4-install` | Installe PgAdmin4 (équivalent SQL studio pour PostgreSQL) |
| `postgres-config` | Ouvre PostgreSQL vers l'extérieur (pour accès distant, depuis SQL Management Studio par exemple) |
| `sql-update` | Met à jour une base de données |
| `sql-backup` | Crée une sauvegarde d'une ou plusieurs base(s) de données |
| `sql-auto-backup` | Met en place une sauvegarde régulière de base(s) de données |
| `postgres-restart` | Redémarre le service PostgreSQL |
| **myfab** | |
| `myfab-sql-uninstall` | Désinstalle tous les modules myfab d'une BDD |
| `myfab-specif-config` | Active ou non les sources myfab Spécifique (modules) |
| **Imprimantes** | |
| `cups-install` | Installe le gestionnaire d'imprimantes Cups |
| `pdf-printer-install` | Installe une imprimante virtuelle PDF (pour tests) |
| **Divers** | |
| `xrdp-config ` | Configuration de l'accès à distance (TSE ou Hyper-V) |
| `myhelp-linux` | Affiche une aide sur Linux |
| `font-barcode-install` | Installe les polices Codebar39, Codebar128 et fre3of9x |
| `hostname-config` | Permet de modifier le nom "netbios" de l'environnement. |
| `ip-show` | Montre l'adresse IP de la machine et les URLs accessibles |
| `shared-folder-config` | Crée et/ou configure un dossier partagé au réseau |
| `ged-remote-config` | Configure l'accès d'Open-Prod à la GED distante |
| `master-password-config` | Modifie le mot de passe Master d'Open-Prod (gestion des bases de données) |
| `git-config` | Configurer/Modifier un git (Utilisateur, Branche, Commit, ...) |
| `git1life-crt-config` | Authentifie localement le certificat du serveur Git 1Life |
A noter toutefois qu'il est possible de stopper le traitement à tout moment avec la combinaison de touche "CTRL + C".
# App Manager L'App Manager est un utilitaire permettant de gérer la maintenance des différents applicatifs myfab installés ou à installer sur le serveur. # Présentation de l'App Manager #### 1. Préambule L'App Manager permet de gérer l'installation et la mise à jour des applications myfab et Open-Prod. Initialement, toute cette gestion se faisait au travers de commandes spécifiques décrites par **myhelp**. De son côté, **[l'utilitaire myhelp](https://docs.myfab.fr/books/2-outils-myhelp-et-app-manager-pour-la-maintenance/chapter/scripts-myhelp "Scripts myhelp")** rassemble et met en forme des lignes de commandes utiles pour la maintenance de l'environnement Open-Prod sur le serveur.**Désormais, les commandes liées à l'installation ou la mise à jour d'Open-Prod, des modules myfab ou de Jasper sont packagées dans l'App Manager afin d'optimiser leur enchainement et ainsi réduire le temps nécessaire pour leur exécution.**
Par exemple, pour une mise à jour d'Open-Prod et des modules myfab, c'est l'App Manager qui se charge de réaliser la mise à jour de la base de données (`sql-update`) une fois toutes les mises à jour terminées. Cela permet d'optimiser le temps nécessaire tout en fiabilisant le processus. En effet, au lieu de réaliser un remise à niveau de la structure de la base de données (via la commande **`sql-update`**) à la fin de la mise à jour d'Open-Prod et une seconde à la fin de celle des modules myfab, une seule structuration est réalisée à la fin de toutes les mises à jour. #### 2. Accès à l'App Manager L'App Manager est accessible depuis un terminal depuis le serveur hébergeant Open-Prod. Si vous ne savez pas vous connecter à votre serveur, vous pouvez suivre les [**instructions décrites ici**](https://docs.myfab.fr/books/1-mise-a-jour-open-prod-et-des-modules-myfab/page/connexion-a-lenvironnement-technique-linux "Connexion à l'environnement technique Linux").**Dans le cas où vous souhaitez effectuer une mise à jour sur un autre environnement serveur que celui d'Open-Prod, il faut exécuter l'App Manager depuis cet environnement. Par exemple, dans le cas où vous avez un environnement dédié au fonctionnement de Jasper et que vous souhaitez mettre à jour les rapports myfab, il faut réaliser cette mise à jour directement sur ce serveur.**
Une fois connecté, ouvrir un terminal, et exécuter la commande **`app-manager`** pour lancer l'App Manager. [](https://docs.myfab.fr/uploads/images/gallery/2022-09/image-1663080601484.png) # Utilisation #### 1. Principe de fonctionnement L'utilisation est guidée au travers des commentaires affichés tout au long de l'exécution du script. Différents menus permettent de sélectionner les modules à installer / mettre à jour. Une fois la sélection faite, le mot de passe **Open-Prod** sera demandé. Le script se charge ensuite de lancer toutes les commandes nécessaires et affiche le déroulé du processus au fur et à mesure dans les terminaux. Vous pouvez suivre l'exécution de ceux-ci à l'écran. En effet, pour chaque application à installer / mettre à jour, l'App Manager ouvrira un terminal pour en gérer indépendamment l'exécution. - **En cas de succès** de l'exécution, le terminal concerné sera fermé automatiquement et un message de confirmation sera affiché dans le terminal initial. - **En cas d'erreur**, le terminal concerné restera ouvert pour que l'utilisateur en connaisse la raison. [](https://docs.myfab.fr/uploads/images/gallery/2022-09/image-1663251759922.png) En résumé, il faut lancer l'utilitaire en exécutant la commande `app-manager` depuis un terminal, et suivre les questions posées dans le terminal. #### 2. Choix proposés Au lancement de l'App Manager, plusieurs choix sont proposés à l'utilisateur. Pour chaque applicatif, il est indiqué entre parenthèses s'il est installé ou non. Voici une description de ce ceux-ci : - **Scripts myhelp** : remplace la commande command-update. Attention, cette option n'est disponible qu'après avoir réalisé la mise à jour permettant d'accéder aux fonctionnalités de l'App Manager. - **Open-Prod** : récupère les dernières sources d'**Open-Prod** sur le Git de l'éditeur Objectif Pi, puis, met à jour l'application Open-Prod. - **Modules myfab** : récupère les dernières sources de myfab sur le Git de l'éditeur myfab, puis, met à jour les modules myfab standards. - **Modules spécifiques myfab** : récupère les dernières sources de myfab specific sur le Git de l'éditeur myfab, puis, met à jour les modules myfab spécifiques. - **Jasper** : lance le processus d'installation complet de Jasper. - **Rapports Jasper d'Objectif Pi** : déploie le catalogue des rapports Jasper standards d'**Open-Prod**. - **Rapports Jasper myfab** : déploie le catalogue des rapports Jasper standards de myfab. [](https://docs.myfab.fr/uploads/images/gallery/2022-11/8bMimage.png) #### 3. Synchronisation d'une base de données Après l'installation ou la mise à jour d'**Open-Prod** ou des modules myfab, une restructuration de la base de données est nécessaire. L'App Manager se charge automatiquement de réaliser cette mise à niveau de la base de données en fin de processus. Il est primordial pendant cette étape de ne pas interrompre le script tant que celui-ci n'a pas rendu la main à l'utilisateur.Attention, suite à la restauration d'une base de données ou lors de la création d'une nouvelle base de données sur cet environnement, il est uniquement nécessaire de synchroniser la nouvelle base de données avec son environnement, sans toutefois avoir besoin de mettre à jour les sources d'Open-Prod ou des modules myfab.
Pour lancer manuellement et uniquement cette restructuration des bases de données, il faut exécuter la commande `sql-update` depuis un terminal.Une restructuration de base de données n'est pas sans risque pour l'intégrité des bases. C'est pourquoi il est nécessaire d'effectuer des sauvegardes avant traitement. De plus, il faut veiller à ce que le traitement se soit bien déroulé avant de considérer celui-ci terminé et réussi.
Comme un sql-update peut prendre plusieurs minutes et être lancé sur plusieurs bases de données en même temps, il est fastidieux pour un utilisateur de scruter les messages durant l'intégralité de son traitement, ou même de parcourir les logs après traitement. La commande a donc été améliorée afin de palier à ce souci.Fonctionnalités disponibles depuis la mise à jour de Juillet 2023 des scripts myfab.
Dorénavant, une fois le traitement terminé, un récapitulatif des différentes erreurs rencontrées s’affichera base par base (dans le cas où plusieurs bases ont été sélectionnées). [](https://docs.myfab.fr/uploads/images/gallery/2023-07/95rimage.png) Un fichier de log sera produit et conservé dans le répertoire « /var/log/openprod ». Le nommage du fichier suit la forme suivante : « UP-<nom de base>-<horodatage>.log ». Le fichier vous permettra une post analyse plus aisée. De plus, le récapitulatif listera les principales erreurs et vous permettra de prendre la décision adéquate en fonction du résultat. Pour rappel, les messages "**CRITICAL"** sont ceux à surveiller particulièrement : **ces derniers ont la capacité d’interrompre un sql-update et sont généralement révélateurs d’un problème réel.** La deuxième priorité concerne les messages "**ERRORS**" : bien qu'ils n'interrompent pas un sql-update, ils peuvent néanmoins dissimuler d'autres problèmes potentiels. Lorsque vous n'obtenez pas de message "**CRITICAL**", vous pouvez considérer que la mise à niveau est effectuée avec succès : les autres messages que vous pouvez rencontrer ne bloquent pas la poursuite des activités du client. Cependant, il reste fortement recommandé d'examiner attentivement les messages de type "**ERRORS**".