Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
EN ESTA PÁGINA
 

Comandos operativos de la CLI de APM

En este tema se proporciona información general sobre los comandos show, incluida la sintaxis, las descripciones de las opciones y los resultados de ejemplo. Utilice estos comandos en APM.

Solicitar APM Activar

Sintaxis

Descripción

Active APM para activar el grupo especificado eliminando el drenaje activo del grupo. Puede emitir este comando cuando el grupo se encuentre en cualquiera de los siguientes estados de recuperación:

  • drain: el comando quita el drenaje activo antes de que el BNG haya configurado el drenaje de la piscina.

  • drain-set: el comando quita el drenaje activo cuando se drena la piscina.

Utilice el comando en APM para comprobar el show apm reclaim-events estado de recuperación del grupo.

Nota:

Este comando sólo funciona cuando el grupo está en el estado o drain-set como resultado de una draining recuperación manual. APM bloquea el comando cuando el estado de recuperación es el resultado de una recuperación automática.

Opciones

entity ip-address

Especifique la dirección IP del BNG administrado que recibió la instrucción.
pool-domain name

Especifique el nombre del dominio del grupo que contiene el grupo de destino.
pool pool-name

Especifique el nombre de la piscina donde se retirará el desagüe.

Nivel de privilegio requerido

Raíz

Salida de muestra

solicitar entidad de activación de APM (grupo específico)

Información de la versión

Declaración introducida en APM versión 3.0.0.

Solicitar drenaje APM

Sintaxis

Descripción

Active APM para indicar al BNG especificado que drene el grupo especificado en el dominio del grupo. Cuando el drenaje está en su lugar en la piscina, no puede asignar ninguna dirección. Puede solicitar un drenaje cuando la piscina tenga el estado de reclamación. Si no hay drenaje colocado en el grupo, el BNG aún puede asignar direcciones.

Utilice el comando para mostrar el show apm alarms estado de la alarma. Utilice el comando para comprobar el show apm reclaim-events estado de recuperación; A drain y drain-setla salida indican que se ha solicitado o colocado un desagüe en la piscina.

Opciones

entity ip-address

Especifique la dirección IP del BNG administrado que recibe la instrucción.
pool-domain name

Especifique el nombre del dominio del grupo que contiene el grupo de destino.
pool pool-name

Especifique el nombre de la piscina que se va a drenar.

Nivel de privilegio requerido

Raíz

Salida de muestra

Solicitar drenaje APM

Información de la versión

Declaración introducida en APM versión 3.0.0.

Solicitar reclamación de APM

Sintaxis

Descripción

Active APM para indicar al BNG especificado que desaprovisione el grupo especificado en el dominio del grupo. Cuando se desaprovisiona el grupo, APM devuelve las direcciones que se habían asignado al grupo a la partición de origen para su reasignación. La piscina debe estar inactiva, lo que significa que no tiene direcciones en uso. Se produce un error en el comando si alguna dirección sigue en uso.

Nota:

Este comando sólo funciona cuando el grupo se encuentra en el estado de recuperación como resultado de la drain-set recuperación manual. APM bloquea el comando cuando el estado del grupo es el resultado de una recuperación automática.

Opciones

entity ip-address

Especifique la dirección IP del BNG administrado que recibe la instrucción.
pool-domain name

Especifique el nombre del dominio del grupo que contiene el grupo de destino.
pool pool-name

Especifique el nombre del grupo drenado del que se recuperan las direcciones.

Nivel de privilegio requerido

Raíz

Salida de muestra

solicitar apm reclaim (grupo específico)

Información de la versión

Declaración introducida en APM versión 3.0.0.

Solicitar entidad de liberación de APM

Sintaxis

Descripción

Active APM para limpiar cualquier dominio de grupo establecido por la entidad y libere los dominios de una entidad y sus prefijos de grupo asociados a la partición de origen de cada dominio. Si la red de acceso no utiliza los prefijos asignados por APM de una entidad, APM fuerza la limpieza de los dominios y desasigna los prefijos de grupo asociados en la partición de origen de cada dominio. Este comando sólo funciona si la entidad es inaccesible o está desconectada. Se muestra una lista de los prefijos que se publicaron y la partición de destino asociada cuando se realiza correctamente.

Nota:

