Skip to content

Latest commit

 

History

History
57 lines (40 loc) · 3.29 KB

Resize-clusters.md

File metadata and controls

57 lines (40 loc) · 3.29 KB
Raw
copyright lastupdated subcollection
years
2017, 2019
2019-03-13
AnalyticsEngine

{:new_window: target="_blank"} {:shortdesc: .shortdesc} {:codeblock: .codeblock} {:screen: .screen} {:pre: .pre}

Resizing clusters

{: #resize-clusters}

You can scale up your cluster by adding more compute nodes. More nodes mean better performance, but also increased cost. For efficiency, add all the nodes that you need at once rather than one at a time.

To resize your {{site.data.keyword.iae_full_notm}} cluster, you must have the following user permissions.

You can resize the cluster by using one of the following modes:

Resizing clusters by using the Cluster Management user interface

{: #resize-cluster-by-cluster-management-user-interface}

To resize a cluster:

  1. On {{site.data.keyword.Bluemix_notm}} console, switch to the organization and space where your service instance was created.
  2. Click the service instance tile to access the service dashboard.
  3. On the right hand side of the page, click Manage. The cluster management page shows you the number of compute nodes in your cluster.
  4. Click + next to the number of compute nodes and click Save.
  5. Wait for the clusters to be resized (the time depends on the number of nodes you added), and then refresh the page to verify that your resize request was handled successfully.

The Nodes section of the cluster management page shows a list of all nodes of the cluster. You can identify the newly added nodes from the creation time shown in the Nodes section.

Resizing clusters using the REST API

{: #resize-cluster-using-the-rest-api}

To resize cluster using the REST API, you must meet the following prerequisites:

  • You must have Editor access to the service instance. Reach out to your {{site.data.keyword.Bluemix_notm}} account owner, if you do not have sufficient permissions. For more details refer to Retrieving IAM access tokens.
  • The API call to resize the cluster requires your IAM bearer token. To obtain the token, follow these steps.

To resize a cluster, enter the following command. For example, to increase the cluster by one node:

curl -i -X POST  https://api.us-south.ae.cloud.ibm.com/v2/analytics_engines/<service_instance_guid>/resize -H 'Authorization: Bearer <user's IAM token>' -d '{"compute_nodes_count":2}' -H "Content-Type:application/json"

For the parameter compute_nodes_count, you need to pass the expected size of the cluster, after the resize operation. For example, if your cluster currently has one compute node and you want to add two more nodes to it, then the value for compute_nodes_count parameter should be 3.

For the United Kingdom region, use the endpoint https://api.eu-gb.ae.cloud.ibm.com. For Germany, use https://api.eu-de.ae.cloud.ibm.com and for Japan https://api.jp-tok.ae.cloud.ibm.com.

Restriction: Currently, only the scale up operation is supported. Removing nodes from a cluster is not supported.