如何使用智简魔方系统对接WHMCS实现自动开通功能

对接WHMCS实现自动开通

智简魔方DCIM系统可以对接WHMCS系统实现服务器的自动开通关闭重装等操作,本文为您介绍如何配置WHMCS对接DCIM系统。

一:WHMCS插件下载和安装方法

本章节文档为您介绍从哪里下载对接DCIM系统的WHMCS插件,以及如何安装WHMCS插件。

1.1 WHMCS插件下载

            请登录DCIM系统,点击导航栏里面的【系统设置】-【WHMCS设置】,然后在页面右上角点击【WHMCS插件下载】,如下图:

2019-08-12_151423.png

1.2 WHMCS插件安装方法

        下载后的压缩包解压后,打开ftp,将文件上传至WHMCS根目录,如下图所示,然后进入WHMCS后台进行设置即可。

image.png

二:WHMCS插件配置教程

本段文档主要是介绍如何对插件进行配置,完整配置流程需要:添加IPMI服务器、添加产品,添加产品又涉及到产品可配置选项。作为本文档最重要的内容,我们建议您仔细阅读下面的操作步骤。

2.1 添加IPMI服务器

        2.1.1、进入WHMCS后台,点击Setup(设置)- Products/Services(产品与服务)- Servers(服务器设置)。

2019-08-12_152251.png

        2.1.2、点击Create New Group新建一个服务器分组,然后再点击Add New Server新建服务器。(如果您已经有设置好的组和服务器,也可以直接编辑已经添加的服务器设置。)

2019-08-12_152712.png

        2.1.3、在服务器Add Server(编辑服务器)区域,Hostname(主机名)和IP Address(IP地址)填写DCIM系统的IP。

2019-08-12_153110.png

        2.1.4、在服务器配置的Server Details里面,填写上对应的IPMI信息,如下图:

2019-08-12_153319.png

        2.1.5、Type(类型)选择ipmi

        2.1.6、Username(用户名)和Password(密码),请访问DCIM系统后台,导航栏-【系统设置】-【API授权】,右上角【+添加API授权】,添加界面如下图:

