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 (Self-ManagedExperience). 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 de AWS mainframes](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.