Upgrading HAF

The haf_upgrade script is provided to upgrade HAF. The haf_upgrade script calls the haf-tool CLI.

• Upgrade HAF on host nodes and the offload nodes with the HAF library.

  Host nodes are deployed with the service as a database. Therefore, no independent upgrade script is provided for host nodes.

  To upgrade HAF, perform the following operations:

  1. Obtain the latest software package.

     For details, see Obtaining Software.

     cp BoostKit-haf_1.3.0.zip /home/omm/haf-software

  2. Decompress the software package.

     cd /home/omm/haf-software

     unzip BoostKit-haf_1.3.0.zip

     tar -zxvf haf-1.3.0.tar.gz

  3. Decompress the service installation package.
     mkdir /home/omm/haf-software/haf-update-tmp

     • Host nodes

       tar -zxvf haf-host-1.3.0.tar.gz -C /home/omm/haf-software/haf-update-tmp

     • Offload nodes with the HAF library

       tar -zxvf haf-target-1.3.0.tar.gz -C /home/omm/haf-software/haf-update-tmp

  4. Back up the bin, lib, and tools directories in the original installation directory.

     Go to the tool installation directory.

     mv ./bin ./bin.bak

     mv ./lib ./lib.bak

     mv ./tools ./tools.bak

  5. Copy the bin and lib directories to the original installation directory and change the permissions.

     cp /home/omm/haf-software/haf-update-tmp/bin ./bin

     cp /home/omm/haf-software/haf-update-tmp/lib ./lib

     chmod -R 500 ./bin

     chmod -R 500 ./lib

  6. Decompress the tool installation package.

     cd /home/omm/haf-software

     tar -zxvf haf-tool-1.3.0.tar.gz -C /home/omm/haf-software/haf-update-tmp

  7. Copy the tools directory to the original installation directory and change the permissions.

     Go to the tool installation directory.

     cp /home/omm/haf-software/haf-update-tmp/tools ./tools

     chmod -R 500 ./tools

     

     • user indicates the user of the files in the original installation path.
     • group indicates the user group of the user corresponding to the files in the original installation path.
     • In the following example, both user and group are omm.

       dr-x------ 2 omm omm   26 May  5 10:15 bin
       drwx------ 2 omm omm   103 May  5 10:15 cert
       drwx------ 2 omm omm   31 May  5 10:15 conf-bak
       -r-x------ 2 omm omm   308 May  5 10:15 env.sh
       drwx------ 2 omm omm   77 May  5 10:15 etc
       dr-x------ 3 omm omm 4096 Apr 29 15:58 lib
       drwxrwxr-x 4 omm omm   42 May  5 20:03 logs
       dr-x------ 3 omm omm   60 May  5 10:15 tools

  8. Check whether the service on the host node is running properly.

     Run the service based on the actual service requirements and check whether the service is running properly.

  9. Delete the backup files.

     rm -rf ./bin.bak

     rm -rf ./lib.bak

     rm -rf ./tools.bak

• Upgrade HAF on the offload nodes with the HAF service.

  The procedure is as follows:

  cd /home/omm/haf-install/haf-target/tools/

  ./haf_upgrade -p <upgrade package>

  Option	Description	Mandatory
  -p <upgrade package>	Specifies the new installation package.	Yes

haf-tool provides the following upgrade interface:

• On host nodes and the offload nodes with the HAF library:

  haf-tool cannot be used to run the upgrade command.

• On offload nodes with the HAF service:

  haf-tool upgrade

The inner signature tool verification is used to verify the software package validity when installing the HAF service on offload nodes. This tool is stored in bin in the installation directory and is invoked by the haf_upgrade script. The internal invoking command is as follows:

<haf_dir>/bin/verification -p <install_package>

• haf_dir indicates the directory where HAF is installed.
• verification is an internal tool of the software. You are not advised to invoke it independently.
• In this version, the HAF service installation on offload nodes cannot be upgraded from an earlier version. You need to uninstall the earlier version (such as 1.0 and 1.2.0) and reinstall it.