An assistant task is a virtual assistant on a device to realize automatic maintenance and management. After you create an assistant task and bind it to a batch of files to be processed, the device performs operations or configurations when it is unattended. Assistant tasks are mainly used for scheduled system upgrade or configuration.

Usage Scenario

The system divides commands into levels for management. Each command in views has a specified level. The device administrator can change a command level as required so that a lower-level user can use certain high-level commands. The device administrator can also increase the command level to a larger value to improve device security.

Precautions

The rules for using this command to set the command level of a specified view are as follows:

• When you degrade the target command, all keywords in the command are degraded.
• When you upgrade the target command, only the last keyword in the command is upgraded.
• When you set a level for the target command, the levels of all commands (in the same view) starting with this command are changed.
• When you set a level for the target command, the keyword level in other commands having the same index as the keyword whose level is changed is also changed.
• If the level of keywords that have the same index is modified for multiple times, the latest configured level takes effect.

Do not change the default command level. If you need to change it, consult with professional personnel to ensure that routine operation and maintenance are not affected and security risks are avoided.

Usage Scenario

Each command registered on a device is assigned a default level 0, 1, 2, or 3. These levels correspond to the visit level, monitoring level, configuration level, and management level. You can run the command-privilege level rearrange command to upgrade all the level-2 and level-3 commands to level-10 and level-15 commands in batches. The level-0 and level-1 commands remain unchanged.

Precautions

• You can change the levels of the commands that are not separately changed by the command-privilege level command. The levels of the commands that are separately changed by the command-privilege level command cannot be upgraded.

• You can restore the levels of the commands that are upgraded in batches. The levels of the commands that are separately changed by the command-privilege level command cannot be upgraded.
• After the command-privilege level rearrange command is run, users at Level 2 to Level 9 are not allowed to run commands defaulted to Level 2, and users at Level 3 to Level 14 are not allowed to run commands defaulted to Level 3. If some users are required to have the same command privilege as that before the command level promotion, you are advised to adjust the levels of all users on the device.
• After the undo command-privilege level rearrange command is run, users at level 3 to level 14 are allowed to run commands defaulted to level 3, and users at level 2 to level 9 are allowed to run commands defaulted to level 2. If some users are required to have the same command privilege as that before the command level decrease, you are advised to adjust the levels of all users on the device.
• You can use the command-privilege level rearrange command only when your user level is 15.
• After the levels of the commands are upgraded in batches and before the levels of the commands are restored, upgrading the levels of the commands is invalid and does not change the current status of the commands.

Diagnostic commands are mainly used for fault diagnosis. However, running certain commands may cause device faults or service interruptions. Therefore, use these diagnostic commands under the instruction of technical support personnel.

The five latest operations of each assistant task are displayed in order from earliest to latest.

The display component command displays information about a registered component.

Usage Scenario

The terminal automatically saves the history commands entered by the user, that is, records any keyboard entry of the user with Enter as the unit.

By default, the display history-command command displays a maximum of 10 historical commands. If the number of historical commands is less than 10, the display history-command command output displays all of them. Run history-command max-size command to set the size of the historical command buffer.

Precautions

Commands run by users are automatically saved on the terminal. Any input that ends with Enter is saved as a historical command.

You can check historical commands using the following methods:

• To check a previous historical command, press the Up arrow key or Ctrl+P.

• To check a next historical command, press the Down arrow key or Ctrl+N.

Usage Scenario

The Simple Network Management Protocol (SNMP) is a standard network management protocol widely used on TCP/IP networks. It uses a central computer (a network management station) that runs network management software to manage network elements. The management agent on the network element automatically reports traps to the network management station. After that, the network administrator immediately takes measures to resolve the problem.

Prerequisites

The SNMP function has been enabled on the network element. For the relevant command, see snmp-agent.

Usage Scenario

After configurations are complete in a certain view, run the display this command to check the current configurations.

Precautions

If a configuration parameter uses the default value, this parameter is not displayed. Configurations for functions that do not take effect are not displayed.

If you run the display this command in an interface view, configurations of the interface view are displayed. If you run this command in a protocol view, configurations of the protocol view are displayed.

You can use this command to check the default configurations of physical attributes, basic Ethernet protocols, routing, multicast, QoS, and security features on Ethernet interfaces.

This command can also display the following default global configurations: enabling of the function that sends ICMP host/port unreachable packets, enabling of the function that discards ICMP packets with TTL value 1, rate limit for ARP Miss packets, enabling of ICMP packet rate limiting, and interval for collecting statistics about CAR-based traffic statistics.