2019-08-12_153851.png

        用户名和key可自定义,IP请填写WHMCS服务器的主IP地址(多个IP则一行一个)。

        2.1.7、ipmi插件参数 Access Hash(访问散列值)请填写下面内容:(各项说明请看这里

                <kvm>on</kvm>
                <resetbmc>on</resetbmc>   
                <kvmadmin>on</kvmadmin>
                <resetbmcadmin>on</resetbmcadmin>  
                <reinstall>off</reinstall>
                <reinstalladmin>on</reinstalladmin>
                <reinstalltimes>3</reinstalltimes> 
                <adminoutip>on</adminoutip>  
                <post_emailorid>userid</post_emailorid>
                <changehostname>ip</changehostname>  
                <reboot>on</reboot>         
                <rebootadmin>off</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>

        配置完毕后保存,ipmi服务器添加完毕。接下来添加产品。

2.2 添加产品

        2.2.1、WHMCS后台点击 Setup(设置)- Products/Services(产品和服务)- Products/Services(产品和服务),新增一个产品(如果没有产品分组,则先创建一个产品分组Group)

2019-08-12_154127.png

        2.2.2、新增产品的时候,Module(模块)选择ipmi(如果您是低版本的WHMCS,可能和下图界面有所不同,添加产品后进入(Module Settings)接口设置里面选择ipmi即可。)

2019-08-12_154346.png

        提示:上图中的Product Type类型选择Server/VPS,当WHMCS自动开通服务器后,DCIM系统会自动重装系统并且在用户前台显示默认密码。

        2.2.3、在Module Settings(模块设置)界面,可以修改类型,将会自动对接到DCIM系统后台后自动分类。

2019-08-12_154543.png

        2.2.4、添加产品的时候,您可以根据自己实际情况选择是否自动开通服务。

    三:产品可配置选项

产品可配置选项需对接DCIM系统,将对以下参数进行配置:

    server_group|服务器分组

     os|操作系统

    ip_num|IP数量

    bw|带宽选择

        3.0 添加配置选项组

        3.0.1、进入WHMCSSetup(系统设置)- Products/Services(产品和服务)- Configurable Options(可配置选项),新增一个分组。

2019-08-12_154925.png

        3.0.2、点击Create a New Group按钮后出现下图:

image.png

  3.0.4、点击保存按钮后,出现Add New Configurable Option按钮,点击Add按钮,添加产品配置参数。

image.png

        先Add(新增)一个可配置项目后保存,然后再次Add(新增)可配置项目。(需要手动刷新页面才会显示新增的内容)配置完成后如下图:

image.png

3.1 server_group|服务器分组

        配置服务器分组前,需要先进入DCIM系统进行设置,操作步骤如下:

2019-08-12_155851.png

        3.1.1、DCIM系统导航栏-【产品销售】-【服务器租用】界面,点击右上角的【设备销售分组】按钮。

        3.1.2、添加一个分组,名称自定义,添加完毕您需要记录以下两个值。(主要是记录ID的值,名称的值仅作为显示,可自定义。)

2019-08-12_160057.png

        3.1.3、在WHMCS的添加可配置选项窗口里面,Option Name的值填写【server_group|服务器分组】

        3.1.4、Add Option里面填写【11|28132】(格式:ID|名称),然后保存。

2019-08-12_165338.png

        3.1.5、为添加的分组增加服务器,否则无法自动开通。

2019-08-16_144435.png

            提示:上图中,服务状态分为正常和空闲,空闲的机器,可以直接使用WHMCS自动开通,正常的服务器,代表已经有用户使用,可以手动同步WHMCS数据,或者清空服务器销售数据变为空闲状态。

3.2 os|操作系统

        点击Add New Configurable Option按钮后,Option Name输入【os|操作系统】,Add Option的值输入【ID|系统名称】.

2019-08-12_165833.png

        注意,ID的值不能乱填,需要去DCIM系统获取,步骤如下:

        DCIM系统后台导航栏-【系统设置】-【重装系统】,在出现的镜像管理列表里面,获取操作系统ID值,如下图:

2019-08-12_160247.png

        例如添加ID为48的那个操作系统,则可以填写【48|Windows 2019】

        点击保存按钮后,可以再次添加Add Option的值(添加其他可选操作系统)。

3.3 ip_num|IP数量

        Option Name的值为 【ip_num|IP数量】,Add Option的值的格式为【数量|说明】,例如【1|1个IP】、【10|10个IP】

2019-08-12_170258.png

3.4 bw|带宽选择

        Option Name的值为 【bw|带宽 】,Add Option的值的格式为【进带宽,出带宽|说明】,例如【100,100|100Mbps】(注意是英文逗号隔开),则代表进出带宽都是100,带宽默认单位为Mbps

2019-08-12_170550.png

四:WHMCS前后台管理

服务器自动开通后,管理员可以在WHMCS后台客户产品详情页面对服务器进行系列管理,客户也可自行在WHMCS前台的产品详情页对服务器进行系列管理,管理功能的开关请参照【ipmi插件配置参数】

4.1 WHMCS管理员后台管理

        从WHMCS后台进入客户的产品详情页面,可以看到下图中的这些按钮。

2019-08-12_160422.png

        Module Commands:(模块命令)后面的按钮您可以在配置【IPMI服务器】的时候,通过【Access Hash(访问散列值)】参数控制是否开启和关闭。

        状态同步按钮:同步DCIM系统的数据(例如服务器密码、IP等)

        system系统按钮:跳转到DCIM系统对应的服务器页面。

4.2 WHMCS客户前台管理

        购买服务器的客户,在WHMCS前台服务详情页面,可以看到下图的界面(Six主题演示)

2019-08-12_160518.png

        如果是使用的【MC Space主题】,则是下图的界面。

2019-08-12_160612.png

        同样的,前台这些功能按钮都是通过【Access Hash(访问散列值)参数】控制是否开启和关闭。

五:其他问题说明

本段文档主要记录客户在配置WHMCS插件过程中常见问题,文档为列出之处,请联系我们客服。

ipmi插件配置Access Hash(访问散列值)参数说明

        <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
        <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关闭

        WHMCS里给服务器开机提示“模块命令错误,产品不一致”

            提示这个错误是因为DCIM系统和WHMCS系统分配的服务器用户不一致导致的。DCIM系统那边录入的这台机器不是现在WHMCS记录的这个用户的,在服务器管理系统中删除后,在点击状态同步即可。

       如何将服务器手动分配给客户?

                方法一:DCIM系统,服务器详情页面,在销售数据处选择编辑,可以修改服务器销售状态,例如指定给客户,将服务器设置为空闲状态。

2019-08-16_145412.png

                方法二:进入WHMCS后台,用户的服务详情页面,在“内部管理服务器ID”处填写上DCIM系统里面服务器列表页获取的服务器ID值,就可以将服务器分配给WHMCS上的客户,然后点击【保存】按钮后再点击【状态同步】按钮。

2019-08-16_150036.png

原创文章,作者:kinpo, k,如若转载,请注明出处:https://www.yidc.net/archives/1105