Ahora he trabajado en muchas migraciones de 7.6 a MAS. Ha sido un buen cambio de ritmo con respecto al mismo parche 7.6 de siempre. Sin embargo, como parte de la transición a MAS, también cambiamos el lugar donde se encuentra el almacenamiento de archivos de DOCLINKS. Ahora puedes usar las notificaciones por volumen persistente (PVC) o S3. Ahora alojamos DOCLINKS mediante S3. Pasar a S3 significa que tenemos que modificar DOCLINKS. Al hacerlo, he aprendido mucho sobre cómo modificar DOCLINKS y cómo hacerlo de forma segura, sin romper todos los archivos adjuntos almacenados.
‍

Antes de comenzar a explicar el proceso de mejores prácticas. Quiero asegurarme de que conoces las partes importantes que controlan DOCLINKS. Las tablas principales son DOCINFO y DOCLINKS. También debe comprender que el archivo adjunto físico se encuentra en el bucket de PVC o S3 y no en la base de datos propiamente dicha.

DOCINFO

Esto almacena los metadatos de los archivos adjuntos. Columnas clave:

• DOCINFOIDE
  
  • ID único
  • Relación con DOCLINKS
• NOMBRE DE URL
  
  • Ruta real del archivo
• TIPO DE URL
  
  • ARCHIVO o URL
• TIPO DE DOCUMENTO
  
  • Archivo adjunto, imagen, etc.
  • S3: se trata de una etiqueta de metadatos que no afecta al lugar donde se almacenan los archivos actualmente.
  • Carpeta: se puede usar como una carpeta secundaria (o una estructura de carpetas independiente) y separa los archivos adjuntos.

ENLACES DE DOCUMENTOS

Esto vincula el documento a Administrar récord. Columnas clave:

• MESA DE PROPIETARIO
  
  • Muestra en qué objeto se encuentra el DOCLINKS
  • Ejemplo: orden de trabajo
• ID DE PROPIETARIO
  
  • ID único para la columna de la tabla
  • Se usa para buscar en qué registro se encuentra el DOCLINK; se usa en las relaciones para unirse a la tabla con archivos adjuntos
• DOCINFOIDE
  
  • Relación con DOCINFO

Mejores prácticas

Respaldo del sistema

Cada vez que vaya a realizar un cambio en DOCLINKS, DOCINFO o, honestamente, en cualquier cosa relacionada con los datos, haga una copia de seguridad de su sistema. Realice primero los cambios en un entorno que no sea de producción. También puede ejecutar SQL para crear una copia de seguridad de la tabla DOCINFO para no perderla y eliminar la tabla una vez que haya terminado para revertirla fácilmente.

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; 

Oráculo

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

Comience con un archivo adjunto

Limita primero los cambios que realices en un archivo. Es posible que tengas muchos nombres de URL diferentes que necesites actualizar. Si intentas hacerlos todos a la vez, puedes estropear todas las URL. Tómate tu tiempo e investiga primero qué es lo que hay que cambiar.
‍

NOTA: las únicas actualizaciones que tendremos que hacer son en la tabla DOCINFO y no en la tabla DOCLINK. No debería necesitar actualizar DOCLINKS durante todo este proceso.

Tipos de URL de ARCHIVO

Solo concentro mi energía en los tipos de URL de FILE. Estos son los documentos que se almacenan en el almacenamiento de archivos adjuntos que está utilizando.

Cambio de manta

A menudo, querrás hacer un cambio general como el que se muestra a continuación; está cerca de ser un buen cambio, pero falta algo de información:
‍

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

Se trata de un error que puede provocar varios problemas:

• La sensibilidad entre mayúsculas y minúsculas podría estar des
• Puedes actualizar todos tus registros
• Podrías convertirla en una ruta UNC no válida

Patrón DOCLINKS

Busque un patrón para sus DOCLINKS y utilícelo para crear una declaración de actualización. Puedes empezar con SQL de la siguiente manera:
‍

SELECT URLNAME FROM DOCINFO WHERE URLTYPE = 'FILE' 

Si todos los DOCLINKS tienen una ruta similar, como\\ server\ DOCLINKS\, puede crear una declaración general. Sin embargo, sigo recomendando probar un solo documento usando algo como esto:

‍

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

Verificación

Verifica que el único adjunto que cambies funcione en la interfaz de usuario del front-end.

Sustitución controlada

El uso de un reemplazo controlado le permite asegurarse de que solo actualiza los DOCLINKS que coinciden con lo que desea reemplazar:

‍

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

Repito

Haga esto para todos los nombres de URL únicos que necesite hasta que todos sus registros DOCINFO apunten a su nuevo almacenamiento de archivos.

‍

No todos los problemas de DOCINFO necesitan necesariamente una actualización como esta en el URLNAME. Sin embargo, cambiar las soluciones de almacenamiento de archivos requerirá estos cambios de URL. También requerirán algunas actualizaciones en algunas configuraciones de las Propiedades del sistema. Es posible que necesite actualizar las siguientes propiedades:

• mxe.doclink.docTypes.defPath

• mxe.doclink.docTypes.TopLevelPaths

• MXE.DocLink.Path01

• maxe.almacenamiento de archivos adjuntos

• MXE.DocLink.Archivo adjunto seguro

‍

Si utilizas S3, también tendrás que dar acceso a Manage al bucket actualizando estas propiedades del sistema:

• mxe.cosendpoints

• clave de acceso mxe.cos

• clave secreta mxe.cos

• nombre de bucket mxe.cos

‍

Por último, querrá revisar sus tipos de documentos. Tras realizar todos estos cambios, la tabla DOCTYPES seguirá haciendo referencia a su antiguo sistema de almacenamiento. Querrá actualizarlo a su nuevo sistema de almacenamiento:

‍

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

‍

La causa más común de la rotura de los archivos adjuntos en los entornos de Maximo no es la corrupción; son los administradores bien intencionados que actualizan las rutas de DOCLINK sin entender cómo interactúan DOCINFO y DOCLINKS.
‍

Clientes actuales: al actualizar a MAS, esto se gestiona por usted como parte de la actualización. Si está pensando en unirse La nube de Naviam, gestionamos estos cambios por usted como parte de la implementación. Ni siquiera tendrá que preocuparse por esto para su sistema.