AWS El servicio de modernización de mainframes (experiencia en entornos de ejecución gestionados) ya no está abierto a nuevos clientes. Para obtener prestaciones similares a las del Servicio de Modernización de AWS Mainframe (experiencia en entornos de ejecución gestionados), explore el Servicio de Modernización de AWS Mainframe (experiencia autogestionada). Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de la modernización del [AWS mainframe.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Instalación de un agente de File Transfer
Puede utilizar este documento como step-by-step guía para instalar un agente en el mainframe de origen.
**nota**
Esta guía está destinada únicamente a los programadores de sistemas de mainframe.
**Topics**
+ [Paso 1: creación de un conjunto de datos de zFS para M2-agent](#allocate-dataset)
+ [Paso 2: formateo del conjunto de datos como zFS](#format-dataset)
+ [Paso 3: montaje del sistema de archivos](#mount-filesystem)
+ [Paso 4: verificación del montaje](#verify-mount)
+ [Paso 5: introducción de OMV](#enter-omvs)
+ [Paso 6: establecimiento de la variable de entorno del directorio de instalación del agente](#agent-directory)
+ [Paso 7: establecimiento de la variable de entorno del directorio de trabajo](#work-directory)
+ [Paso 8: creación del directorio de trabajo](#create-work-directory)
+ [Paso 9: copia del archivo tar del agente y del directorio de trabajo](#agent-tar-package)
+ [Paso 10: Finalizar la instalación del agente](#finish-agent-installation)
## Paso 1: creación de un conjunto de datos de zFS para M2-agent
Cree un zFS para la instalación de M2-agent utilizando el JCL (Lenguaje de control de tareas) que se muestra a continuación:
```
DEFINE EXEC PGM=IDCAMS
SYSPRINT DD SYSOUT=A
SYSIN DD *
DEFINE CLUSTER (NAME(yourhlq.M2AGENT.ZFS) -
VOLUMES(*) -
LINEAR CYL(1000 200))
```
## Paso 2: formateo del conjunto de datos como zFS
Después de crear el conjunto de datos, formatéelo como sistema de archivos zFS.
Una manera de hacerlo es mediante el siguiente JCL:
```
FORMAT EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD SYSOUT=*
```
Envíe este trabajo y compruebe si se ha completado correctamente.
## Paso 3: montaje del sistema de archivos
Para montar el sistema de archivos, utilice el comando `MOUNT`. Puede montar el sistema de archivos en la línea de comandos, en la ISPF o por lotes.
Por ejemplo:
```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```
Utilizará este punto de montaje en el paso 6.
**nota**
La definición de la ruta de montaje es opcional y, para ello, debe utilizar un directorio existente.
## Paso 4: verificación del montaje
Verifique que el sistema de archivos esté montado correctamente mediante un comando `D OMVS,F` o comprobándolo en el Servicio de Sistema Unix (USS).
## Paso 5: introducción de OMV
Utilice el siguiente comando para introducir OMV:
```
TSO OMVS
```
## Paso 6: establecimiento de la variable de entorno del directorio de instalación del agente
Utilice el siguiente comando para definir el entorno del directorio de instalación del agente:
```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```
**nota**
El punto de montaje se define en el paso 3.
## Paso 7: establecimiento de la variable de entorno del directorio de trabajo
Utilice el siguiente comando para definir la variable de entorno del directorio de trabajo:
```
export WORK_DIR=$AGENT_DIR/tmp
```
## Paso 8: creación del directorio de trabajo
Utilice el siguiente comando para definir el entorno del directorio de trabajo:
```
mkdir -p $WORK_DIR
```
## Paso 9: copia del archivo tar del agente y del directorio de trabajo
Descargue el archivo tar del agente de AWS mediante el [enlace del agente M2](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar).
El mecanismo de transferencia dependerá del entorno, pero asegúrese de que el archivo tar se transfiera en modo binario.
## Paso 10: Finalizar la instalación del agente
Siga estos pasos para finalizar la instalación del agente:
1. Establezca la variable de entorno de la versión m2-agent en la versión que se esté instalando actualmente mediante el siguiente comando:
```
export M2_AGENT_VERSION=1.0.0
```
1. Extraiga el paquete tar del agente con el siguiente comando:
```
tar -xpf m2-agent-$M2_AGENT_VERSION.tar -C $AGENT_DIR
```
1. Cree un enlace simbólico `current-version` al directorio de instalación del agente actual con el siguiente comando:
```
ln -s $AGENT_DIR/m2-agent-v$M2_AGENT_VERSION $AGENT_DIR/current-version
```
1. Actualice y envíe `CPY#PDS` para crear los conjuntos de datos del agente de File Transfer.
**nota**
JCL usa `SYS2.AWS.M2 HLQ`.
Para crear el agente de File Transfer, actualice las tres variables simbólicas HLQ (calificador de alto nivel), `VOLSER` y `AGNTPATH` para usarlas más adelante en el JCL:
```
oedit $AGENT_DIR/current-version/installation/CPY#PDS
```
**nota**
Este JCL está diseñado para configurar ciertos aspectos de la instalación del agente en el mainframe. Asigna los conjuntos de datos necesarios y, a continuación, copia archivos específicos del sistema de archivos Unix a estos conjuntos de datos.