ACS模拟器工具使用典型配置案例
ACS 模拟器工具使用典型配置案例
关键词：CWMP、ACS、CPE、HTTP、SOAP、RPC
摘 要：本文主要介绍ACS模拟器工具的使用。ACS模拟器工具安装于NMS中，使用以太网或
串行口与设备连接，通过向设备发送命令和报文，检测设备对CWMP协议的支持程度。
缩略语：
缩略语 英文全名 中文解释
ACS Auto-Configuration Server
自动配置服务器
CLI Command Line Interface
命令行接口
CPE Customer Premises Equipment
用户端设备
CWMP CPE WAN Management Protocol
CPE广域网管理协议
HTTP Hypertext Transfer Protocol
超文本传输协议
NMS Network Management Station
网络管理站
RPC Remote Procedure Call
远程过程调用
SOAP Simple' Object Access Protocol
简单对象访问协议
URL Uniform Resource Location
统一资源定位
Copyright © 2007 杭州华三通信技术有限公司
www.h3c.com.cn
i
ACS模拟器工具使用典型配置案例
目 录
1 特性介绍...............................................................................................................................1
1.1 CWMP介绍.................................................................................................................1
1.2 ACS模拟器介绍..........................................................................................................1
2 应用场合...............................................................................................................................2
3 配置指南...............................................................................................................................2
3.1 编写脚本命令文件.......................................................................................................2
3.1.1 常用脚本命令介绍............................................................................................2
3.1.2 特殊字符与转义字符.........................................................................................4
3.1.3 脚本命令文件的格式.........................................................................................5
3.1.4 脚本命令文件举例............................................................................................5
3.2 编写列表文件..............................................................................................................6
3.3 环境变量.....................................................................................................................6
3.3.1 环境变量简介....................................................................................................6
3.3.2 环境变量使用举例............................................................................................7
4 注意事项...............................................................................................................................8
5 配置举例...............................................................................................................................8
5.1 组网需求.....................................................................................................................8
5.2 配置思路.....................................................................................................................8
5.3 使用版本.....................................................................................................................8
5.4 配置步骤.....................................................................................................................9
5.4.2 验证结果.........................................................................................................11
6 相关资料.............................................................................................................................13
Copyright © 2007 杭州华三通信技术有限公司
www.h3c.com.cn
1
ACS模拟器工具使用典型配置案例
1 特性介绍
1.1 CWMP介绍
CWPM是一个类似于SNMP的管理协议，它提供了对下一代网络中家庭网络设备进
行管理配置的通用框架，实现了从网络侧对家庭网络中的网关、路由器、机顶盒等
设备进行远程集中管理，遵循DSL论坛（www.dslforum.org）所开发的技术规范
TR-069。
CWMP网络也有两种角色：ACS（相当于NMS）和CPE（相当于Agent），网络管
理人员通过ACS对CPE进行远程管理，简化了管理过程，节约了维护成本，提高了
解决问题的效率。
IP network
ACS CPE
图1 ACS和CPE管理示意图
1.2 ACS模拟器介绍
本文介绍的ACS模拟器通过在计算机上模拟ACS的行为，完成对CPE的测试功能。
ACS模拟器对CPE的交互是通过内置脚本命令来完成的。ACS模拟器完成测试功能，
并保持良好的可扩展性依赖于以下几个组成部分：
1. 数据模板文件
数据模板文件定义了ACS如何组织一个特定功能报文的报文头。按照模板类型可分
为HTTP协议模板文件、SOAP协议模板文件、RPC模板文件；按照交互类型可以
分为请求报文模板文件、回复报文模板文件。
2. 内置脚本命令
内置脚本命令是为了实现ACS模拟器工具功能而专门定义的脚本命令，它是ACS模
拟器工具对CPE的交互的最小功能单位，只能被ACS模拟器工具识别和执行。目前
ACS模拟器支持报文发送、命令发送、报文接收等13条内置脚本命令。
Copyright © 2007 杭州华三通信技术有限公司
www.h3c.com.cn
1
ACS模拟器工具使用典型配置案例
若脚本命令执行出错，则会记录出错的相关信息，格式形如：
× 12 acs_self_test2.script $SendHttpPacket
① ② ③ ④
①：表示脚本命令执行错误标志；
②：表示出错的脚本命令在脚本命令文件中的序号；
③：表示出错的脚本命令文件名；
④：表示出错的脚本命令关键字；
详细的错误信息记录在日志文件（例如：example.list.E475）中。
3. 脚本命令文件
脚本命令文件定义了如何测试CPE的单个业务功能。脚本命令文件为文本文件，扩
展名为.script，是完成一个特定业务功能的内置脚本命令的集合。例如进行一个
RPC（remote procedure call，远程过程调用）功能调用至少应包含如下3类命令：
初始化并建立连接命令、RPC报文发送命令、RPC报文接收命令。
4. 列表文件
列表文件定义了ACS模拟器如何测试CPE的多个业务功能。列表文件为文本文件，
扩展名为.list，内容为多个脚本命令文件的文件名列表。
2 应用场合
本文档中介绍的ACS模拟器适用于对CPE进行基本功能验证和测试。如果需要对
CPE支持CWMP特性情况进行完备测试，请使用专业的测试工具。
3 配置指南
3.1 编写脚本命令文件
3.1.1 常用脚本命令介绍
对内置脚本命令的说明如下：
阻塞命令
Copyright © 2007 杭州华三通信技术有限公司
www.h3c.com.cn
2
ACS模拟器工具使用典型配置案例
阻塞命令是指只有该命令执行完毕后，才能继续执行后续命令的命令。一条阻塞命
令执行的时间是不确定的，最长的执行时间由超时时间或者该命令的参数来控制。
非阻塞命令
非阻塞命令是指在该命令能够与后续的命令并发执行的命令。非阻塞命令能很快的
执行，并且永远执行成功。非阻塞命令的作用域从该命令开始执行直到所有脚本命
令执行完毕。
SendCommand 命令
该命令用于通过CLI发送配置命令到CPE设备。目前CLI支持串口和Telnet方式进行
连接。使用串口方式连接时必须保证ACS模拟器设置的串口地址及波特率与CPE的
连接设置保持一致，使用Telnet方式连接时必须保证CPE必须开启了Telnet服务，
否则该命令可能执行失败。
该命令将等待CPE命令执行完毕或接收到CPE输出成功或失败的信息后返回。若
ACS模拟器与CPE的连接设置不正确，或CPE执行命令后无任何响应，该命令不会
立刻返回失败，而将继续等待直到超时。
Sleep 命令
该命令将挂起ACS模拟器指定的时间后恢复执行。该命令是阻塞命令，在挂起期间，
虽然ACS模拟器无法执行任何脚本命令，但仍然可以接收报文。
SendHttpPacket、SendSoapPacket、SendRpcPacket 命令
该命令用于构造并发送一个HTTP/SOAP/RPC报文。该命令执行成功的必要条件是
ACS模拟器必须与CPE成功建立起网络连接。SendHttpPacket命令无超时时间限
制，但SendSoapPacket和SendRpcPacke命令在发送报文前将等待对方的请求报
文，若在超时时间内仍然没有收到对方的请求报文，将强制发送该报文。
ExpectTimeOut 命令
该 命 令 用 于 设 置 内 置 脚 本 命 令 的 超 时 时 间 ， 单 位 为 毫 秒 。 超 时 时 间 只 对
ExpectHttpPacket、ExpectSoapPacket、ExpectRpcPacket、SendCommand、S
endSoapPacket和SendRpcPacke命令有效。若上述任何一条命令执行时间超过设
置的超时时间，该条命令将返回失败，并继续执行后续的命令。
系统默认的超时时间为5000毫秒。不建议超时时间设置得很小，若超时时间小于
该命令在计算机上的实际执行时间时，该命令可能实际执行成功，但却返回超时错
误。
ExpectHttpPacket、ExpectSoapPacket、ExpectRpcPacket 命令
Copyright © 2007 杭州华三通信技术有限公司
www.h3c.com.cn
3
