HPA Portal installation HPA portal First Portal installation

Prerequisites

Check the following information before starting the installation :

  1. Logrotate and cron must be available for current user
  2. Select a list of free ports (see requirements).
  3. Select a filesystem with enough free space (see requirements).
    1. HPA portal filesystem is referenced as hpa_base_dir
  4. HPA controller archive : hpa_controller-X.X.tar.gz
  5. HPA version : X.X.X.tar.gz

Installation steps

  1. Transfer the archives to hpa_base_dir
  2. Extract the controller :
tar xvf hpa_controller-1.8.tar.gz

  1. A directory hpa is created in hpa_base_dir

  2. List versions :

    cd {{hpa_base_dir}}/hpa
./hpa_controller.sh l

    Example of output :

    Extracted version
No versions detected

Archived version
No archived versions detected, add versions in /home/hpa/hpa/versions

  3. If version is already installed and you want to reset it, remove archive and directory :

    rm -rf {{hpa_base_dir}}/hpa/versions/X.X.X*

  4. Copy new archive version in {{hpa_base_dir}}/hpa/versions

  5. List again

    cd {{hpa_base_dir}}/hpa
./hpa_controller.sh l

    Example of output :

    Extracted version
No versions detected

Archived version
2.1.0.tar.gz

  6. Install version

    cd {{hpa_base_dir}}/hpa
./hpa_controller.sh i 2.1.0

    Example of output :

    Unpacking for 2022.06.04 ...
Archive exists : /home/hpa/hpa/versions/2022.06.04.tar.gz
Extracting : /home/hpa/hpa/versions/2022.06.04.tar.gz
Archive successfuly extracted to : /home/hpa/hpa/versions/2022.06.04
Check package file
Testing file and completing upgrade package
Copy template environment
Copy templates for this version
Install log rotation
logrotation crontab is installed
Calypso environments are not described, copy and update:
  cp /home/hpa/hpa/environment.yml.template /home/hpa/hpa/environment.yml
  update the file /home/hpa/hpa/environment.yml
HPA environment is not described, copy and update:
  cp /home/hpa/hpa/environment.config.template /home/hpa/hpa/environment.config
  update the file /home/hpa/hpa/environment.config
HPA security is not described, copy and update:
  cp /home/hpa/hpa/security.config.template /home/hpa/hpa/security.config
  update the file /home/hpa/hpa/security.config
JAVA_HOME is not set, java 1.11 is required. Configure the environment.config file.

  7. Configure version

    1. Copy environment.config template file as described in the output of installation

      Example :

      cp /home/hpa/hpa/environment.config.template /home/hpa/hpa/environment.config

    2. Configure the ports and IP, see configure environment.config

    3. Copy security.config template file as described in the output of installation

      Example :

      cp /home/hpa/hpa/security.config.template /home/hpa/hpa/security.config

    4. Configure the security configure security.yml

    5. Copy environment.yml template file as described in the output of installation

      Example :

      cp /home/hpa/hpa/environment.yml.template /home/hpa/hpa/environment.yml

    6. Configure the Calypso environments configure environment.yml

  8. Finish installation

    cd {{hpa_base_dir}}/hpa
./hpa_controller.sh i 2.1.0

    Example of output :

     Loading environmentUnpacking for 2.1.0 ...
 Directory exists, no extract : /home/hpa/hpa/versions/2.1.0
 Install log rotation
 Copy template version
 Install log rotation
 logrotation crontab is installed
 Loading environmentLaunching installation for 2.1.0 ...
 Load version information for 2.1.0 ...
 Loading 2.1.0 configuration
 Installation 2.1.0 ...
 Calling module_installation postgresql-9.6.2 ...
 Unpack postgresql-9.6.2 ...
 Archive exists : /home/hpa/hpa/versions/2.1.0/postgresql-9.6.2/postgresql-9.6.2.tar.gz
 Extracting : /home/hpa/hpa/versions/2.1.0/postgresql-9.6.2/postgresql-9.6.2.tar.gz
 Archive successfuly extracted to : /home/hpa/hpa/modules/postgresql-9.6.2
 Calling module_installation database-introscope ...
 Unpack database-introscope ...
 Archive exists : /home/hpa/hpa/versions/2.1.0/database-introscope/database-introscope.tar.gz
 Extracting : /home/hpa/hpa/versions/2.1.0/database-introscope/database-introscope.tar.gz
 Archive successfuly extracted to : /home/hpa/hpa/var/database-introscope
 Calling module_installation database-hpa ...
 Unpack database-hpa ...
 Archive exists : /home/hpa/hpa/versions/2.1.0/database-hpa/database-hpa.tar.gz
 Extracting : /home/hpa/hpa/versions/2.1.0/database-hpa/database-hpa.tar.gz
 Archive successfuly extracted to : /home/hpa/hpa/var/database-hpa
 Calling module_installation Introscope ...
 Unpack Introscope ...
 Archive exists : /home/hpa/hpa/versions/2.1.0/Introscope/Introscope.tar.gz
 Extracting : /home/hpa/hpa/versions/2.1.0/Introscope/Introscope.tar.gz
 Archive successfuly extracted to : /home/hpa/hpa/modules/Introscope
 Calling module_installation hpa-extractor-1.16 ...
 Unpack hpa-extractor-1.16 ...
 Archive exists : /home/hpa/hpa/versions/2.1.0/hpa-extractor-1.16/hpa-extractor-1.16.tar.gz
 Extracting : /home/hpa/hpa/versions/2.1.0/hpa-extractor-1.16/hpa-extractor-1.16.tar.gz
 Archive successfuly extracted to : /home/hpa/hpa/modules/hpa-extractor-1.16
 Calling module_installation hpa-portal-server-1.19 ...
 Unpack hpa-portal-server-1.19 ...
 Archive exists : /home/hpa/hpa/versions/2.1.0/hpa-portal-server-1.19/hpa-portal-server-1.19.tar.gz
 Extracting : /home/hpa/hpa/versions/2.1.0/hpa-portal-server-1.19/hpa-portal-server-1.19.tar.gz
 Archive successfuly extracted to : /home/hpa/hpa/modules/hpa-portal-server-1.19
 Apply configuration 2.1.0 ...
 Calling module_apply_config database-introscope ...
 Calling module_apply_config database-hpa ...
 Calling module_apply_config Introscope ...
 Calling module_apply_config hpa-extractor-1.16 ...
 Calling module_apply_config hpa-portal-server-1.19 ...
 Check any running version 2.1.0 ...
 No current version installed yet
 Activate version 2.1.0 ...
 Write current version
 HPA version 2.1.0 activated.

  9. You can start/stop the environment