server-detect

Function

The server-detect command enables the Portal server detection function.

The undo server-detect command disables the Portal server detection function.

By default, the Portal server detection function is disabled.

Format

server-detect [ interval interval-period | max-times times | critical-num critical-num | action { log | trap | permit-all } ^* ] ^*

undo server-detect [ interval | max-times | critical-num | action { log | trap | permit-all } ^* ]

Parameters

Parameter	Description	Value
interval interval-period	Specifies the detection interval of the Portal server.	The value is an integer that ranges from 30 to 65535, in seconds. The default value is 60.
max-times times	Specifies the maximum number of times that the detection fails.	The value is an integer that ranges from 1 to 255. The default value is 3.
critical-num critical-num	Specifies the minimum number of Portal servers in Up state.	The value is an integer that ranges from 0 to 128. The default value is 0. The default value is recommended.
action	Specifies the action to be taken after the number of detection failures exceeds the maximum.	-
log	Indicates that the device sends a log after the number of detection failures exceeds the maximum.	-
trap	Indicates that the device sends a trap after the number of detection failures exceeds the maximum.	-
permit-all	Cancels Portal authentication on an interface after the number of detection failures exceeds the maximum.	-

Views

Portal server template view

Default Level

2: Configuration level

Usage Guidelines

If the communication is interrupted because the network between the device and Portal server is faulty or the Portal server is faulty, new Portal authentication users cannot go online. This brings great inconvenience to users.

After the Portal server detection function is enabled in the Portal server template, the device detects all Portal servers configured in the Portal server template. If the number of times that the device fails to detect a Portal server exceeds the upper limit, the status of the Portal server is changed from Up to Down. If the number of Portal servers in Up state is less than or equal to the minimum number (specified by the critical-num parameter), the device performs the corresponding operation to allow the administrator to obtain the real-time Portal server status or ensure that the users have certain network access rights.

The detection interval of the Portal server multiplied by the maximum number of detection failures cannot be less than the keepalive heartbeat interval of the Portal server. It is recommended that the configured detection interval of the Portal server be greater than the keepalive heartbeat interval of the Portal server.

Example

# Enable the Portal server detection function in the Portal server template abc. Configure the detection interval to 100 seconds, the maximum number of detection failures to 5. Configure the device to send log information when the number of detection failures exceeds the upper limit.

<HUAWEI> system-view
[HUAWEI] web-auth-server abc
[HUAWEI-web-auth-server-abc] server-detect interval 100 max-times 5 action log