Provisioning through Cloud Pak for Data as a Service

You can provision the Data Virtualization service from the Cloud Pak for Data as a Service console. Follow these steps to provision Data Virtualization for Cloud Pak for Data as a Service.

1. If necessary, log in to IBM Cloud and upgrade your IBM Cloud account to Pay-as-you-go. For more information, see Upgrading your account.
2. From the IBM Cloud console, go to Manage > Billing and usage, and select Promotions to apply your promo code for a promotional credit toward Data Virtualization usage.
3. From the Cloud Pak for Data as a Service console, go to Services > Services catalog.
4. Select Data Virtualization.
5. Select a region, choose a pricing plan, configure your resource, and click Create.

Provisioning from the catalog

You can provision the Data Virtualization service on the service's catalog page. When you provision the service from the catalog, specify the following parameters.

1. Service name - The name can be any string. This string is the name that is used on the web and in the command line to identify the new deployment.
2. Resource group - If you are organizing your services into resource groups, you can specify the resource group in this field. Otherwise, you can leave it as the default.
3. Head node size - For the Enterprise plan, you can select only the 8 Cores/32GB Memory option. For the Lite plan, you can select only the 4 Cores/16GB Memory option
4. Worker nodes - For the Enterprise plan, you can select between 3 and 9 worker nodes. For the Lite plan, only 1 worker node is available.
5. Worker node size - For the Enterprise plan, you can select only the 4 Cores/32GB Memory option. For the Lite plan, you can select only the 4 Cores/16GB Memory option
6. Service Endpoints - Select the Public or Private endpoint option. Public endpoints provide a connection to your deployment on the public network and are the default selection. Private endpoints route traffic through the IBM Cloud Private network, avoiding exposure to the public internet.
7. Key Protect instance and disk encryption key - If you use Key Protect, you can select an instance and a key to encrypt the deployment's disk. If you do not use your own key, the deployment automatically creates and manages its own disk encryption key.

Click Create to start the provisioning process.

Provisioning by using the command line

You can provision the Data Virtualization service by using the CLI to request a service instance with the service ID of the database that you want to provision. You can use the IBM Cloud CLI tool to communicate with IBM Cloud from your terminal or command line. For more information, see Getting started with the IBM Cloud CLI.

For example, use the following command template:

ibmcloud resource service-instance-create <service-name> <service-id> <service-plan-id> <region> --service-endpoints <SERVICE_ENDPOINTS_TYPE>

When you run the command, the database deployment begins. The database takes some time to deploy. You can check on its progress on your IBM Cloud dashboard or you can run the following command to see the current state of the service instance:

ibmcloud resource service-instance-create <service-name>

Provisioning by using the Resource Controller API

You can provision the Data Virtualization service by using the Resource Controller API. However, to use the Resource Controller API, you need some additional preparation.

1. Get an IAM token from your API token.
2. Get the ID of the resource group that you would like to deploy to. This information is available through the IBM Cloud CLI. You can find a list of resource groups with ibmcloud resource groups and the ID of a resource group with ibmcloud resource group.
3. Understand the region that you would like to deploy to.
4. The parameters name, target, resource_group, and resource_plan_id are all required. You can send additional parameters in the request body if you need them.

For example, the following create request is a POST to the https://resource-controller.cloud.ibm.com/v2/resource_instances endpoint:

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "my-instance",
    "target": "bluemix-us-south",
    "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
    "resource_plan_id": "dash
  }'