安装配置

截止目前，OpsAny安装脚本的执行成功率还是100%，所以遇到安装失败，不用考虑是不是脚本写错了。唯一需要考虑的是，是不是没有官方文档进行操作，或者前面的操作步骤输出中有报错但是没有注意到（警告可以忽略）。

安装前常见问题

1. 端口冲突导致安装失败？数据库安装失败？

需要一个干净的系统进行部署，可以参考安装手册中，OpsAny需要使用的端口号，保证端口号不能冲突。

2. PaaS安装失败如何继续？

执行uninstall.sh（卸载的时候会删除所有Docker容器，镜像会保留），然后重新执行paas-install.sh，请检查脚本执行前的操作是否有报错。

3. 平台安装完毕，无报错，但是无法登录，不停跳转回登录页面。

由于安装时设置的DOAMIN_NAME和访问的地址不同导致的，验证会使用Cookie，而且设置了Cookie的作用域，因为配置的和访问的地址不同，导致验证失败。请使用install.config中的DOAMIN_NAME进行登录。

安装后常见问题

1. 安装完毕后，想修改DOMAIN_NAME如何进行设置。

cd /opt/opsany-paas/install
./paas-change-domain.sh old_domain_name  new_domain_name

执行完毕脚本后，需要手工进行以下修改： - 管控平台: 采控管理-Grafana集成，修改URL。 - 申请对应的SSL证书并替换。然后执行docker restart opsany-base-openresty

2. 安装完毕后，想修改IP地址如何进行修改？

目前该需求比较少，未提供脚本，可以自行修改所有服务的配置文件即可。

• 1.修改/data/opsany/conf/目录下所有配置文件。
• 2.修改/data/opsany/conf/opsany-saas目录下，所有目录下的所有配置文件。
• 3.重启所有容器。

3. 如何查看日志？

1.日志默认在安装路径的logs目录下，每个SAAS有一个独立的日志目录。

[root@demo ~]# ls -l /data/opsany/logs/
total 36240
-rw-r--r-- 1 root root      545 Jul 12 13:14 appengine.log
-rw-r--r-- 1 root root        0 Jul 12 13:14 appengine_mysql.log
drwxr-xr-x 2 root root     4096 Jul 12 13:14 control 
-rw-r--r-- 1 root root    68209 Jul 13 19:32 esb.log
-rw-r--r-- 1 root root 16363268 Jul 13 19:32 esb_api.log
-rw------- 1 root root  2796017 Jul 13 19:33 heartbeat
-rw-r--r-- 1 root root     8052 Jul 12 13:21 login.log 
-rw-r--r-- 1 root root        0 Jul 12 13:14 login_mysql.log
-rw-r--r-- 1 root root     3385 Jul 12 17:10 nginx_paasagent_error.log
-rw-r--r-- 1 root root  2074644 Jul 13 19:32 nginx_paasagnet_access.log
-rw-r--r-- 1 root root        0 Jul 12 13:17 opsany-salt-api.log
-rw-r--r-- 1 root root   355005 Jul 13 19:33 opsany-salt-master.log
-rw-r--r-- 1 root root      592 Jul 12 13:18 opsany-salt-minion.log
-rw-r--r-- 1 root root   170153 Jul 13 16:11 paas-agent.log
-rw-r--r-- 1 root root  1086376 Jul 13 16:11 paas.log
-rw-r--r-- 1 root root        0 Jul 12 13:14 paas_agent-nginx.log
-rw-r--r-- 1 root root        0 Jul 12 13:14 paas_agent-supervisord.log
-rw-r--r-- 1 root root   288479 Jul 13 16:11 paas_appengine.log
-rw-r--r-- 1 root root  1622275 Jul 13 19:32 paas_esb.log
-rw-r--r-- 1 root root  4160086 Jul 13 19:32 paas_login.log
-rw-r--r-- 1 root root        0 Jul 12 13:13 paas_mysql.log
-rw-r--r-- 1 root root  7813059 Jul 13 19:32 paas_nginx_access.log
-rw-r--r-- 1 root root     2444 Jul 12 19:56 paas_nginx_error.log
-rw-r--r-- 1 root root   180758 Jul 13 19:32 paas_paas.log
-rw-r--r-- 1 root root      344 Jul 12 13:14 paas_websocket.log

