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 una descripción general de los comandos show, incluida la sintaxis, las descripciones de las opciones y los resultados de ejemplo. Utilice estos comandos en APM.

Solicitar activación de APM

Sintaxis

Descripción

Active APM para activar la piscina especificada eliminando el drenaje activo de la piscina. Puede ejecutar este comando cuando el grupo se encuentre en cualquiera de los siguientes estados de recuperación:

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

  • drain-set: el comando elimina el drenaje activo cuando se está drenando la piscina.

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

Nota:

Este comando solo 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 la 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 eliminará el drenaje.

Nivel de privilegio requerido

raíz

Salida de muestra

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

Información de lanzamiento

Declaración introducida en la versión 3.0.0 de APM.

Solicitar drenaje de APM

Sintaxis

Descripción

Active APM para indicar al BNG especificado que vacíe el conjunto 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 recuperación. Si no hay drenaje colocado en el grupo, el BNG aún puede asignar direcciones.

Utilice el show apm alarms comando para mostrar el estado de la alarma. Utilice el show apm reclaim-events comando para comprobar el 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 de APM

Información de lanzamiento

Declaración introducida en la versión 3.0.0 de APM.

Solicitar recuperación de APM

Sintaxis

Descripción

Active APM para indicar al BNG especificado que desaprovisione la agrupación especificada en el dominio de la agrupación. 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. El grupo debe estar inactivo, 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 solo funciona cuando el grupo está en estado de recuperación como resultado de la drain-set recuperación manual. APM bloquea el comando cuando el estado de agrupación 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 de la piscina drenada de la que se recuperan las direcciones.

Nivel de privilegio requerido

raíz

Salida de muestra

solicitar recuperación de APM (grupo específico)

Información de lanzamiento

Declaración introducida en la versión 3.0.0 de APM.

Solicitar entidad de liberación de APM

Sintaxis

Descripción

Active APM para limpiar los dominios de agrupación establecidos por la entidad y liberar los dominios de una entidad y sus prefijos de agrupación asociados a la partición de origen de cada dominio. Si la red de acceso no usa los prefijos asignados por APM de una entidad, APM fuerza la limpieza de cualquier dominio y desasigna los prefijos de agrupación asociados en la partición de origen de cada dominio. Este comando solo funciona si la entidad no está disponible o desconectada. Se muestra una lista de los prefijos que se publicaron y la partición de destino asociada si se realizó 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 ID de sistema de la entidad. El identificador de sistema es una cadena única de hasta 45 caracteres asignada al BNG administrado. Identifica la entidad en APM tras una conexión exitosa.

Nivel de privilegio requerido

raíz

Salida de muestra

Solicitar drenaje de APM

Información de lanzamiento

Declaración introducida en la versión 3.1.0 de APM.

Muestra alarmas de APM

Sintaxis

Descripción

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

Opciones

entity ip-address

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

(Opcional) Muestra las alarmas en el dominio de agrupación especificado.

Nivel de privilegio requerido

raíz

Campos de salida

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

Tabla 1: mostrar alarmas de apm Campos de salida

Nombre del campo

Descripción de 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 de agrupación en la BNG supera el umbral de recuperación, la BNG envía un mensaje de alarma de recuperación con el nombre de la agrupación 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 prorrateando los prefijos que se agregarán a un dominio de grupo.
  • pool-drained—Cuando una piscina está completamente vacía, el BNG envía una alarma de piscina vaciada para informar a APM que se puede recuperar el prefijo asignado para la piscina.

Info

Nombre del grupo prorrateado.

Age

Cuánto tiempo ha estado pendiente una alarma.

Salida de muestra

Muestra alarmas de APM

Información de lanzamiento

Declaración introducida en la versión 3.0.0 de APM.

muestra la entidad de APM

Sintaxis

Descripción

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

Opciones

id system-id

Especifique el system-id de la entidad. El identificador de sistema es una cadena única de hasta 45 caracteres asignada al BNG administrado. Identifica la entidad en 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 agrupación para mostrar información solo para ese dominio.

Nivel de privilegio requerido

raíz

Campos de salida

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

Tabla 2: mostrar entidad apm Campos de salida

Nombre del campo

Descripción de campo

Allocations

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

Entity Id

 ID de sistema único asignado a la entidad.

