CWMP configuration commands 1

cwmp· 1

cwmp acs password· 1

cwmp acs url 2

cwmp acs username· 2

cwmp cpe connect retry· 3

cwmp cpe connect interface· 4

cwmp cpe inform interval 4

cwmp cpe inform interval enable· 5

cwmp cpe inform time· 5

cwmp cpe password· 6

cwmp cpe username· 7

cwmp cpe wait timeout 7

cwmp device-type· 8

cwmp enable· 9

display cwmp configuration· 9

display cwmp status 11

ssl client-policy· 12

 

cwmp

Syntax

cwmp

View

System view

Default level

2: System level

Parameters

None

Description

Use cwmp to enter CWMP view.

Examples

# Enter CWMP view.

<Sysname> system-view

[Sysname] cwmp

cwmp acs password

Syntax

cwmp acs password [ cipher | simple ] password

undo cwmp acs password

View

CWMP view

Default level

2: System level

Parameters

cipher: Specifies a ciphertext password.

simple: Specifies a plaintext password.

password: Specifies the password string. This argument is case sensitive. If simple is specified, it must be a string of 1 to 255 characters. If cipher is specified, it must be a ciphertext string of 1 to 373 characters. If neither cipher nor simple is specified, you set a plaintext password string.

Description

Use cwmp acs password to configure the password used for connecting to the ACS.

Use undo cwmp acs password to restore the default.

By default, no password is configured for connecting to the ACS.

Make sure the ACS username and password are the same as configured on the ACS. If not, the CPE cannot establish a CWMP connection to the ACS.

If you use the command multiple times, the password that is configured most recently takes effect.

Related commands: cwmp acs username.

Examples

# Configure the password used for connecting to the ACS as newpsw.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp acs password newpsw

cwmp acs url

Syntax

cwmp acs url url

undo cwmp acs url

View

CWMP view

Default level

2: System level

Parameters

url: Specifies the URL of the ACS, a string of 8 to 255 characters. A URL must be in the format http://host[:port]/path or https://host[:port]/path.

Description

Use cwmp acs url to configure the ACS URL.

Use undo cwmp acs url to restore the default.

By default, no ACS URL is configured.

If you use the command multiple times, the newly configured URL overwrites the previous one.

Examples

# Specify the ACS URL http://www.acs.com:80/acs.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp acs url http://www.acs.com:80/acs

cwmp acs username

Syntax

cwmp acs username username

undo cwmp acs username

View

CWMP view

Default level

2: System level

Parameters

username: Specifies the username used for authentication when the CPE connects to the ACS. This argument must be a case-sensitive string of 1 to 255 characters.

Description

Use cwmp acs username to configure the username used for connecting to the ACS.

Use undo cwmp acs username to restore the default.

By default, no username is configured for connecting to the ACS.

If you use the command multiple times, the newly configured username overwrites the previous one.

Related commands: cwmp acs password.

Examples

# Configure the username used for connecting to the ACS as newname.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp acs username newname

cwmp cpe connect retry

Syntax

cwmp cpe connect retry times

undo cwmp cpe connect retry

View

CWMP view

Default level

2: System level

Parameters

times: Specifies the maximum number of attempts made to retry a connection. The value range is 0 to 100. 0 indicates that no attempt is made to retry a connection.

Description

Use cwmp cpe connect retry to configure the maximum number of attempts the CPE can make to retry a connection.

Use undo cwmp cpe connect retry to restore the default.

By default, no limit is set on the maximum number of connection attempts. The CPE regularly attempts to connect to the ACS until the connection is set up.

Examples

# Set the maximum number of connection attempts to 5 for the CPE.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp cpe connect retry 5

cwmp cpe connect interface

Syntax

cwmp cpe connect interface interface-type interface-number

undo cwmp cpe connect interface

View

CWMP view

Default level

2: System level

Parameters

interface-type interface-number: Specifies the type and number of the interface that connects the CPE to the ACS.

Description

Use cwmp cpe connect interface to set the interface that connects the CPE to the ACS.

Use undo cwmp cpe connect interface to restore the default.

By default, the CPE automatically chooses one interface for connecting to the ACS.

The CWMP connection interface is the interface that the CPE uses to communicate with the ACS. The CPE sends the IP address of this interface in the Inform messages and the ACS replies to this IP address for setting up a CWMP connection.

If the interface that connects the CPE to the ACS is the only Layer 3 interface that has an IP address on the switch, you do not need to specify the CWMP connection interface. If multiple Layer 3 interfaces are configured, specify the CWMP connection interface to make sure the IP address of the interface connects to the ACS is sent to the ACS for setting up CWMP connection.

Examples

# Specify GigabitEthernet 3/0/1 as the interface connecting the CPE to the ACS.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp cpe connect interface GigabitEthernet3/0/1