La liberación de los prefijos los pone a disposición de otras entidades cuyos grupos de direcciones son administrados por APM y utilizan la misma partición. Si no tiene cuidado de asegurarse de que los prefijos de la entidad ya no estén en uso, la reasignación a otra entidad podría provocar direcciones duplicadas, bucles de enrutamiento, etc.

Opciones

entity system-id

Especifique el identificador de sistema de la entidad. El identificador del sistema es una cadena única de hasta 45 caracteres asignada al BNG administrado. Identifica la entidad a APM tras una conexión exitosa.

Nivel de privilegio requerido

Raíz

Salida de muestra

Solicitar drenaje APM

Información de la versión

Declaración introducida en APM versión 3.1.0.

Mostrar alarmas APM

Sintaxis

Descripción

Muestra todas las alarmas de dominio de grupo pendientes. Puede mostrar alarmas en todos los enrutadores administrados o puede limitar la visualización a un enrutador BNG específico o a un dominio de grupo.

Opciones

entity ip-address

(Opcional) Mostrar las alarmas del enrutador especificado.
pool-domain name

(Opcional) Mostrar las alarmas en el dominio de grupo especificado.

Nivel de privilegio requerido

Raíz

Campos de salida

En la tabla 1 se enumeran los campos de salida del show apm alarms comando. Los campos de salida se enumeran en orden alfabético.

Tabla 1: mostrar campos de salida de alarmas apm

Nombre del campo

Descripción del campo

Entity

Dirección IP del BNG administrado.

Pool Domain

Nombre del dominio del grupo con el grupo crítico.

Alarm

Nombre de la alarma.

  • reclaim: cuando el número de direcciones libres para el dominio del grupo en el BNG supera el umbral de reclamación, el BNG envía un mensaje de alarma de recuperación con el nombre del grupo a APM. A continuación, APM puede iniciar un drenaje activo para el dominio del grupo.
  • apportion: cuando el número de direcciones libres cae por debajo del umbral de prorrateo, el BNG envía una alarma de prorrateo. APM responde mediante la distribución de prefijos que se agregarán a un dominio de grupo.
  • pool-drained—Cuando una piscina está completamente drenada, el BNG envía una alarma de drenaje de piscina para informar a APM que el prefijo asignado para la piscina se puede recuperar.

Info

Nombre del grupo asignado.

Age

Cuánto tiempo ha estado pendiente una alarma.

Salida de muestra

Mostrar alarmas APM

Información de la versión

Declaración introducida en APM versión 3.0.0.

Mostrar entidad APM

Sintaxis

Descripción

Supervise las asociaciones de las APM con BNG administradas. Puede especificar un dominio de enrutador o grupo en particular para ver detalles adicionales.

Opciones

id system-id

Especifique el system-id de la entidad. El identificador del sistema es una cadena única de hasta 45 caracteres asignada al BNG administrado. Identifica la entidad a APM tras una conexión exitosa.

address ip-address

Especifique la dirección IP del BNG administrado para mostrar información solo para ese BNG.
pool-domain name

Especifique el nombre de un dominio de grupo para mostrar información solo de ese dominio.

Nivel de privilegio requerido

Raíz

Campos de salida

En la Tabla 2 se enumeran los campos de salida del show apm entity comando, en orden alfabético.

Tabla 2: mostrar campos de salida de la entidad apm

Nombre del campo

Descripción del campo

Allocations

Número de asignaciones que APM ha realizado en el dominio del grupo.

Entity Id

 ID de sistema único asignado a la entidad.

APMi Version

 Versión de APM que el BNG administrado usa para comunicarse.

Entity Address

Dirección IP del BNG administrado.

Entity Statistics

Detalles sobre el enrutador administrado.

  • IP Address: dirección IP del BNG administrado.

  • Name: nombre del BNG administrado.

  • Status—Estado de la conexión al BNG: up o down.

Pool

Nombre de un grupo en el dominio. Un asterisco (*) junto al nombre indica que se ha configurado un drenaje activo para la piscina.

Pool Domain Statistics

