Install and configure the AWS CloudHSM client (Windows) - AWS CloudHSM

Install and configure the AWS CloudHSM client (Windows)

To work with an HSM in your AWS CloudHSM cluster on Windows, you need the AWS CloudHSM client software for Windows. You should install it on the Windows Server instance that you created previously.

To install (or update) the latest Windows client and command line tools

  1. Connect to your Windows Server instance.

  2. Download the AWSCloudHSMClient-latest.msi installer.

  3. If installing Client SDK 3 on cloudhsm_mgmt_util, complete the following steps to ensure all the nodes in the cluster are synced.

    1. Run configure -a <IP of one of the HSMs>.

    2. Restart the client service.

    3. Run config -m.

  4. Go to your download location and run the installer (AWSCloudHSMClient-latest.msi) with administrative privilege.

  5. Follow the installer instructions, then choose Close after the installer has finished.

  6. Copy your self-signed issuing certificate—the one that you used to sign the cluster certificate—to the C:\ProgramData\Amazon\CloudHSM folder.

  7. Run the following command to update your configuration files. Be sure to stop and start the client during reconfiguration if you are updating it:

    C:\Program Files\Amazon\CloudHSM\bin\ configure.exe -a <HSM IP address>

  8. Go to Activate the cluster.

Notes:

  • If you are updating the client, existing configuration files from previous installations are not overwritten.

  • The AWS CloudHSM client installer for Windows automatically registers the Cryptography API: Next Generation (CNG) and key storage provider (KSP). To uninstall the client, run the installer again and follow the uninstall instructions.

  • If you are using Linux, you can install the Linux client. For more information, see Install and configure the AWS CloudHSM client (Linux).