AWS Il servizio di modernizzazione del mainframe (esperienza Managed Runtime Environment) non è più aperto a nuovi clienti. Per funzionalità simili a AWS Mainframe Modernization Service (esperienza Managed Runtime Environment), esplora AWS Mainframe Modernization Service (Self-Managed Experience). I clienti esistenti possono continuare a utilizzare il servizio normalmente. [Per ulteriori informazioni, consulta AWS Modifica della disponibilità di Mainframe Modernization.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Installare un agente di trasferimento file
È possibile utilizzare questo documento come step-by-step guida per installare un agente sul mainframe di origine.
**Nota**
Questa guida è destinata solo ai programmatori di sistemi mainframe.
**Topics**
+ [Fase 1: Creare un set di dati ZfS per M2-Agent](#allocate-dataset)
+ [Fase 2: Formattare il set di dati come ZFs](#format-dataset)
+ [Fase 3: Montare il filesystem](#mount-filesystem)
+ [Fase 4: Verificare il montaggio](#verify-mount)
+ [Fase 5: Inserire OMVS](#enter-omvs)
+ [Passaggio 6: Impostare la variabile di ambiente della directory di installazione dell'agente](#agent-directory)
+ [Fase 7: Impostare la variabile di ambiente della directory di lavoro](#work-directory)
+ [Fase 8: Creare la cartella di lavoro](#create-work-directory)
+ [Fase 9: Copiare il file tar dell'agente e copiare la directory di lavoro](#agent-tar-package)
+ [Fase 10: Completare l'installazione dell'agente](#finish-agent-installation)
## Fase 1: Creare un set di dati ZfS per M2-Agent
Create uno ZfS per l'installazione di M2-Agent utilizzando il seguente JCL (Job Control Language):
```
DEFINE EXEC PGM=IDCAMS
SYSPRINT DD SYSOUT=A
SYSIN DD *
DEFINE CLUSTER (NAME(yourhlq.M2AGENT.ZFS) -
VOLUMES(*) -
LINEAR CYL(1000 200))
```
## Fase 2: Formattare il set di dati come ZFs
Dopo aver creato il set di dati, formattatelo come file system ZfS.
Un modo per farlo è usare il seguente JCL:
```
FORMAT EXEC PGM=IOEAGFMT,
PARM=('-aggregate yourhlq.M2AGENT.ZFS -size 1200') ,
SYSPRINT DD SYSOUT=*
```
Invia questo lavoro e controlla se è stato completato con successo.
## Fase 3: Montare il filesystem
Per montare il filesystem, usa il comando. `MOUNT` È possibile montare il filesystem nella riga di comando in ISPF o in batch.
Esempio:
```
MOUNT FILESYSTEM('yourhlq.M2AGENT.ZFS') TYPE(ZFS) MODE(RDWR) MOUNTPOINT('/usr/lpp/aws/m2-agent')
```
Utilizzerai questo punto di montaggio nel passaggio 6.
**Nota**
La definizione del percorso di montaggio è facoltativa e a tale scopo è necessario utilizzare una directory esistente.
## Fase 4: Verificare il montaggio
Verificate che il filesystem sia montato correttamente usando il `D OMVS,F` comando o controllando all'interno di Unix System Service (USS).
## Fase 5: Inserire OMVS
Usa il seguente comando per inserire OMVS:
```
TSO OMVS
```
## Passaggio 6: Impostare la variabile di ambiente della directory di installazione dell'agente
Utilizzate il comando seguente per impostare l'ambiente della directory di installazione dell'agente:
```
export AGENT_DIR=/usr/lpp/aws/m2-agent
```
**Nota**
Il punto di montaggio è definito nel passaggio 3.
## Fase 7: Impostare la variabile di ambiente della directory di lavoro
Utilizzate il seguente comando per impostare la variabile di ambiente della directory di lavoro:
```
export WORK_DIR=$AGENT_DIR/tmp
```
## Fase 8: Creare la cartella di lavoro
Utilizzate il seguente comando per impostare l'ambiente della directory di lavoro:
```
mkdir -p $WORK_DIR
```
## Fase 9: Copiare il file tar dell'agente e copiare la directory di lavoro
Scarica il file tar dell'agente da AWS utilizzando il [collegamento all'agente M2](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar).
Il meccanismo di trasferimento dipenderà dal tuo ambiente, ma assicurati che il file tar venga trasferito in modalità binaria.
## Fase 10: Completare l'installazione dell'agente
Segui questi passaggi per completare l'installazione dell'agente.
1. Imposta la variabile di ambiente della versione m2-agent sulla versione attualmente in fase di installazione utilizzando il seguente comando:
```
export M2_AGENT_VERSION=1.0.0
```
1. Estrai il pacchetto agent tar usando il seguente comando:
```
tar -xpf m2-agent-$M2_AGENT_VERSION.tar -C $AGENT_DIR
```
1. Create un collegamento `current-version` simbolico alla directory di installazione dell'agente corrente con il seguente comando:
```
ln -s $AGENT_DIR/m2-agent-v$M2_AGENT_VERSION $AGENT_DIR/current-version
```
1. Aggiorna e invia `CPY#PDS` per creare i set di dati dell'agente File Transfer.
**Nota**
JCL utilizza il. `SYS2.AWS.M2 HLQ`
Per creare l'agente File Transfer, aggiorna le tre variabili simboliche HLQ (High level qualifier) e utilizzale `VOLSER` successivamente in `AGNTPATH` JCL:
```
oedit $AGENT_DIR/current-version/installation/CPY#PDS
```
**Nota**
Questo JCL è personalizzato per configurare alcuni aspetti dell'installazione dell'agente sul mainframe. Alloca i set di dati necessari e quindi copia file specifici dal file system Unix a questi set di dati.