安装器最新详细使用说明

1 启动安装器

(1)获取最新版安装器安装包

(2)将安装包上传至任意一台苍穹安装机器（安装器与苍穹可共用一台机器），或者上传至其他Linux机器(网络需能连通安装机器)。

(3)解压安装包，执行解压文件中的安装器启动程序： singularity/bin/startup.sh。启动安装器后，后台会打印出安装器的访问地址。

(4)浏览器访问安装器地址，开始使用。

2 功能使用详解

安装器的整个安装过程分四大步骤，分别为选择产品、资源规划、产品配置、执行安装。安装前，用户需提前规划好相关环境资源，通过安装器可帮助实现一键安装并初始化苍穹云基础平台(gPaaS)、苍穹应用平台、或单个苍穹关联组件。一个安装器，可多次重复使用，实现多套苍穹相关环境的安装创建。

苍穹及相关应用的安装资源建议可查看详细资源需求

2.1 选择产品

根据安装计划选择安装方式：单台机器安装、多台机器安装、单组件安装，然后选择对应安装的产品。

2.1.1 单台机器安装

选择单台机器安装，表明此次安装只有一台机器，且苍穹云基础平台(gPaaS)和苍穹应用平台中至少有一个产品会被安装。常见的安装方式有：

单台机器只安装苍穹云基础平台(gPaaS)（图1-1）；

单台机器只安装苍穹应用平台（图1-2）；

单台机器同时安装苍穹云基础平台(gPaaS)和苍穹应用平台（图1-3）；

此时该两个应用将会共用一个k8s集群，安装器配置强制无法选择苍穹应用平台的 k8s安装选项。

(1-1)    

(1-2)

(1-3)

2.1.2 多台机器安装

选择多台机器安装，表明此次安装含多台机器，且苍穹云基础平台(gPaaS)和苍穹应用平台中至少有一个产品会被选择安装。这种安装方式下安装场景与单台机器安装基本类似，主要在于机器数量不同；其中，当选择同时安装苍穹云基础平台(gPaaS)和苍穹应用平台时，安装器系统不会限制k8s的安装方式，即用户可选择两个应用k8s共用（图1-4）或k8s隔离（图1-5）。

（1-4）

（1-5）

2.1.3 单组件安装

单组件安装即只安装苍穹组件，当选择这种安装方式时，可选产品将被系统锁定无法修改（固定为数据库、中间件）。

注意，因安装的组件一般用于苍穹环境使用，如要安装Nginx、Logstash等，需提前准备好已安装的苍穹环境的相关信息，安装配置时需要。

“单组件安装”与“单台机器安装”方式的区别在于：单组件安装不限安装机器数量，且该模式下只能安装苍穹组件，无法安装K8s及应用产品。

2.2 资源规划

资源规划主要用于录入本次安装涉及的主机并在机器上配置对应的安装组件，直接点击“新增”按钮添加机器填写即可，页面功能按钮介绍：

①　新增：点击新增即可增加一行主机录入空白行进行录入

②　删除：选择主机选项复选框后激活该按钮，如增加了多余的主机需要删除再进入下一步

③　测试连接：选择主机选项复选框后激活该按钮，点击后系统即进行连接测试，初步测试所填信息是否能联通主机（连接不通可能会导致后续安装过程失败），测试结果展示在“连接状态”行。

（2-1）

交互使用无特别之处，填写过程中主要注意如下几点：

1. 录入的机器台数需要与选择产品中的选择对应，如选择单机器安装则只能录入一台机器，多机器安装则需要录入多于1台机器，单组件安装不限机器台数；

2. 主机登录方式分为密码和主机私钥两种，通过“使用密码登录”字段勾选来区分，勾选则使用密码登录，需要录入密码。

3. 录入主机上关联的安装组件建议完全覆盖当前模式下的全部组件，如含有未勾选安装的组件，则将被第三步“产品配置”中识别为企业自建组件，需提供已经安装好的组件信息供配置安装。

4. 用户可通过规划配置实现组件的高可用安装。举例如下：

    K8s（gPaaS K8s 或 苍穹应用K8s）：在3台主机上选择安装master节点

    Redis（含Cache、Session、Algo 这 3 个模块）：在3台主机上选择安装redis组件

    PostgreSQL：在2台主机上选择安装PostgreSQL数据，另1台主机上选择安装PostgreSQL Monitor（在两台主机上安装了PostgreSQL数据则必须有且仅有一台Monitor需安装）

    MDD：在2台主机上选择安装MDD组件

    Nginx：在2台主机上选择安装Nginx组件

2.3 产品配置

    根据前两个步骤填写的信息，产品配置页将展示全部需安装的应用和组件的安装配置信息待用户填写，部分配置项系统已提供默认值，用户可选择直接使用或修改，系统将按最终的配置信息进行安装。以下按应用/组件介绍填写方法和注意点。

