Variables de configuración para migrar un gestor de despliegue de z/OS utilizando el mandato zmmt

Antes de migrar WebSphere Application Server para z/OS, debe crear los trabajos JCL (Job Control Language - lenguaje de control de trabajos) (conjuntos de datos CNTL y DATA) que ejecutarán durante la migración real. Puede utilizar el mandato zmmt con un archivo de respuestas para crear los trabajos de migración apropiados. El archivo de respuestas de migración contiene un conjunto de variables de configuración que se utilizan para crear trabajos para migrar un gestor de despliegue.

Supported configurations Supported configurations:

En este artículo se describe la migración de la configuración de perfil. Para migrar sus aplicaciones a la versión más reciente, utilice WebSphere Application Server Migration Toolkit. Para obtener más información, consulte Migration Toolkit en WASdev.

sptcfg

Variables de archivo de respuestas

crear
Palabra clave necesaria para indicar la creación de una nueva definición de migración
intermediateSymlinkPreference
Si se ha de configurar un enlace simbólico intermedio

Si especifica un enlace simbólico intermedio, se crearán los enlaces simbólicos desde el sistema del archivo de configuración al enlace simbólico intermedio; de lo contrario, se crearán directamente en el sistema de archivos del producto.

IntermediateSymlink
Nombre de la vía de acceso del enlace simbólico intermedio

Este enlace lo generarán los trabajos de personalización, apuntando al directorio del sistema de archivos del producto.

profileName
Nombre del perfil creado durante la migración

Es siempre "default" en la plataforma z/OS.

profilePath
Vía de acceso totalmente calificada en que debe grabarse la salida de la definición de migración generada
templatePath
Vía de acceso de la plantilla
Es uno de los valores siguientes:
  • zos-migDmgr

    Migrar un gestor de despliegue

  • zos-migFederated

    Migrar un nodo federado

  • zos-migStandalone

    Migrar un servidor de aplicaciones autónomo

zConfigHfsName
Nombre del conjunto de datos MVS que contendrá el sistema de archivos de configuración

Este nombre se utiliza como entrada para el trabajo de migración que crea el sistema de archivos de configuración.

zConfigHfsPrimaryCylinders
Número de cilindros primarios que se asignarán al sistema de archivos de configuración

En un servidor de aplicaciones, el espacio total necesario para este conjunto de datos aumenta con el tamaño y número de aplicaciones instaladas.

Recomendación: El tamaño mínimo recomendado es de 420 cilindros.
zConfigHfsSecondaryCylinders
Número de cilindros secundarios que se asignarán al sistema de archivos de configuración
Recomendación: El tamaño mínimo recomendado es de 100 cilindros.
zConfigHfsVolume
Número de serie de volumen DASD que va a contener el conjunto de datos anterior o "*" para permitir que SMS seleccione un volumen

El uso de "*" requiere que las rutinas de selección automática de clases (ACS) SMS estén en su sitio para seleccionar el volumen. Si SMS no está configurado para manejar automáticamente la asignación de conjuntos de datos, enumere los volúmenes de forma explícita.

zConfigMountPoint
Punto de montaje de directorios del sistema de archivos donde se graban los archivos de entorno y los datos de aplicación

El sistema de archivos de configuración es donde se almacena físicamente la configuración para el nodo que se está migrando. Puede optar por utilizar un sistema de archivos existente de la Versión 9.0 si ya tiene un sistema de archivos adecuado en el nodo que se está migrando. Si elige utilizar un sistema de archivos existente de la Versión 9.0, debe asegurarse de que el punto de montaje especificado aquí exista, antes de ejecutar los trabajos de migración que se crean utilizando esta herramienta. Si opta por crear un nuevo sistema de archivos de la Versión 9.0 en el nodo que está migrando, la creación real del mismo no se llevará a cabo hasta que ejecute el trabajo opcional BBOMDHFS o BBOMDZFS durante el proceso de migración real. En cualquier caso, debe especificar aquí el valor correcto del punto de montaje.

