单节点模式

执行安装包 server 目录的可执行文件，可以快速启动单节点模式。单节点模式可以帮助用户试用并快速上手 DolphinDB。

启动指令

单节点部署，直接启动执行文件即可。以下是不同系统的启动指令示例：

  • Linux 系统

    // 启动本地节点
./dolphindb -localSite localhost:8900:local8900

  • Windows 系统

    在 Windows 环境中，直接双击运行 dolphindb.exe 进行启动。或者在命令行终端输入以下指令启动：

    // 启动本地节点
dolphindb.exe -localSite localhost:8900:local8900

启动 DolphinDB 终端

DolphinDB 终端是一个命令行交互式工具，用于连接到远程的 DolphinDB 服务器执行命令。

Linux 系统使用以下命令启动 DolphinDB 终端：

rlwrap -r ./dolphindb -remoteHost 192.168.1.135 -remotePort 8848

Windows 系统使用以下命令启动 DolphinDB 终端：

dolphindb.exe -remoteHost 192.168.1.135 -remotePort 8848

退出终端：

quit

命令行中支持以 "-" + “配置项” 的格式指定配置参数。不频繁修改的配置项建议在配置文件中指定。命令行通常用于指定一些灵活可变的参数，如 server 的 ip 和端口号、最大内存上限等。需要注意的是，存在部分参数只支持在命令行指定，见下表：

配置参数 解释
remoteHost DolphinDB 远端服务器的 IP 地址。
remotePort DolphinDB 远端服务器的端口号。
stdoutLog 设置输出系统日志到日志文件（dolphindb.log）或者标准输出（控制台）。取值为0（默认），表示输出到日志文件；取值为1，表示输出到 stdout；取值为2，表示同时输出到日志文件和标准输出。
uid DolphinDB 远端服务器的用户名。
pwd DolphinDB 远端服务器的密码。
run 启动时发送到远端的 DolphinDB 服务器执行的位于本地的 DolphinDB 脚本文件。该文件在系统执行 startup 参数指定的文件后执行。默认情况下，该文件应该位于 <HomeDir>。它以命令行方式运行一个任务。注意：该文件执行完后，系统将会自动退出。若文件执行成功，则返回0；否则返回非0值。
maxLogSize=1024 当日志文件达到指定大小（单位为 MB）时，系统会将其存档。默认值是1024，最小值是100。原日志文件名添加前缀作为存档的文件名。前缀的格式为 <date><seq>。例如，20181109000有三位数字，从000开始。
console=true 表示是否启动 DolphinDB 命令行窗口的布尔值，默认值是 true。该参数只能在命令行中指定。

还有部分仅命令行支持的配置项由于在文中已进行了说明，这里仅列出名字：home, logFile, config, clusterConfig, nodesFile。

启动流程

DolphinDB 系统的启动流程如下图所示：

该流程中涉及到三个启动脚本的执行，脚本路径的配置参数如下：

配置参数 解释
init=dolphindb.dos 该文件在系统启动时执行。默认文件是 <HomeDir>/dolphindb.dos。它通常包含了对所有用户可见并且不能被改写的系统级函数的定义。
startup=startup.dos 该文件在系统启动后执行。默认文件是 <HomeDir>/startup.dos。它可以包含加载插件、加载分布式表、定义并加载流数据表等脚本。
postStart=postStart.dos 该文件在初始化定时任务模块之后执行。默认文件是 <HomeDir>/postStart.dos。它可以在启动 DolphinDB 时加载定时作业相关的任务。

此外，DolphinDB 还支持启动时预加载模块和插件，通过配置项 preloadModules 指定。若

  • 预加载插件：必须写上 "plugins::"，比如预加载 mysql 插件，必须指定为 plugins::mysql，系统会到 pluginDir 目录加载插件。

  • 预加载模块：只能指定相对于 moduleDir 的文件路径。比如存放于 moduleDir（默认为 modules）的 system/log/fileLog.dos 模块，必须指定为 system::log::fileLog。

配置参数 解释
preloadModules=plugins::mysql,system::log::fileLog 系统启动后自动加载的模块或插件。如果需要加载多个模块或插件，使用逗号分隔。