系统运维

• 1: Oauth2代理
• 2: 服务检测
• 3: 数据库备份
• 4: 系统激活
• 5: 系统日志清理机制
• 6: 域登录

1 - Oauth2代理

操作指引

AISE系统Oauth2代理配置

默认情况下Auzre oauth2代理是关闭状态，如果需要开启按照如下步骤进行操作:

1. 登录部署服务器，切换到安装目录； cd /home/aise/aise-system-core-deploy
2. 修改docker-compose-allinone.yml文件中有关代理的参数
   1. AISE_PROXY_FLAG：默认为false，true为开启Oauth2代理
   2. AISE_PROXY_HOST：IP为代理IP地址
   3. AISE_PROXY_PORT：Port为代理端口
   4. AISE_PROXY_USER_NAME：username为代理用户名，如果不校验可不填
   5. AISE_PROXY_PASSWORD：password为代理用户名，如果不校验可不填
3. 最后重新部署aise-modules-system;

   docker rm -f aise-modules-system
   docker-compose -f docker-compose-allinone.yml up -d aise-modules-system
   

2 - 服务检测

特性说明

服务检测功能主要检测docker应用的运行状态，如果运行异常需要提示客户具体哪个docker应用异常，除了aise-mysql和aise-redis服务，其他服务都可以灵活配置启用或关闭。

服务检测-页面：通过页面查询服务检测结果，用户可以直观的查询所有服务的运行状态，可以通过详情查询历史异常信息。

服务检测-接口：通过接口查询服务检测结果，第三方通过调用该接口查询服务运行状态。

操作指引

服务检测字典设置

用户可以自由设置哪些服务需要需要检测，aise-mysql和aise-redis为默认服务，不需要另外配置

1. 用户登录AISE管理系统，点击左侧菜单的 系统管理 | 字典管理 ，即可进入如下界面

2. 查找名称为服务检测-URL的字典项，点击字典类型，进入字典数据列表页面

3. 新增检测服务

   1. 点击新增按钮，弹出添加字典键值窗口
   2. 输入必选项信息，字典标签填写服务名称，字典键值填写检测URL，字典排序填写展示顺序，状态默认正常，点击确定按钮，新增成功

4. 修改检测服务

   1. 点击修改按钮，弹出添加字典键值窗口
   2. 修改字典键值、字典排序、状态（状态如果是停用，就不用再检测），点击确定按钮，修改成功

5. 删除检测服务

   1. 选择所要删除字典项，点击删除按钮，确定后删除字典，删除后不会再检测该服务

服务检查查询

1. 用户登录AISE管理系统，点击左侧菜单的 系统监控 | 服务检测 ，即可进入如下界面，默认5分钟检测一次
2. 输入容器名称或选择状态可以查询过滤指定容器
3. 点击服务详情，可查询该服务历史失败信息

服务检测接口调用

服务检测提供单独的接口供第三方调用，检测时间间隔为5分钟

1. 接口地址：https://AISE服务地址/core-api/system/operlog/health_check?refresh=false ，其中AISE服务地址需要根据生产实际情况替换
2. 正常报文信息，status状态为1，代表服务正常

   {"msg":"查询成功","data":[],"status":"1"}
   

3. 异常报文信息，status状态为0，代表服务异常，data数组显示所有检测异常的服务

   {
   "msg": "查询成功",
   "data": [{
   "containerName": "aise-chatui",
   "title": "aise-chatui服务未启动成功",
   "errorMsg": "",
   "recordTime": "2024-11-26 14:39:28"
   }],
   "status": "0"
   }
   

3 - 数据库备份

特性说明

数据库备份支持全量和增量备份

全量备份：每天凌晨3点备份一次，默认最多保留7天

增量备份：暂不支持

操作指引

全量备份参数修改

1. 点击系统监控/定时任务菜单，选择任务数据库备份-全量，点击修改按钮，弹出定时任务修改窗口

