As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS CloudHSM Exemplos de configuração do Client SDK 3
Esses exemplos mostram como usar a **configure** ferramenta para o AWS CloudHSM Client SDK 3.
**Example : atualize os dados do HSM para o AWS CloudHSM cliente e key\_mgmt\_util**
Este exemplo usa o `-a` parâmetro de **configure** para atualizar os dados do HSM para o AWS CloudHSM cliente e key\_mgmt\_util. Para usar o `-a` parâmetro, você deve ter o endereço IP de um deles HSMs em seu cluster. Use o console ou a AWS CLI para obter o endereço IP.
**Para obter um endereço IP para um HSM (console)**
1. Abra o AWS CloudHSM console em [https://console.aws.amazon.com/cloudhsm/casa](https://console.aws.amazon.com/cloudhsm/home).
1. Para alterar a região da Amazon Web Services, use o seletor de região no canto superior direito da página.
1. Para abrir a página de detalhes do cluster, na tabela do cluster, escolha o ID do cluster.
1. Para obter o endereço IP, vá até a HSMs guia. Para IPv4 clusters, escolha um endereço listado em ** IPv4 Endereço ENI**. **Para clusters de pilha dupla, use o endereço ENI IPv4 ou ENI. IPv6 **
**Para obter um endereço IP para um HSM (AWS CLI)**
+ Obtenha o endereço IP de um HSM usando o comando **[describe-clusters](https://docs.aws.amazon.com/cli/latest/reference/cloudhsmv2/describe-clusters.html)** do AWS CLI. Na saída do comando, o endereço IP do HSMs são os valores de `EniIp` e `EniIpV6` (se for um cluster de pilha dupla).
```
$ aws cloudhsmv2 describe-clusters
{
"Clusters": [
{ ... }
"Hsms": [
{
...
"EniIp": "10.0.0.9",
...
},
{
...
"EniIp": "10.0.1.6",
"EniIpV6": "2600:113f:404:be09:310e:ed34:3412:f733",
...
```
**Para atualizar os dados do HSM**
1. Antes de atualizar o `-a` parâmetro, pare o AWS CloudHSM cliente. Isso evita conflitos que podem ocorrer enquanto **configure** edita o arquivo de configuração do cliente. Se o cliente já estiver parado, esse comando não terá efeitos, então você poderá usá-lo em um script.
------
#### [ Amazon Linux ]
```
$ sudo stop cloudhsm-client
```
------
#### [ Amazon Linux 2 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ CentOS 7 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ CentOS 8 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ RHEL 7 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ RHEL 8 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ Ubuntu 16.04 LTS ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ Ubuntu 18.04 LTS ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ Windows ]
+ Para clientes Windows 1.1.2\+:
```
C:\Program Files\Amazon\CloudHSM>net.exe stop AWSCloudHSMClient
```
+ Para o cliente Windows 1.1.1 e anterior:
Use **Ctrl** \+ **C** na janela de comando em que você iniciou o AWS CloudHSM cliente.
------
1. Esta etapa usa o parâmetro `-a` de **configure** para adicionar o endereço IP da ENI `10.0.0.9` aos arquivos de configurações.
------
#### [ Amazon Linux ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ Amazon Linux 2 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ CentOS 7 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ CentOS 8 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ RHEL 7 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ RHEL 8 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ Ubuntu 16.04 LTS ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ Ubuntu 18.04 LTS ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ Windows ]
```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\configure.exe" -a 10.0.0.9
```
------
1. Em seguida, reinicie o AWS CloudHSM cliente. Quando o cliente é iniciado, ele usa o endereço IP ENI em seu arquivo de configuração para consultar o cluster. Em seguida, ele grava os endereços IP ENI de todos HSMs no cluster no `cluster.info` arquivo.
------
#### [ Amazon Linux ]
```
$ sudo start cloudhsm-client
```
------
#### [ Amazon Linux 2 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ CentOS 7 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ CentOS 8 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ RHEL 7 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ RHEL 8 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ Ubuntu 16.04 LTS ]
```
$ sudo service cloudhsm-client start
```
------
#### [ Ubuntu 18.04 LTS ]
```
$ sudo service cloudhsm-client start
```
------
#### [ Windows ]
+ Para clientes Windows 1.1.2\+:
```
C:\Program Files\Amazon\CloudHSM>net.exe start AWSCloudHSMClient
```
+ Para o cliente Windows 1.1.1 e anterior:
```
C:\Program Files\Amazon\CloudHSM>start "cloudhsm_client" cloudhsm_client.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_client.cfg
```
------
Quando o comando é concluído, os dados do HSM que o AWS CloudHSM cliente e o key\_mgmt\_util usam estão completos e precisos.
**Example : atualize os dados do HSM para CMU a partir do client SDK 3.2.1 e versões anteriores**
Esse exemplo usa o comando `-m` **configure** para copiar os dados de HSM atualizados do arquivo `cluster.info` para o arquivo `cloudhsm_mgmt_util.cfg` usado pela cloudhsm\_mgmt\_util. Use isso com a CMU que vem com o SDK do cliente 3.2.1 e versões anteriores.
+ Antes de executar o`-m`, pare o AWS CloudHSM cliente, execute o `-a` comando e reinicie o AWS CloudHSM cliente, conforme mostrado no [exemplo anterior](#configure-tool-examples). Isso garante que os dados copiados no arquivo `cloudhsm_mgmt_util.cfg` do arquivo `cluster.info` estejam completos e precisos.
------
#### [ Linux ]
```
$ sudo /opt/cloudhsm/bin/configure -m
```
------
#### [ Windows ]
```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\configure.exe" -m
```
------
**Example : atualize os dados do HSM para CMU a partir do Client SDK 3.3.0 e versões posteriores**
Este exemplo usa o parâmetro `--cmu` do comando **configure** para atualizar os dados HSM da CMU. Use isso com a CMU que vem com o Client SDK 3.3.0 e versões posteriores. Para obter mais informações sobre o uso da CMU, consulte [Como usar a CloudHSM Management Utility (CMU) para gerenciar usuários](manage-hsm-users-cmu.md) e [como usar a CMU com o Client SDK 3.2.1 e versões anteriores](understand-users.md#downlevel-cmu).
+ Use o parâmetro `--cmu` para transmitir o endereço IP de um HSM no seu cluster.
------
#### [ Linux ]
```
$ sudo /opt/cloudhsm/bin/configure --cmu {{}}
```
------
#### [ Windows ]
```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\configure.exe" --cmu {{}}
```
------