魔方DCIM使用文档>产品销售>对接WHMCS实现服务器管理
前言一、WHMCS插件下载和安装方法 1.1 功能支持 1.2 插件下载和安装二、DCIM服务器管理系统中的设置 2.1 设置API 2.2 服务器分组设置 2.3 对接财务系统相关设置选项三、WHMCS中的设置 3.1 服务器对接原理和参数 3.1.1 添加服务器 3.1.2 添加服务器分组 3.1.3 添加产品 3.2 可配置选项原理和参数 3.2.1 设置销售的服务器型号server_group 3.2.2 设置下单操作系统os 3.2.3 设置IP地址数量ip_num 3.2.4 设置带宽调整|bw 3.2.5 设置开机脚本|mscripts四、WHMCS前后台管理 4.1 产品对接dcim实现开机关机重装后台管理 4.2 会员中心管理功能 4.3 自动开通功能五、问题说明 5.1 服务器设置中的hash自定义 5.2 API用户名密码错误 5.3 连接端口错误 5.4 DCIM无法连接 5.5 自动开通失败:该分组没有空闲服务器 5.6 其他问题 前言WHMCS插件用于「DCIM系统对接WHMCS」,实现自动化管理,实现whmcs开通,删除服务器,开机关机重装等管理。支持whmcs版本为「whmcs6.x 」「whmcs7.x」 一、WHMCS插件下载和安装方法 1.1 功能支持 1.2 插件下载和安装 1.1 功能支持 1.2 插件下载和安装 ①下载:前往【DCIM后台】-【系统设置】-【whmcs设置】-【右上角点击下载whmcs插件】 ②安装:将下载后的插件内容【上传至whmcs中】,需将【ipmi文件】上传至【whmcs根目录/module/server/中】,【idcsmart_flowpacket】上传至【whmcs根目录/module/addons/中】 二、DCIM服务器管理系统中的设置 2.1 设置API 2.2 服务器分组设置 2.3 对接财务系统相关设置选项 2.1 设置api 请前往【DCIM系统】-【系统设置】-【API授权】-【添加API授权】 2.1.1 添加api信息用户名:建议为whmcs 可输入其他Key: 点击随机后注意妥善保存IP:填写whmcs所在服务器的出口IP,我们仅允许该ip地址访问我们的接口 2.2 服务器销售分组设置(自动开通用) 如需实现服务器的自动开通,需设定服务器分组,否则请跳过 前往【DCIM】-【产品销售】-【服务器租用】-【右上角点击设备销售分组】 2.3 对接财务系统相关设置选项 以下选项为设定whmcs操作服务器的方法,例如whmcs操作暂停服务器时应该进行何种操作删除机器自动空闲IP:用于在whmcs唤起删除服务器时是否需要将ip地址移除或移除哪些ip地址通知接口地址:预留设定,用于DCIM系统对接金盾,攻击监控等系统后的自动通知至whmcs,实现封停ip/短信/邮件/工单通知客户等功能whmcs后台地址:用于DCIM中的快速链接,可一键链接至whmcs中流量图95线:用于控制在whmcs显示的流量图是否输出95th和输出方式 三、WHMCS中的设置 3.1 服务器对接原理和参数 3.2 可配置选项原理和参数 3.1 服务器对接原理和参数 3.1.1 添加服务器 3.1.2 添加服务器分组 3.1.3 添加产品 系统通过whmcs预留的server module原生方式对接至whmcs,使用whmcs原生产品设置和配置选项进行产品的价格定义。 我们使用whmcs默认提供的hash方式,进行一些接口自定义配置,您可根据教程一步一步完成配置。 3.1.1 添加服务器 【前往WHMCS】-【系统设置】-【服务器设置】-【添加新的服务器】 *必填字段:NAME(名称):DCIM配置Hostname (主机名):填写DCIM的域名或ip地址Ip(IP地址):填写DCIM的域名或ip地址Type(类型):选择ipmiUsername(用户名):添加的api 用户名Password(密码):添加的key勾选SSL:端口默认为443,如有变更dcim访问端口,请填写dcim端口Hash(访问散列值)建议配置如下:点击这里查看参数说明 <flowchart>on</flowchart>
<kvm>on</kvm>
<resetbmc>on</resetbmc>
<kvmadmin>on</kvmadmin>
<resetbmcadmin>on</resetbmcadmin>
<reinstall>on</reinstall>
<reinstalladmin>on</reinstalladmin>
<reinstalltimes>99</reinstalltimes>
<adminoutip>on</adminoutip>
<post_emailorid>userid</post_emailorid>
<changehostname>ip</changehostname>
<reboot>on</reboot>
<rebootadmin>on</rebootadmin>
<off>on</off>
<offadmin>on</offadmin>
<on>on</on>
<onadmin>on</onadmin>
<ikvm>on</ikvm>
<ikvmadmin>on</ikvmadmin>
<vnc>on</vnc>
<vncadmin>on</vncadmin>
<idcimadmin>on</idcimadmin>
<rescue>on</rescue>
<rescueadmin>on</rescueadmin>
<crackadmin>on</crackadmin>
<crack>on</crack>
<customport>on</customport>
<custompartition>on</custompartition>
<changemainip>on</changemainip>
<changeassignip>on</changeassignip> 3.1.2 添加服务器分组 【前往WHMCS】-【系统设置】-【服务器设置】-【创建新的分组】 3.1.3 分配服务器至分组 3.1.4 添加产品 前往【系统设置】-【产品/服务】-【产品/服务】-【新增产品】 产品类型:独服/VPS产品名称:服务器产品型号1 模块设置: 模块名称-ipmi服务器组:IPMI类型:服务器租用3.2 可配置选项原理和参数 3.2.1 设置销售的服务器型号server_group 3.2.2 设置下单操作系统os 3.2.3 设置IP地址数量ip_num 3.2.4 设置带宽调整|bw 3.2.5 设置开机脚本|mscripts我们使用whmcs可配置选项功能进行配置选项传递,包含以下产品,格式为: 参数 | 显示名称注:红色为自动开通用,如无需使用自动开通功能,无需配置该字段字段:server_group|设备销售分组 参数:1|分组1 (1为DCIM中设备销售分组ID) 字段:os|操作系统 参数:1|windows2008 中文 (1为DCIM中-系统设置-重装系统-操作系统ID) 字段:ip_num|IP数量 参数:5|5个IP (5为需要为该服务器分配的IP数量) 注: NO_CHANGE |1个 可配置为NO_CHANGE,即不改变服务器IP数量,设置为NO_CHANGE后,系统不会对服务器IP数量进行变更字段:ip_num|IP数量 按ip分组来分配ip 参数:5_1|5个IP (5为需要为该服务器分配的IP数量,1为DCIM里ip分组的id)字段:bw|带宽 参数:10,5|进10Mbps,出5Mbps (10,5分别代表进出带宽,单位Mbps) 注: NO_CHANGE,5|5Mbps NO_CHANGE可用,代表不改变服务器当前方向的限速设定前往【系统设置】-【产品/服务】-【可配置选项】-【Create a New Group】Group Name:配置组名称,建议服务器产品型号Description:描述自定义Assigned Products:指定产品Add New Configurable Option:点击添加新的可配置选项 3.2.1 设置销售的服务器型号server_group 3.2.2 设置下单操作系统os 3.2.3 设置IP地址数量ip_num 3.2.4 设置带宽调整|bw 3.2.5 设置开机脚本|mscripts 四、WHMCS前后台管理 4.1 产品对接dcim实现开机关机重装后台管理 4.2 会员中心管理功能 4.3 自动开通功能4.1 产品对接dcim实现开机关机重装后台管理完成以上配置后,我们即可实现对接管理,为客户添加产品在服务器ID处填写该服务器在DCIM中的ID,即可操作功能。4.2 会员中心管理功能同时,客户可在会员中心前台进行管理。关于允许客户使用的功能控制,请参考 5.1 ipmi插件配置参数说明4.3 自动开通功能如需使用自动开通功能请完成以下配置1. 服务器销售分组设置(自动开通用)2. 可配置选项原理和参数中的红色字段五、问题说明5.1 ipmi插件配置参数说明<flowchart>on</flowchart> --flowchart #是否开启流量图输出, on开启,off关闭<kvm>on</kvm> --kvm #是否开启kvm控制按钮输出, on开启,off关闭<resetbmc>on</resetbmc> -- resetbmc #是否输出重置bmc按钮, on开启,off关闭<kvmadmin>on</kvmadmin> --kvm #控制管理员界面是否开启kvm控制按钮输出, on开启,off关闭<resetbmcadmin>on</resetbmcadmin> -- resetbmc #控制管理员界面是否输出重置bmc按钮, 默认开启 on开启,off关闭<reinstall>off</reinstall> --reinstall #重装 是否输出重装按钮, on开启,off关闭<reinstalladmin>on</reinstalladmin> --reinstalladmin #后台重装系统 控制管理员界面是否开启重装按钮输出, 默认开启 on开启,off关闭<reinstalltimes>3</reinstalltimes> --reinstalltimes #每周重装次数<adminoutip>on</adminoutip> --adminoutip #on开启才能输出后台IP控制面板 <post_emailorid>userid</post_emailorid> --post_emailorid #email传递邮箱 userid传递WHMCS的userid<changehostname>ip</changehostname> --changehostname #主机名的保存方式 hostname改为机器名称 ip改为主ip hostnameip改为 机器名称-主ip 例如w20101-10.10.0.1 none不同步<reboot>on</reboot> --reboot #重启 是否输出重启按钮 on开启 off关闭 <rebootadmin>off</rebootadmin> --rebootadmin #重启 控制管理员界面是否输出重启按钮 on开启 off关闭<off>on</off> --off #关机 是否输出关机按钮 on开启 off关闭 <offadmin>on</offadmin> --offadmin #关机 控制管理员界面是否输出关机按钮 on开启 off关闭<on>on</on> --on #开机 是否输出开机按钮 on开启 off关闭<onadmin>on</onadmin> --onadmin #开机 控制管理员界面是否输出开机按钮 on开启 off关闭<ikvm>on</ikvm> --ikvm #是否输出ikvm按钮 on开启 off关闭<ikvmadmin>on</ikvmadmin> --ikvmadmin #控制管理员界面是否开启ikvm控制按钮输出, on开启,off关闭<vnc>on</vnc> --vnc #前台是否输出vnc按钮, on开启,off关闭<vncadmin>on</vncadmin> --vncadmin #控制管理员界面是否输出vnc按钮, on开启,off关闭<idcimadmin>on</idcimadmin> --idcimadmin #快捷跳转 控制管理员界面是否输出快捷跳转服务器管理系统按钮 on开启 off关闭<rescue>off</rescue> --rescue #救援系统 前台是否输出救援系统按钮 on开启,off关闭<rescueadmin>on</rescueadmin> --rescueadmin #后台救援系统 控制管理员界面是否开启救援系统按钮输出 on开启,off关闭<crackadmin>on</crackadmin> --crackadmin #后台破解密码 控制管理员界面是否开启破解密码按钮输出 on开启,off关闭<crack>on</crack> --crack #破解密码 前台是否输出破解密码按钮 on开启,off关闭<customport>on</customport> --customport #重装自定义端口 前台重装是否允许自定义端口 on开启,off关闭<custompartition>on</custompartition> --custompartition #重装自定义分区 前台重装是否允许自定义分区 on开启,off关闭<sms_check>on,off,reboot,bmc,kvm,ikvm,vnc,reinstall,rescue,crack</sms_check> --sms_check #需要短信验证的方法,需要安装短信验证插件, 用,分隔支持on(开机),off(关机),reboot(重启),bmc(重置BMC),kvm(kvm),ikvm(ikvm),vnc(vnc),reinstall(重装系统),rescue(救援系统),crack(破解密码)<changemainip>on</changemainip> --changemainip #同步是否保存主ip 默认开启 on开启,off关闭<changeassignip>on</changeassignip> --changeassignip #同步是否保存分配ip 默认开启 on开启,off关闭5.2 API用户名密码错误检查DCIM的API接口及WHMCS的服务器设置的用户名和密码是否一致5.3 连接端口错误检查SSL端口是否填写正确5.4 DCIM无法连接检查WHMCS服务器设置中的主机名及IP是否填写正确5.5 自动开通失败:该分组没有空闲服务器 检查在DCIM设备销售分组里是否有空闲服务器