Naviam | Préparation au MAS : utilisation du stockage S3 pour les documents joints dans la version 7.6.1

Préparation au MAS : utilisation du stockage S3 pour les documents joints dans la version 7.6.1

Phil Réunion

May 13, 2024

Options dans MAS

Naviam a identifié le stockage des documents joints dans Maximo comme une différence essentielle lors de la mise à niveau 7.6 vers MAS. Le passage d'une architecture basée sur serveur à OpenShift nécessite de repenser les documents joints. Dans Maximo Application Suite, les administrateurs peuvent choisir entre utiliser des systèmes de fichiers réseau (NFS) pour stocker les documents joints à l'aide de la structure de volumes persistants Kubernetes ou utiliser le stockage d'objets cloud Simple Storage Service (S3) pour stocker les pièces jointes. Les deux approches ont leurs avantages et Projetech a estimé que S3 était la meilleure solution pour la plupart des clients.

Pourquoi S3

La mise en œuvre du stockage d'objets dans le cloud S3 (Simple Storage Service) pour le stockage des documents joints repose sur une technologie mise à jour pour stocker et accéder aux fichiers depuis Manage. En utilisant S3 au lieu du système de fichiers réseau (NFS), la configuration et la gestion du stockage passent de l'intérieur d'OpenShift à l'extérieur d'OpenShift. Les administrateurs peuvent ainsi choisir et configurer le fournisseur, les performances et la redondance adaptés à chaque environnement.

L'utilisation de S3 pour les documents joints vous permet également de réussir dans d'autres domaines du MAS. Les archives de personnalisation Maximo, l'intégration et la publication de journaux peuvent toutes être effectuées avec des compartiments S3. La S3 est la technologie dans laquelle IBM investit ses efforts de développement lorsqu'elle doit gérer des fichiers dans le système MAS. Il y a de fortes chances que chaque système MAS soit associé à des compartiments S3, alors pourquoi ne pas utiliser la même technologie pour les documents joints ?

Naviam exploite plusieurs clouds pour aider ses clients. Chaque fournisseur de cloud dispose d'une implémentation de S3 qui peut être utilisée. En utilisant le service S3 de chaque cloud, nous pouvons simplifier la configuration, gérer les coûts et préserver la confidentialité du trafic de transfert de fichiers. Un autre avantage est que S3 est compatible avec les environnements 7.6.1, ce qui signifie que vous pouvez passer à S3 avant de passer à MAS. Cela permet aux administrateurs de réduire les risques, les changements et les efforts nécessaires lors de la transition vers le MAS.

Passer à la section S3 Considérations

Lorsque vous passez à S3, vous devez prendre en compte quelques considérations techniques. Maximo 7.6.1 prend en charge l'utilisation de S3 pour les documents joints et, dans la pratique, cela fonctionne bien. Si vous utilisez Maximo 7.6.1.2, certaines bibliothèques doivent être mises à jour manuellement. La mise à niveau vers Maximo 7.6.1.3 vous évite d'avoir à effectuer cette mise à jour manuelle. C'est une bonne idée si vous utilisez une version prise en charge par IBM. Une autre considération est la manière dont tous les fichiers sont actuellement accessibles par les intégrations et les produits mobiles. Si les fichiers sont accessibles via le framework Maximo, tout va bien, mais si votre processus interagit directement avec le système de fichiers, vous devrez l'ajuster, sinon S3 ne vous convient peut-être pas.

Configuration de Maximo 7.6.1 pour S3

Lors de la configuration de la version 7.6.1 pour S3, deux concepts doivent être pris en compte. La première consiste à connecter Maximo au compartiment S3. La deuxième consiste à déplacer tous les fichiers existants vers le compartiment pour y accéder. Le réglage de votre système Maximo pour qu'il se connecte à S3 est bien documenté par IBM. Une fois que votre compte S3 et votre compartiment auront été créés par votre administrateur système, votre administrateur Maximo devra ajuster quelques propriétés du système. Redémarrez ensuite le système et vous pouvez commencer à utiliser le compartiment S3.

Document IBM : https://www.ibm.com/docs/en/mam/7.6.1.2?topic=properties-attachment-s3

La partie la plus délicate de la configuration du système consiste à déplacer le fichier joint existant vers le compartiment S3. Les fichiers doivent être chargés dans le compartiment S3. L'utilisation d'un outil tel que WinSCP vous permet de vous connecter au compartiment S3 de la même manière que vous vous connecteriez à un site SFTP avec une interface utilisateur client. Avant de télécharger tous vos fichiers, vous devez savoir que l'implémentation Maximo de S3 n'autorise pas les sous-répertoires. Cependant, la plupart des configurations Maximo possèdent des sous-répertoires. Avant le téléchargement, Naviam aplanit la structure de nos dossiers doclinks. Dans MAS, IBM fournit un script pour ce faire dans le pod MAXINST, file2s3.sh, mais il n'est pas disponible si vous migrez vers S3 sur la version 7.6.1, ce qui en fait un processus manuel. Pour éviter les noms de fichiers dupliqués, les scripts Naviam ajoutent le nom du sous-répertoire au nom du fichier, puis déplacent récursivement le fichier vers le haut du répertoire des dossiers. Un fichier qui se trouvait auparavant dans le répertoire des pièces jointes sous la forme. \ Attachments \ testfile.txt est renommé en. \ Attachments-testfile.txt.

Exemple de PowerShell :

Get-ChildItem « 'C:\docklinks\Attachments" -exclude attachments-* | Où {! $.psisContainer} | Renome-Item -NewName {« doclinks-attachments- » + $.Name}

Une fois que les fichiers sont tous aplatis ou combinés dans un seul répertoire, vous pouvez les télécharger dans le compartiment S3. Une fois les noms des fichiers modifiés et chargés, la même modification est nécessaire dans la table DOCINFO. En écrivant le nom du dossier dans le nom du fichier, nous obtenons un résultat prévisible qui peut être reproduit avec SQL dans la base de données.

Exemple de code SQL :

update docinfo set urlname = REPLACE (urlname, 'C:\docklinks\Attachments \', 'cos:doclinks/attachments-') où urltype = 'FILE' et nom d'URL différent de 'cos:doclinks%' et nom d'URL différent de 'cos:doclinks%' et nom d'URL tel que 'C:\docklinks\Attachments \ %'

En combinant les modifications apportées aux propriétés du système Maximo, en téléchargeant des documents vers S3 et en mettant à jour la table DOCINFO, Maximo 7.6.1 peut être transféré avec succès à l'utilisation de S3 pour le stockage des documents joints. L'attention portée aux détails est utile, et vous devriez toujours essayer de modifier d'abord votre environnement hors production, mais avec un peu d'effort, c'est une chose de moins que vous devez modifier et dont vous devez vous préoccuper lors de la mise à niveau de Maximo vers MAS.