Detalles sobre el dominio del grupo:

  • Free addresses: número de direcciones del dominio del grupo que están disponibles para su asignación.

  • Last Allocation: marca de tiempo cuando se completó la última operación de asignación de direcciones.

  • Last Discovery: marca de tiempo cuando se completó la última operación de descubrimiento.

  • Last Reclamation: marca de tiempo cuando se produjo la última recuperación del grupo.

  • Pool Domain: nombre del dominio del grupo en el enrutador administrado.

  • Pool head: nombre del encabezado del grupo del dominio.

  • Pools: número de grupos en el dominio del grupo.

  • Reclamations: número de grupos del dominio que se han desaprovisionado y sus direcciones se han recuperado en la partición de origen para su uso futuro.

  • Allocations: número de prefijos (grupos) que se han agregado a este dominio de grupo.

  • Source Partition— La partición desde la que se han asignado prefijos para este dominio de grupo.

  • Apportion Alarms: número de alarmas de reparto enviadas para este dominio de grupo.

  • Reclamation Alarms: número de alarmas de recuperación enviadas para este dominio de grupo.

  • Pool-drained Alarms: número de alarmas drenadas del grupo enviadas para este dominio del grupo.

Pool Domains

Número de dominios de grupo en el BNG administrado.

Prefix

Subred asignada a un grupo de direcciones. APM crea este prefijo subdividiendo el prefijo raíz de la partición de origen.

Status

 Muestra si la entidad es accesible o inaccesible.

Used

Número de direcciones utilizadas en el grupo. El grupo está inactivo cuando el valor es cero.

Salida de muestra

mostrar entidad apm (todos los BNG)

mostrar entidad apm (BNG específico)

mostrar entidad apm (dominio de grupo)

Información de la versión

Declaración introducida en APM versión 3.0.0.

Opción <id system-id> introducida en 3.1.0

Mostrar asignación de grupo inet de APM

Sintaxis

Descripción

Muestra información sobre cómo se asignan los prefijos en todas las particiones, para una partición específica, para una entidad específica o para una partición específica en una entidad específica.

Opciones

entity ip-address

Especifique la dirección IP del BNG administrado para mostrar información solo para ese BNG.
partition name

Especifique el nombre de una partición para mostrar información sólo para esa partición. La partición se puede utilizar para varios BNG.

Nivel de privilegio requerido

Raíz

Campos de salida

En la tabla 3 se enumeran los campos de salida del show apm inet-pool allocation comando. Los campos de salida se enumeran en orden alfabético.

Tabla 3: mostrar campos de asignación de apm inet-pool

Nombre del campo

Descripción del campo

Allocations

Número de asignaciones que APM ha realizado desde una partición.

Entity Address

Dirección IP del BNG administrado.

Filter fields

Filtros aplicados a la salida antes de que se muestre. Los filtros corresponden a los calificadores que se especifican al ejecutar el comando, como un nombre de partición o una dirección IP de entidad.

Partition

Nombre de una partición desde la que APM asigna direcciones a un dominio de grupo.

Pool Domain

Nombre de un dominio de grupo aprovisionado desde la partición.

Prefix

Subred asignada a un grupo de direcciones. Este prefijo se separa del prefijo raíz de una partición por APM. Un grupo determinado puede tener varios prefijos asignados.

Source Partition

Nombre de una partición desde la que APM asigna direcciones a un dominio de grupo.

Salida de muestra

mostrar asignación inet-pool de apm (todas las particiones)

mostrar asignación de grupo de inet de apm (partición específica)

mostrar asignación de inet-pool de apm (BNG específico)

mostrar asignación de grupo de inet de apm (partición específica y BNG)

Información de la versión

Declaración introducida en APM versión 3.0.0.

Mostrar la utilización del conjunto de inet de APM

Sintaxis

Descripción

Muestra información sobre cómo se usan los prefijos. Puede mostrar la utilización de todas las particiones, de una partición específica o de un prefijo y una partición específicos.

Opciones

partition name

Especifique el nombre de una partición para mostrar el uso de direcciones solo para esa partición.
prefix address/prefix-length

Especifique un prefijo raíz (origen) y un nombre de partición para mostrar la utilización de direcciones solo para esa combinación.

Nivel de privilegio requerido

Raíz

Campos de salida

En la tabla 4 se enumeran los campos de salida del show apm inet-pool utilization comando. Los campos de salida se enumeran en orden alfabético.

Tabla 4: mostrar campos de utilización de inet-pool de apm

Nombre del campo

Descripción del campo