4. 如何持续获取OpsAny的更新？

OpsAny社区版每季度末会发布一个版本，新版本的更新通知会以邮件的方式发送到您申请证书的邮箱中，同时也会在官方社区微信群中进行同步，敬请关注！

5. 如何更新某个SaaS平台？

使用更新脚本，支持两个参数，平台的APPID和需要更新的版本，如下所示。

cd /opt/opsany-paas/install/
./opsany-ce-update.sh workbench 2.0.1

6. OpsAny这么多模块我可以只安装某一个吗，例如仅安装堡垒机，仅安装资源平台？

默认情况下我们的安装脚本当你执行./saas-ce-install.sh base的时候是会安装运维平台的所有模块的，有几种方式可以进行自定义安装：

• 安装前：修改安装脚本，将不需要安装的平台的安装步骤，直接注释了。适用于对Shell脚本比较熟悉的用户。
• 安装后：先正常安装完毕后，将不用的模块，直接执行docker stop opsany-saas-名称，停止容器，然后在工作台-导航管理，删除该导航即可。

注意：必须安装的模块是统一权限（rbac）和工作台（workbench），其它模块均可以灵活选择。

7. 某个平台安装失败了怎么处理？

从技术维度看通常不存在某个平台安装失败的问题，要失败都失败，要成功都成功。但凡是总有例外，例如之前没有安装应用平台，后新增的应用平台。或者由于网络原因，某个平台的镜像无法拉取导致失败。处理起来并不容易，因为关键是要看是哪一步出的问题。可以通过阅读安装脚本来获取，如果你看不懂安装脚本，下面列举了每个SaaS平台的安装经历以下几个步骤：

• 1. 创建对应的数据库、用户并授权。
• 1. 修改注册到ESB的接口的配置。
• 1. 使用UUID命令生成SECRET_KEY。
• 1. 使用上一步生成的SECRET_KEY将应用注册到注册中心。
• 1. 使用sed根据配置文件中的配置，配置应用的配置文件。
• 1. 获取SaaS平台镜像
• 1. 启动容器。

对于升级的用户，最常见的是未安装UUID命令。导致第三步无法生成SECRET_KEY，然后报错会到第四步，提示脚本缺少参数，但是部署脚本会继续操作，启动容器。这个时候安装后的平台无法访问。解决方法： 1. 停止容器。2. 删除容器 3. 查看注册中心应用是否注册。 如果应用没有注册，重新执行安装脚本即可。如果应用已注册，这个时候执行安装脚本部署后的应用是无法访问的。就是因为注册到开发中心的SECRET_KEY，可能和应用配置文件中的SECRET_KEY不一致，导致打开后可能直接跳转到登录界面。解决方案就是到开发中心找到对应的SECRET_KEY然后修改应用配置文件，同时将SECRET_KEY写入到\(INSTALL_PATH/conf/.\)_secret_key文件中。APPID为应用的唯一标识，请替换。

8. 如何卸载OpsAny？

如果OpsAny让你感觉不满意，可以在我们社区交流群提出改进建议。如果觉得就是不喜欢，那立即卸载了吧。毕竟人生苦短，何必自寻烦恼呢？但是卸载脚本有点简单粗暴，有必要说明一下。

• 执行卸载命令前，需要明确知道，该脚本会直接停止本机的所有容器，并删除所有容器。不管是不是OpsAny使用的容器，并直接删除安装目录。

 cd /opt/opsany-paas/install
 ./uninstall.sh uninstall

• 世间多少纷扰事，浮华落尽总随风。OpsAny祝您开心度过每一天，我们会继续践行在“让运维更完美“的道路上，有缘再见！