Ik heb nu aan veel migraties gewerkt van 7.6 naar MAS. Het was een leuke afwisseling ten opzichte van dezelfde oude 7.6-patch. Als onderdeel van de overstap naar MAS verhuizen we echter ook naar de plaats waar de bestandsopslag zich bevindt voor DOCLINKS. Je kunt nu Persistent Volume Claims (PVC's) gebruiken of S3. We hosten nu DOCLINKS met behulp van S3. De overstap naar S3 betekent dat we DOCLINKS moeten aanpassen. Door dit te doen, heb ik veel geleerd over het aanpassen van DOCLINKS en hoe je dit veilig kunt doen, zonder al je opgeslagen bijlagen kapot te maken.
‍

Alvorens het proces van beste praktijken uit te leggen. Ik wil er zeker van zijn dat je de belangrijke onderdelen kent die DOCLINKS beheersen. De kerntabellen zijn DOCINFO en DOCLINKS. U moet ook begrijpen dat de fysieke bijlage zich in de PVC- of S3-bucket bevindt en niet in de database zelf.

DOCINFO

Hierin worden de metagegevens van de bijlagen opgeslagen. Belangrijkste kolommen:

• DOCINFOID
  
  • Uniek identiteitsbewijs
  • Relatie met DOCLINKS
• URL-NAAM
  
  • Werkelijk bestandspad
• URL-TYPE
  
  • BESTAND of URL
• DOCTYPE
  
  • Bijlage, afbeelding, etc.
  • S3 - Dit is een metadatag die geen invloed heeft op waar bestanden momenteel worden opgeslagen.
  • Map: deze kan worden gebruikt als een onderliggende map (of als aparte mappenstructuur) en de bijlagen van elkaar worden gescheiden.

DOCLINKS

Dit koppelt het document aan een Beheren opnemen. Belangrijkste kolommen:

• BEZITTERBAAR
  
  • Laat zien op welk object de DOCLINKS leeft
  • Voorbeeld: werkorder
• EIGENAAR-ID
  
  • Unieke ID voor de kolom van de tabel
  • Wordt gebruikt om te bepalen op welk record de DOCLINK staat; gebruikt in relaties om de tabel met bijlagen samen te voegen
• DOCINFOID
  
  • Relatie met DOCINFO

Beste praktijken

Back-up van het systeem

Elke keer dat u een wijziging gaat aanbrengen in DOCLINKS, DOCINFO of eerlijk gezegd iets met betrekking tot gegevens, maak dan een back-up van uw systeem. Voer de wijzigingen eerst uit in een niet-prod-omgeving. U kunt ook SQL gebruiken om een DOCINFO-tabelback-up te maken, zodat u deze niet kwijtraakt en de tabel laat vallen als u klaar bent om de DOCINFO-tabel eenvoudig terug te zetten.

SQL

SELECT * INTO DOCINFO_BACKUP FROM DOCINFO;
DROP TABLE DOCINFO_BACKUP;

DB2

CREATE TABLE DOCINFO_BACKUP AS (SELECT * FROM DOCINFO) WITH DATA; 
DROP TABLE DOCINFO_BACKUP; 

Oracle

CREATE TABLE DOCINFO_BACKUP AS SELECT * FROM DOCINFO; 
DROP TABLE DOCINFO_BACKUP; 

Begin met één bijlage

Beperk eerst alle wijzigingen die je in één bestand aanbrengt. Er kunnen veel verschillende URL-namen zijn die moeten worden bijgewerkt. Als u ze allemaal tegelijk probeert te doen, kunt u alle URL's verknoeien. Neem de tijd en onderzoek eerst wat er nodig is om te veranderen.
‍

OPMERKING: de enige updates die we hoeven uit te voeren zijn de DOCINFO-tabel en niet de DOCLINK-tabel. U hoeft DOCLINKS tijdens dit hele proces niet te updaten.

URL-typen van BESTANDEN

Ik richt mijn energie alleen op URLtypes van FILE. Dit zijn de documenten die zijn opgeslagen in de bijlageopslag die u gebruikt.

Deken vervangen

Vaak wil je een algemene verandering doen, zoals hieronder; het is bijna een goede verandering, maar er ontbreekt wat informatie:
‍

UPDATE DOCINFO SET URLNAME = REPLACE(URLNAME,'\\OLD','\\NEW')

Dit is een fout die tot meerdere problemen kan leiden:

• De hoofdlettergevoeligheid is mogelijk uitgeschakeld
• Je zou al je records kunnen bijwerken
• Je zou er een ongeldig UNC-pad van kunnen maken

DOCLINKS-patroon

Zoek een patroon voor je DOCLINKS en gebruik dit om een updateverklaring te maken. Je kunt beginnen met SQL zoals:
‍

SELECT URLNAME FROM DOCINFO WHERE URLTYPE = 'FILE' 

Als alle DOCLINKS een vergelijkbaar pad hebben, zoals\\ server\ DOCLINKS\, kunt u een algemene verklaring maken. Ik raad echter nog steeds aan om slechts één document te testen met zoiets als dit:

‍

UPDATE DOCINFO SET URLNAME = 
REPLACE(URLNAME,'\\OLD_SERVER\DOCLINKS','\\NEW_SERVER\DOCLINKS') 
WHERE URLNAME = '\\OLD_SERVER\DOCLINKS\[TEST.TXT]' AND URLTYPE=’FILE’

Verificatie

Controleer of de enige bijlage die je wijzigt, werkt in de gebruikersinterface van de front-end.

Gecontroleerd vervangen

Als u een gecontroleerde Replace gebruikt, kunt u er zeker van zijn dat u alleen DOCLINKS bijwerkt die overeenkomen met wat u wilt vervangen:

‍

UPDATE DOCINFO SET URLNAME = 
REPLACE(URLNAME,'\\OLD_SERVER\DOCLINKS','\\NEW_SERVER\DOCLINKS') 
WHERE URLNAME LIKE '\\OLD_SERVER\DOCLINKS%' AND URLTYPE=’FILE’

Herhaal

Doe dit voor alle unieke URL-namen die u nodig hebt totdat al uw DOCINFO-records naar uw nieuwe bestandsopslag verwijzen.

‍

Niet alle DOCINFO-problemen hebben noodzakelijkerwijs een dergelijke update van de URLNAME nodig. Voor het wijzigen van oplossingen voor bestandsopslag zijn deze URL-wijzigingen echter vereist. Ze hebben ook enkele updates nodig voor enkele configuraties in Systeemeigenschappen. Mogelijk moet u de volgende eigenschappen bijwerken:

• mxe.doclink.doctypes.defpath

• mxe.doclink.doctypes.paden op het hoogste niveau

• mxe.doclink.path01

• mx. opslag voor bijlagen

• mxe.doclink.SecureAttachment

‍

Als je S3 gebruikt, moet je Manage ook toegang geven tot de bucket door deze systeemeigenschappen bij te werken:

• mxe.cosendpointuri

• mxe.cos access-sleutel

• mxe.cos secret sleutel

• mxe.cosbucketname

‍

Tot slot wil je je doctypes bekijken. Nadat al deze wijzigingen zijn aangebracht, verwijst de DOCTYPES-tabel nog steeds naar uw oude opslagsysteem. Je wilt dat updaten naar je nieuwe opslagsysteem:

‍

UPDATE doctypes SET defaultfilepath = ‘[NEW Default Path]’

‍

De meest voorkomende oorzaak van kapotte bijlagen in Maximo-omgevingen is niet corruptie; het zijn goedbedoelde beheerders die DOCLINK-paden updaten zonder te begrijpen hoe DOCINFO en DOCLINKS op elkaar inwerken.
‍

Huidige klanten: bij een upgrade naar MAS wordt dit voor u afgehandeld als onderdeel van de upgrade. Als je erover denkt om lid te worden De cloud van Naviam, we behandelen deze wijzigingen voor u als onderdeel van de implementatie. U hoeft zich hierover zelfs geen zorgen te maken voor uw systeem.