05-Packet Capture命令
本章节下载: 05-Packet Capture命令 (120.27 KB)
display packet-capture status命令用来显示本地或远程报文捕获状态信息。
【命令】
display packet-capture status
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 显示本地或远程报文捕获状态信息。
<Sysname> display packet-capture status
AP name : ap1
Radio ID : 1
Radio mode : 802.11n(2.4GHz)
Channel : 1
Status : Capturing
File name : database.pcap
Username : 1
Password : ******
表1-1 display packet-capture status显示信息描述表
字段 |
描述 |
AP name |
AP名称 |
Radio ID |
射频ID |
Radio mode |
射频模式 |
Channel |
被捕获射频口的当前工作信道 |
Status |
显示捕获状态,目前只有Capturing一种状态 |
File name |
存储捕获报文的文件名称 |
User name |
登录远程FTP服务器时的用户名 |
Password |
登录远程FTP服务器时的密码,配置明文和密文时,均显示为****** 若不涉及或未配置则显示为N/A |
packet-capture local ap命令用来配置射频接口上的本地报文捕获并将捕获到的报文保存到FTP服务器。
【命令】
packet-capture local ap ap-name radio radio-id [ capture-filter capt-expression | limit-frame-size bytes | autostop filesize kilobytes | autostop duration seconds ] * write url url [ username username [ password { cipher | simple } string ] ]
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
ap-name:指定AP的名称,,为1~64个字符的字符串,可以包含字母、数字、下划线、“[”、“]”、“/”及“-”,不区分大小写。
radio radio-id:指定射频号。
capture-filter capt-expression:指定用来捕获报文的过滤规则,capt-expression为捕获过滤表达式,为1~256个字符的字符串,区分大小写。设备根据此参数指定的过滤规则对报文进行过滤并捕获过滤后的报文。捕获过滤语法规则请参见“网络管理和监控配置指导”中的“Packet Capture”。如果不指定此参数,则捕获该接口的所有入方向的报文。
limit-frame-size bytes:指定捕获报文的最大长度,bytes为报文的最大长度,取值范围为64~8000,单位为字节,缺省值为8000。当捕获到的报文超过此长度,会对报文进行截断。
autostop filesize kilobytes:指定存储报文的文件大小,kilobytes为文件的最大长度,取值范围为1~65536,单位为千字节。当报文文件达到最大值时,报文捕获自动停止。如果没有指定本参数,表示对报文文件大小没有限制。
autostop duration seconds:指定捕获报文时长,seconds为最大时长,取值范围为1~2147483647,单位为秒。当捕获报文时长达到最大值时,报文捕获自动停止。如果没有指定本参数,表示不对捕获报文的时长进行限制。
write url url:指定存储报文文件的路径。url为FTP服务器上的路径,为1~255个字符的字符串,区分大小写,路径中不能包含“@”,不能包含用户名和密码,用户名和密码由username和password参数指定。如果没有指定此参数,将不会保存捕获的报文。
username username:指定登录远程FTP服务器时使用的用户名,为1~32个字符的字符串,区分大小写。
password:设置用户密码。
cipher:以密文方式设置密码。
simple:以明文方式设置密码,该密码将以密文形式存储。
string:密码字符串,区分大小写。明文密码为1~32个字符的字符串;密文密码为1~73个字符的字符串。
【使用指导】
开启指定AP、指定射频接口、指定端口的报文捕获功能,并将捕获的报文上传到FTP服务器,如需要停止本地报文捕获,请输入packet-capture stop命令。
具有停止报文捕获条件属性的参数有autostop filesize参数、autostop duration参数。不同条件的停止捕获参数同时存在时,只要满足任意一个参数,则报文捕获退出。
仅支持使用FTP协议将捕获的报文上传到远程FTP服务器。输入url、登录用户名、密码时遵循以下要求:
· url采用“ftp://服务器地址[:端口号]/文件名”的形式,形如ftp://192.168.1.1/test.cfg和ftp://192.168.1.1:21/test.cfg。其中,服务器地址支持IP地址和DNS域名方式,端口号为可选参数(和服务器端的配置一致)。
· 若服务器地址为IPv6地址时需使用方括号“[”和“]”将IPv6地址括起来,以便将IPv6地址和端口号区分开来。形如ftp://[2001::1]/test.cfg和ftp://[2001::1]:21/test.cfg,其中,2001::1为FTP服务器的IPv6地址,21为服务器接收FTP协议报文的端口号。
· 若服务器地址为DNS域名格式时请勿使用方括号引用,形如ftp://sdp:21/test.cfg。
· 如有用户名和密码请分别使用参数username和参数password进行配置,用户名和密码必须和服务器上的配置一致,如果服务器只对用户名进行验证,则不用输入密码。
当用户将捕获的报文保存到FTP服务器时,若指定的autostop duration时间较短时,可能设备还未连接到FTP服务器,捕获服务已经退出,此时FTP服务器不会产生保存捕获报文的文件。
【举例】
# 开启AP1的Radio1的本地报文捕获。
<Sysname> packet-capture local ap ap1 radio 1 write url ftp://10.1.1.1/database.pcap username 1 password simple 1
【相关命令】
· display packet-capture status
· packet-capture stop
packet-capture remote ap ap-name radio radio-id命令用来配置AP远程报文捕获。
【命令】
packet-capture remote ap ap-name radio radio-id [ port port ]
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
ap-name:表示捕获指定AP收到的报文,ap-name表示AP的名称,为1~64个字符的字符串,可以包含字母、数字、下划线、“[”、“]”、“/”及“-”,不区分大小写。
radio radio-id:表示捕获指定射频收到的报文,radio-id表示射频ID。
port port:表示捕获AP上指定RPCAP服务端口号收到的报文,若不指定本参数,缺省值为2002。
【使用指导】
配置指定AP指定Radio口的远程报文捕获,客户端(比如Wireshark)连接到AP的RPCAP服务端口,就可以获取到指定的Radio口捕获的从客户端发往AP的报文。
如需停止报文捕获,请输入packet-capture stop命令。
【举例】
# 配置AP1的Radio 2的远程报文捕获,并且指定服务端口号为2014。
<Sysname> packet-capture remote ap ap1 radio 2 port 2014
【相关命令】
· display packet-capture status
· packet-capture stop
packet-capture stop命令用来停止本地或远程报文捕获。
【命令】
packet-capture stop
【视图】
用户视图
【缺省用户角色】
network-admin
【举例】
# 停止本地或远程报文捕获。
<Sysname> packet-capture stop
【相关命令】
· packet-capture local ap
· packet-capture remote ap
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!