libsolace

目录

• libsolace
  • 概述
  • 安装
  • API文档
    • XML生成器
    • CMDB配置数据和命名模式
    • 限制
• 供应
  • 配置
• 插件
• bin
• 类
• 站点管理/资源调配
  • -
  • 与自定义CMDB集成
  • 运行资源调配任务
• 测试
  • 单个插件
  • 单项测试
  • 全覆盖
• 文档
  • 文档测试
  • html

概述

这是一组python帮助程序，用于管理和设置消息传递设备和vmr。设计要灵活 旨在管理多个环境中的多个群集。

安装

1. 安装lxml和pyyaml
所需的库
2. 使用pip安装：

   pip install libsolace
   

API文档

API文档

XML生成器

这个供应系统的核心是solacexmlbuilder类，它可以通过类字典对象的递归实例化生成xml。例子：

>>>document=SolaceXMLBuilder(version="soltr/6_2")>>>document.create.client_username.username="myUserName">>>document.create.client_username.vpn_name="dev_MyVPN">>>str(document)'<rpc semp-version="soltr/6_2"><create><client-username><username>myUserName</username><vpn-name>dev_MyVPN</vpn-name></client-username></create></rpc>'

插件创建semp请求对象，然后需要通过solaceapi.rpc将其发送到设备。 编写插件来创建一个或多个semp命令，并在根据xsd验证xml后返回它们。

>>>fromlibsolace.SolaceAPIimportSolaceAPI>>>connection=SolaceAPI("dev")>>># VMR: connection = SolaceAPI("dev", detect_status=False, version="soltr/7_1_1")>>># create the command for creating a new user via the "SolaceUser" plugin>>>plugin_request=connection.manage("SolaceUser").create_user(client_username="foo",vpn_name="bar")>>>plugin_request.xml'<rpc semp-version="soltr/7_1_1"><create><client-username><username>foo</username><vpn-name>bar</vpn-name></client-username></create></rpc>'>>>plugin_request.kwargs{'vpn_name':'bar','primaryOnly':True,'backupOnly':True,'client_username':'foo'}

solacexmlbuilder通常通过solacapi使用，它会注意为您检测设备操作系统版本。例如

>>>fromlibsolace.SolaceAPIimportSolaceAPI>>>conn=SolaceAPI("dev")>>>conn.manage("SolaceUser").get(client_username="dev_testvpn",vpn_name="dev_testvpn")[{'HOST':'http://solace1/SEMP',u'rpc-reply':{u'rpc':{u'show':{u'client-username':{u'client-usernames':{u'num-total-client-usernames':u'763',u'max-num-total-client-usernames':u'9002',u'num-dynamic-client-usernames':u'0',u'num-configured-client-usernames':u'763',u'client-username':{u'profile':u'glassfish',u'dynamically-configured':u'false',u'acl-profile':u'dev_testvpn',u'max-endpoints':u'16000',u'client-username':u'dev_testvpn',u'max-connections-service-smf':u'9000',u'enabled':u'true',u'message-vpn':u'dev_testvpn',u'password-configured':u'true',u'num-clients':u'0',u'max-connections-service-web':u'9000',u'num-endpoints':u'3',u'subscription-manager':u'false',u'authorization-group':None,u'max-connections':u'500',u'num-clients-service-web':u'0',u'guaranteed-endpoint-permission-override':u'false',u'num-clients-service-smf':u'0'}}}}},u'execute-result':{u'@code':u'ok'},u'@semp-version':u'soltr/7_1_1'}},{'HOST':'http://solace2/SEMP',u'rpc-reply':{u'rpc':{u'show':{u'client-username':{u'client-usernames':{u'num-total-client-usernames':u'755',u'max-num-total-client-usernames':u'9002',u'num-dynamic-client-usernames':u'0',u'num-configured-client-usernames':u'755',u'client-username':{u'profile':u'glassfish',u'dynamically-configured':u'false',u'acl-profile':u'dev_testvpn',u'max-endpoints':u'16000',u'client-username':u'dev_testvpn',u'max-connections-service-smf':u'9000',u'enabled':u'true',u'message-vpn':u'dev_testvpn',u'password-configured':u'true',u'num-clients':u'0',u'max-connections-service-web':u'9000',u'num-endpoints':u'4',u'subscription-manager':u'false',u'authorization-group':None,u'max-connections':u'500',u'num-clients-service-web':u'0',u'guaranteed-endpoint-permission-override':u'false',u'num-clients-service-smf':u'0'}}}}},u'execute-result':{u'@code':u'ok'},u'@semp-version':u'soltr/7_1_1'}}]

vmr需要使用以下命令进行初始化：

>>>fromlibsolace.SolaceAPIimportSolaceAPI>>>conn=SolaceAPI("dev",detect_status=False,version="soltr/7_1_1)>>>conn.manage("SolaceUser").get(client_username="dev_testvpn",vpn_name="dev_testvpn")[{'HOST':'http://solace3:8080/SEMP',u'rpc-reply':{u'rpc':{u'show':{u'client-username':{u'client-usernames':{u'num-total-client-usernames':u'10',u'max-num-total-client-usernames':u'1002',u'num-dynamic-client-usernames':u'0',u'num-configured-client-usernames':u'10'}}}},u'execute-result':{u'@code':u'ok'},u'@semp-version':u'soltr/7_1_1'}},None]

CMDB配置数据和命名模式

在我的用例中，每个solace集群可能承载多个"环境"，因此所有对象都是用 允许多主机的特定于环境的名称。

* dev_MyVPN
* qa1_productA
* dev_productA

# single VMR "au_dev3"
./bin/solace-provision.py -e au_dev3 --no-detect-status -p MySolaceEcosystem --soltr_version="soltr/7_1_1"# 2 appliance cluster "dev"
./bin/solace-provision.py -e dev -p MySolaceEcosystem

 ./bin/solace-provision.py -e dev --no-detect-status -p MySolaceEcosystem --soltr_version="soltr/7_1_1"

---VPNS:MySolaceEcosystem:-vpn_config:spool_size:1024password:d0nt_u5e_th1sid:au_testvpnname:au_testvpn-vpn_config:spool_size:1024password:d0nt_u5e_th1sid:au_testvpn2name:au_testvpn2QUEUES:au_testvpn:-name:testqueue1queue_config:exclusive:"true"queue_size:4096retries:0max_bind_count:1000owner:au_testproductAconsume:allUSERS:au_testvpn:-username:au_testproductApassword:somepasswordau_testvpn2:-username:au_testproductApassword:somepassword