Allocated

Número de prefijos que se asignan actualmente desde una partición o desde el prefijo raíz de una partición. Es posible que un prefijo sea reservado y asignado.

Partition Name

Nombre de una partición desde la que APM asigna direcciones a un dominio de grupo.

Prefix

Prefijo de ruta (origen) de una partición. Las estadísticas enumeradas se muestran para todos los prefijos de una partición o solo para ese prefijo específico en una partición específica.

Prefixes

Número total de prefijos disponibles para la asignación desde una partición o desde el prefijo raíz de una partición.

Reserved

Número de prefijos que se mantienen en reserva desde una partición o desde un prefijo raíz específico en una partición.

State

Estado de umbral de la partición. El umbral lo establece la free-prefix-utilization instrucción en el nivel jerárquico [edit apm inet-pool partition partition-name] . Una partición puede tener uno de los siguientes estados de umbral:

  • empty
  • above-threshold
  • below-threshold

Prefix Statistics

Se muestran las siguientes estadísticas para una combinación especificada de partición y prefijo raíz:

  • Prefix: prefijo de ruta (origen) de una partición para la que se muestran estadísticas.

  • Total sub-prefixes: número total de subredes posibles para el prefijo raíz de la partición.

  • Total reserved: número total de prefijos actualmente reservados para todas las subredes del prefijo raíz.

  • Total allocated: número total de prefijos asignados actualmente para todas las subredes del prefijo raíz.

  • Prefix length: longitud de un prefijo subdividido del prefijo raíz de la partición.

  • Free: Número de prefijos que actualmente no están asignados o libres para las subredes del prefijo raíz, indicado por la longitud del prefijo.

  • Allocated: número de prefijos asignados actualmente para subredes del prefijo raíz, indicado por la longitud del prefijo.

Salida de muestra

mostrar la utilización del grupo de inet de apm (todas las particiones)

show apm inet-pool utilization (partición específica)

mostrar la utilización de inet-pool de apm (prefijo y partición específicos)

Información de la versión

Declaración introducida en APM versión 3.0.0.

Mostrar eventos de recuperación de APM

Sintaxis

Descripción

Muestra información sobre los eventos de recuperación de grupo activos para todos los BNG, para un BNG específico o para un BNG y un dominio de grupo específicos.

Opciones

entity ip-address

Especifique la dirección IP del BNG administrado para mostrar información de los grupos solo en ese BNG.
pool-domain name

Especifique el nombre de un dominio de grupo para mostrar información solo de los grupos de ese dominio.

Nivel de privilegio requerido

Raíz

Campos de salida

En la tabla 5 se enumeran los campos de salida del show apm reclaim-events comando. Los campos de salida se enumeran en orden alfabético.

Tabla 5: mostrar campos de eventos de recuperación de apm

Nombre del campo

Descripción del campo

Entity

Dirección IP de un BNG administrado.

Pool Domain

Nombre de un dominio de grupo.

Pool

Nombre de un grupo en el dominio del grupo.

State

Estado actual de recuperación de la piscina:

  • draining—APM ha enviado instrucciones al BNG para configurar un drenaje activo en la piscina. La piscina aún no está drenando. Este es un estado transitorio. Cuando se completa la operación de drenaje, el estado pasa a drain-set.

  • drain-set—El BNG ha configurado un drenaje en este grupo en respuesta a las instrucciones de APM. El grupo no puede asignar ninguna dirección. Esto significa que la piscina está inactiva.

  • pending: el grupo está en proceso de desaprovisionamiento (eliminado del BNG) por APM. Este es un estado transitorio. Si se produce un error en esta operación, el estado vuelve a drain-set.

    El desaprovisionamiento y la recuperación de direcciones siguen esta secuencia:

    1. BNG notifica al administrador de aprovisionamiento cuando se libera la última dirección en uso en el grupo.

    2. APM envía instrucciones de desaprovisionamiento al enrutador.

    3. Cuando el enrutador termina de desaprovisionar el grupo, la entrada del grupo desaparece de la salida del show comando.

    4. APM vuelve a colocar las direcciones drenadas en la partición asociada para una asignación futura.

Salida de muestra

mostrar eventos de recuperación de apm (entidad específica)

Información de la versión

Declaración introducida en APM versión 3.0.0.