Environnement technique modules myfab

• Exécution de scripts myfab
• Mise à jour depuis une version antérieure au 12/04/2021
• Scripts myfab
• Concepts importants
• Service Open-Prod
• Jasper
• Répertoires Git
• Base de données PostgreSQL
• HHTP & HTTPS
• Versionnage d'Open-Prod
• GED Open-Prod
• Procédures
• Action serveur - frais de port
• Import des vignettes fiche produit

Exécution de scripts myfab

Mise à jour depuis une version antérieure au 12/04/2021

Si vous avez installé les scripts myfab avant le 12/04/2021 (avant la mise en production de la réécriture des scripts), vous ne devez pas réaliser les étapes décrites dans la page suivante, mais seulement les instructions ci-dessous.

S'il s'agit d'une nouvelle installation ou d'une mise à jour à partir d'une version postérieure au 12/04/2021, vous pouvez directement passer à la page suivante.

1. Téléchargement du script de migration

Dans un premier temps, télécharger le script de migration ci-dessous :

migration-myfab-setup.sh

2. Lancement du script de migration

Ouvrir un terminal de commandes.

Se référer à la page dédiée pour plus de détails sur les méthodes de connexion au serveur.

Exécuter le fichier précédemment téléchargé avec la commande suivante :

sudo chmod 777 [chemin_vers_migration-myfab-setup.sh] && [chemin_vers_migration-myfab-setup.sh]

Par exemple, si le téléchargement s’est fait dans le dossier « Téléchargements », saisir :
sudo chmod 777 ./Téléchargements/migration-myfab-setup.sh && ./Téléchargements/migration-myfab-setup.sh

Les scripts seront ainsi mis à jour. Fermer le terminal et en ouvrir un nouveau pour bénéficier de la mise à jour.

Scripts myfab

Avant de pouvoir installer des modules myfab sur un environnement, il convient de déployer les sources myfab. 

Si votre serveur a été installé par les équipes 1Life, ce fichier a dû être déployé automatiquement et l'utilitaire myhelp sera directement disponible.

1. Connexion à l'environnement technique

Pour réaliser les opérations décrites ci-après, il est nécessaire de se connecter à l'environnement technique d'Open-Prod, autrement dit, votre serveur.

Se référer à la page dédiée pour plus de détails sur les méthodes de connexion au serveur.

Si vous avez une interface graphique sur votre serveur Linux, vous pouvez ouvrir le terminal en utilisant le raccourci clavier CTRL+ALT+T.

2. Déploiement fichier MyFab.deb

Théoriquement, cette section ne concerne pas les environnements installés pas 1Life. Si toutefois, la commande myhelp n'est pas reconnue, vous pouvez suivre ces instructions.

Dans un premier temps, télécharger le fichier ci-dessous :

MyFab.deb

Depuis un terminal, exécuter ce fichier en saisissant la commande : sudo apt update && sudo apt install [chemin_vers_MyFab.deb]

Par exemple, si le fichier est présent dans le dossier "Téléchargements", saisir :

sudo apt update && sudo apt install ./Téléchargements/MyFab.deb

L'installation va se lancer. Restez attentif à la progression et saisir "O" ou Enter en fonction de ce que demande le script.

Avant la fin de l’installation, le script demandera les identifiants Git 1Life (afin de télécharger les scripts et programmes pour installer Open-Prod et myfab). 
Un compte Git est créé pour chaque consultant 1Life et les clients désirant télécharger des sources MyFab (scripts d’installation, modules, etc). Si vous ne les connaissez pas, se rapprocher du service R&D ou du chargé de clientèle pour les obtenir. 
Saisissez vos identifiants comme dans la capture ci-dessous :

• Identifiant
• Email
• Mot de passe

Attention : sur Linux les saisies de mot de passe sont cachés. Ce que vous écrivez au clavier est bien pris en compte, mais n’est pas affiché dans la console. Lorsque c’est possible, privilégiez donc le copier/coller.

3. Accès aux scripts myhelp

Une fois les scripts déployés, les scripts myhelp seront disponibles et vous pouvez procéder à l'installation des modules myfab via l'App Manager.

Concepts importants

Service Open-Prod

Page en cours de construction...

Open-Prod est un ERP full-web. Cela signifie qu’il est exécuté sur un serveur Web, et que chaque utilisateur qui souhaite accéder à l’ERP le fait à partir d’un navigateur sur son poste (sur le même réseau que le serveur).

Pour exécuter Open-Prod « en continu », un service spécifique est actif sur le serveur. On peut le manipuler grâce aux scripts installés plus tôt :
openprod-status : affiche le statut du service (s’il est toujours actif, ses derniers logs, etc).
openprod-start : démarre le service.
openprod-stop : stoppe le service.
openprod-restart : redémarre le service.

Jasper

Page en cours de construction...

Jasper est un logiciel installé sur un autre serveur que celui d’Open-Prod (historiquement). On peut l’installer avec la commande jasper-install. Jasper permet de stocker et éditer tous les modèles de document de l’ERP. Jasper génère les PDFs des documents à la demande d’Open-Prod (quand on clique sur « Imprimer un document » dans l’interface Open-Prod).

