Help Center > > User Guide> Configuring a Cluster> Installing the Third-Party Software Using Bootstrap Actions> Adding a Bootstrap Action

Adding a Bootstrap Action

Updated at: Oct 21, 2021 GMT+08:00

This operation applies to clusters of MRS 3.x or earlier.

In MRS 3.x, bootstrap actions cannot be added during cluster creation.

Adding a Bootstrap Action When Creating a Cluster

  1. Log in to the MRS management console.
  2. Click Buy Cluster. The page for buying a cluster is displayed.
  3. Click the Custom Config tab.
  4. Configure the cluster software and hardware by referring to Custom Purchase of a Cluster.
  5. On the Set Advanced Options tab page, click Add in the Bootstrap Action area.

    Figure 1 Adding a bootstrap action
    Table 1 Parameters




    Name of a bootstrap action script

    The value can contain only digits, letters, spaces, hyphens (-), and underscores (_) and must not start with a space.

    The value can contain 1 to 64 characters.


    A name must be unique in the same cluster. You can set the same name for different clusters.

    Script Path

    Script path. The value can be an OBS file system path or a local VM path.

    • An OBS file system path must start with s3a:// and end with .sh, for example, s3a://mrs-samples/
    • A local VM path must start with a slash (/) and end with .sh.


    Bootstrap action script parameters

    Execution Node

    Select a type of the node where the bootstrap action script is executed.


    Select the time when the bootstrap action script is executed.

    • Before initial component start
    • After initial component start

    Action upon Failure

    Whether to continue to execute subsequent scripts and create a cluster after the script fails to be executed.

    You are advised to set this parameter to Continue in the debugging phase so that the cluster can continue to be installed and started no matter whether the bootstrap action is successful.

  6. Click OK.

    After the bootstrap action is successfully added, you can edit, clone, or delete it in the Operation column.

Adding an Automation Script on the Auto Scaling Page

  1. Log in to the MRS management console.
  2. Choose Clusters > Active Clusters, select a running cluster, and click its name. The cluster details page is displayed.
  3. On the Nodes tab page, click Auto Scaling in the Operation column of the Task node group. The Auto Scaling page is displayed.

    If no Task node exists in the cluster, click Configure Task Node to add a Task node and then perform this step.

    For MRS 3.x or later, Configure Task Node applies only to analysis clusters, streaming clusters, and hybrid clusters.

  4. Configure a resource plan.

    You can configure the resource plan to adjust the number of nodes, which affects the actual price. Therefore, exercise caution when performing this operation.

    Configuration procedure:

    1. On the Auto Scaling page, enable Auto Scaling.
    2. For example, the Default Range of node quantity is set to 2-2, indicating that the number of Task nodes is fixed to 2 except the time range specified in the resource plan.
    3. Click Configure Node Range for Specific Time Range under Default Range.
    4. Configure the Time Range and Node Range parameters. For example, set Time Range to 07:00-13:00, and Node Range to 5-5. This indicates that the number of Task nodes is fixed to 5 in the time range specified in the resource plan. For details about the parameters, see Table 2.

      You can click Configure Node Range for Specific Time Range to configure multiple resource plans.

  5. (Optional) Configure automation scripts.

    1. Set Advanced Settings to Configure.
    2. Click Create. The Automation Script page is displayed.
    1. Set the following parameters: Name, Script Path, Execution Node, Parameter, Executed, and Action upon Failure. For details about the parameters, see Table 3.
    2. Click OK to save the automation script configurations.

  6. Select I agree to authorize MRS to scale out or scale in nodes based on the above rule.
  7. Click OK.

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?

Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel