文档中心

数据库运维 ​

--child |-child ​

以前台模式启动数据库服务，推荐使用--child。 在linux操作系统环境下，以前台模式启动的数据库服务进程会作为bash shell进程的子进程运行，当bash shell进程退出，作为其子进程的数据库服务进程也将被中止并退出；在windows操作系统环境下，以前台模式启动的数据库服务进程会作为命令提示符进程cmd.exe进程的子进程运行，当命令提示符进程退出，作为其子进程的数据库服务进程也将被中止并退出。

--server |-server |-service ​

以后台模式启动数据库服务，推荐使用--server。 在linux操作系统环境下，以后台模式启动的数据库服务进程会作为systemd进程的子进程运行，systemd进程是linux系统启动后第一个被创建的用户态进程，负责初始化系统并启动其他关键的系统进程和服务，这将意味着数据库服务进程不会被动的因为某个bash shell进程被关闭而结束；在windows操作系统环境下，以后台模式启动的数据库服务进程会作为命令提示符进程cmd.exe进程的子进程运行，当命令提示符进程退出，作为其子进程的数据库服务进程也将被中止并退出。

--daemon |-daemon ​

以守护模式启动数据库服务，推荐使用--daemon。 该参数只支持在linux操作系统环境下使用，以守护模式启动数据库服务进程时，系统会额外创建一个数据库服务进程的守护进程，守护进程会作为数据库服务进程的父进程并监视数据库服务子进程的进程状态，一旦数据库服务进程异常退出，数据库服务进程的守护进程将尝试重启服务进程。另外，守护进程的父进程是systemd进程。

--start-ini ​

XuguDB Server支持通过程序启动参数`--start-ini`修改系统参数配置文件xugu.ini，向`--start-ini`提供参数值时，参数值中的参数项必须以键值对的形式提供，相邻参数项之间必须以英文逗号','作为分割符，`--start-ini`参数值中的任何地方都不允许出现空格和换行。

sh
# 修改数据库服务端口为10578，修改用户口令最短长度为10，
# 并使用前台模式启动数据库服务;
./BIN/程序文件名 --start-ini="listen_port=10578,min_pass_len=10"

--start-ini可以搭配--init-setup一起使用，用于生成符合实际部署环境的系统参数配置文件。

sh
# 初始化生成xugu.ini，并修改数据库服务端口为10578后退出;
./BIN/程序文件名 --start-ini="listen_port=10578" --init-setup

--reload-package ​

XuguDB Server支持通过程序启动参数--reload-package重新加载系统包，该功能主要用于数据库服务进行系统包升级（这并不是一个在线升级的功能，该操作需要停掉数据库服务后在管理节点进行，在非管理节点使用该参数将被忽略）。在准备进行系统包升级前，需要提前将新的系统包定义文件xugu_init.sql进行更换。

--key-signal ​

对于XuguDB Server数据库集群系统，一般有两个管理节点（一主一备）负责管理整个集群，当出现灾难事故导致需要重启集群时，如果主管理节点无法再接入集群，可以在启动备管理节点时通过启动参数 --key-signal='a' 来代替敲键进行备用管理节点向主管理节点切换。

sh
# 启动备管理节点, 并将备管理节点切换为主管理节点，集群由主备双管理节点改为单管理节点。
./BIN/程序文件名 --key-signal='a'

sc命令参数 ​

在Windows操作系统中，SCM（Service Control Manager）是一个负责管理服务（包括启动、停止和配置服务等）的系统组件。如果要注册一个服务到SCM，可以使用sc命令行工具来创建、删除、启动、停止和查询服务。

说明：

  • 执行sc命令需要以管理员身份运行CMD或PowerShell。
  • 使用sc命令创建服务时，可将启动的服务名称设置为XuguDB，描述通过DisplayName设置为Xugu Database Management System。

sc命令模版：

sc create <服务名称> binPath= "<服务的可执行文件路径及参数>" DisplayName= "<服务的描述信息>"

执行注册服务时，sc 命令的可执行文件后必须加上额外的参数--backend。

sc命令示例：

创建服务：
sc.exe create XuguDB binPath="D:\SoftDocuments\xugudbms\XuguWindows\BIN\xugu_windows_amd64.exe --backend" DisplayName= "Xugu Database Management System"

启动服务：
sc.exe start XuguDB 

停止服务：
sc.exe stop XuguDB 

删除服务：
sc.exe delete XuguDB

数据库服务端可执行程序参数 ​

在Windows操作系统中，使用可执行程序参数的命令模板：

<服务的可执行文件路径> <程序参数>

支持的程序参数：

  • -install：注册和启动数据库
  • -start：注册和启动数据库
  • -stop：停止数据库服务
  • remove：删除数据库服务

说明：

  • 执行数据库服务端可执行程序参数需要以管理员身份运行CMD或PowerShell。
  • 使用数据库服务端可执行程序参数启动后，任务管理器重名称默认为：XuguDB，描述默认为：Xugu Database Management System。

使用可执行程序参数命令示例：

注册并启动服务：
D:\SoftDocuments\xugudbms\XuguWindows\BIN\xugu_windows_amd64.exe -install

注册并启动服务：
D:\SoftDocuments\xugudbms\XuguWindows\BIN\xugu_windows_amd64.exe -start

停止服务：
D:\SoftDocuments\xugudbms\XuguWindows\BIN\xugu_windows_amd64.exe -stop

删除服务：
D:\SoftDocuments\xugudbms\XuguWindows\BIN\xugu_windows_amd64.exe -remove