Jasper fonctionne par le biais d’un service, comme Open-Prod. Des scripts permettent de manipuler ce service :
jasper-status : Affiche le statut du service (s’il est toujours actif, ses derniers logs, etc).
jasper-start : Démarre le service.
jasper-stop : Stoppe le service.

 

Répertoires Git

Page en cours de construction...

1. Présentation

Un répertoire Git (aussi nommé « projet Git ») permet de stocker, versionner et archiver les sources d’une application. Un serveur Git peut héberger de multiples répertoires Git.

Dans le cadre de l'utilisation des modules myfab, on peut être amenés à interagir avec deux serveurs Git, chacun proposant des répertoires Git intéressants pour notre utilisation d’Open-Prod :

Un répertoire Git contient plusieurs branches, chacune symbolisant (en général) un stade différent dans le flux de développement. Dans le cas d’Open-Prod, on trouve 3 branches : 

• La branche "dev", celle sur laquelle les développeurs travaillent.
• La branche "integration", dans laquelle est régulièrement injecté le code de la branche "dev", afin de tester les développements et les corriger. On peut être amené à tester les futures fonctionnalités (pas encore stables) sur cette branche en local sur son poste : auquel cas, on utilise openprod-update pour changer de branche.
• La branche "master" (qui existe dans tous les projets Git), sur laquelle est transvasé le code stable de la branche "integration" pour être mis en production. Chez un client, on installe toujours les sources Open-Prod en master.
  

2. Changement de comptes Git

Pour pouvoir mettre à jour les scripts et les modules MyFab, il faut lier ces deux répertoires à notre compte Git 1Life personnel. Ce compte nous permet de s’authentifier auprès du serveur Git 1Life et récupérer les dernières sources des deux répertoires.

Pour lier notre compte Git, on lance la commande git-config, en sélectionnant d’abord MyFab Setup (saisir 1 dans l’exemple ci-dessous). On modifie l’utilisateur, et on inscrit nos identifiants (fournis par la R&D). Puis on relance la commande git-config, et on fait pareil pour MyFab Modules (saisir 2 dans l’exemple ci-dessous).

Lors du changement d'utilisateur via la commande git-config, il peut arriver que la manipulation soit refusée par le système car le répertoire n'est pas considéré comme étant un répertoire "git" ou bien qu'il ne soit pas considéré comme sûr. 

Auquel cas, le terminal propose d'appliquer une exception sur le répertoire en question via une commande particulière. Il faut exécuter cette commande en ajoutant la commande sudo comme ci-dessous :

 

Base de données PostgreSQL

Page en cours de construction...

Sur un même serveur Open-Prod, on peut utiliser en parallèle une multitude de bases de données différentes. On peut s’y connecter et les organiser via l’écran d’accueil d’Open-Prod (bouton Manage databases). Chaque ligne de la capture ci-dessous est une base de données à laquelle on peut se connecter.

Le script pgadmin4-install permet d’installer un gestionnaire de base de données (équivalent à SSMS pour SQL Server) pour travailler à plus bas niveau sur les bases de données (tables, requêtes SQL, etc.). 

HHTP & HTTPS

Page en cours de construction...

Par défaut, Open-Prod est installé en HTTP. C’est-à-dire que lorsqu’on accède à l’application via le navigateur Web, les échanges d’information avec le serveur ne sont pas sécurisés. Ce n’est pas un souci si Open-Prod est installé chez le client (On Premise), mais peut représenter une faille de sécurité pour les clients dont l’ERP est dans le cloud.

Si le client émet la demande de l’installation du HTTPS sur son serveur Web Open-Prod, la R&D prend en charge le sujet.

Versionnage d'Open-Prod

Page en cours de construction...

Il faut bien distinguer la version des sources Open-Prod de la version de chaque base de données. Par exemple, lorsqu’on importe une nouvelle BDD via Open-Prod, la version de celle-ci ne sera quasiment jamais la même que celle des sources Open-Prod du serveur sur lequel on l’importe. Il faut donc lancer la commande sql-update et choisir cette BDD, pour la mettre en accord avec les sources Open-Prod du serveur.

Pour connaître la version actuelle d’Open-Prod, on peut utiliser la commande openprod-info.
Quand on met à jour Open-Prod, on le fait dans la majorité des cas à la dernière version. On lance la mise à jour des sources et la synchronisation des bases de données avec la commande openprod-update.

GED Open-Prod

Page en cours de construction...

La GED (gestion électronique des documents) d’Open-Prod est stockée par défaut sur la VM où est installé Open-Prod (GED locale). Toutefois, on peut vouloir stocker celle-ci sur un serveur distant, sur un NAS par exemple (GED distante).
Auquel cas, la commande ged-remote-config permet de créer un lecteur réseau sur la VM vers ce serveur distant, et de configurer Open-Prod pour qu’il stocke sa GED sur ce lecteur réseau. 

Procédures

Action serveur - frais de port

Action serveur - frais de port

Import des vignettes fiche produit

Import des vignettes fiche produit