# 安装和启动GDS
#### 安装和启动GDS
1. 登录[DWS控制台](https://console.huaweicloud.com/dws)。
2. 在左侧导航栏中，单击"连接客户端"。
3. 在 "gsql 命令行客户端"的下拉列表中，选择对应版本的DWS客户端。 
   请根据集群版本和安装客户端的操作系统，选择对应版本。
   ![](https://support.huaweicloud.com/pwp-dws/figure/zh-cn_image_0000001343220617.png "点击放大")
   
   ![](https://support.huaweicloud.com/pwp-dws/public_sys-resources/note_3.0-zh-cn.png)
   客户端CPU架构要和集群一致，如果集群是X86规格，则也应该选择X86客户端。
   
   
4. 单击"下载"。
5. 将GDS工具包上传至ECS的/opt目录中，本例以上传Euler Kunpeng版本的工具包为例。
6. 在工具包所在目录下，解压工具包。 
   ```
   cd /opt/
   unzip dws_client_8.1.x_euler_kunpeng_x64.zip
   ```
   
   
7. 创建用户gds_user及其所属的用户组gdsgrp。此用户用于启动GDS，且需要拥有读取数据源文件目录的权限。 
   ```
   groupadd gdsgrp
   useradd -g gdsgrp gds_user
   ```
   
   
8. 修改工具包以及数据源文件目录属主为创建的用户gds_user及其所属的用户组gdsgrp。 
   ```
   chown -R gds_user:gdsgrp /opt/
   chown -R gds_user:gdsgrp /data1
   chown -R gds_user:gdsgrp /data2
   ```
   
   
9. 切换到gds_user用户。 
   ```
   su - gds_user
   ```
   
   
10. 执行环境依赖脚本（仅8.1.x版本适用）。 
    ```
    cd /opt/gds/bin
    source gds_env
    ```
    
    
11. 启动GDS。 
    ```
    /opt/gds/bin/gds -d /data1/script/tpch-kit/tpch1000X -p 192.168.0.90:5000 -H 192.168.0.0/24 -l /opt/gds/gds01_log.txt -D        #TPC-H使用
    /opt/gds/bin/gds -d /data2/script/tpch-kit/tpch1000X -p 192.168.0.90:5001 -H 192.168.0.0/24 -l /opt/gds/gds02_log.txt -D       #TPC-H使用
    /opt/gds/bin/gds -d /data1/script/tpcds-kit/tpcds1000X/ -p 192.168.0.90:5002 -H 192.168.0.0/24 -l /opt/gds/gds03_log.txt -D        #TPC-DS使用
    /opt/gds/bin/gds -d /data2/script/tpcds-kit/tpcds1000X/ -p 192.168.0.90:5003 -H 192.168.0.0/24 -l /opt/gds/gds04_log.txt -D       #TPC-DS使用
    ```
    ![](https://support.huaweicloud.com/pwp-dws/public_sys-resources/notice_3.0-zh-cn.png)
    - 命令中的斜体部分请根据实际填写，如果数据分片存放至多个数据盘目录，需要启动对应目录数量的GDS。
    
    - 如果TPC-H和TPC-DS数据同时测试，需要启动以上4个GDS，如果只测试TPC-DS或TPC-H数据，请根据命令中的注释启动对应的GDS服务即可。
     
    - **-d** *dir*：保存有待导入数据的数据文件所在目录。
    
    - **-p** *ip:port* ：GDS监听IP和监听端口。IP替换为**ECS的内网IP**，确保DWS能通过此IP与GDS的通讯；端口对于TPC-H取5000、5001，对于TPC-DS取5002、5003。
    
    - **-H** *address_string* ：允许哪些主机连接和使用GDS服务。参数需为CIDR格式。此地址配置成**DWS的集群内网网段** （即GDS所在的ECS与DWS在同一个VPC下，以内网通讯即可），例如*192.168.0.0* */24*。
    
    - **-l** *log_file*：存放GDS的日志文件路径及文件名。
    
    - **-D**：后台运行GDS。仅支持Linux操作系统下使用。