火山引擎 E-MapReduce（EMR）集群创建完成后，您可以通过集群脚本 功能，批量选择节点来运行指定脚本，以实现个性化需求。例如，安装第三方软件和修改集群运行环境。
使用限制 同一集群同一时间只能执行一个集群脚本，如果有正在运行的集群脚本，则无法再提交执行新的集群脚本。 集群脚本添加上限20条，超过20条将无法添加新的集群脚本，需先将之前添加的脚本删除后，再添加新脚本。 此功能仅限用于已经创建完成且处于正常运行中的集群，如果您想在创建集群时运行集群脚本请参考引导操作 。 确保您已经开通对象存储服务（TOS）服务，并将脚本上传到 TOS 中。TOS 服务开通请参考 TOS 快速入门 。 用户角色权限检查：
登录用户单击界面右上角用户头像，进入访问控制 > 角色 界面。 在搜索框中输入 VEECSforEMRRole ，进行角色搜索。若没有该角色，您需单击新建角色 按钮，完成角色创建。角色创建请参考角色管理 。 单击 VEECSforEMRRole 角色名称，检查角色中是否已包含 ECS 和 TOS 相关的权限策略，以确保 EMR 能正常读取您在 TOS 中上传的脚本。 一条集群脚本执行过一次之后无法再次执行，请添加新的脚本。
注意事项 集群脚本可能会存在在部分节点运行失败的情况，例如，节点重启导致脚本运行失败。在解决异常问题后，您可以单独指定失败的节点再次运行。当集群扩容后，您也可以指定扩容的节点单独运行集群脚本。 集群脚本会在您指定的节点上下载 TOS 上的脚本并运行，如果运行状态是失败，则您可以登录到各个节点的 /var/log/clusterscript/<节点名称_IP> 路径查看执行日志。如果集群配置了 TOS 日志目录，运行日志也会上传到 tos-path/emr/clusterid/log/clusterscript/<节点名称_IP> 目录。
使用集群脚本
添加集群脚本 登录 EMR 控制台 。
在左侧导航栏中，单击资源管理 > on ECS > 集群名称 ，进入需配置集群脚本的集群详情界面。
在集群详情界面，单击集群脚本 页签，进入集群脚本配置界面。
在右侧单击添加集群脚本 ，在弹窗中，进行添加集群脚本配置：
参数
说明
脚本名称
输入自定义的脚本名称，方便后续管理。
脚本位置
下拉选择存放脚本的 TOS 路径，此处仅显示 Bucket 下的 Shell 执行脚本。
脚本参数
输入脚本中需引用另外添加的变量脚本参数值。
立即执行
根据实际场景，您可自行选择是否立即执行该脚本，您也可以在业务所需时，再单击执行 按钮操作。
执行范围
下拉选择脚本执行的范围，您可从**集群、节点组、节点实例（单节点）、节点实例（实例范围）**这几个维度选择则执行的范围。
完成上述参数配置后，单击确定 按钮，完成集群脚本添加。
集群脚本管理 集群脚本创建完成后，会显示在集群脚本列表中，您可进行以下管理操作：
未执行状态的集群脚本，您可单击操作 列中的执行 按钮，手动执行添加的集群脚本。 执行中的集群脚本，您可单击操作 列中的详情 按钮，可以查看脚本在各个节点上的运行情况。 单击操作 列中的删除 按钮，可以删除创建的集群脚本。
脚本示例 您可以在上传的脚本中写入以下内容来创建文件夹、解压压缩包以及安装软件包等一系列操作。
#!/bin/bash
mkdir dir
tar -zxvf <myfile>.tar.gz -C /<yourdir>
yum install -y ld-linux.so.2
常见问题 Q1： EMR 引导脚本执行中断，但日志内没有报错信息。 网络连接性问题。ECS 实例和对应的 TOS 需要在同一地域下。例如，北京地域下的 ECS 实例连接不上非北京地域下的 TOS。 ECS 获取 AccessKey 信息失败问题。通常是由于 ECS 实例未绑定 VEECSForEMRRole 导致的。 脚本中使用了 nohup，但又未重定向输出，将导致 Task 长时间无法退出。正确用法为nohup ... >*** 2>&1。 脚本在 Windows 环境下编辑会带有 Windows 的换行符号，导致脚本在 Linux 环境下运行出错。您可以在操作历史报错日志中查看是否有^M字样。如果有的话建议您在 Linux 环境下重新编辑脚本并上传 TOS。 使用 wget 命令下载程序包超时，请检查 ECS 节点是否连接公网。 使用的指令未找到，请检查 ECS 节点是否安装了此命令。 Q2： EMR 引导脚本执行无 YARN、HDFS 等命令。 . /etc/profile加载，便可以使用上述命令。Q3：输入的脚本参数未起作用。