cwmp cpe inform interval

Syntax

cwmp cpe inform interval seconds

undo cwmp cpe inform interval

View

CWMP view

Default level

2: System level

Parameters

seconds: Sets the Inform message sending interval in the range of 10 to 86400 seconds.

Description

Use cwmp cpe inform interval to configure the interval at which the CPE sends Inform messages.

Use undo cwmp cpe inform interval to restore the default.

By default, the Inform message sending interval is 600 seconds.

Examples

# Configure the CPE to send an Inform message every 3600 seconds.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp cpe inform interval 3600

cwmp cpe inform interval enable

Syntax

cwmp cpe inform interval enable

undo cwmp cpe inform interval enable

View

CWMP view

Default level

2: System level

Parameters

None

Description

Use cwmp cpe inform interval enable to enable periodical sending of Inform messages.

Use undo cwmp cpe inform interval enable to restore the default.

By default, periodical sending of Inform messages is disabled.

Examples

# Enable periodical sending of Inform messages.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp cpe inform interval enable

cwmp cpe inform time

Syntax

cwmp cpe inform time time

undo cwmp cpe inform time

View

CWMP view

Default level

2: System level

Parameters

time: Specifies the time at which the CPE sends an Inform message. The specified time must be in the format of yyyy-mm-ddThh:mm:ss, and in the range of 1970-01-01T00:00:00 to 2105-12-31T23:59:59. The specified time must be greater than the current system time.

Description

Use cwmp cpe inform time to configure the CPE to send an Inform message at a specified time.

Use undo cwmp cpe inform time to restore the default.

By default, the CPE is not configured to send an Inform message at a specific time.

Examples

# Configure the CPE to send an Inform message at 2007-12-01T20:00:00.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp cpe inform time 2007-12-01T20:00:00

cwmp cpe password

Syntax

cwmp cpe password [ cipher | simple ] password

undo cwmp cpe password

View

CWMP view

Default level

2: System level

Parameters

cipher: Specifies a ciphertext password.

simple: Specifies a plaintext password.

password: Specifies the password string. This argument is case sensitive. If simple is specified, it must be a string of 1 to 255 characters. If cipher is specified, it must be a ciphertext string of 1 to 373 characters. If neither cipher nor simple is specified, you set a plaintext password string.

Description

Use cwmp cpe password to configure the password used for authentication when the ACS connects to the CPE.

Use undo cwmp cpe password to restore the default.

By default, no password is configured for connecting to the CPE.

Make sure the CPE username and password are the same as configured on the ACS. If not, the ACS cannot establish a CWMP connection to the CPE.

If you use the command multiple times, the password that is configured most recently takes effect.

Related commands: cwmp cpe username.

Examples

# Configure the password used for connecting to the CPE as newpsw.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp cpe password newpsw

cwmp cpe username

Syntax

cwmp cpe username username

undo cwmp cpe username

View

CWMP view

Default level

2: System level

Parameters

username: Specifies the username used for authentication when the ACS connects to the CPE. This argument must be a case-sensitive string of 1 to 255 characters.

Description

Use cwmp cpe username to configure the username used for authentication when the ACS connects to the CPE.

Use undo cwmp cpe username to restore the default.

By default, no username is configured for connection to the CPE.

If you configure the cwmp cpe username command multiple times, the most recent configuration takes effect.

Related commands: cwmp cpe password.

Examples

# Configure the username used for connecting to the CPE as newname.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp cpe username newname

cwmp cpe wait timeout

Syntax

cwmp cpe wait timeout seconds

undo cwmp cpe wait timeout

View

CWMP view

Default level

2: System level

Parameters

seconds: Sets the CPE close-wait timer in the range of 30 to 1800 seconds.

Description

Use cwmp cpe wait timeout to configure the close-wait timer for the CPE to close the idle connection to ACS.

Use undo cwmp cpe wait timeout to restore the default.

By default, the CPE close-wait timer is 30 seconds.

The close-wait timer specifies how long the connection to the ACS can be idle before it is shut down. If no data has been transmitted over the connection before the timer expires, the CPE disconnects the connection to the ACS.

Examples

# Set the CPE close-wait timer to 60 seconds.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp cpe wait timeout 60

cwmp device-type

Syntax

cwmp device-type { device | gateway }

undo cwmp device-type

View

CWMP view

Default level

2: System level

Parameters

device: Sets the device to operate in device mode. Use this option if no lower-level CPEs are attached to the device.

gateway: Sets the device to operate in gateway mode. If the device is the egress to the WAN and has CPEs attached to it, use this option to enable the ACS to manage the device and all the attached CPEs.

Description

Use cwmp device-type to configure the CPE working mode of the device.

Use undo cwmp device-type to restore the default.

