- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
04-CWMP (TR-069) Commands | 100.23 KB |
cwmp
Use cwmp to enter CWMP view.
Syntax
cwmp
Views
System view
Default command level
2: System level
Examples
# Enter CWMP view.
<Sysname> system-view
[Sysname] cwmp
cwmp acs password
Use cwmp acs password to configure the password used for connecting to the ACS.
Use undo cwmp acs password to restore the default.
Syntax
cwmp acs password [ cipher | simple ] password
undo cwmp acs password
Default
No password is configured for connecting to the ACS.
Views
CWMP view
Default command 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.
Usage guidelines
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 configured the last time takes effect.
For secrecy, all keys, including keys configured in plain text, are saved in cipher text.
Examples
# Configure the password used for connecting to the ACS as newpsw.
<Sysname> system
[Sysname] cwmp
[Sysname-cwmp] cwmp acs password newpsw
Related commands
cwmp acs username
cwmp acs url
Use cwmp acs url to configure the ACS URL.
Use undo cwmp acs url to restore the default.
Syntax
cwmp acs url url
undo cwmp acs url
Default
No ACS URL is configured.
Views
CWMP view
Default command 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.
Usage guidelines
If you use the command multiple times, the URL configured the last time takes effect.
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
Use cwmp acs username to configure the username used for connecting to the ACS.
Use undo cwmp acs username to restore the default.
Syntax
cwmp acs username username
undo cwmp acs username
Default
No username is configured for connecting to the ACS.
Views
CWMP view
Default command 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.
Usage guidelines
If you use the command multiple times, the newly configured username overwrites the previous one.
Examples
# Configure the username used for connecting to the ACS as newname.
<Sysname> system
[Sysname] cwmp
[Sysname-cwmp] cwmp acs username newname
Related commands
cwmp acs password
cwmp cpe connect retry
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.
Syntax
cwmp cpe connect retry times
undo cwmp cpe connect retry
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.
Views
CWMP view
Default command 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.
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
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.
Syntax
cwmp cpe connect interface interface-type interface-number
undo cwmp cpe connect interface
Default
The default CWMP connection interface depends on the device model.
Views
CWMP view
Default command level
2: System level
Parameters
interface-type interface-number: Specifies the type and number of the interface that connects the CPE to the ACS.
Examples
# Specify Ethernet 1/0 as the interface that connects the CPE to the ACS.
<Sysname> system
[Sysname] cwmp
[Sysname-cwmp] cwmp cpe connect interface ethernet 1/0
cwmp cpe inform interval
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.
Syntax
cwmp cpe inform interval seconds
undo cwmp cpe inform interval
Default
The Inform message sending interval is 600 seconds.
Views
CWMP view
Default command level
2: System level
Parameters
seconds: Sets the Inform message sending interval, in the range of 10 to 86400 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
Use cwmp cpe inform interval enable to enable periodical sending of Inform messages.
Use undo cwmp cpe inform interval enable to restore the default.
Syntax
cwmp cpe inform interval enable
undo cwmp cpe inform interval enable
Default
Periodical sending of Inform messages is disabled.
Views
CWMP view
Default command level
2: System level
Examples
# Enable periodical sending of Inform messages.
<Sysname> system
[Sysname] cwmp
[Sysname-cwmp] cwmp cpe inform interval enable
cwmp cpe inform time
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.
Syntax
cwmp cpe inform time time
undo cwmp cpe inform time
Default
The CPE is not configured to send an Inform message at a specific time.
Views
CWMP view
Default command level
2: System level
Parameters
time: 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.
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
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.
Syntax
cwmp cpe password [ cipher | simple ] password
undo cwmp cpe password
Default
No password is configured for connecting to the CPE.
Views
CWMP view
Default command 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.
Usage guidelines
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 configured the last time takes effect.
For secrecy, all keys, including keys configured in plain text, are saved in cipher text.
Examples
# Configure the password used for connecting to the CPE as newpsw.
<Sysname> system
[Sysname] cwmp
[Sysname-cwmp] cwmp cpe password newpsw
Related commands
cwmp cpe username
cwmp cpe username
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.
Syntax
cwmp cpe username username
undo cwmp cpe username
Default
No username is configured for connecting to the CPE.
Views
CWMP view
Default command 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.
Usage guidelines
If you configure the cwmp cpe username command multiple times, the last configuration takes effect.
Examples
# Configure the username used for connecting to the CPE as newname.
<Sysname> system
[Sysname] cwmp
[Sysname-cwmp] cwmp cpe username newname
Related commands
cwmp cpe password
cwmp cpe wait timeout
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.
Syntax
cwmp cpe wait timeout seconds
undo cwmp cpe wait timeout
Default
The CPE close-wait timer is 30 seconds.
Views
CWMP view
Default command level
2: System level
Parameters
seconds: Sets the CPE close-wait timer, in the range of 30 to 1800 seconds.
Usage guidelines
The close-wait timer specifies how long the connection to the ACS can be idle before it is shut down. If no data is transmitted over the connection before the timer expires, the CPE disconnects the connection to the ACS.
Examples
# Configure the CPE close-wait timeout as 60 seconds.
<Sysname> system
[Sysname] cwmp
[Sysname-cwmp] cwmp cpe wait timeout 60
cwmp device-type
Use cwmp device-type to configure the CPE working mode of the device.
Use undo cwmp device-type to restore the default.
Syntax
cwmp device-type { device | gateway }
undo cwmp device-type
Default
The device works in gateway mode.
View
CWMP view
Default level
2: System level
Parameters
device: Sets the device to operate in device mode. Use this keyword if no lower-level CPEs attach 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 keyword to enable the ACS to manage the device and all the attached CPEs.
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
Use cwmp enable to enable CWMP.
Use undo cwmp enable to disable CWMP.
Syntax
cwmp enable
undo cwmp enable
Default
CWMP is disabled.
Views
CWMP view
Default command level
2: System level
Usage guidelines
CWMP cannot be disabled when the CPE or ACS is performing an uploading or download operation.
Examples
# Enable CWMP.
<Sysname> system
[Sysname] cwmp
[Sysname-cwmp] cwmp enable
display cwmp configuration
Use display cwmp configuration to display the current CWMP configuration.
Syntax
display cwmp configuration [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command 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.
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
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 connecting to the ACS. It is displayed as null if not configured. |
Inform enable status |
Enabled/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 |
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
Use display cwmp status to display the current status of CWMP.
Syntax
display cwmp status [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command 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.
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
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—Indicates that the ACS URL is configured through CLI. · config file—Indicates that the ACS URL is configured through ACS. · DHCP—Indicates that the ACS URL is configured through DHCP. |
ACS username |
Authentication username for connecting 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 last 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
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.
Syntax
ssl client-policy policy-name
undo ssl client-policy
Default
No SSL client policy is specified.
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.
Usage guidelines
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