Bereid je voor op MAS: S3-opslag gebruiken voor bijgevoegde documenten in 7.6.1
Phil Runion
May 13, 2024


Naviam identificeerde de opslag van bijgevoegde documenten in Maximo als een belangrijk verschil in de 7.6-upgrade naar MAS. De overstap naar OpenShift vanuit een servergebaseerde architectuur vereist dat bijgevoegde documenten opnieuw worden bekeken. In de Maximo Application Suite kunnen beheerders kiezen tussen het gebruik van Network File Systems (NFS) om opslag te bieden voor bijgevoegde documenten met behulp van het Persistent Volume Framework van Kubernetes of het gebruik van Simple Storage Service (S3) cloudobjectopslag voor het opslaan van bijlagen. Beide benaderingen hebben hun voordelen en Projetech vond S3 de beste oplossing voor de meeste klanten.
De implementatie van Simple Storage Service (S3) -cloudobjectopslag voor het opslaan van bijgevoegde documenten maakt gebruik van bijgewerkte technologie voor het opslaan en openen van bestanden vanuit Manage. Door S3 te gebruiken in plaats van Network Files System (NFS), wordt de configuratie en het beheer van de opslag verplaatst van binnen OpenShift naar buiten OpenShift. Dit geeft beheerders de mogelijkheid om de provider, prestaties en redundantie te kiezen en te configureren die geschikt zijn voor elke omgeving.
Door gebruik te maken van S3 voor bijgevoegde documenten bent u ook klaar voor succes op andere gebieden van MAS. Maximo Customization Archives, integratie en publicatie van logboeken kunnen allemaal worden gedaan met S3-buckets. S3 is de technologie waarin IBM ontwikkelingsinspanningen investeert wanneer ze bestanden in het MAS-systeem moeten beheren. De kans is groot dat aan elk MAS-systeem enkele S3-buckets zijn gekoppeld, dus waarom zou u niet dezelfde technologie gebruiken voor bijgevoegde documenten?
Naviam maakt gebruik van meerdere clouds om hun klanten te ondersteunen. Elke cloudprovider heeft een implementatie van S3 die kan worden gebruikt. Door de S3-service van elke cloud te gebruiken, kunnen we de configuratie vereenvoudigen, de kosten beheren en het verkeer voor bestandsoverdracht privé houden. Een ander voordeel is dat S3 ondersteuning biedt in 7.6.1-omgevingen, wat betekent dat u naar S3 kunt overstappen voordat u naar MAS overstapt. Dit stelt beheerders in staat om het risico, de wijzigingen en de inspanningen die nodig zijn tijdens de overgang naar MAS te verminderen.
Bij de overstap naar S3 zijn er enkele technische overwegingen waar u op moet letten. Maximo 7.6.1 ondersteunt het gebruik van S3 voor bijgevoegde documenten, en in de praktijk werkt het goed. Als u Maximo 7.6.1.2 gebruikt, zijn er enkele bibliotheken die handmatig moeten worden bijgewerkt. Een upgrade naar Maximo 7.6.1.3 voorkomt dat u deze handmatige update hoeft uit te voeren en is een goed idee om ervoor te zorgen dat u een versie gebruikt die IBM ondersteunt. Een andere overweging is hoe alle bestanden momenteel toegankelijk zijn via integraties en mobiele producten. Als bestanden via het Maximo-framework worden geopend, zit je goed, maar als je een proces hebt dat rechtstreeks interageert met het bestandssysteem, moet je het aanpassen, anders is S3 misschien niet geschikt voor jou.
Bij het configureren van 7.6.1 voor S3 zijn er twee concepten waarmee u rekening moet houden. De eerste is om Maximo aan te sluiten op de S3-bucket. Ten tweede is het verplaatsen van alle bestaande bestanden naar de bucket om ze te openen. Het aanpassen van uw Maximo-systeem om verbinding te maken met S3 is goed gedocumenteerd door IBM. Zodra uw S3-account en -bucket zijn aangemaakt door uw systeembeheerder, moet uw Maximo-beheerder enkele systeemeigenschappen aanpassen. Start het systeem vervolgens opnieuw op en je kunt de S3-bucket gaan gebruiken.
IBM-document: https://www.ibm.com/docs/en/mam/7.6.1.2?topic=properties-attachment-s3

Het lastiger bij het configureren van het systeem is het verplaatsen van het bestaande bijlagebestand naar de S3-bucket. De bestanden moeten worden geüpload naar de S3-bucket. Met behulp van een tool zoals WinSCP kun je verbinding maken met de S3-bucket, net zoals je verbinding zou maken met een SFTP-site met een gebruikersinterface van de client. Voordat u al uw bestanden uploadt, moet u zich ervan bewust zijn dat de Maximo implementatie van S3 geen submappen toestaat. De meeste Maximo-configuraties hebben echter submappen. Voor het uploaden vlakt Naviam onze doclinks-mappenstructuur af. In MAS biedt IBM hiervoor een script in de MAXINST-pod, file2s3.sh, maar dit is niet beschikbaar als u migreert naar S3 op 7.6.1, waardoor dit een handmatig proces is. Om dubbele bestandsnamen te voorkomen, voegen Naviam-scripts de submapnaam toe aan de bestandsnaam en verplaatsen ze het bestand vervolgens recursief naar boven in de mapmap. Een bestand dat voorheen in de bijlagemap stond als. \ Attachments\ testfile.txt is hernoemd naar. \ Attachments-testfile.txt.
Voorbeeld PowerShell:
Get-childItem „'C:\docklinks\Attachments" -bijlagen uitsluiten-* | Waar {! $.psisContainer} | Item hernoemen -NewName {„doclinks-attachments-” + $.Name}
Zodra de bestanden allemaal zijn afgevlakt of gecombineerd in één map, kunt u ze uploaden naar de S3-bucket. Zodra de bestandsnamen zijn gewijzigd en geüpload, is dezelfde wijziging nodig in de DOCINFO-tabel. Door de mapnaam in de bestandsnaam te scripten, hebben we een voorspelbaar resultaat dat met SQL in de database kan worden gereproduceerd.
Voorbeeld van SQL:
update docinfo set urlname = REPLACE (urlname, 'C:\docklinks\Attachments\', 'cos:doclinks/attachments-') waarbij urltype = 'FILE' en urlname niet zoals 'cos:doclinks%' en urlname zoals 'C:\docklinks\Attachments\ %'
Het combineren van wijzigingen in de eigenschappen van het Maximo systeem, het uploaden van documenten naar S3 en het updaten van de DOCINFO-tabel Maximo 7.6.1 kan met succes worden overgezet naar het gebruik van S3 voor de opslag van bijgevoegde documenten. Aandacht voor detail is nuttig, en u moet altijd eerst wijzigingen proberen in uw niet-productieomgeving, maar met een beetje moeite is dit een ding minder waar u zich zorgen over hoeft te maken tijdens uw upgrade van Maximo naar MAS.
https://www.ibm.com/docs/en/mam/7.6.1.2?topic=properties-attachment-s3
https://www.ibm.com/docs/en/mas-cd/maximo-manage/continuous-delivery?topic=properties-attachment-s3
Discover everything you need to know to modernize your asset management strategy.
Inside, you’ll learn:

ActiveG, BPD Zenith, EAM Swiss, InterPro Solutions, Lexco, Peacock Engineering, Projetech, Sharptree, and ZNAPZ have united under one brand: Naviam.
You’ll be redirected to the most relevant page at Naviam.io in a few seconds — or you can
go now.