By default, the device operates in gateway mode.

Disable CWMP before you change the CPE working mode.

Examples

# Configure the device to operate in gateway mode.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] undo cwmp enable

[Sysname-cwmp] cwmp device-type gateway

[Sysname-cwmp] cwmp enable

cwmp enable

Syntax

cwmp enable

undo cwmp enable

View

CWMP view

Default level

2: System level

Parameters

None

Description

Use cwmp enable to enable CWMP.

Use undo cwmp enable to disable CWMP.

By default, CWMP is disabled.

CWMP cannot be disabled while the CPE or ACS is performing an upload or download operation.

Examples

# Enable CWMP.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] cwmp enable

display cwmp configuration

Syntax

display cwmp configuration [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: System level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display cwmp configuration to display the current CWMP configuration.

Examples

# Display CWMP configuration after CWMP is enabled.

<Sysname> display cwmp configuration

 

TR-069 is enabled.

ACS URL                             :http://www.acs.com:80/acs

ACS username                        :newname

ACS password                        :newpsw3

Inform enable status               :disabled

Inform interval                     :600s

Inform time                          :none

Wait timeout                         :30s

Reconnection times                  :Unlimited

Source IP interface                 :none

Table 1 Command output

Field	Description
TR-069 is	Status of CWMP (TR-069), including enabled and disabled.
ACS URL	URL of the ACS. It is displayed as null if not configured.
ACS username	Authentication username for connection to the ACS. It is displayed as null if not configured.
ACS password	Authentication password for connection to the ACS. It is displayed as null if not configured.
Inform enable status	Enabled or disabled status of periodical sending of Inform messages.
Inform interval	Interval between sending Inform messages.
Inform time	Date and time at which an Inform message will be sent. It is displayed as null if not configured.
Wait timeout	Displays the close-wait timer. It sets how long the connection to the ACS can be idle before it is shut down. If no data has been transmitted over the connection before the timer expires, the CPE disconnects the connection to the ACS.
Reconnection times	Number of attempts the CPE can make to retry a connection.
Source IP interface	Interface connecting to the ACS on the CPE. You can set this interface with the cwmp cpe connect interface command.

 

display cwmp status

Syntax

display cwmp status [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: System level

Parameters

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display cwmp status to display the current status of CWMP.

Examples

# Display CWMP status after CWMP is disabled.

<Sysname> display cwmp status

CWMP is disabled.

# Display CWMP status after CWMP is enabled.

<Sysname> display cwmp status

 

TR-069 is enabled.

ACS URL                                  :http://www.acs.com:80/acs

ACS information is set by            :user

ACS username                            :newname

ACS password                            :newpsw3

Connection status                      :disconnected

Data transfer status                   :none

Time of last successful connection  :none

Interval upon to next connection     :1096832s

Table 2 Command output

Field	Description
ACS URL	URL of the ACS. It is displayed as null if not configured.
ACS information is set by	Mode through which CWMP gets the ACS URL. It is displayed as null if ACS URL is not configured: ·     user—The ACS URL is configured through CLI. ·     config file—The ACS URL is configured through ACS. ·     DHCP—The ACS URL is configured through DHCP.
ACS username	Authentication username for connection to the ACS. It is displayed as null if not configured.
ACS password	Authentication password for connection to the ACS. It is displayed as null if not configured.
Connection status	Connection status: ·     connected—The connection is established. ·     disconnected—The connection is not established. ·     waiting response—The device is waiting for a response.
Data transfer status	Data transfer status: ·     uploading—The device is uploading data. ·     downloading—The device is downloading data. ·     none—The device is not transferring data.
Time of last successful connection	Time at which the most recent successful connection was established. If there is no successful connection, it is displayed as none.
Interval upon to next connection	Period of time after which the device will initiate a connection. If no interval or time is configured for Inform message sending, it is displayed as null.

 

ssl client-policy

Syntax

ssl client-policy policy-name

undo ssl client-policy

View

CWMP view

Default level

2: System level

Parameters

policy-name: Specifies an SSL client policy name, a case-insensitive string of 1 to 16 characters. For information about configuring SSL client policies, see Security Configuration Guide.

Description

Use ssl client-policy to specify an SSL client policy for the CPE to authenticate the ACS for setting up an HTTPS connection.

Use undo ssl client-policy to remove the SSL client policy from the CWMP configuration.

By default, no SSL client policy is specified.

CWMP uses HTTP or HTTPS for data transmission. If the ACS uses HTTPS for secure access, its URL begins with https://. You must configure an SSL client policy for the CPE to authenticate the ACS for establishing an HTTPS connection.

Examples

# Specify the SSL client policy test for ACS authentication.

<Sysname> system

[Sysname] cwmp

[Sysname-cwmp] ssl client-policy test