Usage Scenario

To provide some prompts or alarms to users, run the header command to configure a title on the device. If a user logs in to the device, the title is displayed.

Procedure

If information is specified, the header text starts and ends with the same character. You can set the header text in either of the following modes:

• Non-interactive: enter the header text behind the start character.

  Use the same character at the beginning and end of the header and press Enter. If the start and end characters are inconsistent, the system prompts an error message.

• Interactive: enter the start character and press Enter to enter the interactive process.

  The system displays a message asking you to enter the correct header information. After you enter the information, enter the same character as the start character. Press Enter. The system quits the interactive process.

  During interaction, you can press Enter at any time to enter information in the next line.

Precautions

• Before setting the login parameter, you must set login authentication parameters; otherwise, no header information about authentication is displayed.
• Before setting the file parameter, ensure that the file containing the header exists; otherwise, the file name cannot be obtained. If you change header information after login, the header information that has been displayed in the system does not change, even if you exit and log in to the system again. The header information changes in either of the following cases:
  • You have successfully changed the header information. Before the system restarts, you run this command again. Then you exit and log in to the system again.
  • You have successfully changed the header information. Then you restart the system.
• If you use SSH1.X to log in to the device, only the shell header is displayed.
• If you use SSH2.0 to log in to the device, both login and shell headers are displayed in the login process.
• If the header command is configured several times, only the latest configuration takes effect.
• After configuring the login header, any user that logs in to the system can view the header.
• In the system view, run the execute batch-filename batch processing command. If the batch processing command contains the header { login | shell } information text command and text contains line feed character \r\n, you need to use third-party software to change the hexadecimal value (0D 0A) of the line feed character \r\n to (1B 19).

Usage Scenario

The if-match timer cron command is used to set the time to perform an assistant task. The time is expressed in the cron format defined in UNIX or Linux.

Precautions

• If you run the if-match timer cron command multiple times in the same view, only the latest configuration takes effect.

• The days-of-month and days-of-week parameters are exclusive. Set one or both of them to "*". If one parameter is set to *, the other one specifies a specific date. If both parameters are set to *, they can refer to any date.

• The minimum unit supported is minute, so set the second parameter to *. The specified assistant task works only once every minute.

• Since the system can perform only one assistant task at a time, the time when one assistant task finished working may be later than the time when the next task is schedule to start. There may be a time span between the time when an assistant task is scheduled to work and the time when it actually starts to work. The if-match timer cron command specifies the time when an assistant task is scheduled to work.

• When you enter digits, such as 000002012, the numeric string means the same as 2012.

Usage Scenario

After you successfully create an assistant task and specify the execution time, you can run this command to configure the device to process a batch file at the specified time.

Prerequisites

An assistant task has been created using the assistant task command and the execution time has been specified using the if-match timer cron command.

Precautions

To delete an assistant task that is being executed, stop it first. To delete an assistant task to be executed, directly delete it. The device will not execute the assistant task in the future.

Usage Scenario

Three types of views are available (listed from a lower level to a higher level):

• User view

• System view

• Service view, such as the interface view

Run the quit command to return to a lower-level command view from the current view. Running this command in the user view quits from the system.

To delete historical commands entered by the current user, run the reset history-command command. If a level 3 (or higher) user runs the reset history-command all-users command, historical commands entered by all users are deleted.

Use the return command in other views to return to the user view.

• This command returns to the user view if the current view is another view (but not the user view).
• No change occurs after running this command if the current view is the user view.
• The shortcut keys Ctrl+Z functions similarly as the return command.

You can specify trap-name to enable the trap function for one or more events of the LINE module.

You must configure the device in the system view. Run this command in the user view to enter the system view.

Usage Scenario

If forward commands are enabled to automatically match the upper-level view and you run a forward command not registered in the current view, the system automatically switches to the upper-level view to search for the command. If the command is found in that view, the system runs the command. If the command is not found in that view, the system continues the search in the next upper-level view until the system view.

Precautions

The terminal command forward matched upper-view command takes effect only for the current login user who runs this command.

Usage Scenario

When operating a device using the NMS, run this command to change the command output mode to line to improve operation efficiency. Common users typically use the character mode, so use this mode for common users to improve operation efficiency.

Precautions

• After a user runs this command to set the line mode, this mode takes effect only for this user. Other users still use the character mode.

• After a user changes the command output mode to line, the command output mode automatically switches to character when the user exits the device or the device restarts or performs an active/standby switchover.
• This command does not affect interactive inputs for the command line.