ANCP commands -- aging-time

Use aging-time to configure the aging time for DSL entries.

Use undo aging-time to restore the default.

Syntax

aging-time value

undo aging-time

Default

The aging time for DSL entries is 150 seconds.

Views

ANCP neighbor view

Predefined user roles

network-admin

mdc-admin

Parameters

value: Configures the aging time, in the range of 0 to 65535 seconds. If you set the value to 0, the system deletes a DSL entry once the DSL goes down.

Usage guidelines

| IMPORTANT: If an ANCP neighbor needs to reboot the DSL after receiving a service profile, the DSL entry aging time configured for the neighbor must be long enough for the neighbor to complete the reboot.

‌

The ANCP server records DSL information in DSL entries. If a user on a DSL goes offline, the server will remove the corresponding DSL entry when its aging timer expires.

Examples

# Configure the DSL entry aging time as 100 seconds for ANCP neighbor test1.

<Sysname> system-view

[sysname] ancp neighbor test1

[sysname-ancp-neighbor-test1] aging-time 100

ANCP commands -- ancp access-loop-configure

Use ancp access-loop-configure to assign a service profile to a DSL from the ANCP server.

Syntax

ancp access-loop-configure circuit-id circuit-id service-profile profile-name [ timeout time-value ]

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

circuit-id circuit-id: Specifies a DSL ID, a case-sensitive string of 1 to 63 characters. You can use display ancp access-loop to view the ID of a DSL.

service-profile profile-name: Specifies a service profile by its name, a case-sensitive string of 1 to 64 characters.

timeout time-value: Configures the timeout timer for the client to respond, in the range of 0 to 60 seconds. The default timeout timer is 5 seconds. If you set the timer to 0, the server does not wait for the client to respond.

Usage guidelines

This command assigns a service profile to a DSL from the server. The service profile must already exist on the client.

Examples

# Assign service profile text-profile to DSL Dslam1/1:100 and set the timeout timer to 0.

<Sysname> system-view

[Sysname] ancp access-loop-configure circuit-id Dslam1/1:100 service-profile text-profile timeout 0

# Assign service profile text-profile to DSL Dslam1/1:100 and use the default timeout timer. (The DSL does not exist.)

<Sysname> system-view

[Sysname] ancp access-loop-configure circuit-id Dslam1/1:100 service-profile text-profile

Issuing service profile name text-profile for Dslam1/1:100. Please wait…

Access line Dslam1/1:100 doesn’t exist.

# Assign service profile text-profile to DSL Dslam1/1:100 and set the timeout timer to 10 seconds. (Service profile assignment succeeds.)

<Sysname> system-view

[Sysname] ancp access-loop-configure circuit-id Dslam1/1:100 service-profile text-profile timeout 10

Issuing service profile name text-profile for Dslam1/1:100. Please wait…

Issued the service profile name successfully.

Status info: xxxxxxxxxxxxxxxxxxxx

# Assign service profile text-profile to DSL Dslam1/1:100 and use the default timeout timer. (Service profile assignment fails.)

<Sysname> system-view

[Sysname] ancp access-loop-configure circuit-id Dslam1/1:100 service-profile text-profile

Issuing service profile name text-profile for Dslam1/1:100. Please wait…

Failed to issue the service profile name. Operation timed out.

Status info: xxxxxxxxxxxxxxxxxxxx

Table 1 Command output

Field | Description
Status info: xxxxxxxxxxxxxxxxxxxx | Status information sent by the client. This field varies by device model. If the client does not send status information, xxxxxxxxxxxxxxxxxxxx is displayed.
Failed to issue the service profile name | The service profile was not assigned.
Out of resources | The client does not have sufficient resources.
Request message type not implemented | The system does not support the request message type.

‌

Related commands

display ancp access-loop

ANCP commands -- ancp enable

Use ancp enable to enable the ANCP server.

Use undo ancp enable to disable the ANCP server.

Syntax

ancp enable

undo ancp enable

Default

The ANCP server is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You must enable the ANCP server. If the ANCP server is disabled, the system terminates all ANCP adjacencies and closes TCP port 6068.

Examples

# Enable the ANCP server.

<Sysname> system-view

[Sysname] ancp enable

Related commands

ancp source-interface

source-interface

ANCP commands -- ancp neighbor

Use ancp neighbor to create an ANCP neighbor and enter its view, or enter the view of an existing ANCP neighbor.

Use undo ancp neighbor to delete the ANCP neighbor.

Syntax

ancp neighbor neighbor-name

undo ancp neighbor neighbor-name

Default

