display ip-pool usage-status

Function

The display ip-pool usage-status command displays information about public IP address pool status in a specified domain.

This command is supported only on the NetEngine 8000 F1A.

Format

display ip-pool usage-status [ domain domain-name ]

Parameters

Parameter	Description	Value
domain domain-name	Domain name.	The value is a string of 1 to 64 case-insensitive characters.

Parameter

Description

Value

domain domain-name

Domain name.

The value is a string of 1 to 64 case-insensitive characters.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
ippool	read

Usage Guidelines

Usage Scenario

When a domain has public and private network users, a BRAS sends public IP address pool status through HW-Public-IP-Addr-State attribute to a RADIUS server. The RADIUS server determines whether a user is a public or private network user based on user information and the public IP address pool status. The RADIUS server then sends the corresponding user group name through Filter-Id attribute , IP address pool name through Framed-Pool attribute or IP address pool group name through HW-Framed-Pool-Group to the BRAS. The BRAS determines whether the user is a public or private network user based on the received user group name and assigns an IP address to the user from the received IP address pool or IP address pool group. To view information about public IP address pool status in the domain, run the display ip-pool usage-status command.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display information about public IP address pool status in the AAA domain named isp1.

<HUAWEI> display ip-pool usage-status domain isp1
-----------------------------------------------------------------------------
  Domain name                     Used    Total   Ratio(%) Low(%)  High(%) Status
  isp1                             0       2       0       2       100     0
-----------------------------------------------------------------------------

**Table 1** Description of the **display ip-pool usage-status** command output
Item	Description
Domain name	Name of an AAA domain that has the upper and lower thresholds for public IP address pool usage configured.
Used	Number of used IP addresses in all IP address pools or IP address pool groups that are used in the calculation of public IP address pool status. The number of used IP addresses = the number of IP addresses - the number of idle IP addresses.
Total	Number of IP addresses in all IP address pools or IP address pool groups that are used in the calculation of public IP address pool status.
Ratio(%)	Usage of IP address pools or IP address pool groups that are used in the calculation of public IP address pool status. If the number of IP addresses is 0, the usage is 0.
Low(%)	Lower threshold configured for public IP address pool usage in an AAA domain.
High(%)	Upper threshold configured for public IP address pool usage in an AAA domain.
Status	public IP address pool status can be 0, 1, or 2: The value is 0 (safe) in one of the following conditions: a. No NAT instance is bound to an AAA domain. b. The NAT instance bound to an AAA domain does not take effect. c. The IP address pool usage is less than or equal to the lower threshold. If the IP address pool usage is greater than the lower threshold and less than the upper threshold, the value is 1 (warning). If the IP address pool usage is greater than or equal to the upper threshold, the value is 2 (danger).