Etapa 1: Configurar permissões e iniciar o controle de tarefas (STC)Etapa 2: criar buckets do Amazon S3 Etapa 3: criar uma chave gerenciada pelo AWS KMS cliente para criptografia Etapa 4: criar um AWS Secrets Manager segredo para as credenciais do mainframe Etapa 5: criar uma IAM política Etapa 6: criar um IAM usuário com credenciais de acesso de longo prazo Etapa 7: criar uma IAM função para o agente assumir Etapa 8: configuração do agente

Configurar um agente de transferência de arquivos

Depois de instalar um agente de transferência de arquivos, siga estas etapas para configurar o agente. Se precisar instalar um novo agente, siga as instruções na Instalar um agente do Transferência de Arquivos página.

Tópicos

Etapa 1: Configurar permissões e iniciar o controle de tarefas (STC)
Etapa 2: criar buckets do Amazon S3
Etapa 3: criar uma chave gerenciada pelo AWS KMS cliente para criptografia
Etapa 4: criar um AWS Secrets Manager segredo para as credenciais do mainframe
Etapa 5: criar uma IAM política
Etapa 6: criar um IAM usuário com credenciais de acesso de longo prazo
Etapa 7: criar uma IAM função para o agente assumir
Etapa 8: configuração do agente

Etapa 1: Configurar permissões e iniciar o controle de tarefas (STC)