No ANCP neighbors exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

neighbor-name: Specifies the name of the ANCP neighbor, a case-sensitive string of 1 to 31 characters.

Usage guidelines

You can create multiple ANCP neighbors, and configure parameters for each neighbor.

If you delete an ANCP neighbor, the system deletes information about the neighbor, and closes the ANCP adjacency and TCP connection to the neighbor.

Examples

# Create ANCP neighbor test1 and enter its view.

<Sysname> system-view

[sysname] ancp neighbor test1

[sysname-ancp-neighbor-test1]

ANCP commands -- ancp oam

Use ancp oam to start an ANCP OAM test for a DSL.

Syntax

ancp oam [ count test-counter | timeout time-value ] * access-loop circuit-id

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

count test-counter: Configures the number of OAM attempts, in the range of 1 to 32. The default number is 5.

timeout time-value: Configures the timeout timer for the client to respond, in the range of 1 to 60 seconds. The default timeout timer is 5 seconds.

access-loop circuit-id: Specifies the DSL ID, a case-sensitive string of 1 to 63 characters. You can use display ancp access-loop to view the ID of a DSL.

Usage guidelines

This command requests the client to check the status of the specified DSL before the number of test attempts reaches the maximum. The ANCP OAM test fails if the client does not send the test result to the server before the timer expires.

Examples

# Start an ANCP OAM test for a DSL. (The DSL does not exist.)

<Sysname> system-view

[sysname] ancp oam count 5 timeout 5 access-loop Dslam1/1:100

OAM testing Dslam1/1:100. Please wait…

Access line Dslam1/1:100 doesn't exist.

# Start an ANCP OAM test for a DSL. (The OAM test succeeds.)

<Sysname> system-view

[sysname] ancp oam count 5 timeout 5 access-loop Dslam1/1:100

OAM testing Dslam1/1:100. Please wait…

OAM test succeeded.

Status info: xxxxxxxxxxxxxxxxxxxx

# Start an ANCP OAM test for a DSL. (The OAM test fails.)

<Sysname> system-view

[sysname] ancp oam count 5 timeout 5 access-loop Dslam2/1:100

OAM testing Dslam2/1:100. Please wait…

OAM test failed. Loopback test timed out

Status info: xxxxxxxxxxxxxxxxxxxx

Table 2 Command output

Field | Description
Status info: xxxxxxxxxxxxxxxxxxxx | Status information sent by the client. This field varies by device model. If the client does not send status information, xxxxxxxxxxxxxxxxxxxx is displayed.
DSL access line status showtime | The DSL status is SHOWTIME. For more information about the DSL status, see ITU-T G.993.2.
DSL access line status idle | The DSL status is IDLE. For more information about the DSL status, see ITU-T G.993.2.
DSL access line status silent | The DSL status is SILENT. For more information about the DSL status, see ITU-T G.993.2.
DSL access line status training | The DSL status is TRAINING. For more information about the DSL status, see ITU-T G.993.2.

‌

Related commands

display ancp access-loop

ANCP commands -- ancp session interval

Use ancp session interval to configure the adjacency timer for sending SYN packets.

Use undo ancp session interval to restore the default.

Syntax

ancp session interval interval

undo ancp session interval

Default

The adjacency timer is 25 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Configures the adjacency timer, in the range of 1 to 25 seconds.

Usage guidelines

The ANCP server and the ANCP client exchange SYN packets to negotiate adjacency timers. The two ends use the longer adjacency timer to send SYNACK and ACK packets.

If you modify the adjacency timer after an ANCP adjacency is established, the change does not take effect immediately. The change takes effect after the ANCP adjacency is disconnected and adjacency timers are negotiated again.

Examples

# Configure the adjacency timer as 15 seconds.

<Sysname> system-view

[sysname] ancp session interval 15

ANCP commands -- ancp session retransmit

Use ancp session retransmit to configure the maximum number of retransmission attempts for SYN and SYNACK packets.

Use undo ancp session retransmit to restore the default.

Syntax

ancp session retransmit retransmit-value

undo ancp session retransmit

Default

The maximum number of retransmission attempts for SYN and SYNACK packets is 10.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

retransmit-value: Configures the maximum number of retransmission attempts, in the range of 3 to 255.

Usage guidelines

The ANCP server retransmits a SYN or SYNACK message if it does not receive the message from the client before the adjacency timer expires. If the client does not respond after the retransmission attempts reach the maximum, the server closes the TCP connection.

Examples

# Configure a maximum of 100 retransmission attempts.

<Sysname> system-view

[sysname] ancp session retransmit 100

