# gds_install
#### 背景信息
gds_install是用于批量安装gds的脚本工具，可大大提高GDS部署效率。
#### 注意事项
- 执行脚本前需设置环境变量，可参考《开发指南》中"导入数据\>通过外表并行导入\>安装配置和启动GDS"章节。
- 脚本需要在Python 3环境下运行。
- 必须在root用户下执行脚本gds_install。
- 用户需要检查上层目录权限，保证GDS用户对安装操作目录、安装目录及安装包有读写执行的权限。
- 目前不支持跨平台的安装部署。
- 执行命令节点也必须是安装部署机器之一。
- --host参数指定的所有节点的密码必须保持一致，才能保证脚本成功进行远程部署。
 
#### 语法
```
gds_install -I /path/to/install_dir -U user -G user_group --pkg /path/to/pkg.tar.gz --host [/path/to/hostfile | ipaddr1,ipaddr2...] [--ping-host [/path/to/hostfile | ipaddr1,ipaddr2...]]
```
#### 参数说明
- -I 安装目录。
  默认值：/opt/${gds_user}/packages/，其中${gds_user}表示GDS业务的操作系统用户。
  
- -U GDS用户。
  
- -G GDS用户所属组。
  
- --pkg GDS安装包路径，形如/path/to/GaussDB-9.1.1-REDHAT-x86_64bit-Gds.tar.gz。
  
- --host 待安装部署节点的IP列表，支持文件和字符串两种形式：
  - 文件形式：每一行一个IP地址，如： 192.168.2.200
    192.168.2.201
    
  
  - 字符串形式：半角逗号分隔，如： 192.168.2.200,192.168.2.201。
    
  
  
  ![](https://support.huaweicloud.com/tg-dws/public_sys-resources/note_3.0-zh-cn.png)
  执行命令节点必须是待部署节点之一，其IP须在列表中。
  
- --ping-host 调用gds_check时，在各检查节点上进行网络ping检查的目标地址。
  取值：IP列表，支持文件和字符串两种形式，一般是DN、CN、网关的IP地址。
  - 文件形式：每一行一个IP地址，如： 192.168.2.200
    192.168.2.201
    
  
  - 字符串形式：半角逗号分隔，如： 192.168.2.200,192.168.2.201
    
   
- -V 显示版本信息。
  
- -h, --help 显示帮助信息。
  
 
#### 示例
将GDS安装部署在节点192.168.1.100、192.168.1.101上，并指定安装目录为/opt/gdspackages/install_dir，GDS用户是gds_test:wheel。
```
gds_install -I /opt/gdspackages/install_dir --host 192.168.1.100,192.168.1.101 -U gds_test -G wheel --pkg /home/gds_test/GaussDB-9.1.1-REDHAT-x86_64bit-Gds.tar.gz
```