APMi Version

 Versión de APM que el BNG administrado utiliza 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 en el dominio del grupo que están disponibles para la asignación.

  • Last Allocation—Marca de tiempo en la que se completó la última operación de asignación de direcciones.

  • Last Discovery: marca de tiempo en la que se completó la última operación de detección.

  • Last Reclamation—Marca de hora en la que se produjo la última recuperación del grupo.

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

  • Pool head—Nombre del jefe de grupo del dominio.

  • Pools—Número de agrupaciones en el dominio de la agrupación.

  • Reclamations—Número de agrupaciones en el dominio que se han desaprovisionado y sus direcciones recuperadas en la partición de origen para uso futuro.

  • Allocations—Número de prefijos (agrupaciones) que se han agregado a este dominio de agrupación.

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

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

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

  • Pool-drained Alarms—Número de alarmas de pool vaciado enviadas para este dominio de pool.

Pool Domains

Número de dominios de agrupación en el BNG administrado.

Prefix

Subred asignada a un conjunto 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 inalcanzable.

Used

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

Salida de muestra

muestra la entidad apm (todos los BNG)

muestra la entidad apm (BNG específica)

muestra la entidad apm (dominio de grupo)

Información de lanzamiento

Declaración introducida en la versión 3.0.0 de APM.

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

mostrar estado de APM

Sintaxis

Descripción

Muestra información de estado de los subsistemas APM y sus roles actuales (activos o de respaldo).

Opciones

none

Muestra información de estado de todos los subsistemas de APM. Solo se enumeran los subsistemas activos.
subsystem subsystem-name Puede mostrar información de estado para los siguientes subsistemas especificados:

  • addrman—Administrador de direcciones

  • apm-db—Base de datos APM (redis)

  • apm-mgmt—Administración de CLI

  • apm-operator—Operador de APM

  • dbsync—Sincronización de bases de datos

  • entman—Administrador de entidades

  • provman—Gerente de aprovisionamiento
deployment

Muestra información de despliegue para el subsistema especificado.
extensive

En varias configuraciones geográficas, la extensive opción no muestra ninguna información a menos que se pueda recopilar la información de estado de ambos clústeres de carga de trabajo.

Nivel de privilegio requerido

raíz

Campos de salida

En la tabla 3 se enumeran los campos de salida del show apm health comando.

Tabla 3: Mostrar el estado de la apm

Nombre del campo

Descripción de campo

Name

El nombre del subsistema

Cluster

Nombre del clúster de cargas de trabajo en el que se ejecuta un subsistema.

Subsystem-State

El estado del subsistema. Cualquiera o active .dormant

Health

Estado del subsistema APM. Los siguientes son los niveles de salud:

  • En buen estado: debe existir todo lo siguiente: todos los servicios están activos, la memoria compartida está en buen estado, la recuperación de estado inicial se realizó correctamente y todos los puntos de conexión clave están activos.

  • Unhealthy-major: si existe alguna de las siguientes condiciones: alguno de los servicios está inactivo de forma permanente, la memoria compartida no está en buen estado o la recuperación del estado inicial falló.

  • Unhealthy-minor: si existe alguna de las siguientes condiciones: alguno de los servicios está inactivo, la recuperación del estado inicial está en curso, cualquiera de los puntos de conexión clave está inactivo.

Up-time

La cantidad de tiempo que ha estado funcionando el servicio.

Generation

Número de generación del subsistema. El número de generación de un subsistema se incrementa cada vez que cambia los clústeres de carga de trabajo.

Configuration

El estado de sincronización de la configuración. El estado es sincronizado o no sincronizado. Debe esperar hasta que la configuración esté sincronizada antes de iniciar el proceso de cambio.

Database

El estado de sincronización de la base de datos. El estado es sincronizado o no sincronizado. Debe esperar hasta que la base de datos esté sincronizada antes de iniciar el proceso de cambio.

Subsystem

El subsistema para el que se muestra la información.

Active cluster

El clúster que está activo actualmente.

Deployment-Env

Enumera información detallada para el entorno de implementación.

Pod-name

Nombre del pod.

Node

El nombre del nodo del clúster en el que está programado actualmente el subsistema.

Pod health

