HPA installation and deployment HPA portal Split installation instructions

Description

It can happen that for architecture constraints, it is needed to split the HPA installation :

  • install hpa-portal on a server
  • install hpa-extractor and Enterprise Manager on another server

When possible avoid this separation as it is not required and add complexity in the application lifecyle.

Installation

On server 1

During the installation, after the first execution :

cd {{hpa_base_dir}}/hpa
./controller.sh i 2022.06.04

Copy the version.config.bash file in the override_config directory :

cd {{hpa_base_dir}}/hpa
cp ./versions/{{version}}/version.config.bash ./override_config

Then edit the following lines on 1st server (remove of introscope, HPA_EXTRACTOR_VERSION) :

module_installation_order=(systemd java "postgresql" nginx keycloak agent database-hpa $HPA_SERVER_VERSION global)
module_start_order=(nginx keycloak database-hpa $HPA_SERVER_VERSION agent)
module_stop_order=(agent $HPA_SERVER_VERSION database-hpa keycloak nginx)

Finish installation.

You should have the following log during HPA startup :

Overriding standard configuration with {{hpa_base_dir}}/override_config/version.config.bash

On server 2

Follow the same steps.

Do the same on the second server (remove $HPA_SERVER_VERSION) :

module_installation_order=(systemd java "postgresql" nginx keycloak agent database-hpa introscope database-introscope $HPA_EXTRACTOR_VERSION global)
module_start_order=(nginx keycloak database-introscope database-hpa introscope $HPA_EXTRACTOR_VERSION agent)
module_stop_order=(agent $HPA_EXTRACTOR_VERSION introscope database-hpa database-introscope keycloak nginx)

Upgrade on split version

As the version.config.bash is not used anymore, during the upgrade :

Extract the new archive

Run the installation as usual, it will extract the new directory

cd {{hpa_base_dir}}/hpa
./controller.sh i 2023.01.01

Update the version.config.bash

Two solutions :

  • repeat the installation steps
  • update the versions numbers

Repeat installation steps

Easy, check installation section : copy again.

cp ./versions/{{version}}/version.config.bash ./override_config

Edit the copied files and reproduce the steps.

Or update directly the file

Update the versions in : {{hpa_base_dir}}/override_config/version.config.bash

  1. Exctract versions from original files :
cat ./versions/{{version}}/version.config.bash

Find the following lines :

export HPA_EXTRACTOR_VERSION=hpa-extractor-5.08
export HPA_SERVER_VERSION=hpa-portal-server-5.09
export HPA_AGENT_VERSION=4.09

Report them to {{hpa_base_dir}}/override_config/version.config.bash