createOM()

名称

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

语法

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

类别

Oma

描述

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

Note:

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

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

参数

  • svcname ( String必填 )

节点端口号。

  • dbpath ( String必填 )

节点路径。

  • config ( Object选填 )

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

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

返回值

成功:返回 Oma 对象。

失败:抛出异常。

错误

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

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

当异常抛出时,可以通过getLastError()获取错误码,或通过getLastErrMsg()获取错误信息。可以参考常见错误处理指南了解更多内容。

版本

v2.0及以上版本。

示例

  • 在本地中创建并启动一个本地端口号为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 )