createOM()

名称

createOM - 在目标集群控制器(sdbcm)所在的机器中创建 sdbom 服务进程( SequoiaDB 管理中心进程)。

语法

oma.createOM(<svcname>,<dbpath>,[config])

类别

Oma

描述

在目标集群控制器(sdbcm)所在的机器中创建sdbom服务进程( SequoiaDB 管理中心进程)。

Note:

  • oma 对象为连接到目标(本地/远端机器)集群控制器(sdbcm)获得的连接对象。

  • 一个集群只能归属于一个SequoiaDB 管理中心管理,但一个 SequoiaDB 管理中心却可管理多个集群。一般只创建一个 sdbom 服务进程即可。

参数

  • svcname ( Int | String必填 )

    节点端口号。

  • dbpath ( String必填 )

    节点路径。

  • config ( Object选填 )

    节点配置信息,如配置日志大小等,具体可参考数据库配置

    常用配置描述默认值
    httpname设置sdbom的网页端口svcname + 4
    wwwpath设置sdbom的网页路径sequoiadb安装路径的web目录

返回值

成功:返回 Oma 对象。

失败:抛出异常。

错误

createOM()函数常见异常如下:

错误码错误类型描述解决方法
-6SDB_INVALIDARG参数错误确认参数类型和参数个数是否正确
-145SDBCM_NODE_EXISTED节点已存在使用列表查看节点是否存在

如果出错则抛异常,并输出错误信息,可以通过getLastErrMsg()获取错误信息或通过getLastError()获取错误码。

关于错误处理可以参考常见错误处理指南

常见错误可参考错误码

版本

v2.0及以上版本。

示例

  1. 在本地中创建并启动一个本地端口号为11780,http端口为8000,web路径为/opt/sequoiadb/web的sdbom进程

    1. > var oma = new Oma("localhost", 11790)
    2. > oma.createOM( "11780", "/opt/sequoiadb/database/sms/11780",
    3. { "httpname": 8000, "wwwpath": "/opt/sequoiadb/web" } )
    4. > oma.startNode( 11780 )