【产品安装目录】按绝对路径填写，产品安装的相关文件将放在该路径下（所有录入主机的该路径），注意需要保证空间大小充足。若填写的文件路径不存在，系统将自动创建一个；若存在，系统安装时会清空该目录。

该字段放置的位置会因选择产品和资源规划不同而有变化，作用一致。

2.3.1 苍穹云基础平台(gPaaS) - gPaaS应用

【管理员手机号】用于创建一个default_user普通用户，该用户具有云基础平台(gPaaS)管理后台（omp）的管理员权限，和云基础平台(gPaaS)控制台默认租户的默认项目的全部使用权限。

【gPaaS系统登录密码】改密码将用于设置云基础平台(gPaaS)管理后台（omp）超级管理员admin账户密码（该账号只能登录gPaaS管理后台，且具有后台的全部权限），及default_user用户密码。安装器会默认生成一个随机密码，用户可根据需要修改。

【企业名称】将用于云基础平台(gPaaS)初始化时设置企业名称，可以在gPaaS管理后台omp中查看。

【gPaaS访问IP/域名】输入IP应当为安装机器中的IP、VIP或负载均衡IP，若填写域名则需要用户自己先配置好DNS服务器，否则可能安装失败。该字段也可以不填，则安装时系统默认获取K8S master IP或K8S VIP或负载均衡IP。

点击“高级配置”会弹出展示可配置的多项gPaaS高级配置，一般情况下，用户对高级配置中的信息可不做任何修改直接安装（有默认值的系统将按默认值安装，无默认值的不填写也不影响安装）；空值部分为特殊配置，如有需要可查看字段释义充分了解后进行填写。

2.3.2 苍穹云基础平台(gPaaS) - Kubernetes

K8S的配置主要为3个网络配置项，均有默认值；注意POD CIDR和SVC CIDR需要配置为不同的网段，否则安装后K8S异常，安装器系统有相应填写限制。

当资源规划gPaaS K8S为高可用安装时，还需要填写K8S VIP或弹性负载均衡地址（二选一）；其中，填写K8S VIP 需要是一个未被使用过、且与当次装下其他VIP不同的值，填写弹性负载均衡地址则需要提前配置好外部负载均衡器。

2.3.3 苍穹应用平台 - 苍穹应用

【苍穹集群编码】当前安装环境关联的集群编码，可在MC系统集群管理页面中查看。

【苍穹租户ID】苍穹安装并初始化后创建的初始租户的ID，可在MC系统租户列表页面中查看。

【MC登录密码】苍穹MC系统的初次登录密码，系统自动设置不允许修改。

【是否默认创建数据中心】可选择创建或不创建。建议创建，否则安装完后需要用户自行创建数据中心后才可正常使用。

【管理员手机号】云苍穹系统管理员手机号，首次登陆云苍穹系统时会用到管理员用于重置密码激活账号，需要是有效手机号，否则可能造成系统无法进一步使用；填写“苍穹云基础平台(gPaaS) - gPaaS应用”中的管理员手机号后，会自动同步此处的值，用户可更改。

【数据中心名称】选择创建数据中心时需要填写该字段。

【云苍穹登录密码】云苍穹系统的初次登录密码，系统自动设置不允许修改。

【企业名称】将用于苍穹系统初始化时设置企业名称，可在MC系统租户列表页面中查看；填写“苍穹云基础平台(gPaaS) - gPaaS应用”中的企业名称后，会自动同步此处的值，用户可更改。

2.3.4 苍穹应用平台 - Kubernetes

注意事项同“苍穹云基础平台(gPaaS) - Kubernetes”

2.3.5 苍穹应用平台 - 数据库

1) PostgreSQL

资源规划时选择安装的postgreSQL为单机模式时：只需配置该单机PG的普通账户用户名、密码及端口；系统会生成默认值，用户可修改；为了保证苍穹系统的使用，端口值建议使用默认推荐的5432。

资源规划时选择安装的postgreSQL为主备模式时：需配置该主备PG的普通账户用户名、密码及端口、监视器用户名及端口；系统会生成默认值，用户可修改；为了保证苍穹系统的使用，端口值建议使用默认推荐的5432和5433。

2) MDD

非高可用模式时无需额外填写信息；

高可用模式时，需要填写一个VIP地址，其中，填写的VIP 需要是一个未被使用过、且与当次安装下其他VIP不同的值。

2.3.6 苍穹应用平台 - 中间件

1)   Zookeeper

直接设置用户名和密码即可，系统会生成默认值，用户可修改。

2)   RabbitMQ

设置用户名和密码，另外需要配置 MQ Ierp Vhost 和MQ MC Vhost，系统会生成默认值，用户可修改。其中两个Vhost分别为MQ给Ierp和mc用的Vhost，为保证初始化后应用功能正常，建议不做修改。

