--- title: "零售 - 安装用于零售外围设备报告的 RPOS 代理" slug: "retail-installing-the-rpos-agent-for-retail-peripheral-reporting" description: "Optimize retail operations with the HP Retail Peripheral Agent, monitoring devices and preventing failures for enhanced performance and efficiency." updated: 2026-03-23T17:03:26Z published: 2026-03-23T17:03:26Z canonical: "learn.workforceexperience.hp.com/retail-installing-the-rpos-agent-for-retail-peripheral-reporting" --- > ## Documentation Index > Fetch the complete documentation index at: https://learn.workforceexperience.hp.com/llms.txt > Use this file to discover all available pages before exploring further. # 零售 - 安装用于零售外围设备报告的 RPOS 代理 ## 介绍 HP 零售外围设备 代理 是一项多功能服务，旨在远程收集有关连接到零售终端的零售外围设备（例如条形码扫描仪和收据打印机）的信息。它支持所有 36 个 UPOS 设备类别，并在通用信息模型 （CIM） 对象管理器和托管销售点 （POS） 单元之间进行调解。 HP Retail Peripheral Agent 收集的数据以加密格式存储在本地，可管理性应用程序可以访问该格式进行分析。它与 [HP Insights Agent 应用程序](https://www.hp.com/us-en/services/proactive-insights.html)集成 ，通过提供预防策略和监控功能来提供增强的零售体验。 ### 主要特点 一些主要功能包括： 1. **预防策略：** 用户可以手动为每个零售外围设备设置分析阈值以监控使用水平。这种主动方法可以根据预定义的阈值在故障发生之前及时更换设备。 2. **监控和警报选项：** 该代理包括额外的监控功能，用于检测零售环境中的已知设备信号，例如 USB 现金抽屉设备掉落或手持式扫描仪断开连接。它还监控 USB 拇指驱动器的插入或移除，并可以通过电子邮件报告事件（SMTP 端口# 587，备用 SMTP 端口# 465，默认邮件服务器： rposserver@gmail.com）。 ### **先决条件** HP 零售外围设备代理需要以下内容： - 作系统：Windows 10 专业版或 Windows 10 IoT - 惠普制造的 PC - 框架：Microsoft .NET Framework v4.6 - UPOS 驱动程序：CCO v1.14 和外设的 OPOS 驱动程序堆栈支持 - 访问 URL - [https://workforceexperience.hp.com/software](https://workforceexperience.hp.com/software) 安装 下载 HP Insights 窗口代理。 HP 零售外围设备和 UPOS v1.14 规范的一般知识： - HP POS 配置指南：[https://h10032.www1.hp.com/ctg/Manual/c05837004.pdf](https://h10032.www1.hp.com/ctg/Manual/c05837004.pdf) - UPOS v1.14 规范：[https://www.omg.org/retail/unified-pos.htm](http://www.omg.org/retail/unified-pos.htm) ### 安装和设置 要安装 HP Retail Peripheral Agent，请执行以下步骤： 1. 运行 HP Retail Peripheral Agent Softpaq 安装程序。 2. 按照 GUI 完成安装过程。 1. 接受许可协议 2. 在**“删除安装文件** ” 对话框中，选择“将用于执行安装的文件解压缩到临时位置，并在安装完成后自动删除这些文件”选项。如果您不打算稍后再次运行安装程序，请选择此选项。 1. 将**文件保存在文件夹中字段** 显示安装包的安装位置。 3. 单击 **下一步**，安装将完成并自动关闭。 3. 要静默安装，请使用 HP Image Assistant 或使用静默交换机运行以进行远程部署，然后执行以下命令行字符串：sp9****.exe /s 4. 安装完成后，服务将自动启动。 5. 成功安装后，HP Retail Peripheral Agent 文件内容将存储在以下路径中：“C：\Program Files （x86）\HP\HP Retail Peripheral Agent” 6. 通过输入以下命令行查看 HP 零售外围设备代理服务的状态：sc query “HP RPOS 代理服务” 1. 如果命令返回“运行”状态，则服务处于活动状态并正常工作。如果命令返回“stop”，则服务未运行。如果服务处于停止状态，请检查事件查看器中是否有任何错误代码 7. 如果使用该服务， 请运行以下命令检查其状态： sc query “HPTouchpointAnalyticsService” 8. 要配置 Retail Peripheral Agent，请导航到安装路径并运行“HP Retail Peripheral Agent Configuration Utility”（RPOSAgentUtility.exe）。可以自定义配置此工具中的以下部分，以满足各种 ISV 的环境需求. > [!NOTE] > 注意 > > 要启用外设分析，您必须在安装 **HP Insights Agent** 的同时安装 **HP Retail Peripheral Agent**。您可以在对应型号的支持页面中，通过 **支持 → 软件和驱动程序 → 软件 – 系统管理** 下载 HP Retail Peripheral Agent。 ### **零售外围设备阈值警报设置** HP 零售外围设备代理利用设备 LDN（逻辑设备名称） 作为关键设置来分配和收集设备信息。此部分允许用户选择使用 LDN 将支持的零售外围设备分配给管理列表（添加或删除），并自定义分配要监控的阈值。对于 HP 外围设备，HP Retail Peripheral Agent Configuration Utility 旨在自动检测 HP 外围设备 ID，并具有将设备的默认 LDN（逻辑设备名称）分配给配置列表的逻辑。对于设备的阈值设置，该值会自动从平均故障间隔时间 （MTBF） 规范填充到配置列表中。HP 零售外围设备代理可以支持所有 36 个 UPOS 设备类别和多达四个相同的设备类别。 ![](https://cdn.us.document360.io/c9ecd56a-08d4-4e2f-ab71-60540f7ba8f3/Images/Documentation/retail---installing-the-rpos-agent-for-retail-peripheral-reporting-image-ykgneqz2.jpg?sv=2026-02-06&spr=https&st=2026-10-30T06%3A10%3A39Z&se=2026-10-30T07%3A10%3A39Z&sr=c&sp=r&sig=ihLrAdFlIgx%2FJge1iH2RPabyH6rd0woDOJ8FJyXUoTM%3D) 例如，在上图中，零售终端系统安装了 HP H300 收据打印机和两个 HP 扫描仪设备类别。默认情况下，配置实用程序会检测这些设备的存在，并将 LDN 和阈值设置自动填充到配置文件中。LDN 和阈值字段都可以编辑为用户所需的 LDN/阈值设置，因此这些设置可用于支持第三方零售外围设备或 HP 外围设备，但具有自定义 LDN 名称。阈值字段应更改为用户的规格，因为默认值仅用于 HP 的测试演示。 ### **设备监视器设置** 此部分可以选择 监视某些 USB 设备连接状态或任何 USB 设备。它可以在检测到设备和删除设备时生成报告。如果终端支持 SMTP，则可以选择通过电子邮件直接通知用户事件。 ![](https://cdn.us.document360.io/c9ecd56a-08d4-4e2f-ab71-60540f7ba8f3/Images/Documentation/retail---installing-the-rpos-agent-for-retail-peripheral-reporting-image-gkqumkl7.jpg?sv=2026-02-06&spr=https&st=2026-10-30T06%3A10%3A39Z&se=2026-10-30T07%3A10%3A39Z&sr=c&sp=r&sig=ihLrAdFlIgx%2FJge1iH2RPabyH6rd0woDOJ8FJyXUoTM%3D) 例如，在上图中，“设备监视器设置”部分中的设置将 HP 线性扫描仪和 HP Cash Drawer 设备 ID 输入到监视器列表中。如果设备连接因意外事件意外拔出，如果设备电缆长度设计超出 USB 规格，或者设备遇到信号完整性问题，则 HP 零售外围设备代理将能够记录事件并向TestUser@_.com 成员发送 电子邮件通知。 ### 联系我们 如需任何帮助， 请[创建支持案例](https://learn.workforceexperience.hp.com/docs/creating-a-support-case) 或电子邮件 `support@wxp.hp.com`。