配置Cisco IP Manager Assistant(IPMA)并排除故障

已更新: 2021 年 1 月 13 日
文档 ID:200159

非歧视性语言

此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。

关于此翻译

思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言，希望全球的用户都能通过各自的语言得到支持性的内容。 请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任，并建议您总是参考英文原始文档（已提供链接）。

    简介

    本文档介绍Call Manager上的Cisco IPMA功能。此功能可根据要求将呼叫有效路由到管理员/助理。根据管理员电话上设置的过滤器，呼叫可以直接路由到管理员或助理，具体取决于经理的可用性。或者，管理员过滤器也可以从助理的电话设置，从而使其成为可扩展的功能。

    先决条件

    要求

    思科建议您对以下主题有基本的了解：

    • 呼叫路由和计算机电话集成(CTI)路由点
    • 呼叫搜索空间(CSS)和分区
    • 在思科统一通信管理器(CUCM)上配置IP电话

    使用的组件

    本文档中的信息基于以下软件版本：

    • 思科统一通信管理器9.1(2)
    • Cisco IP Manager Assistant服务

    本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您使用的是真实网络，请确保您已经了解所有命令的潜在影响。

    背景信息

    Cisco IPMA功能被广泛使用，以便有效地管理对管理员/助理的呼叫。它允许在集群中配置主IPMA和辅助IPMA服务器，但同时只有一台可以处于活动状态，从而提供冗余。

    此功能在两种模式下均基于要求：

    • 代理线路模式
    • 共享线路模式

    代理线路:助理在电话上的线路充当经理的代理线路。除助理的主线路外，您需要在助理的电话上为与助理关联的每个经理配置一条新线路。这为助理电话上的每个管理员创建的线路用作代理线路。Cisco IPMA使用这些代理线路来出席助理电话中经理的呼叫。

    • CTI路由点应具有与管理器或其超集相同的目录编号(DN)。
    • 所有电话都必须能够访问CTI路由点和助理DN，并且必须能够相互访问。但是，管理器的DN只能从CTI路由点和助理DN访问。
    • 此CTI路由点需要在IPMA服务参数中配置，该服务参数将其与此服务相关联。关联后，所有到Manager电话的呼叫都会到达CTI路由点，因为所有电话都可访问该路由点，并且根据IPMA参数，服务会将呼叫路由到助理/经理。
    • 必须为Manager/Assistant电话的Call Forward No Answer功能配置CTI路由点，以便在IPMA关闭/CTI关闭时不会在呼叫中断。

    共享线路:在此模式下，“管理员”和“助理”电话上的线路号相同。当呼叫到经理时，会同时振铃助理的电话。经理或助理可根据需要选择电话。如果管理员不想再接听呼叫，希望其助理出席所有呼叫，则需要启用IPMA功能的免打扰(DND)选项。

    配置

    以下是预配置任务：

    1. 在Call Manager上注册两部IP电话。（在本例中为Cisco 7975和Cisco 7965）
    2. 创建最终用户助理并将此用户与助理的电话关联，反之亦然。(在本例中为Cisco 7975:00083031ED49)

    3. 创建最终用户管理器，并将此用户与管理器的电话关联，反之亦然。(在本例中为Cisco 7965:F02929E2D831)

     配置IPMA的步骤：

    1. 为IPMA创建服务。
    2. 分区和呼叫搜索空间。
    3. 配置助理电话。
    4. 配置Manager电话。
    5. 配置Manager Enduser。
    6. 配置助理最终用户。
    7. 配置CTI路由点。
    8. 配置IPMA服务参数。
    9. Cisco Unified Communication Manager Assistant控制台（可选）

    步骤1.为IPMA创建服务

    1. 登录CUCM管理Web GUI。
    2. 导航至设备>设备设置>电话服务。
    3. 添加新服务并将其命名为IPMA。
    4. 在服务URL中提供URL:（CUCM — 呼叫管理器）。
      http://<CUCM-IP>:8080/ma/servlet/MAService?cmd=doPhoneService&Name=#DEVICENAME#
    5. 选中“启用”参数，然后单击“保存”，如图所示。

    注意：如果对IPMA服务器使用FQDN而不是IP地址，请确保它解析为仅一个IP地址

    步骤2.分区和呼叫搜索空间

    1. 登录CUCM管理Web GUI。
    2. 导航至呼叫路由>控制类>分区。
    3. 创建三个分区：ptmanager、ptinternal和pteveryone。
    4. 导航至呼叫路由>控制类>呼叫搜索空间。
    5. 创建两个CSS:generated_css_M_E(ptmanager+pteveryone)和generated_css_I_E:(ptinternal+pteveryone)。

    步骤3.配置助理电话

    1. 登录CUCM管理Web GUI。
    2. 导航至Device > Phone > Phone configuration页面(Assistant Phone)。
    3. 选择软键模板到“标准助理”。
    4. 在分区peveryone和CSS as generated_css_I_E中，将新行创建为Assistant的主DN。
    5. 创建一条新线路，该线路作为分区peveryone中的管理器的代理线路，CSS作为generated_css_M_E，如图所示。




    1. 导航至Related Links > Subscriber/Unsubscriber Services，然后订用此电话的IPMA服务，如图所示。





    步骤4.配置Manager电话

    1. 登录CUCM管理Web GUI。
    2. 导航至Device > Phone > Phone configuration页面(Manager Phone)。
    3. 选择软键模板到“标准管理器”。
    4. 在分区ptmanager中创建新行作为Manager的主DN，在CSS中创建为generated_css_I_E。
    5. 导航至Related Links > Subscriber/Unsubscriber Services，并为此电话订用IPMA服务。

    步骤5.配置Manager最终用户

    1. 登录CUCM管理Web GUI。
    2. 导航至User Management > End User。
    3. 使用适当的凭证和详细信息创建新的用户管理器。
    4. 如图所示，从“设备关联”选项卡将Manager电话与此用户关联。




    1. 选中允许从CTI控制设备(Allow Control of Device from CTI)复选框，并选中分配/选择Manager的主分机，如此图所示。



    2. 导航到页面底部，选择Add to Access Control Group并根据要求在此处分配所有CTI角色。
    3. 导航至“相关链接”部分> Manager Configuration > Go。
    4. 取消选中自动配置复选框，并为管理器选择电话设备名称。
    5. 选择要与此经理关联的助理。（如果需要，您可以关联多个助理）
    6. 选择需要由IPMA服务通过CTI控制的行，然后单击Save，如图所示。




    1. 导航至Manager电话设备页面，并将Manager用户关联到此处。

    步骤6.配置Assistant最终用户

    1. 登录CUCM管理Web GUI。
    2. 导航至“用户管理”>“最终用户”。
    3. 使用适当的凭证和详细信息创建新的用户助理。
    4. 从“设备关联”选项卡将助理电话与此用户关联。
    5. 选中允许从CTI控制设备复选框，并分配/选择助理的主分机。
    6. 导航至页面底部，然后选择Add to Access Control Group，并根据要求在此处分配所有CTI角色。
    7. 导航至“相关链接”部分>“助理配置”>转到。
    8. 取消选中“自动配置”复选框，然后选择“助理”的“电话设备名称”。
    9. 在“助理经理”框中，列出了与此助理关联的所有经理。
    10. 在“经理与助理行关联”中，从要与任何特定经理关联的助理中选择任何可用行。选择要关联的此行的Manager名称。选择要与Assistant的可用行关联的经理行号。Click Save.




    步骤7.配置CTI路由点

    1. 登录CUCM管理Web GUI。
    2. 导航至Device > CTI Route Point > Add New。
    3. 根据需要提供任何名称和详细信息。
    4. 向此CTI路由点添加新DN，该DN必须与Manager的DN匹配。如果有多个管理器，则DN必须与所有管理器的DN匹配（例如使用通配符的50XX）。
    5. 将分区作为ptinternal分配给它，将CSS作为generated_css_M_E分配给它，因为它必须可以到达所有Manager DN，如图所示。

    步骤8.配置IPMA服务参数

    1. 登录CUCM管理Web GUI。
    2. 导航至系统>服务参数。
    3. 选择Call Manager服务器> Cisco IP Manager Assistant。
    4. 设置主CTI管理器和主IPMA服务器IP地址。
    5. 设置用于IPMA的路由点名称
    6. 按照在集群中完成的配置，保留可保留的所有参数，如图所示。
      注意：如果对IPMA服务器使用FQDN而不是IP地址，请确保它解析为仅一个IP地址



    1. 注意：如果在集群中配置了多个IPMA服务器，请指定要用作Cisco IPMA主电话服务中主要的IPMA服务器服务，以及要用作辅助的IPMA服务器服务。对于IPMA，可以将本地服务器配置为CTI服务器（推荐）。

    步骤9. Cisco Unified Communication Manager Assistant控制台

    此应用程序设计为助理的附加功能，使助理能够通过应用程序（助理控制台）使用所有助理电话功能。 完整的助理电话通过CUCM Assistant控制台进行控制。助理可以在运行Windows 2000、Windows XP、Windows Vista或Windows 7的PC上安装助理控制台（客户端 — 服务器Java应用程序）。助理控制台连接到CUCM(IPMA)服务，用于登录和目录服务。多个助理控制台可以连接到单个CUCM IPMA服务。

    要下载此应用程序：

    1. 登录CUCM管理Web GUI。
    2. 导航至Application > Plugins > Cisco Unified CM Assistant Console（下载）。

    安装后，配置后的接口将如此图所示。



    可通过助理控制台专门使用的另一个功能是呼叫的包含/排他过滤。启用包含过滤并将过滤模式设置为ON时，Manager仍可以从与此配置中的模式匹配的号码接收呼叫。启用独占过滤后，过滤器ON/OFF不会产生任何影响，但是，Manager不会从与此配置中的模式匹配的号码接收呼叫。

    要配置这些过滤器：

    1. 登录CUCM Assistant控制台。
    2. 导航至“我的管理器”>“管理器”(您想要配置)>“配置”，如图所示。



    3. 根据此图中所示的要求在此处创建模式。


    注意：本图所示的配置用于基本IPMA功能。根据要求，可以将快速拨号、内部呼叫和其他线路添加到Manager/Assistant电话。

    网络图

    此图显示了IPMA工作的完整基本流程图。




    1. 如果文件管理器模式设置为Exclusive，则所有呼叫都会转移到转移目标，而与如图所示的过滤器ON/OFF无关。




    2. 如果文件管理器模式设置为“包括”，则所有呼叫都会根据“打开/关闭”过滤到“管理器/助理”，而与图中所示的“转移打开/关闭”无关。




    3. 如果打开“免打扰”选项，则根据过滤器设置，呼叫仍可转接到Manager，但电话不会振铃。只有包含呼叫信息的可视警报在经理的电话上可见，如图所示。




    1. 根据设计，如果电话故障切换到辅助服务器，则即使它变为活动状态，也不会再次返回主服务器，直到辅助服务器关闭。

    2. 如果IPMA服务关闭，可以为管理器的DN配置无应答呼叫转移(CFNA)，以避免掉线并保持呼叫继续。

    3. 在共享线路模式下使用IPMA时，不需要CTI路由点。

    验证

    使用本部分可确认配置能否正常运行。

    1. 检查IPMA服务是否可从Manager和Assistant Phones访问。
    2. IPMA图标（助理监视窗口）和软键必须显示在管理员电话上。
    3. 检查当Manager的DN被拨打且文件管理器设置为ON时，呼叫是否路由到助理电话。
    4. 在此安装Cisco Unified Communication Manager Assistant控制台并以Assistant身份登录。尝试设置IPMA过滤器和呼叫路由以检查其是否工作正常。
    5. 关闭主服务器上的IPMA服务，检查IPMA故障切换是否按预期工作。（即使服务器上的Cisco Tomcat服务已关闭，IPMA也将进行故障转移）

    故障排除

    本部分提供了可用于对配置进行故障排除的信息。

    IPMA的IP电话支持

    首先，必须验证并检查IP电话支持IPMA功能的所有协议。

    1. 登录到Cisco Unified Reporting页面。
    2. 导航至系统报告> Unified CM电话功能列表
    3. 点击“报告名称”下的“Unified CM电话功能列表”超链接，导航至查询页面。
    4. 在“产品”列表和“功能”中选择IP电话型号作为IPMA。例如，如果IP电话支持SIP协议的此功能，则输出将如下图所示。


      否则，如果电话不支持任何协议上的IPMA，则表中的所有行都将为空。

    要排除故障的常见检查点

    • 如果在访问IPMA服务时在电话上收到任何类型的HTTP错误，请重新检查在CUCM的电话服务配置中配置的电话URL。以下是通用URL:
      http://<CUCM-Server-IP>:8080/ma/servlet/MAService?cmd=doPhoneService&Name=#DEVICENAME#
    • 在所有服务器的服务参数列表中，验证主IPMA/CTI服务器和辅助IP服务器的确切IP地址。（配置不正确可能导致CTI路由点频繁注销或IPMA图标在电话上消失）
    • 交叉验证所有Manager/Assistant电话是否已订用IPMA服务。
    • 对于IPMA配置中任何类型的更改后出现的任何类型的问题，最佳做法是重新启动以下服务：
                     -       Cisco IPMA
                     -Cisco Tomcat
                     -Cisco CTIManager
    • 对于IPMA的任何相关网络问题，默认情况下为IPMA服务器通信分配的端口是2912。验证是否允许在CUCM和IP电话之间的所有设备上执行此操作。

    • 使用共享线路模式时，必须在Manager配置中选中“使用共享线路”选项。

    • 如果问题仍然存在，请从实时监控工具(RTMT)收集以下跟踪信息，并随附TAC案例：
      Cisco IPMA
      Cisco CTIManager
      Cisco CallManager
      Cisco Tomcat
      （确保向用户提供用户、IP电话和集群详细信息）

    常见思科漏洞ID

    CSCtg21509和CSCup52338:IP电话上的IPMA File not Found错误。（重新配置Manager/Assistant配置）

    CSCuq44874、CSCud90278和CSCud11654:IPMA故障切换问题，如果主发生故障，它不会回退到辅助。

    CSCte60089:IP电话上的IPMA Host not Found错误。

    CSCun74352:IPMA漏洞（可能允许未经身份验证的远程攻击者访问受影响设备上的敏感信息）

    CSCvi54672:IPMA功能已停止工作JTAPI事件线程仍被IPMA阻止

    相关信息

    TAC Authored

    由思科工程师提供

    • Sagar Wani
      Cisco TAC Engineer

    此文档是否有帮助?

    Feedback反馈

    联系我们

    本文档适用于以下产品