The Media Gateway Control Protocol (MGCP) Bulk Audit Package
RFC 3624
Network Working Group B. Foster
Request for Comments: 3624 D. Auerbach
Category: Informational F. Andreasen
Cisco Systems
November 2003
The Media Gateway Control Protocol (MGCP) Bulk Audit Package
Status of this Memo
This memo provides information for the Internet community. It does
not specify an Internet standard of any kind. Distribution of this
memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (2003). All Rights Reserved.
IESG Note
This document is being published for the information of the
community. It describes a non-IETF protocol that is currently being
deployed in a number of products. Implementers should be aware of
RFC 3015, which was developed in the IETF Megaco Working Group and
the ITU-T SG16, and which is considered by the IETF and the ITU-T to
be the standards-based (including reviewed security considerations)
way to meet the needs that MGCP was designed to address.
Abstract
The base Media Gateway Control Protocol (MGCP) includes audit
commands that only allow a Call Agent to audit endpoint and/or
connection state one endpoint at a time. This document describes a
new MGCP package for bulk auditing of a group of gateway endpoints.
It allows a Call Agent to determine the endpoint naming convention,
the list of instantiated endpoints as well connection and endpoint
state for the group of endpoints.
Foster, et al. Informational [Page 1]
RFC 3624 MGCP Bulk Audit Package November 2003
Table of Contents
1. Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 2
2. Bulk Audit Package. . . . . . . . . . . . . . . . . . . . . . 2
2.1. Package Definition. . . . . . . . . . . . . . . . . . . 2
2.1.1. Package Parameters . . . . . . . . . . . . . . . 3
2.1.2. Bulk Auditing of Non-persistent Virtual
Endpoints. . . . . . . . . . . . . . . . . . . . 11
2.1.3. Package Specific Return Codes. . . . . . . . . . 12
2.2. Examples of Package Use . . . . . . . . . . . . . . . . 13
2.2.1. Endpoint List. . . . . . . . . . . . . . . . . . 13
2.2.2. Connection Count List. . . . . . . . . . . . . . 13
2.2.3. Connection Mode List . . . . . . . . . . . . . . 15
2.2.4. Endpoint State . . . . . . . . . . . . . . . . . 15
3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 17
4. Security Considerations . . . . . . . . . . . . . . . . . . . 17
5. References. . . . . . . . . . . . . . . . . . . . . . . . . . 18
6. Authors' Addresses. . . . . . . . . . . . . . . . . . . . . . 18
7. Full Copyright Statement. . . . . . . . . . . . . . . . . . . 19
1. Introduction
The reader is assumed to be familiar with the base MGCP protocol [3].
The base Media Gateway Control Protocol (MGCP) [3] includes audit
commands that only allow a Call Agent to audit an endpoint and/or a
connection state, one endpoint at a time. This document describes a
new MGCP package for bulk auditing of a group of gateway endpoints.
It allows a Call Agent to determine the endpoint naming convention,
to determine the list of instantiated endpoints, and to determine the
connection and endpoint state for the group of endpoints. This is
particularly important in fail-over situations in which there are
gateways that have large numbers of endpoints.
Conventions Used in this Document
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [2].
2. Bulk Audit Package
2.1. Package Definition
Package Name: BA
Package Version: 0
Foster, et al. Informational [Page 2]
RFC 3624 MGCP Bulk Audit Package November 2003
Package Description: This package provides the Call Agent the ability
to audit and obtain high-level view of endpoint and connection state
for a group of endpoints in a gateway.
2.1.1. Package Parameters
A new BulkRequestedInfo parameter is defined for use in the
AuditEndpoint command. The parameter can be used to request a
compact list of EndpointIds or to request a high level view of
endpoint or connection state for a group of endpoints as defined
below:
ReturnCode,
[EndPointNameList,]
[InstantiatedEndpointList,]
[ConnectionCountList,]
[ConnectionModeList,]
[EndpointStateList,]
[NextEndpointName,]
[ReportedEndpointList]
<-- AuditEndPoint(EndpointId,
Show full document text