The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
To upgrade the device using trivial file transfer protocol (TFTP), follow these conditions:
The device must be connected to the network.
The device must be configured to communicate with the local TFTP server.
The target device image must be uploaded to the root directory of the local TFTP server.
The TFTP device upgrade feature enables you to perform an automatic device upgrade or a direct device upgrade. In an automatic device upgrade, the device periodically checks for the availability of new device using the manifest file and initiates the upgrading process. In a direct device upgrade, the device retrieves the specified device image from the TFTP server and initiates the upgrading process.
You can choose either of the following methods:
This method enables the device to connect to the local TFTP server at user-determined intervals to check for the availability of new device image. The device detects the device image file and performs the upgrade.
|
Step 1 |
Create device.manifest file and upload to the same TFTP server root directory where the device image is stored. |
||||
|
Step 2 |
Before enabling the TFTP automatic upgrade, configure the TFTP server and time interval.
|
The manifest file is a configuration component that acts as a roadmap for the device upgrade process.
Provides instructions for retrieving the device image from the TFTP server.
Defines the conditions that must be satisfied before the upgrade begins.
The device retrieves the manifest file from the TFTP server.
The device parses the manifest file to locate the device image.
The device retrieves the image from the TFTP server.
The device verifies the required conditions and initiates the upgrade.
The manifest file contains the device image filename, MD5 checksum, and device image version required for the device upgrade process.
The manifest file includes the following information:
Device image filename
MD5 checksum of the device image file
Device image version
|
Device Type |
Manifest File Name |
|---|---|
|
IW9167EH |
IW9167EH.manifest |
|
IW9165E |
IW9165E.manifest |
|
IW9165DH |
IW9165DH.manifest |
image_name=ap1g6m-k9c1-tar.202307110910
image_md5=376e15acd4e82a49a81d42add904f5b0
image_version=8.8.1.101Direct device upgrade using TFTP is a configuration method where the device retrieves a specified image file directly from a remote TFTP server to perform a system update.
Requires a reachable TFTP server with the target image file.
Uses specific CLI commands to define the server address and file path.
Initiates the upgrade process immediately upon command execution.
|
Purpose |
Command or Action |
|---|---|
|
To configure the TFTP server with IP address |
A.B.C.D: IP address of the TFTP server |
|
To configure the TFTP upgrade image |
Configure TFTP upgrade image <image file bin> |
 Caution |
Do not disconnect or reboot the device until the device download completes. Based on the image file size, the device upgrade may take some time. |
|
Step 1 |
Use the configure tftp server ip-address command to configure the TFTP server IP address. Example:ip-address : IP address of the TFTP server. |
||
|
Step 2 |
Enable or disable automatic TFTP device upgrades.
|
||
|
Step 3 |
Use the configure tftp upgrade check period period command to configure the check period for TFTP device upgrades. Example:
|
||
|
Step 4 |
Use the configure tftp upgrade check now command to check for the manifest file immediately. Example: |
||
|
Step 5 |
Use the show tftp config command to verify the TFTP configuration. Example: |
The device upgrade procedure fails to start under the following conditions:
If the MD5 checksum reported in the manifest file does not match the MD5 checksum calculated on the device image file ( image_name ).
If the device image version reported in the manifest file matches the current device version running on the device.
Example of show TFTP configuration:
Device# show tftp config
Automatic TFTP Upgrade settings:
Status: enabled
Server: A.B.C.D
Check period (hours): 3
Example of automatic TFTP upgrade:
Device# configure tftp server A.B.C.D
Device#configure tftp upgrade check period 3
Device#write
Device#configure tftp upgrade automatic enable
Device#write
Device#reload
Feedback