Ich habe jetzt an vielen Migrationen von 7.6 zu gearbeitet MAS. Es war eine nette Abwechslung gegenüber dem gleichen alten 7.6-Patch. Im Rahmen der Umstellung auf MAS wechseln wir jedoch auch dorthin, wo sich der Dateispeicher für DOCLINKS befindet. Sie können jetzt Persistent Volume Claims (PVCs) verwenden oder S3. Wir hosten jetzt DOCLINKS mit S3. Die Umstellung auf S3 bedeutet, dass wir DOCLINKS ändern müssen. Dabei habe ich viel über das Ändern von DOCLINKS gelernt und wie man es sicher macht, ohne alle Ihre gespeicherten Anhänge zu beschädigen.
‍

Bevor wir mit der Erläuterung des Prozesses der Best Practices beginnen. Ich möchte sichergehen, dass Sie die wichtigen Teile kennen, die DOCLINKS steuern. Die Kerntabellen sind DOCINFO und DOCLINKS. Sie müssen auch verstehen, dass sich der physische Anhang im PC oder im S3-Bucket befindet und nicht in der Datenbank selbst.

DOCINFO

Dadurch werden die Metadaten des Anhangs gespeichert. Wichtige Spalten:

• DOCINFOID
  
  • Eindeutige ID
  • Beziehung zu DOCLINKS
• URL-NAME
  
  • Tatsächlicher Dateipfad
• URL-TYP
  
  • DATEI oder URL
• DOCTYPE
  
  • Anlage, Bild usw.
  • S3 — Dies ist ein Metadaten-Tag, das keinen Einfluss darauf hat, wo Dateien derzeit gespeichert sind.
  • Ordner: Dieser kann als untergeordneter Ordner (oder separate Ordnerstruktur) verwendet werden und trennt die Anlagen.

DOCLINKS

Dies verknüpft das Dokument mit einem Managen rekord. Wichtige Spalten:

• BESITZERTABELLE
  
  • Zeigt an, auf welchem Objekt der DOCLINKS lebt
  • Beispiel: Arbeitsauftrag
• BESITZER-ID
  
  • Eindeutige ID für die Spalte der Tabelle
  • Wird verwendet, um herauszufinden, auf welchem Datensatz sich der DOCLINK befindet; wird in Beziehungen verwendet, um die Tabelle mit Anlagen zu verbinden
• DOCINFOID
  
  • Beziehung zu DOCINFO

Bewährte Verfahren

Systemsicherung

Jedes Mal, wenn Sie eine Änderung an DOCLINKS, DOCINFO oder ehrlich gesagt an allem, was mit Daten zu tun hat, vornehmen, erstellen Sie eine Sicherungskopie Ihres Systems. Nehmen Sie die Änderungen zuerst in einer Umgebung vor, in der es sich nicht um Produkte handelt. Sie können auch SQL ausführen, um eine DOCINFO-Tabellensicherung zu erstellen, damit Sie sie nicht verlieren und die Tabelle löschen, wenn Sie fertig sind, um die DOCINFO-Tabelle einfach wiederherzustellen.

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; 

Orakel

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

Beginne mit einem Anhang

Grenzen Sie zunächst alle Änderungen ein, die Sie an einer Datei vornehmen. Möglicherweise haben Sie viele verschiedene URL-Namen, die aktualisiert werden müssen. Wenn du versuchst, sie alle auf einmal zu machen, könntest du alle URLs durcheinander bringen. Nehmen Sie sich Zeit und untersuchen Sie, was zuerst geändert werden muss.
‍

HINWEIS: Die einzigen Aktualisierungen, die wir vornehmen müssen, betreffen die DOCINFO-Tabelle und nicht die DOCLINK-Tabelle. Sie sollten DOCLINKS nicht während des gesamten Vorgangs aktualisieren müssen.

URL-Typen von FILE

Ich konzentriere meine Energie nur auf URLTypes von FILE. Dies sind die Dokumente, die in dem von Ihnen verwendeten Anhangsspeicher gespeichert sind.

Pauschalwechsel

Oft möchten Sie eine pauschale Änderung wie unten vornehmen. Das ist fast eine gute Änderung, aber es fehlen einige Informationen:
‍

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

Dies ist ein Fehler, der zu mehreren Problemen führen kann:

• Die Groß- und Kleinschreibung könnte ausgeschaltet sein
• Sie könnten alle Ihre Aufzeichnungen aktualisieren
• Sie könnten einen ungültigen UNC-Pfad daraus machen

DOCLINKS-Muster

Suchen Sie ein Muster für Ihre DOCLINKS und verwenden Sie es, um eine Aktualisierungsanweisung zu erstellen. Sie können mit SQL beginnen wie:
‍

SELECT URLNAME FROM DOCINFO WHERE URLTYPE = 'FILE' 

Wenn alle DOCLINKS einen ähnlichen Pfad wie\\ server\ DOCLINKS\ haben, können Sie eine pauschale Anweisung erstellen. Ich empfehle jedoch immer noch, nur ein Dokument mit etwas wie dem folgenden zu testen:

‍

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

Überprüfung

Stellen Sie sicher, dass der eine Anhang, den Sie ändern, in der Frontend-Benutzeroberfläche funktioniert.

Kontrolliertes Ersetzen

Wenn Sie ein kontrolliertes Ersetzen verwenden, können Sie sicher sein, dass Sie nur DOCLINKS aktualisieren, die dem entsprechen, was Sie ersetzen möchten:

‍

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

Wiederhole

Tun Sie dies für alle eindeutigen URL-Namen, die Sie benötigen, bis alle Ihre DOCINFO-Datensätze auf Ihren neuen Dateispeicher verweisen.

‍

Nicht alle DOCINFO-Ausgaben benötigen unbedingt ein solches Update für den URLNAME. Das Ändern der Dateispeicherlösungen erfordert jedoch diese URL-Änderungen. Sie erfordern auch einige Aktualisierungen einiger Konfigurationen in den Systemeigenschaften. Möglicherweise müssen Sie die folgenden Eigenschaften aktualisieren:

• mxe.doclink.doctypes.defPath

• mxe.doclink.doctypes.TopLevelPaths

• mxe.doclink.path01

• mxe.anhangstorage

• mxe.doclink.securedAttachment

‍

Wenn Sie S3 verwenden, müssen Sie Manage auch Zugriff auf den Bucket gewähren, indem Sie die folgenden Systemeigenschaften aktualisieren:

• mxe.co sendpointuri

• mxe.cos Zugriffsschlüssel

• mxe.cosgeheimer Schlüssel

• mxe.cos-Bucketname

‍

Schließlich sollten Sie Ihre Doctypes überprüfen. Nachdem Sie all diese Änderungen vorgenommen haben, verweist die DOCTYPES-Tabelle weiterhin auf Ihr altes Speichersystem. Sie sollten das auf Ihr neues Speichersystem aktualisieren:

‍

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

‍

Die häufigste Ursache für defekte Anhänge in Maximo-Umgebungen ist nicht die Beschädigung; es sind wohlmeinende Administratoren, die DOCLINK-Pfade aktualisieren, ohne zu verstehen, wie DOCINFO und DOCLINKS interagieren.
‍

Aktuelle Kunden: Wenn Sie auf MAS aktualisieren, wird dies im Rahmen des Upgrades für Sie erledigt. Wenn Sie daran denken, beizutreten Die Wolke von Naviam, wir kümmern uns im Rahmen der Implementierung um diese Änderungen für Sie. Darüber müssen Sie sich für Ihr System nicht einmal Gedanken machen.