Atualize e envie um dos SYS2.AWS.M2.SAMPLIB(SEC#RACF) (para configurar RACF permissões) ou SYS2.AWS.M2.SAMPLIB(SEC#TSS) (para configurar TSS permissões) de acordo com suas instruções. Esses membros foram criados pela etapa anterior de CPY#PDS.

nota
SYS2.AWS.M2é o qualificador de alto nível (HLQ) que foi escolhido durante a instalação.
Atualize a PWD exportação no SYS2.AWS.M2.SAMPLIB(M2AGENT) STCJCL, se o caminho padrão do diretório do agente de transferência de arquivos (/usr/lpp/aws/m2-agent) tiver sido alterado.
Atualize e copie o SYS2.AWS.M2.SAMPLIB(M2AGENT) JCL paraSYS1.PROCLIB.
Adicione SYS2.AWS.M2.LOADLIB à APF lista usando o seguinte comando:
```
SETPROG APF ADD DSNAME(SYS2.AWS.M2.LOADLIB) SMS
```
Defina o grupo e o proprietário do agente logs e diag das pastas como o usuário/grupo do agente (M2/M2). USER GROUP Use o seguinte comando:
```
chown -R M2USER:M2GROUP $AGENT_DIR/current-version/logs
chown -R M2USER:M2GROUP $AGENT_DIR/current-version/diag
```

Etapa 2: criar buckets do Amazon S3

AWSA transferência de arquivos de modernização do mainframe requer um bucket intermediário do Amazon S3 como área de trabalho. Recomendamos criar um bucket especificamente para isso.

Opcionalmente, crie um novo bucket Amazon S3 de destino para os conjuntos de dados transferidos. Caso contrário, você também pode usar seu bucket Amazon S3 existente. Para obter mais informações sobre a criação de buckets do Amazon S3, consulte Criação de um bucket.

Etapa 3: criar uma chave gerenciada pelo AWS KMS cliente para criptografia

Para criar uma chave gerenciada pelo cliente em AWS KMS

Abra o AWS KMS console emhttps://console.aws.amazon.com/kms.
Escolha Chaves gerenciadas pelo cliente no painel de navegação esquerdo.
Escolha Create key (Criar chave).
Em Configurar chave, escolha Tipo de chave como Simétrico e Uso da chave como criptografia e descriptografia. Use outras configurações padrão.
Em Adicionar rótulos, adicione um alias e uma descrição para sua chave.
Escolha Próximo.
Em Definir as principais permissões administrativas, escolha pelo menos um IAM usuário e uma função que administre essa chave.
Escolha Próximo.
Na página Revisar, adicione a seguinte sintaxe à política de chaves. Isso permite que o serviço de modernização do AWS mainframe leia e use essas chaves para criptografia/descriptografia.

Importante
Adicione a declaração às declarações existentes. Não substitua o que já está na política.
```
{
    "Sid" : "Enable AWS M2 File Transfer Permissions",
    "Effect" : "Allow",
    "Principal" : {
        "Service" : "m2.amazonaws.com"
    },
    "Action" : [
        "kms:Encrypt",
        "kms:Decrypt"
    ],
   "Resource" : "*"
},
```

Salve ARN a chave gerenciada pelo cliente depois de criada. Ele será usado na política posteriormente.

Etapa 4: criar um AWS Secrets Manager segredo para as credenciais do mainframe

As credenciais do mainframe são necessárias para acessar os conjuntos de dados a serem transferidos e devem ser armazenadas como um AWS Secrets Manager segredo.

Para criar um AWS Secrets Manager segredo

Abra o console do gerenciador Secrets emhttps://console.aws.amazon.com/secretsmanager.
Em Escolher tipo de segredo, escolha Outro tipo de segredo.
Use o valor da chave userId para o mainframe userId que tem acesso aos conjuntos de dados.
Use o valor da chave password para o campo de senha.
Em Chave de criptografia, escolha a chave gerenciada pelo AWS cliente criada anteriormente.
Escolha Próximo.
Na página Configurar segredo, forneça um nome e uma descrição.

Na mesma página, edite as permissões do recurso e use a política de recursos a seguir para que o serviço de modernização do AWS mainframe possa acessá-la.


{
  "Version" : "2012-10-17",
  "Statement" : [ {
    "Effect" : "Allow",
    "Principal" : {
        "Service" : "m2.amazonaws.com"
    },
    "Action" : [ "secretsmanager:GetSecretValue", 
                 "secretsmanager:DescribeSecret" ],
    "Resource" : "*"
  } ]
}

Escolha Salvar para salvar as permissões atualizadas antes de escolher Avançar.
Passe pela página Configurar rotações e escolha Avançar.
Na página Revisar, verifique todas as configurações e escolha Armazenar para salvar o segredo.

Importante

As userId chaves password secretas fazem distinção entre maiúsculas e minúsculas e devem ser inseridas conforme mostrado.

Etapa 5: criar uma IAM política

Para criar uma nova política com as permissões necessárias para o agente

Alterne do editor visual para o JSON editor e substitua o conteúdo pelo seguinte modelo:


{
"Version": "2012-10-17",
    "Statement": [
        {
         "Sid": "FileTransferAgentSQSReceive",
            "Effect": "Allow",
            "Action": [
                "sqs:DeleteMessage",
                "sqs:ReceiveMessage"
            ],
            "Resource": "arn:aws:sqs:*:111122223333:m2-*-request-queue.fifo"
        },
        {
         "Sid": "FileTransferAgentSQSSend",
            "Effect": "Allow",
            "Action": "sqs:SendMessage",
            "Resource": "arn:aws:sqs:*:111122223333:m2-*-response-queue.fifo"
        },
        {
         "Sid": "FileTransferWorkingS3",
            "Effect": "Allow",
            "Action": "s3:PutObject",
            "Resource": "<file-transfer-endpoint-intermediate-bucket-arn>/*"
        },
        {
         "Sid": "FileTransferAgentKMSDecrypt",
            "Effect": "Allow",
            "Action": "kms:Decrypt",
            "Resource": "<kms-key-arn>"
        }
    ]
}

Substitua o 111122223333 na fila de solicitações e na fila de respostas pela sua contaARN.

nota
Esses são ARN curingas que correspondem às duas SQS filas da Amazon criadas durante a inicialização do endpoint de transferência de dados. Depois de criar um endpoint de transferência de arquivos, substitua-o opcionalmente pelos valores reais da Amazon. ARN SQS
file-transfer-endpoint-intermediate-bucket-arnSubstitua pelo ARN do bucket de transferência criado anteriormente. Deixe o caractere curinga “/*” no final.
kms-key-arnARNSubstitua pela AWS KMS chave criada anteriormente.

Etapa 6: criar um IAM usuário com credenciais de acesso de longo prazo

Crie um IAM usuário que permita que o agente de mainframe se conecte à sua AWS conta. O agente se conectará a esse usuário e, em seguida, assumirá uma função que você define com permissões para usar as filas de SQS resposta e solicitação da Amazon e para salvar conjuntos de dados nos buckets do Amazon S3.

Para criar este IAM usuário

Navegue até o AWS IAM console emhttps://console.aws.amazon.com/iam.
Nas opções de Permissões, escolha a opção Anexar políticas diretamente, mas não anexe nenhuma política de permissões. Essas permissões serão gerenciadas por uma função que será anexada.
Depois que o usuário for criado, escolha o usuário e abra a guia Credenciais de segurança.
Em Criar chave de acesso, escolha Outro quando solicitado para Caso de uso.
Copie e salve com segurança a chave de acesso e a chave de acesso secreta geradas. Eles serão usados posteriormente.

Para obter mais informações sobre a criação de chaves de IAM acesso, consulte Gerenciamento de chaves de acesso para IAM usuários.

Importante

Salve a chave de acesso e a chave de acesso secreta exibidas na última página do assistente de criação da chave de acesso, antes de escolher Concluído. Essas chaves são usadas para configurar o agente de mainframe.

nota

Salve o IAM usuário ARN usado para configurar uma relação de confiança com uma IAM função.

Etapa 7: criar uma IAM função para o agente assumir

Para criar uma nova IAM função para o agente

Escolha Funções no IAM console emhttps://console.aws.amazon.com/iam.
Selecione Criar função.
Na página Selecionar entidade confiável, escolha Política de confiança personalizada para o tipo de entidade confiável.

Substitua a política de confiança personalizada pela seguinte e <iam-user-arn> substitua pela ARN do usuário criada anteriormente.


{
    "Version": "2012-10-17",
    "Statement": [ {
         "Sid": "FileTransferAgent",
         "Effect": "Allow",
         "Principal": {
            "AWS": "<IAM-User-arn>"
         },
         "Action": "sts:AssumeRole"
    } ]
}

Escolha Próximo.
Em Adicionar permissões, filtre o nome da política que você criou anteriormente e escolha-o.
Escolha Próximo.
Dê um nome à função e escolha Criar função.

nota

Salve o nome da função, que será usado posteriormente para configurar o agente de mainframe.

Etapa 8: configuração do agente

Para configurar o agente de transferência de arquivos

Acesse $AGENT_DIR/current-version/config.
Edite o arquivo de configuração do agente appication.properties para adicionar uma configuração de ambientes usando o seguinte comando:
```
oedit $AGENT_DIR/current-version/config/application.properties
```
Por exemplo:
```
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>
zos.complex-name=<File_Transfer_Endpoint_Name>
```
Em que:
- AWS_ACCOUNT_IDé o ID da AWS conta.
- AWS_IAM_ROLE_NAMEé o nome da IAM função criada noEtapa 7: criar uma IAM função para o agente assumir.
- AWS_IAM_ROLE_ACCESS_KEYé a chave de acesso do IAM usuário criado emEtapa 6: criar um IAM usuário com credenciais de acesso de longo prazo.
- AWS_IAM_ROLE_SECRET_KEYé a chave secreta de acesso para o IAM usuário criado emEtapa 6: criar um IAM usuário com credenciais de acesso de longo prazo.
- AWS_S3_BUCKET_NAME é o nome do bucket de transferência criado com o endpoint de transferência de dados.
- AWS_REGION é a região na qual você configura o agente do Transferência de Arquivos.
  
  nota
  Você pode fazer com que o agente de transferência de arquivos seja transferido para várias regiões e contas AWS definindo vários ambientes.
- (Opcional). zos.complex-nameé o nome complexo que você criou ao criar um endpoint de transferência de arquivos.
  
  nota
  Esse campo é necessário somente se você quiser personalizar o nome complexo (cujo padrão é o nome do sysplex) que é o mesmo que você definiu ao criar seu endpoint de transferência de arquivos. Para obter mais informações, consulte Crie pontos de extremidade de transferência de dados para transferência de arquivos.
Importante
Pode haver várias seções desse tipo, desde que o índice entre colchetes ([0]) seja incrementado para cada uma.

Reinicie o agente para que as alterações entrem em vigor.

Requisitos

Quando um parâmetro é adicionado ou removido, o agente deve ser interrompido e iniciado. Inicie o agente de transferência de arquivos usando o seguinte comando noCLI:
```
/S M2AGENT
```
Para interromper o agente M2, use o seguinte comando emCLI:
```
/P M2AGENT
```

Você pode fazer com que o agente de transferência de arquivos seja transferido para várias regiões e contas AWS definindo vários ambientes.

nota

Substitua os valores pelos valores dos parâmetros que você criou e configurou anteriormente.


#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

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Instalar um agente do Transferência de Arquivos

Crie endpoints de transferência de dados