Upgrading the HAF

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

The haf_upgrade script is provided to upgrade the 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 the HAF on the 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.0.zip

  3. Decompress the host installation package.

     tar -zxvf haf-host-1.0.tar.gz

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

     mv /opt/haf-host/bin /opt/haf-host/bin.bak

     mv /opt/haf-host/lib /opt/haf-host/lib.bak

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

     cp ./bin /opt/haf-host/bin

     cp ./lib /opt/haf-host/lib

     chmod -R 550 /opt/haf-host/bin

     chmod -R 550 /opt/haf-host/lib

     chown -R user :group /opt/haf-host/

     

     • 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 root.

       dr-xr-x--- 2 root root 4.0K Nov 12  2021 bin
       -r--r--r-- 1 root root  241 Nov 12 11:07 env.sh
       -rw------- 1 root root  220 Nov 12 11:07 haf_host_install.conf
       -r--r----- 1 root root  221 Nov 12 11:07 haf_user.conf
       dr-xr-x--- 3 root root 4.0K Nov 12  2021 lib
       dr-x------ 4 root root 4.0K Nov 12 11:07 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 /opt/haf-host/bin.bak

     rm -rf /opt/haf-host/lib.bak

• On an offload node:

  The procedure is as follows:

  cd /opt/haf-software

  ./haf_upgrade -m offload -p <upgrade package>

  Option	Description	Mandatory
  -m <mode>	mode: offload	Yes
  -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 --offload

  Option	Description	Mandatory
  --offload	The operation is performed on an offload node.	Yes