Upgrading HAF

The HAF upgrade will interrupt services. Therefore, obtain customers' approval before performing the upgrade.

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

• On a host node:

  A host node is deployed with the service as a database. Therefore, no independent upgrade script is provided.

  To upgrade HAF on a host node separately, perform the following operations:

  1. Obtain the latest software package.

     For details, see Obtaining Software.

  2. Decompress the software package.

     unzip BoostKit-haf_1.2.0.zip

  3. Decompress the host installation package.

     tar -zxvf haf-host-1.2.0.tar.gz

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

     mv /home/omm/haf-install/haf-host/bin /home/omm/haf-install/haf-host/bin.bak

     mv /home/omm/haf-install/haf-host/lib /home/omm/haf-install/haf-host/lib.bak

     mv /home/omm/haf-install/haf-host/tools /home/omm/haf-install/haf-host/tools.bak

  5. Copy the bin, lib, and tools directories to the original installation directory, restore the configuration files in tools/scripts, and grant the corresponding permission to the bin, lib, and tools directories.

     cp ./bin /home/omm/haf-install/haf-host/bin

     cp ./lib /home/omm/haf-install/haf-host/lib

     cp ./tools /home/omm/haf-install/haf-host/tools

     cp -rf /home/omm/haf-install/haf-host/tools.bak/scripts/*.json /home/omm/haf-install/haf-host/tools/scripts

     chmod -R 500 /home/omm/haf-install/haf-host/bin

     chmod -R 500 /home/omm/haf-install/haf-host/lib

     chmod -R 500 /home/omm/haf-install/haf-host/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   84 May  5 10:15 bin
       drwx------ 2 omm omm   72 May  5 10:15 etc
       dr-x------ 3 omm omm 4096 Apr 29 15:58 lib
       drwxrwxr-x 4 omm omm   62 May  5 20:03 logs
       drwx------ 6 omm omm   66 May  5 10:15 run
       dr-x------ 3 omm omm   79 May  5 10:15 tools

  6. 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.

  7. Delete the backup files.

     rm -rf /home/omm/haf-install/haf-host/bin.bak

     rm -rf /home/omm/haf-install/haf-host/lib.bak

• On an offload node:

  The procedure is as follows:

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

  ./haf_upgrade -p <upgrade package>

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

haf-tool provides the following upgrade interface:

• Host node:

  haf-tool cannot be used to run the upgrade command on a host node.

• Offload node:

  haf-tool upgrade