Intel ZT 7102 Hooks for User Scripts, Update Mode User Scripts, Data Restore User Scripts, 134

Intel® NetStructureTMZT 7102 Chassis Management Module

Updating Software

user and password - Optional argument that is the username and password for the FTP server.

Note: The -v argument can be up to 64 characters long.

The command returns a 0 if the update request is successful, and non-zero if an error occurs.

25.12Hooks for User Scripts

The update process provides hooks for user scripts in two places during the update process. User scripts should follow the convention of returning a "0" if successful and a non-zero for failure. The user scripts will be invoked as a forked sub-shell.

25.12.1Update Mode User Scripts

Entering update mode requires that all JFFS2 drives be unmounted, which requires that all processes using these drives be stopped. Prior to entering update mode, the update process will call user scripts located in /home/update/scripts/ if they exist. The update process will execute any scripts that match the following pattern: /home/update/scripts/K*. No arguments are passed to these scripts. The update process will not fail if a script returns a failure, however, the update process will fail if the flash drives cannot be unmounted when necessary. A message indicating if the script was successful or failed will be output to the terminal. See Section 25.6, “Update Mode” on page 131 for more information on the Update Mode.

25.12.2Data Restore User Scripts.

The update process will also execute user scripts following the update of the new /etc file system to flash. The update process will execute any user scripts that match the following pattern: /home/update/scripts/S*. Arguments will be passed that the scripts can use. These arguments are:

arg1 = Update Component Name: ["BlueCat", "etc_jffs", "RedBoot", "fpga"]

Note: For the user scripts, this argument will always be "etc_jffs".

arg2 = Update Direction: ["forward", "backward", "same"]

Note: "forward" means that the Update Package version is newer than the installed version. "same" means they are the same, and "backward" means the Update Package version is older then the installed version.

arg3 = Installed Package Version: i.e., "P00.105b". This is the version of the software that is currently installed on the cmm.

arg4 = Update Package Version: i.e., "P00.111a". This is the version of the update package software.

The update script will print a message to the terminal indicating whether the script was successful or failed. Currently, the failure of one of these scripts does not cause the overall update process to fail.

These scripts can be used to perform any user updates that need to coincide with the newly installed version.

134 Technical Product Specification