2. 调用方法参数 MysqlBackupTask.work（“full”,“7”,“AISE服务地址”,“13306”,"./mysql-backup"）

   1. full: 全量标志，默认值
   2. 7：备份保留天数,默认保留7天以内的备份数据,可按需修改
   3. AISE服务地址：mysql数据库域名地址，可以是IP地址,需要根据生产实际情况修改 若为多机部署,建议使用IP指向mysql数据库部署服务器IP
   4. 13306：mysql数据库端口(默认为13306) 若部署时有指定过其他端口,则此处需要修改为您指定的端口
   5. ./mysql-backup：数据库备份存储目录,默认为.表示当前目录(当前目录为部署目录的1.mysql/backup文件夹下) 可以更改为其他目录(路径可使用相对或绝对路径)

3. cron执行参数：每天凌晨3点执行备份

4. 备份文件默认地址：/home/aise/aise-system-core-deploy/1.mysql/backup，可通过修改任务详情页面中调整调用方法参数

4 - 系统激活

操作指引

AISE系统激活指南

首次部署时，系统带有默认激活码。如激活码过期或者临时修改，则按照如下步骤进行操作:

1. 从软件开发商或销售人员获取新的激活码；
2. 登录部署服务器，切换到安装目录；

   cd /home/aise/aise-system-core-deploy
   

3. 修改docker-compose-allinone.yml文件中AISE_ACTIVATION_CODE激活码参数
4. 最后重新部署aise-gateway;

   docker rm -f aise-gateway
   docker-compose -f docker-compose-allinone.yml up -d aise-gateway
   

5 - 系统日志清理机制

特性说明

AISE 后台管理系统，之前是日志默认保留60天，超过60天的日志会被删除，现修改成默认保留7天，且在docker-compose-allinone.yml中的服务aise-manager、aise-auth、aise-modules-system、aise-modules-job、aise-modules-file、aise-gateway新增环境变量AISE_LOG_MAX_HISTORY，部署时可以通过修改环境变量修改日期默认保留天数。

操作指引

单应用日志保留天数修改：

1. 部署全部应用时，可以修改multihost.env文件中AISE_LOG_MAX_HISTORY参数，然后执行start.sh脚本

2. 部署单个应用，修改docker-compose-allinone.yml文件中所属应用参数，例如：${AISE_LOG_MAX_HISTORY:-10}

3. 执行以下命令：

   cd /home/aise/aise-system-core-deploy
   docker-compose -f docker-compose-allinone.yml stop aise-manager
   docker-compose -f docker-compose-allinone.yml rm -f aise-manager
   docker-compose -f docker-compose-allinone.yml up -d aise-manager
   

4. 示例说明：默认保留7天，如果当天是11月27日，会删除11月20日之前的日志

6 - 域登录

操作指引

AISE系统域登录配置

默认情况下AISE系统域登录配置为关闭状态，如果需要开启按照如下步骤进行操作:

1. 登录AISE系统，点击左侧导航栏“系统管理”->“域登录”->“域配置”菜单，如下图所示:
2. 默认关闭状态，点击“启用”按钮，如下图所示:
3. 各个参数的详细说明如下:
   1. 域服务器地址:AD服务器地址，默认格式为: ldap://example.com:389,example.com为域服务器名称或IP地址，389为端口
   2. 账号:管理员账号，使用DN格式：CN=admin,CN=Users,DC=example,DC=com
   3. 密码:管理员密码
   4. 域名称:域名称，格式为example.com,确保该域名可以正常访问域服务器
   5. 基础DN：域服务器的根目录，格式为：DC=example,DC=com
   6. 跟随引用：默认值
   7. AISE账号：选中后，已登录验证过的域账号将不能使用普通登录窗口登录，必须使用域账号登录窗口登录
   8. 默认部门：域账号登录成功后，默认选择的部门
   9. 默认角色：域账号登录成功后，默认选择的角色
4. 点击“保存”按钮，配置成功
5. 只有启用时登录页面才会显示域账号登录窗口，如下图所示：
6. 已登录过域账号可以在“系统管理”->“域登录”->“用户管理”菜单中查看域账号信息，如下图所示:

注意事项:
1、如果已在AISE系统创建过用户，且用户名称和域账号名称相同，则使用域账号登录时，不会重新创建和修改用户信息，只是绑定该账号为域账号