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.

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.

3. Synchronisation d'une base de données

Après l'installation ou la mise à jour d'Open-Prod ou des modules myfab, une restructurationsynchronisation (restructuration) de la base de données est nécessaire. L'App 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,Si suitevous àavez laeffectué une restauration d'une base de données ou lors de laune création d'une nouvellede base de données sur cetvotre environnement, ilseule estla uniquement nécessairesynchronisation de synchroniser la nouvelle base de données avecrésultante, sondoit environnement,être sanseffectuée toutefoisen avoircomplément. besoinLa de mettremise à jour lesdes sources d'Open-Prod ou des modules myfab.

myFAB

Pourn'est lancerpas manuellementnécessaire etpour uniquementces cettedeux restructuration des bases de données, il faut exécuter la commande sql-update depuis un terminal.cas.

Une restructurationsynchronisation 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.

CommePour lancer manuellement la synchronisation des bases de données, vous avez le choix d'utiliser la commande sql-update-parallel ou la commandesql-update-background depuis un terminal.

 

      A. Synchronisation de vos bases de données en simultané : sql-updateupdate-parallel

peut

La prendrecommande plusieurssql-update-parallel minutesvous etpermet êtrede lancé sursynchroniser plusieurs bases de données en mêmesimultané temps,avec ilun estgain fastidieuxde temps conséquent. Par défaut, nous vous proposons de synchroniser vos bases par groupes de 2. Vous pouvez réaliser jusqu'à 6 traitements simultanés, avec une limite définie en fonction des capacités de votre environnement (CPU/RAM) pour unne utilisateurpas entraver son fonctionnement. Vous ne pourrez donc pas entamer le processus si vous saisissez une valeur au delà de scrutercette leslimite messages:

durant

Contrairement à la commande sql-update-background, la commande sql-update-parallel interrompt l'intégralitéexécution de sonl'ERP traitement,pendant oule mêmeprocessus. Veuillez à sauvegarder votre travail avant.

      B. Synchronisation d'une base de parcourirdonnées les: logssql-update-background

après traitement.

La commande asql-update-background doncvous été améliorée afinpermet de paliersynchroniser 1 base à cela souci.fois en arrière-plan. A la différence d'un traitement en simultané, l'ERP continue de fonctionner pendant le processus de synchronisation, mais le mode maintenance sera activé sur votre base de données :

 

      C. Issue du traitement

A l'issue de la synchronisation (peu importe la commande sql-update- utilisée) vous obtiendrez un récapitulatif global. Celui-ci vous affiche notamment la durée totale de traitement, les bases de données traitées et les erreurs rencontrées pendant la synchronisation :

 

Un erreur critique (CRITICAL) implique une interruption totale de l'ERP. En cas d'erreur veuillez vous rapprocher du support pour résoudre le problème.

FonctionnalitésDe disponibles depuis la mise à jour de Juillet 2023 des scripts myfab.

Dorénavant, une fois le traitement terminé,même, 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).

Un fichier de log sera produitcréé et conservé dans le répertoire « /var/log/openprod ». Le nommage du fichier suit la formeconvention suivante : « UP-<nom de base>-<horodatage>.log ». 

Le fichierCelui-ci vous permettra uned'analyser postles analyseévènements lors du traitement avec plus aisée.de détails. 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".