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à. # Trasferimento di file nella modernizzazione del AWS mainframe AWS Mainframe Modernization File Transfer consente di trasferire e convertire set di dati mainframe in Amazon S3 per casi d'uso di modernizzazione, migrazione e potenziamento del mainframe. Semplifica il processo di trasferimento dei set di dati dal mainframe al. Cloud AWS Le caratteristiche principali includono: individuazione dei set di dati e degli artefatti mainframe di origine e scalabilità ed efficienza per trasferimenti di dati più rapidi verso Amazon S3. File Transfer supporta vari tipi di set di dati mainframe come sequential, PDS, GDS, GDG e VSAM KSDS. Il servizio trasferisce i set di dati in un bucket Amazon S3 intermedio, li converte nella tabella codici di destinazione specificata e quindi li sposta nel bucket S3 di destinazione desiderato. **Topics** + [ # Cos'è AWS Mainframe Modernization File Transfer? ](what-is-filetransfer.md) + [ # Installare un agente di trasferimento file ](m2-agent-installation.md) + [ # Configurare un agente di trasferimento file ](m2-agent-configuration.md) + [ # Crea endpoint di trasferimento dati per File Transfer ](filetransfer-data-transfer-endpoints.md) + [ # Crea attività di trasferimento in File Transfer ](filetransfer-transfer-tasks.md) + [ # Tutorial: Come iniziare a usare AWS Mainframe Modernization File Transfer ](tutorial-filetransfer-getting-started.md) + [ # Codifiche di origine e destinazione supportate in AWS Mainframe Modernization File Transfer ](filetransfer-encodings.md) # Cos'è AWS Mainframe Modernization File Transfer? Con AWS Mainframe Modernization File Transfer, puoi trasferire e convertire set di dati e file con un servizio completamente gestito per accelerare e semplificare i casi d'uso di modernizzazione, migrazione e potenziamento verso il servizio di AWS modernizzazione del mainframe e Amazon S3. **Topics** + [ ## Vantaggi del trasferimento di file per la modernizzazione dei mainframe di AWS ](#filetransfer-benefit-overview) + [ ## Come funziona AWS Mainframe Modernization File Transfer ](#filetransfer-how) ## Vantaggi del trasferimento di file per la modernizzazione dei mainframe di AWS AWS Mainframe Modernization File Transfer ti aiuta a trasferire set di dati dal mainframe ad Amazon S3. Alcuni vantaggi includono: + Scoperta dei set di dati e degli artefatti mainframe di origine + Trasferimenti automatici e conversione di set di dati + Scalabilità, efficienza e velocità per ottenere trasferimenti di set di dati più rapidi verso AWS ## Come funziona AWS Mainframe Modernization File Transfer La figura seguente è una panoramica di come funziona AWS Mainframe Modernization File Transfer a livello concettuale. ![\[Il modo in cui funziona per la funzionalità File Transfer con diverse fasi.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/filetransfer-overview.png) La figura seguente è una panoramica dell'architettura della funzionalità AWS Mainframe Modernization File Transfer. ![\[Panoramica dell'architettura della funzionalità File Transfer che rappresenta il trasferimento di dati tra mainframe e Region. Cloud AWS\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/filetransfer-architecture.png) # 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. # Configurare un agente di trasferimento file Dopo aver installato un agente di trasferimento file, segui questi passaggi per configurare l'agente. Se devi installare un nuovo agente, segui le istruzioni riportate nella [Installare un agente di trasferimento file](m2-agent-installation.md) pagina. **Topics** + [ ## Passaggio 1: Configurazione delle autorizzazioni e Started Task Control (STC) ](#configure-permissions) + [ ## Fase 2: creazione di bucket Amazon S3 ](#filetransfer-s3-buckets) + [ ## Fase 3: Creare una chiave di crittografia gestita AWS KMS dal cliente ](#filetransfer-kms-encryption) + [ ## Fase 4: Creare un Gestione dei segreti AWS segreto per le credenziali del mainframe ](#filetransfer-secret-manager) + [ ## Fase 5: Creare una policy IAM ](#filetransfer-IAM-policy) + [ ## Fase 6: Creare un utente IAM con credenziali di accesso a lungo termine ](#filetransfer-create-IAM-user) + [ ## Fase 7: Creare un ruolo IAM che l'agente deve assumere ](#filetransfer-create-IAM-role) + [ ## Fase 8: Configurazione dell'agente ](#agent-configuration) ## Passaggio 1: Configurazione delle autorizzazioni e Started Task Control (STC) 1. Aggiorna e invia uno dei seguenti `SYS2.AWS.M2.SAMPLIB(SEC#RACF)` (per la configurazione delle autorizzazioni RACF) o `SYS2.AWS.M2.SAMPLIB(SEC#TSS)` (per l'impostazione delle autorizzazioni TSS) in base alle relative istruzioni. Questi membri sono stati creati nel passaggio precedente. `CPY#PDS` **Nota** `SYS2.AWS.M2`deve essere sostituito con il qualificatore di alto livello (HLQ) scelto durante l'installazione. 1. Aggiorna l'esportazione PWD in `SYS2.AWS.M2.SAMPLIB(M2AGENT)` STC JCL, se il percorso di directory predefinito dell'agente File Transfer () è stato modificato. `/usr/lpp/aws/m2-agent` 1. Aggiorna il PROC in base agli standard del tuo sito: 1. Aggiorna la scheda PROC in base ai requisiti di installazione. 1. Aggiorna STEPLIB con. `M2 LOADLIB PDSE ALIAS` 1. Modifica PWD per indicare il percorso di installazione dell'agente (è incluso solo questo). 1. Aggiorna `JAVA_HOME` se necessario. 1. Aggiorna e copia il `SYS2.AWS.M2.SAMPLIB(M2AGENT)` JCL in `SYS1.PROCLIB` uno dei file della tua PROCLIBs `PROCLIB` concatenazione. 1. Aggiungete `SYS2.AWS.M2.LOADLIB` all'elenco APF usando il seguente comando: ``` SETPROG APF ADD DSNAME(SYS2.AWS.M2.LOADLIB) SMS ``` 1. Imposta il gruppo e il proprietario dell'agente sull'agente user/group (M2USER/M2GROUP). Usa il seguente comando in OMVS: ``` chown -R M2USER:M2GROUP $AGENT_DIR/current-version ``` **Nota** Modifica M2USER e M2GROUP con i nomi che hai usato nel processo delle definizioni di sicurezza. ## Fase 2: creazione di bucket Amazon S3 AWS Mainframe Modernization File Transfer richiede un bucket Amazon S3 intermedio come area di lavoro. Ti consigliamo di creare un bucket specifico per questo scopo. Facoltativamente, crea un nuovo bucket Amazon S3 di destinazione per i set di dati trasferiti. Altrimenti puoi anche usare il tuo bucket Amazon S3 esistente. Per ulteriori informazioni sulla creazione di bucket Amazon S3, consulta [Creazione](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) di un bucket. ## Fase 3: Creare una chiave di crittografia gestita AWS KMS dal cliente **Per creare una chiave gestita dal cliente in AWS KMS** 1. Apri la AWS KMS console all'indirizzo[https://console.aws.amazon.com/kms](https://console.aws.amazon.com/kms). 1. Scegli **Customer managed keys** nel riquadro di navigazione a sinistra. 1. Scegli **Crea chiave**. 1. In **Configura chiave**, scegli **Tipo di chiave** come **Simmetrico** e **Utilizzo della chiave** come Crittografa e **decrittografa**. Usa altre configurazioni predefinite. 1. Scegli **Next (Successivo)**. 1. In **Aggiungi etichette**, aggiungi alias e descrizione per la tua chiave. 1. Scegli **Next (Successivo)**. 1. In **Definisci le autorizzazioni amministrative chiave**, scegli almeno un utente e un ruolo IAM che amministra questa chiave. 1. Scegli **Next (Successivo)**. 1. Facoltativamente, in **Definisci le autorizzazioni amministrative chiave**, scegli almeno un utente e un ruolo IAM che può utilizzare questa chiave. 1. Scegli **Next (Successivo)**. 1. **Nella sezione **Modifica politica chiave**, scegli **Modifica** e aggiungi la seguente sintassi alla politica chiave.** Ciò consente al servizio AWS Mainframe Modernization di leggere e utilizzare queste chiavi per la crittografia/decrittografia. **Importante** Aggiungere l'istruzione alle istruzioni esistenti. Non sostituire ciò che è già contenuto nella politica. ``` { "Sid" : "Enable AWS M2 File Transfer Permissions", "Effect" : "Allow", "Principal" : { "Service" : "m2.amazonaws.com" }, "Action" : [ "kms:Encrypt", "kms:Decrypt" ], "Resource" : "*" }, ``` 1. Scegli **Next (Successivo)**. 1. Nella pagina **Revisione**, controlla tutti i dettagli e scegli **Fine**. Copia e salva l'ARN per la chiave gestita dal cliente aprendo la chiave KMS appena creata. Verrà utilizzato nella politica in un secondo momento. ## Fase 4: Creare un Gestione dei segreti AWS segreto per le credenziali del mainframe Le credenziali del mainframe sono necessarie per accedere ai set di dati da trasferire e queste devono essere archiviate come segrete. Gestione dei segreti AWS **Per creare un segreto Gestione dei segreti AWS** 1. Apri la console di gestione di Secrets all'indirizzo[https://console.aws.amazon.com/secretsmanager](https://console.aws.amazon.com/secretsmanager). 1. Scegli **Archivia un nuovo segreto**. 1. In **Scegli il tipo di segreto**, scegli **Altro tipo di segreto**. 1. Utilizzate il valore chiave `userId` per l'UserID del mainframe che ha accesso ai set di dati. Utilizzate il valore chiave `password` per il campo della password. 1. Per la **chiave di crittografia**, scegli la chiave gestita AWS dal cliente creata in precedenza. 1. Scegli **Next (Successivo)**. 1. Nella pagina **Configura segreto**, fornisci un nome e una descrizione. 1. Nella stessa pagina, modifica le **autorizzazioni delle risorse** e utilizza la seguente politica delle risorse in modo che il servizio di modernizzazione del AWS mainframe possa accedervi. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement" : [ { "Effect" : "Allow", "Principal" : { "Service" : "m2.amazonaws.com" }, "Action" : [ "secretsmanager:GetSecretValue", "secretsmanager:DescribeSecret" ], "Resource" : "*" } ] } ``` ------ 1. Scegli **Salva per salvare** le autorizzazioni aggiornate. 1. Scegli **Next (Successivo)**. 1. **Passa alla pagina **Configura le rotazioni** e scegli Avanti.** 1. Nella pagina **Revisione**, controlla tutte le configurazioni e scegli **Store** per salvare il segreto. **Importante** Le chiavi `password` segrete `userId` e le chiavi segrete fanno distinzione tra maiuscole e minuscole e devono essere immesse come mostrato. ## Fase 5: Creare una policy IAM **Per creare una nuova policy con le autorizzazioni richieste per l'agente** 1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam). 1. Scegli **Politiche** in **Gestione degli accessi**. 1. Scegli **Crea policy**. 1. Nella pagina **Specificare le autorizzazioni**, in **Policy editor**, passa dall'editor visuale all'editor JSON e sostituisci il contenuto con il seguente modello: 1. Sostituisci gli `111122223333` ARN presenti nella coda di richiesta e nella coda di risposta con il tuo account. **Nota** Si tratta di ARN wildcard che corrispondono alle due code Amazon SQS create durante l'inizializzazione dell'endpoint di trasferimento dati. Dopo aver creato un endpoint File Transfer, puoi facoltativamente sostituire questi ARN con i valori effettivi di Amazon SQS. 1. Sostituisci `file-transfer-endpoint-intermediate-bucket-arn` con l'ARN del bucket di trasferimento creato in precedenza. Lascia il carattere jolly «/\$1» alla fine. 1. Sostituisci `kms-key-arn` con l'ARN della AWS KMS chiave creata in precedenza. 1. Scegli **Next (Successivo)**. 1. Nella pagina **Rivedi e crea**, aggiungi il nome e la descrizione della politica. 1. Scegli **Crea policy**. ## Fase 6: Creare un utente IAM con credenziali di accesso a lungo termine Crea un utente IAM che consenta all'agente mainframe di connettersi al tuo AWS account. L'agente si connetterà con questo utente e quindi assumerà un ruolo da te definito con le autorizzazioni per utilizzare le code di risposta e richiesta di Amazon SQS e per salvare i set di dati nei bucket Amazon S3. **Per creare questo utente IAM** 1. Accedi alla console IAM all'indirizzo[https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam). 1. Scegli **Utenti** in **Gestione degli accessi**. 1. Selezionare **Create user (Crea utente)**. 1. Aggiungi un **nome utente** significativo in **Dettagli utente**. Ad esempio, `Configure-ft-agent`. 1. Scegli **Next (Successivo)**. 1. Nelle **opzioni di autorizzazione**, scegli l'opzione **Allega direttamente le politiche** ma non allegare alcuna politica di autorizzazione. Queste autorizzazioni saranno gestite da un ruolo che verrà allegato. 1. Scegli **Next (Successivo)**. 1. Controlla i dettagli e scegli **Crea utente**. 1. Una volta creato l'utente, scegli l'utente e apri la scheda **Credenziali di sicurezza**. 1. In **Chiavi di accesso**, seleziona **Crea chiave di accesso**. 1. Quindi, scegli **Altro** quando richiesto per il caso d'uso. 1. Scegli **Next (Successivo)**. 1. Facoltativamente, puoi impostare un tag descrittivo come,. `Access key for configuring file transfer agent` 1. Selezionare **Create access key (Crea chiave di accesso)**. 1. Copia e salva in modo sicuro la chiave di **accesso generata e la chiave** di **accesso segreta**. Questi verranno utilizzati in seguito. Per ulteriori informazioni sulla creazione della chiave di accesso IAM, consulta [Gestione delle chiavi di accesso per gli utenti IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html). **Importante** Salva la **chiave di accesso** e la **chiave di accesso segreta** visualizzate nell'ultima pagina della procedura guidata per la creazione delle chiavi di accesso, prima di scegliere **Fine**. Queste chiavi vengono utilizzate per configurare l'agente mainframe e non possono essere recuperate in seguito. **Nota** Salva l'ARN dell'utente IAM utilizzato per impostare una relazione di trust con un ruolo IAM. ## Fase 7: Creare un ruolo IAM che l'agente deve assumere **Per creare un nuovo ruolo IAM per l'agente** 1. Scegli **Ruoli** nella console IAM all'indirizzo[https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam). 1. Scegli **Crea ruolo**. 1. Nella pagina **Seleziona un'entità affidabile**, scegli **Criteri di attendibilità personalizzati** **per il tipo di entità affidabile**. 1. Sostituisci la politica di fiducia personalizzata con la seguente e `` sostituiscila con l'ARN dell'utente creato in precedenza. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "FileTransferAgent", "Effect": "Allow", "Principal": { "AWS": "" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Scegli **Next (Successivo)**. 1. In **Aggiungi autorizzazioni**, filtra in base al **nome della politica** che hai creato in precedenza e selezionalo. 1. Scegli **Next (Successivo)**. 1. Assegna un nome al ruolo e scegli **Crea ruolo**. **Nota** Salva il *nome del ruolo*, che utilizzerai in seguito per configurare l'agente mainframe. ## Fase 8: Configurazione dell'agente **Per configurare l'agente File Transfer** 1. Accedi a `$AGENT_DIR/current-version/config`. 1. Modifica il file di configurazione dell'agente `appication.properties` per aggiungere una configurazione degli ambienti utilizzando il seguente comando: ``` oedit $AGENT_DIR/current-version/config/application.properties ``` Esempio: ``` agent.environments[0].account-id= agent.environments[0].agent-role-name= agent.environments[0].access-key-id= agent.environments[0].secret-access-id= agent.environments[0].bucket-name= agent.environments[0].environment-name= agent.environments[0].region= zos.complex-name= ``` Dove: + `AWS_ACCOUNT_ID`è l'ID dell' AWS account. + `AWS_IAM_ROLE_NAME`è il nome del ruolo IAM creato in[Fase 7: Creare un ruolo IAM che l'agente deve assumere](#filetransfer-create-IAM-role). + `AWS_IAM_ROLE_ACCESS_KEY`è la chiave di accesso dell'utente IAM creato in[Fase 6: Creare un utente IAM con credenziali di accesso a lungo termine](#filetransfer-create-IAM-user). + `AWS_IAM_ROLE_SECRET_KEY`è la chiave segreta di accesso per l'utente IAM creato in[Fase 6: Creare un utente IAM con credenziali di accesso a lungo termine](#filetransfer-create-IAM-user). + `AWS_S3_BUCKET_NAME`è il nome del bucket di trasferimento creato con l'endpoint di trasferimento dati. + `AWS_REGION`è la regione in cui si configura l'agente File Transfer. **Nota** È possibile fare in modo che l'agente File Transfer venga trasferito su più regioni e account AWS definendo più ambienti. + (Facoltativo). `zos.complex-name`è il nome complesso che hai creato durante la creazione di un endpoint File Transfer. **Nota** Questo campo è necessario solo se desideri personalizzare il nome complesso (che per impostazione predefinita è il nome sysplex) che è lo stesso che hai definito durante la creazione dell'endpoint File Transfer. Per ulteriori informazioni, consulta [Crea endpoint di trasferimento dati per File Transfer](filetransfer-data-transfer-endpoints.md). **Importante** Possono esserci diverse sezioni di questo tipo, purché l'indice tra parentesi — `[0]` sia incrementato per ciascuna di esse. È necessario riavviare l'agente per rendere effettive le modifiche. **Requisiti** 1. Quando un parametro viene aggiunto o rimosso, l'agente deve essere arrestato e avviato. Avvia l'agente di trasferimento file utilizzando il seguente comando nella CLI: ``` /S M2AGENT ``` Per arrestare l'agente M2, utilizzate il seguente comando nella CLI: ``` /P M2AGENT ``` 1. È possibile configurare l'agente File Transfer per trasferire dati a più regioni e account AWS definendo le voci di ambiente. **Nota** Sostituite i valori con i valori dei parametri creati e configurati in precedenza. ``` #Region 1 agent.environments[0].account-id=AWS_ACCOUNT_ID agent.environments[0].agent-role-name=AWS_IAM_ROLE_NAME agent.environments[0].access-key-id=AWS_IAM_ROLE_ACCESS_KEY agent.environments[0].secret-access-id=AWS_IAM_ROLE_SECRET_KEY agent.environments[0].bucket-name=AWS_S3_BUCKET_NAME agent.environments[0].environment-name=AWS_REGION agent.environments[0].region=AWS_REGION #Region 2 agent.environments[1].account-id=AWS_ACCOUNT_ID agent.environments[1].agent-role-name=AWS_IAM_ROLE_NAME agent.environments[1].access-key-id=AWS_IAM_ROLE_ACCESS_KEY agent.environments[1].secret-access-id=AWS_IAM_ROLE_SECRET_KEY agent.environments[1].bucket-name=AWS_S3_BUCKET_NAME agent.environments[1].environment-name=AWS_REGION agent.environments[1].region=AWS_REGION ``` # Crea endpoint di trasferimento dati per File Transfer Gli endpoint di trasferimento dati consentono la connettività con il mainframe di origine e supportano alta disponibilità, scalabilità e gestione semplificata degli agenti. I singoli agenti sono installati sul mainframe LPARs e possono essere raggruppati in un endpoint di trasferimento dati. Quando viene effettuata una richiesta di trasferimento di un set di dati, un agente nell'endpoint di trasferimento dati gestirà quel trasferimento specifico. Per avviare i trasferimenti di dati, almeno un agente sull'endpoint di trasferimento dati deve essere online. Questa procedura presuppone che siano stati completati i passaggi indicati in [Configurazione per la modernizzazione del AWS mainframe](setting-up.md) [Configurazione dell'agente di trasferimento file sul](tutorial-filetransfer-getting-started.md#filetransfer-configure) mainframe di origine. ## Crea endpoint per il trasferimento dei dati Per creare endpoint di trasferimento dati per File Transfer, segui questi passaggi nella console di modernizzazione del AWS mainframe. **Per creare un endpoint per il trasferimento dei dati** 1. Apri la console di modernizzazione del AWS mainframe all'indirizzo. [https://console.aws.amazon.com/m2/](https://console.aws.amazon.com/m2/) 1. Nel Regione AWS selettore, scegli la regione in cui desideri trasferire i file dal mainframe a un bucket Amazon S3. 1. **Nella pagina **Endpoint di trasferimento dati**, in Trasferimento **file, scegli Crea endpoint di trasferimento** dati.** 1. Nella pagina **Prerequisiti dell'endpoint di trasferimento dati**, leggi tutte le istruzioni per assicurarti di aver completato questi passaggi sul mainframe di origine. **Una volta confermato, scegli Avanti.** 1. Nella pagina **Configura l'endpoint di trasferimento dati**, aggiungi le informazioni di base per il tuo endpoint di trasferimento dati. 1. Nella sezione delle informazioni di base, inserisci il nome dell'endpoint di trasferimento dati. **Nota** Il nome dell'endpoint di trasferimento dati deve corrispondere al nome Sysplex, a meno che non si specifichi un nome complesso nella configurazione dell'agente. 1. Descrizione facoltativa 1. La chiave KMS utilizzata per crittografare il segreto. **Nota** È necessario aggiungere la seguente politica basata sulle risorse per KMS in modo che il servizio di modernizzazione del AWS mainframe possa leggere e utilizzare queste chiavi per la crittografia/decrittografia: ``` { "Sid" : "Enable AWS M2 Permissions", "Effect" : "Allow", "Principal" : { "Service" : "m2.amazonaws.com" }, "Action" : [ "kms:Encrypt", "kms:Decrypt" ], "Resource" : "*" } ``` 1. **Specificate la posizione S3 per i dati intermedi**, che è la posizione S3 intermedia in cui vengono archiviati i set di dati trasferiti dal mainframe prima di essere convertiti e trasferiti nel bucket Amazon S3 di destinazione. . **Nota** Si consiglia di creare un nuovo bucket Amazon S3 per le attività di trasferimento. Per ulteriori informazioni, consulta [Creazione di un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html). Puoi anche sfogliare i bucket Amazon S3 esistenti scegliendo l'opzione **Browse** S3. 1. **Dopo aver inserito i campi obbligatori, scegli Avanti.** 1. Nella pagina **Rivedi e crea un endpoint per il trasferimento dei dati**, controlla se hai completato i prerequisiti e rivedi le informazioni di base. Una volta confermato, scegli **Crea endpoint per il trasferimento dei dati**. Verrai reindirizzato alla pagina di **panoramica degli endpoint di trasferimento dati** dove potrai visualizzare l'elenco di tutti gli endpoint di trasferimento dati. Potrai anche vedere gli endpoint di trasferimento dati disponibili o che hanno avuto esito negativo. Puoi anche cercare gli endpoint di trasferimento dati per nome e accedere a informazioni aggiuntive per ogni agente disponibile. # Crea attività di trasferimento in File Transfer Le attività di trasferimento vengono utilizzate per specificare i set di dati da trasferire dal mainframe ad Amazon S3 e consentono di scegliere le opzioni di conversione della tabella codici. Queste istruzioni presuppongono che tu abbia completato i passaggi indicati [Configurazione per la modernizzazione del AWS mainframe](setting-up.md) e che tu abbia creato. [Crea endpoint di trasferimento dati per File Transfer](filetransfer-data-transfer-endpoints.md) **Topics** + [ ## Crea attività di trasferimento ](#filetransfer-console-create-task) + [ ## Visualizza le attività di trasferimento ](#filetransfer-console-view-task) ## Crea attività di trasferimento Per creare attività di trasferimento in File Transfer, segui questi passaggi nella console di modernizzazione del AWS mainframe. **Per creare un'attività di trasferimento** **Importante** È necessario disporre di almeno un endpoint di trasferimento dati per creare nuove attività di trasferimento. 1. Apri la console di modernizzazione del AWS mainframe all'indirizzo. [https://console.aws.amazon.com/m2/](https://console.aws.amazon.com/m2/) 1. Nel Regione AWS selettore, scegli la regione in cui desideri trasferire i file dal mainframe a un bucket Amazon S3. 1. Nella pagina **Attività di trasferimento**, puoi scegliere qualsiasi endpoint di trasferimento dati per creare attività di trasferimento. 1. Nella pagina **Crea attività di trasferimento**, imposta le proprietà per l'operazione di trasferimento. Se non hai creato alcuna attività di trasferimento in precedenza, puoi creare la prima attività scegliendo l'opzione **Crea attività di trasferimento**. + In questa pagina, inserisci le informazioni di base dell'operazione di trasferimento, tra cui il nome, la descrizione e la chiave segreta dell'operazione di trasferimento. **Nota** Crittografa il segreto utilizzando la chiave KMS definita con l'endpoint di trasferimento dati. Il segreto deve contenere le credenziali del mainframe necessarie per accedere ai set di dati sul mainframe utilizzando le chiavi and. `userId` `password` Per ulteriori informazioni, consulta il [segreto di AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html). È necessario configurare la chiave segreta con la seguente politica basata sulle risorse in modo che il servizio di modernizzazione del AWS mainframe possa accedervi per eseguire attività di trasferimento dei dati. **** ``` { "Version":"2012-10-17", "Statement" : [ { "Effect" : "Allow", "Principal" : { "Service" : "m2.amazonaws.com" }, "Action" : [ "secretsmanager:GetSecretValue", "secretsmanager:DescribeSecret" ], "Resource" : "*" } ] } ``` **Nota** La dimensione massima attualmente supportata del set di dati per il trasferimento è 90 GB. + Successivamente, seleziona la posizione del bucket Amazon S3 di destinazione in cui verranno trasferiti i set di dati di destinazione dal mainframe. + Verrà selezionato l'endpoint di trasferimento dati scelto in precedenza. È inoltre possibile selezionare un altro endpoint tra gli endpoint disponibili. 1. Scegli **Next (Successivo)**. 1. Nella pagina **Aggiungi set di dati**, nella sezione **Configurazione dell'attività di trasferimento**, puoi scegliere di configurare l'attività di trasferimento in modalità binaria o di convertire e trasferire i set di dati. + L'opzione **Trasferimento in modalità binaria** consente di trasferire i set di dati ignorando le conversioni delle tabelle codici e conservando i relativi byte RDW (Record Descriptor Word). + L'opzione **Trasferisci e converti i set di dati** consente di trasferire i set di dati impostando le tabelle codici di origine e di destinazione per i set di dati. Puoi vedere le tabelle codici disponibili per File Transfer nella [Codifiche di origine e destinazione supportate in AWS Mainframe Modernization File Transfer](filetransfer-encodings.md) pagina. 1. Inserisci la tua query nel **mainframe Search for data sets** per cercare nel mainframe i set di dati da includere nell'operazione di trasferimento. Scegli **Visualizza set di dati**. I seguenti simboli jolly possono essere utilizzati come parte dei criteri di ricerca dei set di dati per il mainframe: + Un asterisco singolo (\$1) come qualificatore (tra i periodi o dopo l'ultimo periodo) corrisponde a un singolo qualificatore in quella posizione. + Un singolo asterisco (\$1) all'interno di un qualificatore corrisponde a zero o più caratteri in quella posizione. + Un doppio asterisco (\$1\$1) come qualificatore (tra i periodi o dopo l'ultimo periodo) corrisponde a zero o più qualificatori in quella posizione. + Un doppio asterisco (\$1\$1) all'interno di un qualificatore non è un'interrogazione valida. + Un singolo segno di percentuale (%) corrisponde a qualsiasi carattere alfanumerico o nazionale presente in quella posizione. Puoi utilizzare fino all'otto percento in ogni qualificatore. **Nota** Ti consigliamo di terminare sempre i criteri di ricerca con un punto seguito da un doppio asterisco (.\$1\$1) e di affinare ulteriormente la ricerca, se necessario. *Per ulteriori informazioni sulle regole jolly, consulta la sezione [Filtraggio dei nomi dei set di dati](https://www.ibm.com/docs/en/zos/3.1.0?topic=processed-filtering-by-data-set-names) nella documentazione IBM.* 1. Questi set di dati verranno caricati nella sezione **Set di dati Mainframe**, dove puoi cercare o scegliere uno o più set di dati per i quali configurare le conversioni della tabella codici. Questi set di dati scelti verranno visualizzati nella sezione **Set di dati aggiunti**. Se non viene caricato alcun set di dati, è necessario rivisitare il passaggio 7. **Nota** È possibile selezionare set di dati da più query di ricerca e aggiungerli all'attività di trasferimento. 1. Nella sezione **Set di dati aggiunti**, vedrai il nome, il tipo e il nome del volume dei tuoi set di dati. **Importante** Per l'opzione **Trasferisci e converti i set di dati**, devi inserire manualmente la tabella codici sorgente e la tabella codici di destinazione per ciascuno dei set di dati scelti. La *tabella codici sorgente* è il formato del set di dati di origine e la *tabella codici* di destinazione è il formato del set di dati di destinazione utilizzato per convertire i set di dati e archiviarli nel bucket Amazon S3 di destinazione. 1. **Dopo aver confermato i set di dati nella sezione **Set di dati aggiunti** (e le tabelle codici sorgente e di destinazione per l'opzione Trasferisci e converti i set di dati), scegli Avanti.** 1. Nella pagina **Rivedi e crea**, puoi rivedere o modificare le informazioni relative all'attività di trasferimento. 1. Quindi, scegli **Crea attività di trasferimento**. **Importante** Scegliendo il pulsante **Crea attività di trasferimento** verrà avviato il trasferimento dei dati, fatturabile in base alla pagina dei prezzi di [AWS Mainframe Modernization](https://aws.amazon.com/mainframe-modernization/pricing/). Questa fatturazione si basa sulla quantità di dati (GB) trasferiti misurata dalla dimensione del set di dati. ## Visualizza le attività di trasferimento Per visualizzare le attività di trasferimento in File Transfer, è necessario seguire questi passaggi nella console di modernizzazione del AWS mainframe. **Per visualizzare le attività di trasferimento** 1. Apri la console di modernizzazione AWS del mainframe all'indirizzo. [https://console.aws.amazon.com/m2/](https://console.aws.amazon.com/m2/) 1. Nel Regione AWS selettore, scegli la regione in cui desideri trasferire i file dal mainframe a un bucket Amazon S3. 1. Nella pagina **Attività di trasferimento**, seleziona l'endpoint di trasferimento dati per visualizzare le attività di trasferimento. 1. Per gli endpoint con attività di trasferimento preesistenti, queste verranno visualizzate nella sezione Attività di **trasferimento**. Puoi scegliere di visualizzare i dettagli di qualsiasi attività di trasferimento da questo elenco. # Tutorial: Come iniziare a usare AWS Mainframe Modernization File Transfer AWS Mainframe Modernization File Transfer consente di trasferire e convertire set di dati mainframe per casi d'uso di modernizzazione, migrazione e potenziamento del mainframe. Segui i passaggi di questo tutorial per capire come funziona AWS Mainframe Modernization File Transfer. ## Panoramica di File Transfer è composto da quanto segue: 1. Un agente da installare sul mainframe di origine. 1. Accesso alle funzionalità di individuazione, trasferimento e conversione dei set di dati direttamente dalla console del servizio di gestione AWS Mainframe Modernization. Come utente, puoi trasferire set di dati dal mainframe al tuo bucket Amazon S3. **Topics** + [ ## Panoramica di ](#filetransfer-getting-started-overview) + [ ## Passaggio 1: trasferire il pacchetto tar dei binari dell'agente dalla partizione logica del mainframe AWS ](#filetransfer-agent-binaries) + [ ## Fase 2: Configurare l'agente File Transfer sul mainframe di origine ](#filetransfer-configure) + [ ## Fase 3: Creare un endpoint per il trasferimento dei dati ](#filetransfer-data-transfer-endpoint) + [ ## Passaggio 4: Creare un'attività di trasferimento ](#filetransfer-create-transfer-tasks) + [ ## Passaggio 5: Visualizza lo stato di avanzamento dell'operazione di trasferimento ](#view-transfer-tasks) ## Passaggio 1: trasferire il pacchetto tar dei binari dell'agente dalla partizione logica del mainframe AWS [Scarica i file tar dal link tar di M2-Agent.](https://drm0z31ua8gi7.cloudfront.net/filetransfer/m2-agent-v1.0.0.tar) ## Fase 2: Configurare l'agente File Transfer sul mainframe di origine In questa fase, configuri e avvii l'agente AWS Mainframe Modernization File Transfer sul mainframe di origine. L'agente è necessario per facilitare le comunicazioni tra la funzionalità del servizio File Transfer e il mainframe di origine. È richiesto almeno un agente per mainframe. È possibile avviare più di un agente per un'elevata disponibilità e una maggiore scalabilità. Segui le istruzioni riportate nella [Configurare un agente di trasferimento file](m2-agent-configuration.md) guida per completare l'installazione dell'agente File Transfer sul mainframe. ## Fase 3: Creare un endpoint per il trasferimento dei dati Segui i passaggi indicati [Crea endpoint di trasferimento dati per File Transfer](filetransfer-data-transfer-endpoints.md) nella pagina per creare un nuovo endpoint di trasferimento dati. ## Passaggio 4: Creare un'attività di trasferimento Segui i passaggi indicati [Crea attività di trasferimento in File Transfer](filetransfer-transfer-tasks.md) nella pagina per creare e gestire le attività di trasferimento. ## Passaggio 5: Visualizza lo stato di avanzamento dell'operazione di trasferimento È possibile visualizzare lo stato di avanzamento dell'attività di trasferimento nella console di modernizzazione del AWS mainframe. Per maggiori dettagli, consulta la sezione[Visualizza le attività di trasferimento](filetransfer-transfer-tasks.md#filetransfer-console-view-task). # Codifiche di origine e destinazione supportate in AWS Mainframe Modernization File Transfer AWS Mainframe Modernization File Transfer supporta vari tipi di set di dati e opzioni di conversione della tabella codici. ## Tipi di set di dati mainframe AWS Mainframe Modernization File Transfer supporta i seguenti tipi di set di dati mainframe: + Non VSAM: sequenziale (PS), PDS, GDS, GDG + Tipi di VSAM: KSDS ## Pagine codici supportate AWS Mainframe Modernization File Transfer supporta le seguenti code page per la conversione di set di dati (da/a): "BIG5", "BIG5\$1HKSCS», «CESU\$18", «EUC\$1JP», «EUC\$1KR», "", "", «GBK», GB18030 "GB2312", "", ",", ",IBM00858", ",IBM01140", ",IBM01141" ","IBM01142, "IBM01143", ",IBM01144", ",IBM01145", ",IBM01146", ",IBM01147", ",IBM01148", ",IBM01149", ",IBM037"», IBM1026 ",", IBM1047 ",IBM273"», ",IBM277", "», IBM278 ",IBM280"», ",IBM284", IBM285 "», "», IBM290 "", IBM297 "", IBM420 "", "IBM424", "IBM437", "", IBM500 "", IBM775 "",» IBM850"," IBM852 "," ",IBM855" ",IBM857" "," IBM860 ",", IBM861 "", IBM862 "," ",IBM863", "IBM864", "IBM865", "", IBM866 "", IBM868 "", "IBM869IBM870", «IBM\$1THAI», «ISO\$12022\$1CN», «ISO\$12022\$1JP», «ISO\$12022\$1JP\$12", «ISO\$12022\$1IT», «ISO\$12022\$1IT», «ISO\$12022\$1IT», «ISO\$18859\$11", «ISO\$18859\$113", «ISO\$18859\$115", «ISO\$18859\$116", «ISO\$18859\$12", «ISO\$18859\$13", «ISO\$18859\$14", «ISO\$18859\$15", «ISO\$18859\$16", «ISO\$18859\$17", «ISO\$18859\$17", «ISO\$18859\$17" 8", «ISO\$18859\$19", "JIS\$1X0201", «JIS\$1X0212\$11990",» IBM871 IBM918 KOI8\$1R», "KOI8\$1U», «SHIFT\$1JIS», «TIS\$1620", «US\$1ASCII», «UTF\$116", «UTF\$116BE», «UTF\$116LE», «UTF\$132", «UTF\$132BE», «UTF\$132LE», «UTF\$18", «WINDOWS\$11250", «WINDOWS\$11250", «WINDOWS\$11250", «WINDOWS\$112\$112" 51", «WINDOWS\$11252", «WINDOWS\$11253", "WINDOWS\$11254", «WINDOWS\$11255", «WINDOWS\$11256", «WINDOWS\$11257", «WINDOWS\$11258", «WINDOWS\$131J», «BIG5X\$1\$1HKSCS\$12001", «BIG5X\$1\$1SOLARIS», «X\$1EUCJPOPEN», «X\$1EUC\$1JP\$1LINUX», «X\$1EUC\$1TW», «X\$1", «X\$1", «X\$1IBM1006", «X\$1IBM1025", «X\$1", «X\$1IBM1046", «X\$1IBM1097» IBM1098 IBM1112 IBM1122 IBM1123", «X\$1IBM1124", «X\$1IBM1129", «X\$1", «X\$1IBM1166", «X\$1IBM1364", «X\$1IBM1381», «X\$1 IBM29626 C», «X\$1IBM1383", «X\$1", «X\$1IBM300", «X\$1IBM33722", «X\$1", «X\$1IBM737", «X\$1IBM833", «X\$1IBM834", «X\$1", «X\$1IBM856", «X\$1IBM874", «X\$1IBM875», «X\$1IBM921», «X\$1», «X\$1IBM922», «X\$1IBM930», «X\$1IBM933», «X\$1», «X\$1IBM935», «X\$1IBM937», «X\$1» \$1 IBM939 ", «X\$1IBM942", «X\$1", «X\$1IBM943", «X\$1 IBM942 C», «X\$1", «X\$1 IBM943 C», «X\$1 IBM948IBM949", «X\$1", «X\$1 IBM949 C», «X\$1IBM950", «X\$1IBM964", «X\$1IBM970", «X\$1ISCII91", «X\$1ISO\$12022\$1CN\$1CNS», «X\$1ISO\$12022\$1CN\$1GB», «X\$1ISO\$18859\$111", «X\$1JIS0208", «X\$1JISAUTODETECT», «X\$1JOHAB», «X\$1MACARABIC», «X\$1MACARABIC», «X\$1MACEUROPA CENTRALE», «X\$1MACCROATIAN», «X\$1MACCYRILLIC», «X\$1MACDINGBAT», «X\$1MACGREEK», «X\$1MACHEBREW», «X\$1MACICELAND», «X\$1MACROMANIA», «X\$1MACSYMBOL», «X\$1MACTHAI», «X\$1MACTURKISH», «X\$1MACTURKISH», «X\$1MACUKRAINE»», «MS932X\$1\$10213", «MS950X\$1\$1HKSCS», «MS950X\$1\$1HKSCS\$1XP», «X\$1MSWIN\$1936", «X\$1PCK», «X\$1SJIS\$10213", «X\$1UTF\$116LE\$1BOM», «X\$1UTF\$132 BE\$1BOM», «X\$1UTF\$132LE\$1BOM», «X\$1WINDOWS\$150220", «X\$1WINDOWS\$150221", «X\$1WINDOWS\$1874", «X\$1WINDOWS\$1949", «X\$1WINDOWS\$1950", «X\$1WINDOWS\$1ISO2022j»