zFilesystemType
Tipo del sistema de archivos
Es uno de los valores siguientes:
  • HFS

    Asigne y monte el conjunto de datos de sistema de archivos de configuración utilizando HFS (Hierarchical File System)

  • ZFS

    Asigne y monte el conjunto de datos de sistema de archivos de configuración utilizando el sistema de archivos zSeries

zJobStatement1 . . . n
Sentencias JOB personalizables que se utilizarán para los trabajos de migración generados

Todos los trabajos que se adaptarán para el usuario necesitarán una sentencia de trabajo. Especifique una sentencia de trabajo válida para la instalación del usuario. El proceso de creación de la migración actualizará automáticamente el nombre del trabajo en todos los trabajos generados, por lo que no tendrá que preocuparse por esa parte de la sentencia de trabajo. Si se necesitan líneas de continuación, sustituya las líneas de comentarios por líneas de continuación.

zTargetHLQ
Calificador de alto nivel para los conjuntos de datos z/OS de destino que contendrán los trabajos generados y las instrucciones
Nota: Se puede especificar un calificador de alto nivel de varios niveles como calificador de alto nivel del conjunto de datos.
zmbAdminUserid
ID de usuario de un administrador que se utiliza para gestionar el nodo que se está migrando

Se necesita para realizar acciones administrativas necesarias durante el proceso de migración.

zmbAdminPassword
Contraseña para el ID de usuario del administrador que se utiliza para gestionar el nodo que se está migrando

Se necesita para realizar acciones administrativas necesarias durante el proceso de migración.

zmbAppMigrationPreference
Cómo desea migrar las aplicaciones instaladas
Es uno de los valores siguientes:
  • D

    Instalar aplicaciones de empresa de usuario en el directorio de instalación de aplicaciones por omisión como parte de la migración

  • Y

    Instalar aplicaciones de empresa de usuario en un directorio especificado en las variables siguientes como parte de la migración

    zmbAppInstallDirLine1
    zmbAppInstallDirLine2
    Ubicación donde WebSphere Application Server instala las aplicaciones de empresa

    Esta ubicación se utiliza cuando se especifica que se desea migrar e instalar aplicaciones como preferencia de migración de aplicaciones. Tiene la opción de elegir una ubicación personalizada y específica del entorno o utilizar la ubicación por omisión.

    Si la longitud de vía de acceso de ubicación supera los 60 caracteres, se debe especificar en dos líneas tal como se muestra, pero no puede sobrepasar la longitud total de 120 caracteres.

    Deje estos dos campos en blanco a menos que especifique Y para zmbAppMigrationPreference.

  • S

    Preparar las aplicaciones empresariales del usuario para la instalación del directorio installableApps WebSphere Application Server Versión 9.0 sin instalarlas realmente durante la migración.

    Los scripts que se pueden utilizar para instalar estas aplicaciones se generan y guardan en el directorio de copia de seguridad de migración. Para WebSphere Application Server para z/OS, la ubicación de este directorio de copia de seguridad es relativa al directorio temporal que especifique para la variable zmbTempDirectory. La ubicación del directorio de copia de seguridad también está determinada por el identificador de migración derivada y el tipo de nodo que se migra. Si especifica /tmp/migrate como directorio temporal y el identificador de migración derivada es 55449, por ejemplo, la ubicación de los scripts generados es:
    /tmp/migrate/55449/tiponodo_backup/
    donde tiponodo es dmgr, fed, o base en función del tipo de nodo que está migrando.

    Una vez que se ha completado la migración podrá ejecutar estos archivos cuando desee y en cualquier orden. También puede reorganizar y combinar estos archivos para obtener una mejor eficacia de la instalación de la aplicación. Para obtener información adicional, consulte el artículo "Herramienta Wsadmin" en la documentación.

  • P

    Instalar las aplicaciones de empresa de usuario como parte de la migración y mantener los mismos directorios de instalación de aplicaciones que en la versión anterior

    Restricciones: Si selecciona esta opción, la ubicación la comparten la instalación existente de WebSphere Application Server Versión 7.0 y la instalación de la Versión 9.0. Si mantiene las aplicaciones migradas en las mismas ubicaciones que la versión anterior, se aplican las siguientes restricciones:
    • Es necesario atenerse a las limitaciones del soporte de nodos combinados de WebSphere Application Server Versión 9.0. Esto significa que no se puede utilizar el siguiente soporte al invocar el mandato wsadmin:
      • Precompilar JSP
      • Utilizar configuración binaria
      • Desplegar EJB
    • Se arriesga a perder accidentalmente las aplicaciones migradas si posteriormente suprime las aplicaciones de estas ubicaciones cuando administra (por ejemplo, en la desinstalación) la instalación de la Versión 7.0.
    • Cualquier aplicación que se instale, en relación con una variable de la Versión 7.0, se instalará de forma relativa a la ubicación asignada a dicha variable en la Versión 9.0. Es decir, la ubicación absoluta no se conserva—la aplicación se migra a la ubicación relativa dentro del entorno de la Versión 9.0.
      Si binariesURL del archivo deployment.xml para una aplicación que se migra tiene una vía de acceso que es relativa a WebSphere Application Server—es decir, que empieza por $(APP_INSTALL_ROOT), $(WAS_INSTALL_ROOT), etc—el nuevo valor de la variable de WebSphere Application Server se utiliza para resolver la vía de acceso cuando se instala la aplicación en la nueva ubicación. Esto genera los resultados siguientes cuando selecciona esta opción:
      • Cualquier aplicación que se instale en una ubicación de directorio relativa a una variable de WebSphere Application Server se instala bajo el valor de variable en la Versión 9.0.
      • Cualquier aplicación que se instale en una ubicación de directorio que no es relativa a una variable de WebSphere Application Server, se migra y se sobrescribe en este mismo directorio. Si se instala en una aplicación en el directorio /employee_records/retrieval_Apps, por ejemplo, la aplicación se migra y sobrescribe en el directorio /employee_records/retrieval_Apps.
  • N

    No hacer nada con las aplicaciones empresariales de usuario

