启停服务

1. 创建配置文件，执行下述命令：

   python3 startup.py service setup -c confpath
   

2. 执行完上述命令后，会在configpath目录下生成gaussmaster.conf和model_config.yaml，请参照配置文件使用文本编辑器对这两个文件做相关修改。

3. （必须）关闭HISTORY记录。

   # 修改根目录下/etc/profile文件
   vim /etc/profile
   # 设置HISTSIZE值为0
   HISTSIZE=0
   # 保存/etc/profile
   :wq
   # 设置/etc/profile生效
   source /etc/profile
   

4. 待用户手动修改完上述配置文件后，需要执行下述命令进行配置项的初始化。

   echo '{"VECTOR_password": "********","WEB-SERVICE_ssl_keyfile_password": "********", "DBMIND_ssl_keyfile_password": "********"}' | python3 startup.py service setup -c confpath --initialize --initialize_vector_db --initialize_meta_db
   

   上述初始化命令会执行如下3步操作：

   1. 创建两个密钥组件：密钥组件A存储在confpath目录下的dynamic_config.db中，密钥组件B存储在confpath目录下的encryption_part_b.bin中。
   2. 初始化运维知识库和问答知识库。
   3. 初始化元数据库。

   说明：

   1. gaussmaster.conf配置文件中VECTOR模块用于配置GaussMaster服务需要用到的数据库信息，其中"VECTOR_password"为该模块指定"VECTOR_user"的密码，“VECTOR_vector_dbname"为知识库的名称，“VECTOR_metadatabase"为元数据库的名称。
   2. “--initialize_vector_db"用于初始化运维知识库和用于智能问答的问答知识库，如果不需要对运维知识库和问答知识库进行初始化，可以不附加该参数。
   3. “--initialize_meta_db"用于初始化GaussMaster服务的元数据库，用于存储中间业务数据，如果不需要初始化元数据库，可以不附件该参数。
   4. 如果知识库和元数据库都不需要初始化，”--initialize_vector_db"和”--initialize_meta_db"参数都无需附加到初始化命令后，如下：

   echo '{"VECTOR_password": "********","WEB-SERVICE_ssl_keyfile_password": "********","DBMIND_ssl_keyfile_password": "********"}' | python3 startup.py service setup -c confpath --initialize
   

   5. 在执行初始化命令之前，需要根据gaussmaster.conf配置文件中VECTOR章节定义的数据库名vector_dbname和metadatabase并创建对应的库，否则会报错。
   6. “WEB-SERVICE_ssl_keyfile_password"为GaussMaster服务的私钥的密码。
   7. “DBMIND_ssl_keyfile_password"为连接DBMIND服务时使用的私钥的密码。
   8. “WEB-SERVICE_ssl_keyfile_password"和"DBMIND_ssl_keyfile_password"密码长度需要至少8个字符，且必须包含如下至少两种特殊字符的组合：一个大写字母、一个小写字母、一个数字、一个特殊字符（[~`!@#$%^&*()-_+\\|{};:,<.>/?]）。不满足复杂度要求会导致初始化失败。

5. 执行启动命令

   python3 startup.py service start -c confpath
   

   上述命令执行后，会在confpath目录下生成gaussmaster.pid文件，用户记录GaussMaster服务的进程ID。

   说明：

   1. 在GaussMaster服务初始化或启动阶段，如果向量模型服务或Reranker模型服务如果不可用，会有错误提示，GaussMaster服务依旧会启动，不涉及使用上述模型服务的接口可以正常使用。
   2. 在GaussMaster服务启动阶段，如果DBMind服务不可用，会有错误提示，GaussMaster服务依旧会启动，智能问答功能可正常使用，智能运维功能将受到影响。
   3. 在GaussMaster服务启动阶段，如果大语言模型服务不可用，会有错误提示，GaussMaster服务依旧会启动，需要使用到大模型服务的接口将受到影响。

6. GaussMaster服务启动之后，执行停止命令停止服务

   python3 startup.py service stop -c confpath
   

GaussMaster服务启动后，其日志会记录在"confpath/logs/gaussmaster.log中”，用户可以查看详细日志记录。

说明：

1. 在GaussMaster服务启动之后不能执行初始化操作，否则会有错误提示。
2. GaussMaster服务启动之后，不要删除配置文件目录，否则会导致stop命令失效，甚至服务进程异常。