# 准备本地应用开发环境 #### 准备开发环境 在进行应用开发时，要准备的开发和运行环境如[表1]所示。 表1开发环境 | 准备项 | 说明 | |:---|:---| | 操作系统 | - 开发环境：Windows系统，推荐Windows 7以上版本。 - 运行环境：Windows或Linux系统。 如需在本地调测程序，运行环境需要和集群业务平面网络互通。 | | 安装JDK | 开发和运行环境的基本配置，版本要求如下： 服务端和客户端仅支持集群自带的OpenJDK，不允许替换。 对于客户应用需引用SDK类的Jar包运行在客户应用进程中的： MRS 3.6.0-LTS之前版本： - X86客户端： - Oracle JDK：支持1.8版本； - IBM JDK：支持1.8.0.7.20和1.8.0.6.15版本。 - ARM客户端： - OpenJDK：支持1.8.0_272版本（集群自带JDK，可通过集群客户端安装目录中"JDK"文件夹下获取）。 - 毕昇JDK：支持1.8.0_272版本。 MRS 3.6.0-LTS及之后版本： - X86客户端： - OpenJDK：支持JDK 8、JDK 17和JDK 21。 - 毕昇JDK：支持JDK 8、JDK 17和JDK 21。 - Oracle JDK：支持JDK 8、JDK 17和JDK 21。 - IBM JDK：支持JDK 8。 - ARM客户端： - OpenJDK：支持JDK 8、JDK 17和JDK 21。 - 毕昇JDK：支持JDK 8、JDK 17和JDK 21。 - Oracle JDK：支持JDK 8、JDK 17和JDK 21。 说明： - 基于安全考虑，服务端只支持TLS V1.2及以上的加密协议。 - IBM JDK默认只支持TLS V1.0，若使用IBM JDK，请配置启动参数"com.ibm.jsse2.overrideDefaultTLS"为"true"，设置后可以同时支持TLS V1.0/V1.1/V1.2，详情可参考。 - 毕昇JDK详细信息可参考。 | | 安装和配置IntelliJ IDEA | 开发环境的基本配置，建议使用2019.1或其他兼容版本。 说明： - 若使用IBM JDK，请确保IntelliJ IDEA中的JDK配置为IBM JDK。 - 若使用Oracle JDK，请确保IntelliJ IDEA中的JDK配置为Oracle JDK。 - 若使用Open JDK，请确保IntelliJ IDEA中的JDK配置为Open JDK。 - 不同的IntelliJ IDEA不要使用相同的workspace和相同路径下的示例工程。 | | 安装Maven | 开发环境的基本配置。用于项目管理，贯穿软件开发生命周期。 | | 准备开发用户 | 参考[准备MRS应用开发用户](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_020002.html)进行操作，准备用于应用开发的集群用户并授予相应权限。 | | 7-zip | 用于解压"\*.zip"和"\*.rar"文件，支持7-Zip 16.04版本。 | 表2Python3开发环境（使用Python样例工程需配置）适用于MRS 3.3.0及以后版本 | 准备项 | 说明 | |:---|:---| | Python3 | 用于开发HetuEngine Python应用程序的工具，版本要求不低于3.6，最高不超过3.9。 | | 安装setuptools | Python3开发环境的基本配置，版本如47.3.1。 | | jaydebeapi | Python3开发环境的基本配置，可以通过该模块使用Java的JDBC来连接数据库。 | #### 准备运行环境 进行应用开发时，需要同时准备代码的运行调测的环境，用于验证应用程序运行正常。 - 如果本地Windows开发环境和集群业务平面网络互通，可下载集群客户端到本地，获取相关调测程序所需的集群配置文件及配置网络连通后，然后直接在Windows中进行程序调测。 1. 下载客户端到本地并解压。 - MRS 3.3.0之前版本，登录FusionInsight Manager，选择"集群 \> 概览 \> 更多 \> 下载客户端"，"选择客户端类型"设置为"完整客户端"，注意平台类型与待安装客户端节点的节点类型相同（x86为**x86_64** ，ARM为**aarch64**），单击"确定"，等待客户端文件包生成后根据浏览器提示下载客户端到本地并解压。 - MRS 3.3.0及之后版本，登录FusionInsight Manager，在"主页"右上方单击"下载客户端"，"选择客户端类型"设置为"完整客户端"，注意平台类型与待安装客户端节点的节点类型相同（x86为**x86_64** ，ARM为**aarch64**），下载位置选择"浏览器"，单击"确定"，等待客户端文件包生成后根据浏览器提示下载客户端到本地并解压。 例如，客户端文件压缩包为"FusionInsight_Cluster_1_Services_Client.tar"，解压后得到"FusionInsight_Cluster_1_Services_ClientConfig.tar"，继续解压该文件。解压到本地PC的"D:\\FusionInsight_Cluster_1_Services_ClientConfig"目录下（路径中不能有空格）。 2. 进入客户端解压路径"FusionInsight_Cluster_1_Services_ClientConfig\\HetuEngine\\config"，手动将配置文件放置到HetuEngine样例工程的resources目录中。 将[准备MRS应用开发用户](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_020002.html)时获取的keytab文件也放置于resources目录下。 以**omm** 用户登录部署了HSBroker角色的节点，进入"${BIGDATA_HOME}/FusionInsight_Hetu_*XXX* /*XXX* _HSBroker/etc/"目录，下载"hetuserver.jks"文件，并将该文件也放置到"resources"目录下，主要配置文件说明如[表3]所示。 表3配置文件 | **文件名称** | **作用** | |:---|:---| | hdfs-site.xml | 集群HDFS相关配置参数。 | | hetuserver-client.properties | 配置HetuEngine客户端连接参数。 | | hetuserver-client-logging.properties | 配置HetuEngine客户端日志参数。 | | user.keytab | 对于Kerberos安全认证提供用户信息。 | | krb5.conf | Kerberos Server配置信息。 | | hetuserver.jks | Java TrustStore文件。 | 3. 在应用开发过程中，如需在本地Windows系统中调测应用程序，需要复制解压目录下的"hosts"文件中的内容到客户端所在节点的hosts文件中，确保本地机器能与解压目录下"hosts"文件中所列出的各主机在网络上互通。 ![](https://support.huaweicloud.com/devg-lts-mrs/public_sys-resources/note_3.0-zh-cn.png) - 当客户端所在主机不是集群中的节点时，配置客户端网络连接，可避免执行客户端命令时出现错误。 - Windows本地hosts文件存放路径举例："C:\\WINDOWS\\system32\\drivers\\etc\\hosts"。 - 如果使用Linux环境调测程序，需在准备安装集群客户端的Linux节点并获取相关配置文件。 1. 在节点中安装客户端，例如客户端安装目录为"/opt/client"。 客户端机器的时间与集群的时间要保持一致，时间差小于5分钟。 集群的Master节点或者Core节点使用客户端可参考[集群内节点使用MRS客户端](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0090.html)，MRS集群外客户端的安装操作可参考[集群外节点使用MRS客户端](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0091.html)。 2. 登录FusionInsight Manager，下载集群客户端软件包至主管理节点并解压，然后以**root** 用户登录主管理节点，进入集群客户端解压路径下，复制"FusionInsight_Cluster_1_Services_ClientConfi/HetuEngine/config"路径下的所有配置文件至客户端节点，放置到与准备放置编译出的jar包同目录的"conf"目录下，用于后续调测，例如"/opt/client/conf"。 例如客户端软件包为"FusionInsight_Cluster_1_Services_Client.tar"，下载路径为主管理节点的"/tmp/FusionInsight-Client"： **cd /tmp/FusionInsight-Client** **tar -xvf FusionInsight_Cluster_1_Services_Client.tar** **tar -xvf FusionInsight_Cluster_1_Services_ClientConfig.tar** **cd FusionInsight_Cluster_1_Services_ClientConfig** **scp HetuEngine/config/\* root@** *客户端节点IP地址* **:/opt/client/conf** 以**omm** 用户登录部署了HSBroker角色的节点，进入"${BIGDATA_HOME}/FusionInsight_Hetu_xxx/*xxx*_HSBroker/etc/"目录，下载"hetuserver.jks"文件，并将该文件也放置于该目录下。 [准备MRS应用开发用户](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_020002.html)时获取的keytab文件也放置于该目录下，主要配置文件说明如[表4]所示（根据需要获取所需文件）。 表4配置文件 | **文件名称** | **作用** | |:---|:---| | hdfs-site.xml | 配置HDFS详细参数。 | | hetuserver-client.properties | 配置HetuEngine客户端连接参数。 | | hetuserver-client-logging.properties | 配置HetuEngine客户端日志参数。 | | user.keytab | 对于Kerberos安全认证提供用户信息。 | | krb5.conf | Kerberos Server配置信息。 | | hetuserver.jks | Java TrustStore文件。 | 3. 检查客户端节点网络连接。 在安装客户端过程中，系统会自动配置客户端节点"hosts"文件，建议检查"/etc/hosts"文件内是否包含集群内节点的主机名信息，如未包含，需要手动复制解压目录下的"hosts"文件中的内容到客户端所在节点的hosts文件中，确保本地机器能与集群各主机在网络上互通。