Nota: Las aplicaciones del sistema de WebSphere Application Server se migrarán independientemente del valor establecido aquí.
zmbControllerProcName
Nombre del procedimiento iniciado JCL utilizado para iniciar los controladores migrados

Cuando se migra a la Versión 9.0, debe actualizar los procedimientos JCL iniciados. Se generará automáticamente un procedimiento iniciado nuevo durante la migración. Puede especificar un nombre nuevo para el procedimiento de controlador o utilizar el antiguo.

zmbServantProcName
Nombre del procedimiento iniciado JCL utilizado para iniciar los servants migrados

Cuando se migra a la Versión 9.0, debe actualizar los procedimientos JCL iniciados. Se generará automáticamente un procedimiento iniciado nuevo durante la migración. Puede especificar un nombre nuevo para el procedimiento de servant o utilizar el antiguo.

zmbDaemonProcName
Nombre del procedimiento iniciado JCL utilizado para iniciar el daemon migrado

Cuando se migra a la Versión 9.0, debe actualizar los procedimientos JCL iniciados. Se generará automáticamente un procedimiento iniciado nuevo durante la migración. Puede especificar un nombre nuevo para el procedimiento de daemon o utilizar el antiguo.

zmbReplaceStartedProcedureNames
Si se actualizan los mandatos START en la configuración con los nuevos valores especificados (true) o conservar los mismos nombres (false).

Si ha especificado nombres nuevos para los procedimientos JCL, los mandatos START correspondientes de la configuración de WebSphere Application Server se deben actualizar para que coincidan con los nuevos nombres de procedimiento. Especifique true para que esta variable realice esta actualización de la configuración.

Si elige utilizar los mismos nombres de procedimiento, especifique false para esta variable. Si no va a utilizar nombres de procedimiento coherentes para todos los servidores de un tipo de proceso determinado (por ejemplo, todos servants) para el nodo que va a migrar, es recomendable que especifique false para esta variable. En este caso, tendrá que mantener los mismos mandatos START y sustituir manualmente los procedimientos utilizando como plantilla el procedimiento que se ha generado durante la migración.