3)   Redis

无论安装的是单机或哨兵模式，均只需要设置密码。

4)   Nginx

非高可用模式时只需填写云苍穹登录端口、云苍穹&MC访问IP/域名；其中填写的端口需确保未被占用，若需要自定义IP/域名，需要提前配置好映射关系，该字段非必填，置空时系统会自动获取NG地址；

高可用模式时，还需要填写VIP或弹性负载均衡地址（二选一）和共享存储路径；其中，填写VIP 需要是一个未被使用过、且与当次安装下其他VIP不同的值，填写弹性负载均衡地址需要提前配置好外部负载均衡器；共享存储路径需要用户先将该目录乖崽到NFS服务器上；云苍穹&MC访问IP/域名置空时系统会自动获取NG弹性负载均衡或VIP地址。

5)   Kafka

无需额外填写信息；

6)   Elasticsearch

直接设置用户名、密码、start essrv user即可，系统会生成默认值，用户可修改。

7)   Logstash

无需额外填写信息；

2.3.7 苍穹应用平台 - 中间件 - 企业提供的组件

此场景下用户不通过安装器进行组件安装，而是已有安装组件，需要填写相关连接信息，安装器在进行苍穹应用安装时连接，并进行初始化操作。

2.3.8 单组件安装方式下的信息配置

单组件安装方式下大部分组件安装的信息填写与上述一致，nginx和Logstash因与苍穹应用关联紧密而有部分区别，主要如下：

1. nginx

需要额外填写即将关联的苍穹应用所在的集群K8S Master，多个用逗号隔开；已安装的苍穹应用租户ID，可在MC系统租户列表页面中查看。应用仓库可选择是否安装，如选择安装，则对于有共享存储路径的高可用nginx，可能会覆盖历史安装和存放的数据，谨慎操作。

（2-2非高可用nginx）

（2-3高可用nginx）

2. Logstash

需要额外填写即将关联的苍穹应用的集群编码，可在已安装的的苍穹应用的MC系统集群管理页面中查看

2.4 执行安装

由于安装器系统可反复多次使用、用于安装多套环境，首次使用和非首次使用时第三步到第四步之间的交互会有细微区别，具体使用如下：

1. 首次使用安装器进行系统安装时，填写完第三步产品配置，如想触发安装，则直接点击页面底部最右侧按钮“开始安装”，安装器随即会保存加载后自动跳转至第四步开始执行安装；

2. 非首次使用安装器进行系统安装时，在第三步产品配置页底部需要点击按钮“下一步”进入第四步“执行安装”页；

然后点击“重新安装”

页面会弹框二次确认供选择，分别为：直接安装、卸载安装。

直接安装：即直接在当前配置的主机上开始安装，其效果与首次安装执行安装一致；

卸载安装：安装器会根据上次使用的安装配置，对主机上已安装的组件产品进行卸载（只适用于用安装器安装的组件），卸载完后再按照本次安装配置执行新的安装。

卸载安装相比直接安装，在安装页面会多一个“组件卸载”步骤。

在“执行安装”页面，可看到当前安装到什么组件、安装进度条和时长、以及输出的日志，执行到此步骤，安装流程会在后台自动执行，用户可随时关闭浏览器。

安装完成后，页面出现如下展示，用户可点击查看相关产品访问的地址及账号密码等，关闭后也可通过点击页面右上方的“登录信息”按钮来再次查看（单组件安装时无应用登录信息，故此处无法查询或查询信息为空）。此功能是为了方便用户查询，但因安装器可能会进行多次安装，且后续的安装操作将会覆盖前一次的安装数据，为了减少安装配置信息丢失导致查询困难，请用户在完成安装后，有必要记录相关应用访问地址、用户名密码、数据库、组件的用户名密码等重要信息。

2.5 其他

1. 安装前会先进行安装环境的相关检测，包括网络、环境、内存等一系列检查，如果检查不通过则安装器将不继续执行安装操作，通过则直接开始安装。安装检测失败会弹出如下失败提示，可点击“失败详情”查看检测报告；自行处理好相关问题后，可点击页面底部的“继续安装”按钮，则安装器会再次检查并继续安装。

2. 安装过程中会出现“中止安装”按钮，若点击则会暂停安装流程，同时该按钮变为重新安装和继续安装，点击“继续安装”，则系统将从上次中止的地方开始继续该安装过程。如果没有特殊情况不建议中途中止。

3. 安装器使用过程中，点击每个步骤下的“保存”按钮会保存当前配置内容，点击“下一步”也会保存当前页面配置且进行初步的填写内容校验，校验异常则红框提示且无法进入下一步页面。当安装器正在进行一个安装过程时，用户若返回至前面步骤进行修改“下一步”按钮无上述功能。