- Table of Contents
-
- 01-Fundamentals Configuration Guide
- 00-Preface
- 01-CLI configuration
- 02-RBAC configuration
- 03-Login management configuration
- 04-FTP and TFTP configuration
- 05-File system management configuration
- 06-Configuration file management configuration
- 07-Software upgrade configuration
- 08-ISSU configuration
- 09-Automatic configuration
- 10-Device management configuration
- 11-Tcl configuration
- 12-Python configuration
- 13-License management
- Related Documents
-
Title | Size | Download |
---|---|---|
09-Automatic configuration | 67.07 KB |
Contents
Using URL-based automatic configuration
About URL-based automatic configuration
How URL-based automatic configuration works
Using automatic configuration
About automatic configuration
With the automatic configuration feature, the device can automatically obtain a set of configuration settings at startup. You only need to save the configuration file on a specific storage medium. This feature simplifies network configuration and maintenance.
The device supports only URL-based automatic configuration. URL-based automatic configuration applies to scenarios where the devices to be configured are geographically distributed.
Using URL-based automatic configuration
About URL-based automatic configuration
URL-based automatic configuration uses a customizable configuration file saved on the device by default to implement basic device configuration after the device starts up. The configuration file contains the basic network configuration command lines. This feature requires you to construct a URL to indicate the values for the parameters in the command lines.
How URL-based automatic configuration works
The basic device configuration defines how the device connects to the network. By default, the following connection modes are available: PPPoE mode, static IP address mode, and DHCP mode. The customizable configuration file contains the command lines for the connection modes. The required URL varies by connection mode.
PPPoE mode
Table 1 lists the parameters required or optional in the URL in PPPoE mode. The following is the format of the URL in PPPoE mode:
http://Device IP address/urlcfg?sys_name=Device name&link_mode=Link mode&ntp_server=NTP server (optional)&link_if=WAN interface&ac_host=Server IP address&ac_port=Server port&ac_password=Server password&pap_user=PPPoE PAP authentication password&pap_password=PPPoE PAP authentication password&chap_user=PPPoE CHAP authentication username&chap_password=PPPoE CHAP authentication password
Table 1 Parameters required for PPPoE mode
Item |
Parameter |
Value type |
Value range |
Corresponding command |
Required |
Device address |
Device IP address |
IP address |
N/A |
N/A |
Yes |
Device name |
sys_name |
String |
1 to 64 |
sysname sysname |
Yes |
Server address |
ac_host |
IP address |
N/A |
cloud-management server domain ip-address |
Yes |
Server port |
ac_port |
Integer |
1 to 65535 |
cloud-management server port port-number |
Yes |
Server password |
ac_password |
String |
1 to 63 |
cloud-management server password simple password |
Yes |
NTP server |
ntp_server |
IP address |
N/A |
ntp-service unicast-server ip-address |
No |
WAN interface |
link_if |
Interface type and number |
N/A |
interface interface-type interface-number |
Yes |
PPPoE connection mode |
link_mode |
String |
PPPoE |
N/A |
Yes |
PPPoE PAP authentication username |
pap_user |
String |
1 to 80 |
ppp pap local-user user-name password simple password |
Yes |
PPPoE PAP authentication password |
pap_password |
String |
1 to 255 |
ppp pap local-user user-name password simple password |
Yes |
PPPoE CHAP authentication username |
chap_user |
String |
1 to 80 |
ppp chap user user-name |
Yes |
PPPoE CHAP authentication password |
chap_password |
String |
1 to 255 |
ppp chap password simple password |
Yes |
Static IP address mode
Table 2 lists the parameters required or optional in static IP address mode. The following is the format of the URL in static IP address mode:
http://Device IP address/urlcfg?sys_name=Device name&link_mode=Link mode&ntp_server=NTP server (optional)&link_if=WAN interface&static_ip=Static IP address&static_mask=Static IP mask&ac_host=Server address&ac_port=Server port&ac_password=Server password
Table 2 Parameters required for static IP address mode
Item |
Parameter |
Value type |
Value range |
Corresponding command |
Required |
Device address |
Device IP address |
IP address |
N/A |
N/A |
Yes |
Device name |
sys_name |
String |
1 to 64 |
sysname sysname |
Yes |
Server address |
ac_host |
IP address |
N/A |
cloud-management server domain ip-address |
Yes |
Server port |
ac_port |
Integer |
1 to 65535 |
cloud-management server port port-number |
Yes |
Server password |
ac_password |
String |
1 to 63 |
cloud-management server password simple password |
Yes |
NTP server |
ntp_server |
IP address |
N/A |
ntp-service unicast-server ip-address |
No |
WAN interface |
link_if |
Interface type and number |
N/A |
interface interface-type interface-number |
Yes |
Static IP address connection mode |
link_mode |
String |
STATIC |
N/A |
Yes |
Static IP address |
static_ip |
IP address |
N/A |
ip address ip-address mask |
Yes |
Static IP mask |
static_mask |
IP mask |
N/A |
ip address ip-address mask |
Yes |
Static default gateway |
gateway |
IP address |
N/A |
ip route-static 0.0.0.0 0.0.0.0 next-hop-address |
Yes |
DHCP mode
Table 3 lists the parameters required or optional in DHCP mode. The following is the format of the URL in DHCP mode:
http://Device IP address/urlcfg?sys_name=Device name&link_mode=Link mode&ntp_server=NTP server (optional)&link_if=WAN interface&ac_host=Server address&ac_port=Server port&ac_password=Server password
Table 3 Parameters required for DHCP mode
Item |
Parameter |
Value type |
Value range |
Corresponding command |
Required |
Device address |
Device IP address |
IP address |
N/A |
N/A |
Yes |
Device name |
sys_name |
String |
1 to 64 |
sysname sysname |
Yes |
Server address |
ac_host |
IP address |
N/A |
cloud-management server domain ip-address |
Yes |
Server port |
ac_port |
Integer |
1 to 65535 |
cloud-management server port port-number |
Yes |
Server password |
ac_password |
String |
1 to 63 |
cloud-management server password simple password |
Yes |
NTP server |
ntp_server |
IP address |
N/A |
ntp-service unicast-server ip-address |
No |
WAN interface |
link_if |
Interface type and number |
N/A |
interface interface-type interface-number |
Yes |
DHCP connection mode |
link_mode |
String |
DHCP |
N/A |
Yes |
Procedure
1. Power on the device.
2. On the configuration terminal, launch a Web browser and enter the default IP address of the device in the address bar. Then, enter the default username and password as prompted to log in to the device.
You can change the default IP address, username, and password on the device. The IP address and username are the device address and device name required in the URL.
3. Construct a URL as describe in "How URL-based automatic configuration works."
4. Enter the URL in the address bar and enter the username and password as prompted.
The device will use the parameters and values in the URL and the customizable configuration file to reconstruct a configuration file, and then execute the file to complete automatic configuration.
Configuration file
IMPORTANT: The contents of the configuration file might vary by device model. |
PPPoE mode section
{link_mode = PPPoE}
#
system-view
#
sysname [sys_name]
#
dialer-group 1 rule ip permit
#
interface Dialer1
1:ppp chap password simple [chap_password]
1:ppp chap user [chap_user]
ppp ipcp dns admit-any
ppp ipcp dns request
1:ppp pap local-user [pap_user] password simple [pap_password]
dialer bundle enable
dialer-group 1
dialer timer idle 0
dialer timer autodial 5
ip address ppp-negotiate
tcp mss 1024
nat outbound
#
quit
#
interface [link_if]
port link-mode route
pppoe-client dial-bundle-number 1
#
quit
#
1:ntp-service unicast-server [ntp_server]
#
cloud-management server domain [ac_host]
cloud-management server port [ac_port]
cloud-management server password simple [ac_password]
#
ip route-static 0.0.0.0 0 Dialer1
#
Static IP address mode section
{link_mode = STATIC}
#
system-view
#
sysname [sys_name]
#
interface [link_if]
port link-mode route
ip address [static_ip] [static_mask]
nat outbound
#
qu
#
1:ntp-service unicast-server [ntp_server]
#
cloud-management server domain [ac_host]
cloud-management server port [ac_port]
cloud-management server password simple [ac_password]
#
ip route-static 0.0.0.0 0.0.0.0 [gateway]
#
DHCP mode section
{link_mode = DHCP}
#
system-view
#
sysname [sys_name]
#
interface [link_if]
port link-mode route
ip address dhcp-alloc
nat outbound
#
qu
#
1:ntp-service unicast-server [ntp_server]
#
cloud-management server domain [ac_host]
cloud-management server port [ac_port]
cloud-management server password simple [ac_password]
#