Notas:
  • La configuración de la Versión 9.0 debe utilizar procedimientos JCL distintos de los utilizados por la configuración de la versión 7.0. El proceso de migración crea nuevos procedimientos JCL de la Versión 9.0 utilizando los nombres de procedimientos especificados aquí.
  • Si utiliza los mismos nombres que los utilizados en la configuración de la versión 7.0, el proceso de migración sobrescribirá los procedimientos existentes. Si utiliza los mismos nombres, asegúrese de hacer una copia de seguridad de los procedimientos existentes de la versión 7.0 antes de ejecutar este programa de utilidad por si fuera necesario retrotraerlos más adelante.
zmbDisableDmgr
Si se debe inhabilitar (true) o no (false) el gestor de despliegue anterior durante la migración
Si el gestor de despliegue de la versión 7.0 no se inhabilita, puede seguir utilizándolo mientras la migración se completa.
Precaución: Utilice esta opción con cuidado. El motivo por el que normalmente los gestores de despliegue de WebSphere Application Server Versión 7.0 se detienen y se inhabilitan es para impedir que varios gestores de despliegue gestionen los mismos nodos. Debe detener el gestor de despliegue de la versión 7.0 antes de empezar a utilizar el gestor de despliegue de la Versión 9.0. Si se deselecciona esta opción, no se migrará ninguno de los los cambios de configuración que se hayan realizado en la configuración anterior durante la migración.
zmbEnablePostUpgradeTrace
Habilitar (true) o inhabilitar (false) el rastreo durante el proceso WASPostUpgrade
zmbEnablePreUpgradeTrace
Habilitar (true) o inhabilitar (false) el rastreo durante el proceso WASPreUpgrade
zmbEnableProfileTrace
Habilitar (true) o inhabilitar (false) el rastreo durante la creación de perfiles
zmbEnableScriptingTrace
Habilitar (true) o inhabilitar (false) el rastreo de la invocación inicial de las herramientas de creación, perfiles y migración, así como las fases de proceso finales de la migración
zmbFromConfigRoot
Punto de montaje de la configuración desde la que va a realizar la migración
zmbFromWASHomeDir
Directorio inicial de la configuración desde la que va a realizar la migración
zmbInitialHeapSize
La memoria inicial asignada para el almacenamiento dinámico de JVM.
zmbJavaTempDirectory
Un directorio temporal Java que utiliza la máquina virtual Java para crear y almacenar archivos temporales durante la migración.
zmbMaxHeapSize
El tamaño máximo de almacenamiento dinámico que puede asignarse para el almacenamiento dinámico de JVM.
zmbProclibName
Biblioteca de procedimientos existentes en la que se deben copiar los procedimientos catalogados de WebSphere Application Server para z/OS.
zmbResolvePortConflicts
Defina cómo manejar los conflictos de puerto especificando uno de los valores siguientes.
  • incrementCurrent

    Si se detecta un conflicto de puerto, el valor de puerto se incrementa desde el puerto en conflicto al siguiente valor de puerto disponible.

  • startingPort
    Si se detecta un conflicto de puerto, el valor de puerto se incrementa desde el valor especificado al siguiente valor de puerto disponible.
    Nota: Si tanto zmbResolvePortConflicts como zmbSetPorts se establecen en startingPort, se ignora la variable zmbResolvePortConflicts.
    zmbStartingPort
    El valor de puerto inicial desde el que se generan los puertos nuevos.
zmbSetPorts
Defina los valores de puerto que se utilizarán en el nuevo perfil especificando uno de los valores siguientes.
  • useOld

    Reutilizar los valores de puerto que están definidos en el perfil de origen.

  • generateNew

    Establecer valores personalizados para cada puerto en el perfil de destino.

  • startingPort

    Generar puertos nuevos incrementando desde el valor de puerto especificado. Los puertos en conflicto se resuelven automáticamente.

    zmbStartingPort
    El valor de puerto inicial desde el que se generan los puertos nuevos.