Salud de la vaina. Los siguientes son los niveles de salud:

  • Saludable: toda la actividad es saludable.

  • Unhealthy-major: se detecta actividad inusual y la actividad afecta al funcionamiento del pod.

  • Unhealthy-minor: se detecta actividad inusual, pero actualmente no afecta al funcionamiento del pod.

Pod phase

El estado de Kubernetes del pod (por ejemplo, inicialización, pendiente, inicialización del pod, ejecución, terminación, etc.).

Pod Age

La duración desde que se programó el pod en este nodo del clúster.

Container uptime

Cuánto tiempo ha estado funcionando el contenedor.

Container restarts

Número de veces que se reinició el contenedor.

Unexpected conditions

Cualquier evento inesperado de Kubernetes que haya ocurrido que pueda estar afectando la función del pod.

Salida de muestra

mostrar estado de APM

muestra la salud de APM ampliada

muestra el despliegue del subsistema de estado de APM <nombre del subsistema>

Información de lanzamiento

Declaración introducida en la versión 3.6.0 de APM.

muestra la asignación del grupo de inets de APM

Sintaxis

Descripción

Muestra información sobre cómo se asignan los prefijos a 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 solo para esa partición. La partición se puede usar para varios BNG.

Nivel de privilegio requerido

raíz

Campos de salida

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

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

Nombre del campo

Descripción de campo

Allocations

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

Entity Address

Dirección IP del BNG administrado.

Backup

Nombre de la partición de copia de seguridad desde la que APM asigna direcciones a un dominio de agrupación.

Backup-allocations

Número de prefijos asignados desde la partición de copia de seguridad.

Filter fields

Filtros aplicados a la salida antes de que se muestre. Los filtros corresponden a los calificadores que se especifican al ejecutar el mandato, 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 agrupación.

Pool Domain

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

Prefix

Subred asignada a un conjunto de direcciones. APM separa este prefijo del prefijo raíz de una partición. 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 agrupación.

Salida de muestra

muestra la asignación de grupo de inets de apm (todas las particiones)

muestra la asignación de grupo de inets de apm (partición específica)

muestra la asignación del grupo de inets de apm (BNG específico)

muestra la asignación del grupo de inets de apm (partición específica y BNG)

Información de lanzamiento

Declaración introducida en la versión 3.0.0 de APM.

muestra la utilización del grupo de inets 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 la utilización 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 5 se enumeran los campos de salida para el show apm inet-pool utilization comando. Los campos de salida se enumeran en orden alfabético.

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

Nombre del campo

Descripción de 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 reservar y asignar un prefijo.

Backup-partition

Nombre de la partición de copia de seguridad para la que APM asigna direcciones a un dominio de agrupación.

Partition Name

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

Prefix

Prefijo de ruta (origen) de una partición. Las estadísticas enumeradas se muestran para todos los prefijos de una partición o sólo 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.

Role

El papel de la parte. El rol puede ser uno de los siguientes:

  • Origen

  • copia de seguridad

State

El estado de umbral de la partición. El umbral lo establece la free-prefix-utilization instrucción en el nivel de [edit apm inet-pool partition partition-name] jerarquía. 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 que están reservados actualmente para todas las subredes del prefijo raíz.

  • Total allocated—Número total de prefijos que se asignan 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 están libres para las subredes del prefijo raíz, indicado por la longitud del prefijo.

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

Salida de muestra

muestra la utilización del grupo de inets de apm (todas las particiones)

muestra la utilización del grupo inet de apm (partición específica)

muestra el prefijo pation-name de la partición de utilización del grupo inet-pool de apm

Información de lanzamiento

Declaración introducida en la versión 3.0.0 de APM.

mostrar eventos de recuperación de APM

Sintaxis

Descripción

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

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 agrupación para mostrar información de las agrupaciones solo en ese dominio.

Nivel de privilegio requerido

raíz

Campos de salida

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

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

Nombre del campo

Descripción de 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 del grupo:

  • draining—APM ha enviado instrucciones al BNG para configurar un drenaje activo en la piscina. La piscina aún no se 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 el grupo está inactivo.

  • pending—El pool está en proceso de ser desaprovisionado (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 gestor 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 purgadas en la partición asociada para su asignación futura.

Salida de muestra

show apm reclaim-events (entidad específica)

Información de lanzamiento

Declaración introducida en la versión 3.0.0 de APM.