单节点模式

执行安装包 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 系统启动后自动加载的模块或插件。如果需要加载多个模块或插件,使用逗号分隔。