金蝶云·星空旗舰版安装器使用指南发布日期:2023年12月版权所有©金蝶软件(中国)有限公司i目录1安装器介绍....................................................................................................................12服务器配置要求..............................................................................................................13环境配置........................................................................................................................23.1数据库时区是否为CST?...............................................................................................................................23.2安装目录需要指定为磁盘最大的目录...........................................................................................................23.3服务器主机名规范...........................................................................................................................................23.4添加服务器映射...............................................................................................................................................34部署规范........................................................................................................................34.1部署流程...........................................................................................................................................................34.1.1下载安装器..............................................................................................................................................34.1.2解压并运行安装器..................................................................................................................................34.1.3安装应用..................................................................................................................................................54.2修改ip和端口(非必要)............................................................................................................................124.2.1GPaaS更改ip和端口..........................................................................................................................124.2.2应用改ip................................................................................................................................................124.3许可申请和激活.............................................................................................................................................144.3.1GPaaS许可...........................................................................................................................................144.3.2星空旗舰版许可....................................................................................................................................154.3.3自助申请许可........................................................................................................................................164.4挂载文件服务.................................................................................................................................................174.4.1GPaaS激活后进入容器管理页面.......................................................................................................174.5测试/开发环境关闭数据库归档....................................................................................................................184.5.1磁盘占用达到85%会导致k8s运行异常...........................................................................................184.6MC管理平台数据中心说明..........................................................................................................................194.6.1通过MC租户列表,进入租户详情,可以创建多个数据中心(账套)........................................194.6.2星空旗舰版默认分库模板是:不分库................................................................................................194.7开发时使用开发助手连接附件服务器本地配置说明.................................................................................234.7.1开发助手默认是使用本地环境需要打开以下配置,才能使用集群环境........................................235特殊问题......................................................................................................................265.1应用无法连接数据库.....................................................................................................................................266运维支持......................................................................................................................276.1运维手册.........................................................................................................................................................276.2在线支持.........................................................................................................................................................27版权所有©金蝶软件(中国)有限公司ii6.2.1苍穹安装器使用手册............................................................................................................................276.2.2安装器客服反馈问题............................................................................................................................276.2.3【高级进阶】安装器后台安装流程详解............................................................................................276.2.4首次登录monitor修改初始密码操作手册.......................................................................................286.2.5金蝶云·苍穹私有云部署运维工具包V5.0..........................................................................................286.3运维人员支持.................................................................................................................................................28版权所有©金蝶软件(中国)有限公司iii1安装器介绍安装器是一款可视化安装工具,主要供苍穹&星空旗舰版私有云部署使用。安装器以安装包形式进行提供,安装包里包含安装苍穹&星空旗舰版需要的所有文件(包括安装脚本、应用jar包、模板库、各个中间件二进制文件、应用镜像文件等)。星空旗舰版安装器是基于苍穹平台安装器升级改造而来,除了安装模式和安装内容各异以外,其他安装步骤和安装细节均和苍穹平台安装器保持一致。安装过程中如有疑问可咨询星空旗舰版安装器运维人员和苍穹平台安装器运维人员。2服务器配置要求1.服务器的操作系统建议CentOS7.9642.网络说明:a)服务器内网网络要求:一律不能丢包,网络延时(rtt)在1ms以下:小于0.5ms(优)0.5ms-1ms(良)大于1ms(差)内部网络带宽>=2.0Gbpsb)客户端通过Internet/intranet访问服务端时对网络的要求:每个用户不低于120Kbps的可用带宽,客户端到服务端的网络延时(rtt)不高于50ms,丢包率小于2%(电信行业标准)3.服务器资源配置部署方式:单机部署(开发、测试、演示)部署内容:GPaaS平台管理(容器管理服务、监控报警服务、镜像仓库)、ZooKeeper、RabbitMQ、Redis、Nginx、ELK、K8S容器(星空旗舰版应用、文件服务、管理中心)、PostgreSQL、MDD硬件要求:cpu16(核)内存64(G)系统盘80(G)数据盘200(G)版权所有©金蝶软件(中国)有限公司13环境配置开始安装星空旗舰版相关组件,请注意以下信息:3.1数据库时区是否为CST?确认系统时区设置是否为CST,否则请参照以下命令进行调整。rm-rf/etc/localtimeln-s/usr/share/zoneinfo/Asia/Shanghai/etc/localtime3.2安装目录需要指定为磁盘最大的目录df-h查看目录大小3.3服务器主机名规范主机hostname必须以字母开头且必须以字母数字结尾,主机hostname最多包含63个字符且只能包含小写字母、数字以及-cat/etc/hostname查看主机名称3.4添加服务器映射修改完主机名称后,添加主机映射vim/etc/hosts添加如下格式:ip[空格]主机名172.168.168.168v-kdxk-hostname4部署规范4.1部署流程4.1.1下载安装器详见:https://vip.kingdee.com/article/429284641028418560?productLineId=14.1.2解压并运行安装器安装目录不要放/home下版权所有©金蝶软件(中国)有限公司2修改本机hosts提升安装速度下载并解压安装器:unzipgalaxy-installer-pg-R202302.001-20230317.zip查看README,使用说明参考:https://vip.kingdee.com/knowledge/specialDetail/200907939946275072?category=245857885191161856&id=337282790926564352&productLineId=29进入安装器目录,并运行singularity/bin/startup.sh一般需要更新内核,选择Y,更新完成后需要重启系统,然后再启动安装器版权所有©金蝶软件(中国)有限公司3设置安装器登录密码,后安装器启动成功4.1.3安装应用使用设置密码登录安装器版权所有©金蝶软件(中国)有限公司4目前安装器只支持:演示/二开环境安装填写资源信息:版权所有©金蝶软件(中国)有限公司5修改组件(需要体验报表功能时,勾选上MDD)产品配置:设置管理员账号、以及安装目录、应用信息(其他组件参数保持默认即可)版权所有©金蝶软件(中国)有限公司6进入安装页面目前安装过程中可能会卡在初始化omp(因为k8s自身问题,需要重启下k8s网络组件)版权所有©金蝶软件(中国)有限公司7命令行:kubectlgetpod-A查看pod情况命令行:删除pod重建k8s网络:kubectldeletepod$(kubectlgetpods-nkube-system|grep-E"calico|coredns|ingress"|awk'{print$1}')-nkube-system版权所有©金蝶软件(中国)有限公司8命令行:删除苍穹pod重建:kubectldeletepod--all-nkce-system再通过kubectlgetpod-A查看pod情况,直到所有pod都正常启动,如碰到一直未正常启动的pod,可通过以下伸缩pod命令进行重建:先将伸缩设置为0:kubectlscale--replicas=0deploymentkme-nkce-system等pod彻底销毁后,再设置为原来数值:kubectlscale--replicas=1deploymentkme-nkce-system回到安装器页面,点击继续安装,直到安装完成版权所有©金蝶软件(中国)有限公司9安装完成,查看应用访问路径版权所有©金蝶软件(中国)有限公司104.2修改ip和端口(非必要)4.2.1GPaaS更改ip和端口参照:https://club.kdcloud.com/knowledge/specialDetail/200907939946275072?category=245858105777549312&id=408671810054662912&productLineId=294.2.2应用改ip在mc管理页面修改集群配置里面的应用登录地址,修改保存后,记得在集群管理里进行发布;版权所有©金蝶软件(中国)有限公司11发布版权所有©金蝶软件(中国)有限公司124.3许可申请和激活4.3.1GPaaS许可进入GPaaS管理页面:http://192.168.0.XXX/omp,获取GPaaS特征码(重新安装后会变化),提供给金蝶实施顾问申请试用许可获取许可后,可导入许可,激活应用版权所有©金蝶软件(中国)有限公司134.3.2星空旗舰版许可进入mc管理页面http://192.168.0.XXX:8090/mc,进入租户列表,获取租户特征码(重新安装后会变化),提供给金蝶实施顾问申请试用许可获取许可后,导入租户许可激活应用版权所有©金蝶软件(中国)有限公司144.3.3自助申请许可请参照知识:《环境许可申请与导入》https://vip.kingdee.com/link/s/l63kkGPaaS产品选择旗舰版产品选择4.4挂载文件服务4.4.1GPaaS激活后进入容器管理页面主机路径:设置为服务器已有目录容器内挂载路径,固定为:/kddata版权所有©金蝶软件(中国)有限公司15挂载好后重启pod,文件服务器即可正常启动4.5测试/开发环境关闭数据库归档4.5.1磁盘占用达到85%会导致k8s运行异常安装完成后默认是开启了数据库归档,可按照以下办法关闭数据库归档。未关闭数据归档的环境,磁盘随着数据库的使用,使用率将会达到占用85%的阀值,届时会导致k8s运行异常,需监控并定时清理日志:达到85%后导致k8s启动异常处理办法:https://club.kdcloud.com/knowledge/specialDetail/200907939946275072?category=245858064639735552&id=409052718875992832&productLineId=29日志清理办法(关闭数据库归档办法):https://vip.kingdee.com/article/296702729471742720?productLineId=29&isKnowledge=2版权所有©金蝶软件(中国)有限公司164.6MC管理平台数据中心说明4.6.1通过MC租户列表,进入租户详情,可以创建多个数据中心(账套)4.6.2星空旗舰版默认分库模板是:不分库生产环境使用不分库模式,建议开发环境和生产环境保持一致,以避免上生产时可能不一致导致的异常。版权所有©金蝶软件(中国)有限公司17版权所有©金蝶软件(中国)有限公司18选择所属数据库版权所有©金蝶软件(中国)有限公司19填写基础信息后,点击提交建库版权所有©金蝶软件(中国)有限公司204.7开发时使用开发助手连接附件服务器本地配置说明4.7.1开发助手默认是使用本地环境需要打开以下配置,才能使用集群环境使用集群环境:set("lightweightdeploy","false");版权所有©金蝶软件(中国)有限公司21配置并修改实际文件服务器ip(容器端口为30003)cosmic.set("fileserver","http://127.0.0.1:30003/fileserver/");cosmic.set("imageServer.url","http://127.0.0.1:30003/fileserver/");cosmic.set("attachmentServer.url","http://127.0.0.1:30003/fileserver/");版权所有©金蝶软件(中国)有限公司22开发工具使用疑问可加入开发工具支持群版权所有©金蝶软件(中国)有限公司235特殊问题5.1应用无法连接数据库服务器重启、应用升级后可能会出现无法连接数据库的错误,打开F12可查看返回错误提示:数据库配置或表结构不正确,请联系系统管理员。Getdbconnectionfalied这个错误打开时是升级包里的数据库驱动不兼容引起,修复步骤:1、从服务器应用仓库(可在mc里查看具体路径)trd目录下拉取trd-drivers.zip文件2、解压后将里面的驱动postgresql-42.6.*.jar版本替换成postgresql-42.2.16.jar,重新压缩成trd-drivers.zip覆盖回服务器应用仓库3、重启容器版权所有©金蝶软件(中国)有限公司246运维支持6.1运维手册详见《金蝶云·苍穹私有云运维手册20220428.docx》6.2在线支持6.2.1苍穹安装器使用手册https://vip.kingdee.com/knowledge/specialDetail/200907939946275072?category=352145344094428160&id=337282790926564352&productLineId=296.2.2安装器客服反馈问题https://pan.yunzhijia.com/edit#/502871674048217088/6.2.3【高级进阶】安装器后台安装流程详解https://vip.kingdee.com/knowledge/specialDetail/200907939946275072?category=354633102834138368&id=387617104205736192&productLineId=296.2.4首次登录monitor修改初始密码操作手册https://vip.kingdee.com/article/252027028575023616?productLineId=29&isKnowledge=2版权所有©金蝶软件(中国)有限公司256.2.5金蝶云·苍穹私有云部署运维工具包V5.0https://iknow.kingdee.com/inbiz/wcm/km/#knode-detail/knodeId/6ee065af-a1c5-4d57-b124-4050b7bb4b0f6.3运维人员支持云之家运维群版权所有©金蝶软件(中国)有限公司26