# 安装KooCLI工具
KooCLI工具用于调用CAE服务提供的接口，对CAE组件执行升级等操作。
使用KooCLI工具之前，您需要先安装和初始化配置KooCLI工具：
- 安装KooCLI：您可以选择[方式一：联网安装]或者[方式二：软件包安装]安装KooCLI工具。
- [初始化配置KooCLI]：使用KooCLI工具前，需要先进行初始化配置。
 #### 方式一：联网安装
1. 登录Jenkins所在虚拟机.
2. 执行安装命令： 
   ```
   curl -sSL https://hwcloudcli.obs.cn-north-1.myhuaweicloud.com/cli/latest/hcloud_install.sh -o ./hcloud_install.sh && bash ./hcloud_install.sh -y
   ```
   ![](https://support.huaweicloud.com/bestpractice-cae/public_sys-resources/note_3.0-zh-cn.png)
   如上命令默认将KooCLI下载至"/usr/local/hcloud/"目录下，同时在"/usr/local/bin/"目录下创建KooCLI的符号链接。
   
   
 
 #### 方式二：软件包安装
1. 登录Jenkins所在虚拟机，执行如下命令确认所需安装操作系统： 
   ```
   echo $HOSTTYPE
   ```
   - 若执行如上命令的输出值是"x86_64"，请下载AMD 64位系统；
   
   - 若执行如上命令的输出值是"aarch64"，请下载ARM 64位系统。
   
   
   
   
2. 执行如下命令下载对应的软件包。 
   - AMD
     ```
     wget "https://hwcloudcli.obs.cn-north-1.myhuaweicloud.com/cli/latest/huaweicloud-cli-linux-amd64.tar.gz" -O huaweicloud-cli-linux-amd64.tar.gz
     ```
     
   
   - ARM
     ```
     wget "https://hwcloudcli.obs.cn-north-1.myhuaweicloud.com/cli/latest/huaweicloud-cli-linux-arm64.tar.gz" -O huaweicloud-cli-linux-arm64.tar.gz
     ```
     
   
   
   
   
3. 执行如下命令解压软件包。 
   - AMD
     ```
     tar -zxvf huaweicloud-cli-linux-amd64.tar.gz
     ```
     
   
   - ARM
     ```
     tar -zxvf huaweicloud-cli-linux-arm64.tar.gz
     ```
     
   
   
   
   
4. 在解压后的目录执行如下命令创建软链接到"/usr/local/bin"目录： 
   ```
   ln -s $(pwd)/hcloud /usr/local/bin/
   ```
   
   
5. 执行如下命令验证是否安装成功： 
   ```
   hcloud version
   ```
   系统显示类似"当前KooCLI版本:3.4.1.1"版本信息，表示安装成功。
   图1koocli版本查验   
   ![](https://support.huaweicloud.com/bestpractice-cae/zh-cn_image_0000001387345728.png)
   
   
 
#### 验证安装结果
1. KooCLI工具安装完成后，请执行**hcloud CAE** 命令测试是否支持CAE服务。
   
   ![](https://support.huaweicloud.com/bestpractice-cae/zh-cn_image_0000001676551781.png "点击放大")
   
   
2. 如果出现**Unsupported service: CAE** ，则需要将KooCLI工具切换成中文。
   
   ```
   hcloud configure set --cli-lang=cn
   ```
   
   
3. 切换完成后，再次执行**hcloud CAE**命令。
4. 如果没有出现ERROR，则表示KooCLI工具已支持CAE服务。
 
 #### 初始化配置KooCLI
1. 登录Jenkins所在Linux虚拟机。
2. 执行命令进行初始化配置，输入命令后按回车进入交互模式，根据界面提示输入各参数值，各参数配置参考[表1]。
   
   ```
   hcloud configure init
   ```
    表1初始化配置 
   | 参数                | 说明                                                                                                                 |
   |:---|:---|
   | Access Key ID     | （必填参数）访问密钥ID，即AK。获取方法，请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)。                    |
   | Secret Access Key | （必填参数）与访问密钥ID（AK）结合使用的密钥，即SK，初始化时必填。获取方法，请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)。 |
   | Region            | （选填参数）区域，即CAE服务部署区域。获取方法，请参考[地区和终端节点](https://developer.huaweicloud.com/endpoint)。                                 |