技术文档以及常见问题解答
2020-12-29 更新： 考虑到 miniSIPServer 已经提供了“事件通道” 功能，能供提供详细的分机状态、呼叫等信息，用户可以根据这些信息自己定制报表，因此从 V38 版本开始， miniSIPServer 不再提供这两张报表。
在SIP/PBX等设备中，一般都会包含“报表”功能，可以帮助系统管理员了解系统基本的运行状况。
在MSS中，也包含了一些基础的报表信息。请点击菜单“报表”即可。目前包含两个报表：
（1）基本呼叫报表
（2）分机报表
上述报表的统计周期都是以小时为单位，每小时出一条记录，如果当前统计周期内，所有统计项都为零，则不输出统计记录。
“分机报表”比较简单，目前只统计当前系统每小时内最大同时在线用户数，这有助于管理员了解在线用户情况。
“基本呼叫报表”统计当前的呼叫情况，例如收到呼叫数、呼叫振铃、呼叫应答等数据，同时也包括当前统计周期内应答呼叫的总通话时长，这样用户可以了解到呼叫平均占用情况，每个应答呼叫的平均通话时长等重要数据。如果系统呼叫数很高，负荷很大，系统管理员可以考虑升级MSS。
更新： 您现在可以访问在线文档，了解更多的细节。
如果您使用的是Ubuntu桌面版本，那么就非常容易了。下载deb文件后，双击即可安装MSS。安装完成后，您可以在“互联网”菜单群中找到MSS的图标，点击该图标即可启动MSS。
如果您是使用Ubuntu服务器版本，情况就稍有不同。需要多几步来安装运行MSS，下面我们详细介绍这些步骤。
首先，您必须从我们的网站下载相应的deb文件，例如mss_v13_u20.deb文件。接着，运行下面的命令进行安装：
sudo dpkg -i mss_v13_u20.deb
Ubuntu通常可能会提示缺少部分必要的依赖库。不用担心，请继续执行下面的命令：
sudo apt-get -f install
此时，Ubuntu系统会自动检查依赖关系，并从Ubuntu软件库中安装MSS所要求的依赖库。
在Ubuntu服务器版本中，您不能运行MSS的图形版本，因为通常服务器版本都不会启动X视窗系统。您可以运行MSS的命令行版本，文件名为msscli，安装在以下目录：’/opt/sipserver’。
因此，现在您可以使用以下命令来启动MSS：
/opt/sipserver/msscli
您必须使用MSS的web界面来管理MSS，缺省情况下是在TCP 8080端口访问该界面。请阅读以下文档了解web管理系统：
http://www.myvoipapp.com/cn/docs/mss_services/web_management/index.html
有部分虚拟PBX客户登录账户后发现，他们配置的外线信息不见了。
发生了什么事？外线配置怎么了？
这个现象的根本原因在于：用户在配置外线数据时，可能配置了错误的信息，例如配置了错误的密码。cloud-mss根据这些错误的信息向voip运营商注册，很显然会注册失败。当然，cloud-mss会继续尝试注册很多次。这样，对端的voip运营商很有可能将cloud-mss视为垃圾消息发送者或者不怀好意的攻击者，因此可能对cloud-mss实施消息过滤或者屏蔽，对其他cloud-mss用户造成恶劣影响。
为了避免这种情况，如果cloud-mss尝试注册外线达到一定次数后，始终无法注册成功，cloud-mss系统会判定外线配置错误并把这一信息通知后台管理系统，因此该外线将被系统自动删除。
这就是为什么会丢失掉虚拟IPPBX系统中的外线配置。如果你发现自己的账户出现了这种情况，请检查您的外线配置信息或者与您的VoIP运营商进行协调，然后在虚拟系统中重新配置外线即可。
您可能知道，我们可以采用Python脚本语言来提供业务。这种方式可以非常灵活地满足许多客户各种各样的需求。
例如，MSS内部的卡号业务就是采用Python脚本实现。在某些地方部署该业务时，客户会有些不同的需求，例如播放某种语音，或者不播放某条语音，提示这种情况，或者提示另一种情况，等等。我们可以根据客户的需求，更新python脚本文件，而不需要对MSS核心做任何改动。
但是某些东西就不那么灵活，例如业务的触发方式。以前的MSS版本在卡号业务中，固定了业务触发方式。也就是说，只有被叫号码是‘*300*’的呼叫才会触发卡号业务。有些客户就是不喜欢这个号码，还有些客户希望能支持更多的号码来触发业务。
最新的V10.4版本可以支持客户自己配置Python业务的触发方式，实际上，我们可以根据呼叫的拨号计划以及被叫号码来触发Python业务。现在就完美了！客户不仅可以实现定制化的业务，也可以自由地根据自己的需求选择如何触发业务。您不喜欢”*300*”？没问题，只需要配置另外一条数据即可。
请参考用户手册，了解Python业务触发的更多细节信息：
http://www.myvoipapp.com/cn/docs/mss_services/manual/index.html#python_services
昨天在某位朋友的网站上, 看到为了做个回呼, 折腾了很久, 不停地尝试各种各样的PBX产品.
“回呼”确实是个非常有中国特色需求的VoIP应用. 在我们以前的blog以及业务文档中曾经说过, MSS其实是很容易实现回呼(callback)功能的. MSS只要接收相应的业务请求命令即可发起回呼.
然而让我们没有想到的是, 相当部分的使用者并不知道如何向MSS发起回呼请求. “打开UDP端口”实在是个过于技术化的说明. 因此我们更新了回呼业务文档, 增加了一个PHP演示脚本程序, 用户仅需要进行简单更新即可. 当然, 这仍然要求用户具备一点点PHP知识背景. 用户也可以根据这个程序, 使用其他任何一种语言进行重写和定制.
http://www.myvoipapp.com/cn/docs/mss_services/call_back/index.html#faq
相信您看了这个PHP文件后, 会发现”回呼, 其实很简单”. 试试吧!
昨天我们收到了一位中国客户报告的问题： 系统运行几十分钟后， MSS丢失了和MySQL数据库之间的连接，错误原因是“2006, ‘MySQL server has gone away’”。
这是我们首次接到这个问题的报告。在MSS系统中， 一旦和MySQL数据库建立连接后，MSS会每1.5小时自动向MySQL数据库发送ping消息，以保持双方的连接。而MySQL数据库激活定时器缺省值为28800秒，即8小时。我们猜测，可能是MySQL数据库中的缺省值被修改了， 导致MSS试图连接MySQL数据库时， 发生连接丢失的情况。
因此我们请客户在MySQL的命令行管理界面中，输入以下命令进行检查：
show variables like '%out%';
其中，我们关心interactive_timeout和wait_timeout两个参数的值。在客户的环境中，这两个参数被修改为1200秒。
我们不确定是新版本的MySQL将缺省值修改为1200秒，还是某位管理员人工修改了这些值。如果您的环境中也有类似的问题，请进行同样的检查并将这些参数修改为超过1.5小时的值。我们建议保持原有的缺省值，即28800秒。
一旦修改了这些参数，请重启MySQL和MSS，以确保双方的连接采用新的定时器值。
有很多MSS云系统客户经常来信咨询这个问题，他们当地的运营商大部分采用封锁SIP标准端口5060来屏蔽SIP呼叫。
对于这种情况，我们升级了MSS云系统，可以支持多个UDP端口处理SIP呼叫：5060，6060以及8080端口。在云系统管理界面中，请点击“基本呼叫 / 系统信息”，然后选择相应端口更新即可。请参考下图的操作：
如果您选择的端口不是标准5060端口，您必须注意同时更改客户端（包括SIP电话和SIP软终端等）的相关配置。下图是我们的一个xlite软终端演示配置，其中服务器端的端口已经修改为8080端口：
miniSipServer升级到V6.5版本，支持针对不同的入呼叫触发不同的IVR流程。
在MSS中进行简单的配置即可实现上述目的，请参考在线文档：
http://www.myvoipapp.com/cn/docs/mss_services/auto_attendant/index.html#multi-ivr
例如，我们希望对外线“1234”的入呼叫触发另外一个IVR流程，我们可以在“IVR业务”表中进行以下配置：
拨号计划 = default 被叫号码 = 1234 <--外线号码 IVR-XML文件名 = aa2.xml <--您自己定义的IVR-XML文件
“缩位拨号”业务，通常也称为“速拨”业务，是传统PBX系统中的一项业务。该业务允许用户拨打某些删减的号码发起呼叫。如果用户经常拨打某些特定的呼叫，则该项业务非常有用。
在云端miniSipServer中很容易配置该业务。请参考下图：
我们需要作的仅仅是点击菜单“高级业务 / 缩位拨号”，然后添加一些记录即可。
昨天我们升级了云端miniSipServer。本次升级主要目的之一就是支持“连选组”业务。
本地miniSipServer中在很久以前就已经支持连选组业务。本次云端IPPBX升级就是移植了本地系统的实现方式，使云端系统的用户也能使用连选组业务服务自己的客户。云端连选组业务与本地连选组业务的业务逻辑、配置方式是完全一致的，区别仅仅在于界面的表现形式不同而已。
下面两张图是云端miniSipServer与本地miniSipServer的“连选组业务“界面截图。
云端系统截图：
本地系统截图：
关于连选组业务的更多细节，请参考我们的在线业务指导文档：
http://www.myvoipapp.com/cn/docs/mss_services/hunting_group/index.html