No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

AR Router Troubleshooting Guide

This Product Documentation provides guidance for maintaining AR Enterprise Router, covering common information collection and fault diagnostic commands, typical fault troubleshooting guide, and troubleshooting.
Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
How Do I Make an Index File for USB-based Deployment?

How Do I Make an Index File for USB-based Deployment?

Before using a USB flash drive to configure the router, check whether the index file of the USB flash drive exists. You can edit the index file to perform deployment.

To edit the index file on the PC, perform the following operations:
  1. Create a text file.
  2. Edit the index file.
  3. Save the .txt file as USB_AR.ini.
  4. Copy the USB_AR.ini file to the root directory of the USB flash drive.

In versions earlier than V200R005C00, the format of the index file for USB-based deployment is as follows:

BEGIN AR
[USB CONFIG]
SN=
EMS_ONLINE_STATE=
[UPGRADE INFO]
OPTION=
AUTOFLAG=
PASSWORD=
DEVICENUM=
[DEVICEn DESCRIPTION]
OPTION=
ESN=
MAC=
VERSION=
DIRECTORY=
FILENUM=
TYPEn=
FILENAMEn=
END AR

In V200R005C00 and later versions, the format of the index file for USB-based deployment is as follows:

BEGIN AR
[USB CONFIG]
SN=
EMS_ONLINE_STATE=
[UPGRADE INFO]
OPTION=
DEVICENUM=
[DEVICEn DESCRIPTION]
OPTION=
ESN=
MAC=
VERSION=
DIRECTORY=
FILENUM=
TYPEn=
FILENAMEn=
HMACn=
END AR
Table 29-42  Fields in the index file

Field

Description

BEGIN AR

Start tag of the index file. This field cannot be modified.

USB CONFIG

USB flash drive configuration. This field cannot be modified.

SN

Data change time in the format YearMonthDay.HourMinuteSecond.

For example, the value 20110628.080910 indicates 2011-06-28 08:09:10.

NOTE:
The SN field is a USB-based deployment flag. A device has a default USB-based deployment flag. If the USB_AR.ini file exists in the USB flash drive, the device checks whether the default USB-based deployment flag and the SN value in the USB_AR.ini file are the same. If they are different, the USB-based deployment process is triggered. If the deployment succeeds, the value of the default USB-based deployment flag on the device is changed to the SN value in the USB_AR.ini file.

EMS_ONLINE_STATE

Indicates whether the NMS is online. The options are as follows:
  • YES: The NMS is online.
  • NO: The NMS is offline.

UPGRADE INFO

Upgrade information header. This field cannot be modified.

OPTION

Upgrade mode flag. The field has a fixed value of AUTO.

AUTOFLAG

Whether password authentication is performed:
  • 0: password authentication is not performed.
  • 1: password authentication is performed.
NOTE:

This field is supported in versions from V200R002C01 to versions earlier than V200R005C00..

PASSWORD

Authentication password in USB-based deployment. This parameter is mandatory when the value of AUTOFLAG is 1. The password must be the same as the password configured using the set usb autoupdate password command. The value is a string of 1 to 64 characters without spaces.

NOTE:

This field is supported in versions from V200R002C01 to versions earlier than V200R005C00.

DEVICENUM

Number of devices to be upgraded using this index file.

  • To upgrade the software version of one device, set the value of the DEVICENUM field to 1 and use the device's ESN and MAC address.

  • To upgrade software versions of multiple devices to the same version, set the value of the DEVICENUM field to 1 and use the default ESN and MAC address.

  • To upgrade software versions of multiple devices to different versions, set the value of the DEVICENUM field to the number of devices to be upgraded and use devices' ESNs and MAC addresses.

DEVICEn DESCRIPTION

Description information header of device n. The value of n is an integer that ranges from 1 to 100.

NOTE:
The value n must be set when you make the index file.

OPTION

This field determines whether USB-based deployment is required for the device. The value OK indicates that USB-based deployment is required, and the value NOK indicates that USB-based deployment is not required.

ESN

Serial number of a device. If the value of this field is DEFAULT, the index file is applicable to all devices. Otherwise, the index file is applicable to a specific device.

NOTE:

If this field is left empty, this field matches all devices.

MAC

MAC address of a device. If the value of this field is DEFAULT, the index file is applicable to all devices. Otherwise, the index file is applicable to a specific device.

NOTE:

If this field is left empty, this field matches all devices.

VERSION

Version number after the upgrade.

NOTE:

If the software version is unknown, set this field to any value.

DIRECTORY

Path for storing deployment files.
  • If the value is DEFAULT, the deployment files are stored in the root directory of the USB flash drive.
  • If the value is /abc, the deployment files are stored in the abc directory.
NOTE:

If this field is left empty, the deployment files are saved in the root directory of the USB flash drive.

FILENUM

Number of files to be loaded.

If only the system software needs to be loaded, the value of this field is set to 1. If the system software and patch file need to be loaded, the value of this field is set to 2.

TYPEn

Upgrade file type. The options are as follows:
  • SYSTEM-SOFTWARE: system software.
  • SYSTEM-CONFIG: configuration file.
    NOTE:

    If the device supports the voice function and works as a PBX, the configuration file is SYSTEM-CONFIG_PBX.

    If the device supports the voice function and works as a SIP AG, the configuration file is SYSTEM-CONFIG_AG.

  • SYSTEM-PAT: patch file.
  • SYSTEM-LICENSE: license file.
  • SYSTEM-VOICE: voice file.
  • USER-DEFINE: user-defined file.

The value of n starts from 1.

FILENAMEn

Upgrade file name. For example, if the value of the TYPE1 field is SYSTEM-SOFTWARE and the name of the system software corresponding to the U disk is system-software.cc, the value of the FILENAME1 field is system-software.cc.

The value of n starts from 1.

HMACn

HMAC used to verify a file to be downloaded. The MAC is a 64-byte character string that is calculated for a specific file using a file checker based on the HMAC-SHA256 algorithm. The key used to calculate the HMAC must be the same as the password configured by the set usb autoupdate password command.

The value of n starts with 1.

NOTE:

This field is optional and supported in V200R005C00 and later versions.

END AR

End tag of the index file.

Translation
Download
Updated: 2019-05-10

Document ID: EDOC1000079719

Views: 444429

Downloads: 4295

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next