zmbSMPEHome
Ubicación del sistema de archivos de productos instalados de WebSphere Application Server Versión 9.0.
zmbTempDirectory
El directorio donde se graba la copia de seguridad de la configuración anterior y el rastreo de migración.

Durante la migración, es preciso realizar una copia de seguridad de la configuración de la versión anterior. La ubicación predeterminada de esta copia de seguridad es /tmp/migrate. Si el sistema de archivos /tmp no tiene suficiente espacio para almacenar la configuración de copia de seguridad, puede especificar otra ubicación. Si opta por sobrescribir la ubicación por omisión de la copia de seguridad, se recomienda mantener el mismo convenio de denominación y únicamente reemplazar la parte /tmp por otra vía de acceso, por ejemplo, /myTemp/migrate.

zmbTimestamp
Identificador que se utilizará para crear un directorio bajo el directorio temporal que contendrá los conjuntos de datos de migración temporales y los datos de configuración de copia de seguridad
zmbToConfigRoot
Punto de montaje de la configuración a la que va a realizar la migración

Es el mismo valor que el especificado para la variable zConfigMountPoint.

zmbToWASHomeDir
Directorio inicial de la configuración a la que va a realizar la migración
zmbWorkspaceRootPreference
Indica si se deben migrar los valores de "Mis tareas" personalizados de la consola administrativa guardados en la ubicación raíz de usuario de espacio de trabajo por omisión (D) o se deben migrar los valores guardados en una ubicación raíz de espacio de trabajo definida por el usuario (U)
zmbUserWorkspaceRoot
Ubicación raíz de espacio de trabajo definida por el usuario

Ejemplo de un archivo de respuestas para migrar un gestor de despliegue

create
EnableIntermediateSymlink=false
EnableJavaTmpDir=true
intermediateSymlinkPreference=N
profileName=default
profilePath=<root>/profiles/ZMigDmgr01
templatePath=<root>/profileTemplates/zos-migDmgr
zConfigHfsName=OMVS.WAS90.CONFIG.HFS
zConfigHfsPrimaryCylinders=420
zConfigHfsSecondaryCylinders=100
zConfigHfsVolume=*
zConfigMountPoint=/wasv9config
zFilesystemType=HFS
zJobStatement1=(ACCTNO,ROOM),'USERID',CLASS=A,REGION=0M
zJobStatement2=//*
zJobStatement3=//*
zJobStatement4=//*
zTargetHLQ=DMR
zmbAdminPassword={xor}BwcHBwcHBwc=
zmbAdminUserid=XXXXXXXX
zmbAppInstallDirLine1=/wasv9config/DeploymentManager/profiles/default/installedApps
zmbAppInstallDirLine2= 
zmbAppMigrationPreference=D
zmbControllerProcName=BBO9DCR
zmbDaemonProcName=BBO9DMN
zmbDisableDmgr=true
zmbEnablePostUpgradeTrace=0
zmbEnablePreUpgradeTrace=0
zmbEnableProfileTrace=0
zmbEnableScriptingTrace=0
zmbFromConfigRoot=/WebSphere/V7R0
zmbFromWASHomeDir=DeploymentManager
zmbInitialHeapSize=512
zmbJavaTempDirectory=/tmp
zmbMaxHeapSize=768
zmbProclibName=SYS1.PROCLIB
zmbReplaceStartedProcedureNames=true
zmbResolvePortConflicts=incrementCurrent
zmbSMPEHome=/usr/lpp/WebSphere/AppServer/V9R0
zmbServantProcName=BBO9DSR
zmbSetPorts=useOld
zmbTempDirectory=/tmp/migrate
zmbTimestamp=05171857
zmbToConfigRoot=/wasv9config
zmbToWASHomeDir=DeploymentManager
zmbWorkspaceRootPreference=D

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-zos&topic=cmig_zmmt_cmd_depmanvar
File name: cmig_zmmt_cmd_depmanvar.html