ANCP commands -- ancp source-interface

Use ancp source-interface to configure a global source interface.

Use undo ancp source-interface to restore the default.

Syntax

ancp source-interface loopback interface-number

undo ancp source-interface

Default

No global source interface is configured.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

loopback interface-number: Specifies a loopback interface as the global source interface.

Usage guidelines

You must configure one global source interface for all adjacencies or one neighbor-specific source interface for each adjacency. The global source interface applies to all adjacencies. The ANCP server prefers the neighbor-specific source interface over the global source interface when it communicates with the specified neighbor.

The ANCP server uses one of the following addresses as the source IP address for TCP packets sent to an ANCP neighbor:

· The primary IPv4 address of the source interface.

· The first IPv6 global unicast address of the source interface.

If you delete the global source interface, the device closes the TCP port 6068 for neighbors without a neighbor-specific source interface. If you change the global source interface, the device uses the IP address of the new source interface. The delete or change operation does not affect existing ANCP adjacencies.

Examples

# Configure loopback 100 as the global source interface.

<Sysname> system-view

[sysname] ancp source-interface loopback 100

Related commands

ancp enable

source-interface

ANCP commands -- display ancp access-loop

Use display ancp access-loop to display information about DSL entries.

Syntax

display ancp access-loop [ circuit-id circuit-id | neighbor neighbor-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

circuit-id circuit-id: Specifies a DSL ID, a case-sensitive string of 1 to 63 characters. You can use display ancp access-loop to view the ID of a DSL. If you specify a DSL, this command displays detailed information about the specified DSL entry. If you do not specify a DSL, this command displays brief information about all DSL entries.

neighbor neighbor-name: Specifies an ANCP neighbor by its name, a case-sensitive string of 1 to 31 characters. If you specify an ANCP neighbor, this command displays brief information about DSL entries for the specified ANCP neighbor. If you do not specify an ANCP neighbor, this command displays brief information about DSL entries for all ANCP neighbors.

Examples

# Display general information about DSL entries for all ANCP neighbors.

<Sysname> display ancp access-loop

Total entries: 1

Neighbor name Peer ID Circuit ID State

bras 0001-0002-0003 circuit4:430 UP

# Display detailed information about the entry of a specified DSL.

<Sysname> display ancp access-loop circuit-id circuit4:430

Neighbor name : bras

Circuit ID : circuit4:430

Remote ID : -

Peer ID : 0001-0002-0003

DSL type : ADSL1

Actual data rate upstream : 64 kbps

Actual data rate downstream : 128 kbps

Min data rate upstream : 32 kbps

Min data rate downstream : 32 kbps

Attainable data rate upstream : 1024 kbps

Attainable data rate downstream : 8192 kbps

Max data rate upstream : 1024 kbps

Max data rate downstream : 8192 kbps

Min low power data rate upstream : 32 kbps

Min low power data rate downstream : 32 kbps

Max delay upstream : 20 s

Max delay downstream : 8192 s

Actual delay upstream : 20 s

Actual delay downstream : 20 s

Data link : ETHERNET

Encapsulation 1 : Untagged Ethernet

Encapsulation 2 : NA

# Display general information about DSL entries for a specified ANCP neighbor.

<Sysname> display ancp access-loop neighbor dslam1

Total entries: 1

Neighbor name Peer ID Circuit ID State

dslam1 0001-0002-0003 001882362CFF eth 0/3/0/2:6 UP

Table 3 Command output

Field | Description
Peer ID | ANCP neighbor ID, which is the MAC address of the client.
Circuit ID | DSL ID.
State | DSL status: · UP. · DOWN.
DSL type | DSL type: · ADSL1. · ADSL2. · ADSL2+. · VDSL1. · VDSL2. · SDSL. · Other.
Data link | Data link type: · ATM ALL5—ATM link. · ETHERNET—Ethernet link.
Encapsulation 1 | Encapsulation 1 information: · NA—The packet does not contain encapsulation 1. · Untagged Ethernet—Ethernet packet without VLAN tags. · Single-tagged Ethernet—Ethernet packet with one VLAN tag. · Double-tagged Ethernet—Ethernet packet with two VLAN tags.
Encapsulation 2 | Encapsulation 2 information: · NA—The packet does not contain encapsulation 2. · PPPoA LLC—PPPoA packet based on logical link control. · PPPoA Null—PPPoA packet. · IPoA LLC—IPoA packet based on logical link control. · IPoA Null—IPoA packet. · Ethernet over AAL5 LLC with FCS—Ethernet packet based on ATM logical link control with the FCS. · Ethernet over AAL5 LLC without FCS—Ethernet packet based on ATM logical link control without the FCS. · Ethernet over AAL5 NULL with FCS—Ethernet packet based on ATM with the FCS. · Ethernet over AAL5 NULL without FCS—Ethernet packet based on ATM without the FCS.

‌

Related commands

reset ancp access-loop

ANCP commands -- display ancp neighbor

Use display ancp neighbor to display information about ANCP neighbors.

Syntax

display ancp neighbor [ neighbor-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

neighbor-name: Specifies an ANCP neighbor by its name, a case-sensitive string of 1 to 31 characters. If you specify an ANCP neighbor, this command displays detailed information for the specified ANCP neighbor. If you do not specify an ANCP neighbor, this command displays brief information for all ANCP neighbors.

Examples

# Display general information about all ANCP neighbors.

<Sysname> display ancp neighbor

Total entries: 2

Neighbor name Peer ID State Access loop number

default-neighbor - Unused 0

dslam1 0001-0002-0003 Used 3

# Display detailed information about the specified ANCP neighbor.

<Sysname> display ancp neighbor dslam1

Neighbor name : dslam1

Peer ID : 0001-0002-0003

Source interface : LoopBack1

Session message interval : 25 s

Session message retransmit : 255

Aging time : 150 s

State : Used

Peer IP : 1.1.1.1

Peer port : 8093

Neighbor capacities : discovery, line-cfg, oam

Negotiated interval : 25.0 s

Access loop number : 0

Table 4 Command output

Field | Description
Peer ID | ANCP neighbor ID.
State | ANCP neighbor status: · Used—The server has established an adjacency with the ANCP client. · Unused—The server has not established an adjacency with the ANCP client.
Peer IP | IP address of the ANCP neighbor.
Peer port | TCP port of the ANCP neighbor.
Neighbor capacities | ANCP neighbor capabilities: · discovery—Dynamic topology discovery. · line-cfg—DSL configuration. · oam—OAM test.
Access loop number | Total DSLs on the ANCP neighbor.

‌

Related commands

reset ancp neighbor

ANCP commands -- display ancp statistic

Use display ancp statistic to display ANCP neighbor statistics.

Syntax

display ancp statistic [ neighbor neighbor-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

neighbor neighbor-name: Specifies an ANCP neighbor by its name, a case-sensitive string of 1 to 31 characters. If you do not specify an ANCP neighbor, this command displays statistics for all ANCP neighbors.

Examples

# Display statistics for all ANCP neighbors.

<Sysname> display ancp statistic

Received ack packets : 1311

Received syn packets : 0

Received synack packets : 2

Received reset ack packets : 0

Received port up packets : 1

Received port down packets : 0

Received oam packets : 0

Received access loop config packets : 0

Received update packets : 0

Received generic response packets : 0

Received unknown packets : 0

Dropped packets : 0

Sent ack packets : 1311

Sent syn packets : 6

Sent synack packets : 0

Sent reset ack packets : 0

Sent oam packets : 0

Sent access loop config packets : 0

Sent generic response packets : 0

Packets failing to be sent : 0

Adjacency up : 2

Adjacency failed : 0

Adjacency down : 1

# Display statistics for the specified ANCP neighbor.

<Sysname>display ancp statistic neighbor dslam1

Received ack packets : 981

Received syn packets : 0

Received synack packets : 1

Received reset ack packets : 0

Received port up packets : 1

Received port down packets : 0

Received oam packets : 0

Received access loop config packets : 0

Received update packets : 0

Received generic response packets : 0

Received unknown packets : 0

Dropped packets : 0

Sent ack packets : 981

Sent syn packets : 1

Sent synack packets : 1

Sent reset ack packets : 0

Sent oam packets : 0

Sent access loop config packets : 0

Sent generic response packets : 0

Packets failing to be sent : 0

Table 5 Command output

Field | Description
Received reset ack packets | Number of received RSTACK packets. RSTACK messages are used for resetting ANCP adjacencies.
Received port up packets | Number of received Port Up packets. When a DSL is up, the client sends the server a Port Up message containing the DSL parameters.
Received port down packets | Number of received Port Down packets. When a DSL is down, the client sends the server a Port Down message informing the server to delete the DSL parameters.
Received access loop config packets | Number of received DSL configuration packets.
Received update packets | Number of received Update packets. The client sends an Update message to the server when new BRASs enter the network. The Update message contains the total number of BRASs in the network and the total number of DSLs connecting to the client.
Received generic response packets | Number of received Generic Response packets. A Generic Response message is sent as a response to a request message or sent because of errors.
Sent access loop config packets | Number of transmitted DSL configuration packets.

‌

Related commands

reset ancp statistic

ANCP commands -- peer-id

Use peer-id to configure an ANCP neighbor ID.

Use undo peer-id to restore the default.

Syntax

peer-id peer-id

undo peer-id

Default

No ANCP neighbor ID is configured.

Views

ANCP neighbor view

Predefined user roles

network-admin

mdc-admin

Parameters

peer-id: Specifies an ANCP neighbor ID, in the format of H-H-H. The ID is the MAC address of a client.

Usage guidelines

The ANCP server uses ANCP neighbor IDs to identify ANCP clients. If the MAC address of a client does not match any ANCP neighbor ID, the server closes the TCP connection to the client.

A neighbor ID uniquely identifies an ANCP neighbor. If you remove a neighbor ID, the server closes the TCP connection to the corresponding neighbor.

Examples

# Configure 1-2-3 as the ID of ANCP neighbor test1.

<Sysname> system-view

[sysname] ancp neighbor test1

[sysname-ancp-neighbor-test1] peer-id 1-2-3

Related commands

ancp neighbor

ANCP commands -- reset ancp access-loop

Use reset ancp access-loop to delete DSL entries.

Syntax

reset ancp access-loop [ circuit-id circuit-id | neighbor neighbor-name ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

circuit-id circuit-id: Specifies the DSL ID, a case-sensitive string of 1 to 63 characters. You can use display ancp access-loop to view the ID of a DSL. If you do not specify a DSL, this command deletes all DSL entries.

neighbor neighbor-name: Specifies an ANCP neighbor by its name, a case-sensitive string of 1 to 31 characters. If you do not specify an ANCP neighbor, this command deletes DSL entries for all ANCP neighbors.

Examples

# Delete the entry for DSL 0001-0002-0003 eth 1/162 3:11.

<Sysname> reset ancp access-loop circuit-id “0001-0002-0003 eth 1/162 3:11”

Related commands

display ancp access-loop

ANCP commands -- reset ancp neighbor

Use reset ancp neighbor to clear ANCP neighbor information and close TCP connections.

Syntax

reset ancp neighbor [ neighbor-name ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

neighbor-name: Specifies an ANCP neighbor by its name, a case-sensitive string of 1 to 31 characters. If you do not specify an ANCP neighbor, this command clears information about all ANCP neighbors and closes all TCP connections.

Examples

# Clear information about ANCP neighbor dslam1 and close its TCP connection.

<Sysname> reset ancp neighbor dslam1

Deleting the neighbor and shutting down the TCP socket. Continue?[Y/N]y

Related commands

display ancp neighbor

ANCP commands -- reset ancp statistic

Use reset ancp statistic to clear ANCP neighbor statistics.

Syntax

reset ancp statistic [ neighbor neighbor-name ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

neighbor-name: Specifies an ANCP neighbor by its name, a case-sensitive string of 1 to 31 characters. If you do not specify an ANCP neighbor, this command removes statistics for all ANCP neighbors.

Examples

# Clear statistics for ANCP neighbor dslam1.

<Sysname> reset ancp statistic neighbor dslam1

Related commands

display ancp statistic

ANCP commands -- source-interface

Use source-interface to configure a source interface for a neighbor.

Use undo source-interface to restore the default.

Syntax

source-interface loopback interface-number

undo source-interface

Default

No source interface is configured for a neighbor.

Views

ANCP neighbor view

Predefined user roles

network-admin

mdc-admin

Parameters

loopback interface-number: Specifies a loopback interface as the source interface for a neighbor.

Usage guidelines

You must configure one global source interface for all adjacencies or one neighbor-specific source interface for each adjacency. The ANCP server prefers the neighbor-specific source interface over the global source interface when it communicates with the neighbor.

The ANCP server uses one of the following addresses as the source IP address for TCP packets sent to an ANCP neighbor:

· The primary IPv4 address of the source interface.

· The first IPv6 global unicast address of the source interface.

If you delete a neighbor-specific source interface, and no global source interface exists, the device closes the TCP port 6068 for the neighbor. If you change the global source interface, the device uses the IP address of the new source interface. The delete or change operation does not affect existing ANCP adjacencies.

Examples

# Configure loopback 100 as the source interface for ANCP neighbor test1.

<Sysname> system-view

[sysname] ancp neighbor test1

[sysname-ancp-neighbor-test1] source-interface loopback 100

Related commands

ancp enable

ancp source-interface