The Media Gateway Control Protocol (MGCP) Bulk Audit Package
RFC 3624

• Status
• IESG evaluation record
• IESG writeups
• Email expansions
• History

• Versions
• 09

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,