install-module

Function

The install-module command installs module packages.

By default, no module package is installed.

Format

install-module file-name [ next-startup ]

Parameters

Parameter	Description	Value
file-name	Specifies the name of a module package to be installed. file-name supports file name association. The related file can be associated and displayed after you enter a specified character string.	The value is a string of 5 to 64 case-insensitive characters without spaces.
next-startup	Specifies the name of the module package to be installed during next startup.	-

Parameter

Description

Value

file-name

Specifies the name of a module package to be installed.

file-name supports file name association. The related file can be associated and displayed after you enter a specified character string.

The value is a string of 5 to 64 case-insensitive characters without spaces.

next-startup

Specifies the name of the module package to be installed during next startup.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Software upgrade is a common method to add new services on a network. This method, however, is complex and affects services. To solve these problems, you can run the install-module command to install the module package of a desired function, without upgrading or powering off your device.

Run the install-module file-name command to load a module in the module package to the device. The module directly takes effect after being loaded. If the device is in a stack, the module is loaded to all the devices in the stack, including the master, standby, and slave switches.
Run the install-module file-name next-startup command to add the module package to the next startup module list. The device automatically loads the module next time it starts. Before a module package is installed dynamically, the system checks the module package validity. In the next startup module list, one module can exist in only one module package.

Precautions

The file name extension of the module package must be .MOD, and the file must be saved in the directory $_install_mod on the device.
The module package version must match the current system software version. Otherwise, the module package will fail to be installed.
The system allows you to install up to 16 modules.

Example

# Load the module package s5720hi.mod.

<HUAWEI> install-module s5720hi.mod
Info: Installing the module flash:/$_install_mod/s5720hi.mod..
.
Info: Succeeded in installing the module on the master board....

# Configure the module package to be loaded during next startup.

<HUAWEI> install-module s5720hi.mod next-startup
Info: The result will be shown in several minutes. Please wait for a moment.....
...
Info: Succeeded in setting the next-startup module.