Configuring the Amazon Web Services provider instance

Configure the Amazon Web Services (AWS) provider instance to provide authentication information and to define host templates that are used to map your cluster's resource demands to AWS instances.

About this task

Follow these steps to configure the AWS configuration files, which can be found on the management host on which the HostFactory service runs. The files are by default at $HF_CONFDIR/providers/awsinst/conf/.

Procedure

  1. Update the awsinstprov_config.json file to provide administrative and authentication information that enables your cluster to connect to AWS. For more information, see the awsprov_config.json reference.
  2. Update the awsinstprov_templates.json file to define host templates that specify, among others, the type of host that must be provisioned and the maximum number of cloud hosts. You can configure host factory to provision only On-Demand instances (default), only Spot instances, or a combination of On-Demand and Spot instances. For more information, see the awsprov_templates.json reference.
    Note: For each custom image that you created and want to use, ensure that a corresponding record exists in the host templates file. Ensure that you delete all sample entries.

What to do next

  1. Ensure that AWS is enabled as the cloud provider for your cluster. AWS is enabled by default. If you did not change the default configuration, further updates are not required. Otherwise, update the following configuration files:
    1. In the hostProviderPlugins.json file, make sure AWS is enabled in the enabled parameter. See hostProviderPlugins.json reference.
    2. In the hostProviders.json file, make sure that awsinst is enabled in the enabled parameter. See hostProviders.json reference.
    3. In the hostRequestors.json file, specify awsinst as a provider instance for the cwsinst requestor instance in the providers parameter. See hostRequestors.json reference.
  2. Configure the cwsinst requestor. See Registering a dynamic requestor which uses the cwsinst provider instance.