简介
本文档介绍Cisco Unified Communication Manager(CUCM)12.X中新的服务统一资源定位器(URL)。
先决条件
Cisco Extension Mobility允许用户临时访问其Cisco Unified IP电话配置,如线路显示、服务和从其他Cisco Unified IP电话快速拨号。分机移动支持运行SCCP和SIP的思科统一IP电话。
分机移动功能在大多数思科统一IP电话上扩展。您可以在Cisco Unified Communications Manager Administration的Default Device Profile窗口中配置每部Cisco Unified IP电话,以支持Cisco Extension Mobility。这样,没有特定Cisco Unified IP电话的用户设备配置文件的用户就可以将Cisco Extension Mobility与该电话配合使用。
要求
CUCM 12.X中引入了此功能。
使用的组件
CUCM版本:12.0.0.99834-5
电话型号 — 88XX
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始(默认)配置。如果您的网络处于活动状态,请确保您了解所有命令的潜在影响。
配置
网络图
配置
分机移动服务URL配置(EM):
您熟悉为“用户ID”的普通登录配置分机移动URL。
普通EM登录URL:
http:// <ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#
根据电话服务URL中的参数,Extension Mobility Application为最终用户提供不同类型的登录页面。
EM登录现在有三种不同类型:
- 用户 ID
- 主DN
- 自助服务用户ID
下表帮助您识别不同的登录类型:
1.用户ID(UID):
这是允许用户使用其用户ID登录的服务URL。
此处,UID是登录类型。
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=UID
导航至Device > Device Setting > Phone Services > Add New
它在实际电话上的外观:
2.主DN
首先,您需要了解主DN的含义是什么?
因此,在“最终用户配置”(End user configuration)页面上,您可以选择设置主DN。
如果未为用户设置主DN并尝试登录,则会收到以下错误失败:
Error code : 23
Error message on phone: Login is unavailable(23) / Logout is unavailable(23
在数据库中找不到输入的用户ID(UID)/自助服务用户ID(SP)或主分机(DN)时发生
这是允许用户使用其权限DN登录的服务URL。
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=DN
导航至Device > Device Setting > Phone Services > Add New
它在实际电话上的外观:
3.自助服务用户ID
这是用于管理自助服务门户的ID。
如果未在最终用户页面上配置,则不允许您登录此服务URL,并会显示以下错误:
Error code : 23
Error message on phone: Login is unavailable(23) / Logout is unavailable(23)
- 在数据库中找不到输入的用户ID(UID)/自助服务用户ID(SP)或主分机(DN)时发生
自助服务用户ID的服务URL:
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&loginType=SP
导航至Device > Device Setting > Phone Services > Add New
它在实际电话上的外观:
跨群集分机移动服务URL配置(EMCC):
与EM服务URL一样,我们也有三种类型的EMCC登录。以下是各登录类型的服务URL。
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=UID
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=DN
http://<ip>:8080/emapp/EMAppServlet?device=#DEVICENAME#&EMCC=#EMCC#&loginType=SP
EMCC的错误代码:
EMCC登录问题的常见错误代码:
- 错误代码:47
电话上的错误消息:DN有多个用户(47)
当为多个用户分配用于登录的分机(最终用户配置页下的主分机)时,在EMCC登录时发生
- 错误代码:1
电话上的错误消息: 登录不可用(1)/注销不可用(1)
当EM服务无法解析来自EMApp/EMservice的XML请求或由于主版本和访问CUCM版本之间的版本不匹配而发生。
- 错误代码:23
电话上的错误消息: 登录不可用(23)/注销不可用(23)
在数据库中找不到输入的用户ID(UID)/自助服务用户ID(SP)或主分机(DN)时发生
注意:如果EMCC在12.x和任何12.x之前的CUCM之间配置,则登录过程仅使用用户ID(传统方式),而不使用DN或自助服务ID。
验证
故障排除
收集以下EM/EMCC问题日志:
- Cisco Extension Mobility
- Cisco Extension Mobility应用程序
- 电话控制台日志
- 从电话捕获数据包
- TVS记录详细信息
Snippet for EM APP logs.
========================================================================================
Sample Snippets for Login Type "DN"
2017-08-28 21:07:04,522 INFO [http-bio-8080-exec-10] EMAppServlet - EMApp Request# ----->1190
2017-08-28 21:07:04,523 INFO [http-bio-8080-exec-10] EMAppServlet - EMAppServlet: Request protocol is :http
2017-08-28 21:07:04,523 INFO [http-bio-8080-exec-10] EMAppServlet - EMApp Request parameters: Logout=null Device Name=SEP74A02FC09CDF User Id=null Device Profile=null Refresh=null Remote Host IP Address = 10.106.99.235 Via Header Set = false getClusterInfo = null Lang = en_US Charset=utf-8,;q=0.8 Emcc = true LoginType = DN
2017-08-28 21:07:04,523 INFO [http-bio-8080-exec-10] CMDatabase - CMDatabase:checkDeviceAllowsAlternateScript
2017-08-28 21:07:04,551 INFO [http-bio-8080-exec-10] CMDatabase - SEP74A02FC09CDF with model 36224 and locale 1 does not support alternate script
2017-08-28 21:07:04,551 INFO [http-bio-8080-exec-10] EMAppServlet - Alternate Script for device SEP74A02FC09CDF =
2017-08-28 21:07:04,552 DEBUG [http-bio-8080-exec-10] EMServiceCommunicator - Posting to EM Service:<query>
<appInfo>
<appID>CCMSysUser</appID>
<appEncryptedCertificate>xxxxxxx</appEncryptedCertificate>
</appInfo>
<deviceUserQuery>
<deviceName>SEP74A02FC09CDF</deviceName>
<loginType>DN</loginType>
<remoteIPAddr>10.106.99.235</remoteIPAddr>
</deviceUserQuery>
</query>
==================================================================================
Sample Snippets for Login Type "SP"
2017-08-28 22:06:05,781 INFO [http-bio-8080-exec-24] EMAppServlet - EMApp Request# ----->1204
2017-08-28 22:06:05,782 INFO [http-bio-8080-exec-24] EMAppServlet - EMAppServlet: Request protocol is :http
2017-08-28 22:06:05,782 INFO [http-bio-8080-exec-24] EMAppServlet - EMApp Request parameters: Logout=null Device Name=SEP74A02FC09CDF User Id=null Device Profile=null Refresh=null Remote Host IP Address = 10.106.99.235 Via Header Set = false getClusterInfo = null Lang = en_US Charset=utf-8,;q=0.8 Emcc = true LoginType = SP
2017-08-28 22:06:05,782 DEBUG [http-bio-8080-exec-24] EMServiceCommunicator - Posting to EM Service:<query>
<appInfo>
<appID>CCMSysUser</appID>
<appEncryptedCertificate>xxxxxxx</appEncryptedCertificate>
</appInfo>
<deviceUserQuery>
<deviceName>SEP74A02FC09CDF</deviceName>
<loginType>SP</loginType>
<remoteIPAddr>10.106.99.235</remoteIPAddr>
</deviceUserQuery>
</query>
====================================================================================
Sample Snippets for Login Type "UID"
2017-08-29 14:48:20,657 INFO [http-bio-8080-exec-1167] EMAppServlet - EMApp Request# ----->10
2017-08-29 14:48:20,657 INFO [http-bio-8080-exec-1167] EMAppServlet - EMAppServlet: Request protocol is :http
2017-08-29 14:48:20,658 INFO [http-bio-8080-exec-1167] EMAppServlet - EMApp Request parameters: Logout=null Device Name=SEP402CF4915265 User Id=null Device Profile=null Refresh=null Remote Host IP Address = 10.77.22.225 Via Header Set = false getClusterInfo = null Lang = en Charset=utf-8,utf-8;q=0.8 Emcc = null LoginType = UID
2017-05-29 14:48:20,658 DEBUG [http-bio-8080-exec-1167] EMServiceCommunicator - Posting to EM Service:<query>
<appInfo>
<appID>CCMSysUser</appID>
<appEncryptedCertificate>xxxxxxx</appEncryptedCertificate>
</appInfo>
<deviceUserQuery>
<deviceName>SEP74A02FC09CDF </deviceName>
<loginType>UID</loginType>
<remoteIPAddr>10.106.99.235</remoteIPAddr>
</deviceUserQuery>
</query>
2017-08-29 14:48:20,658 INFO [http-bio-8080-exec-1167] EMServiceCommunicator - Posting to EM Query Service:https://localhost:8443/emservice/EMServiceServlet