Prerequisites
Check the following information before starting the installation :
- Logrotate and cron must be available for current user
- Select a list of free ports (see requirements).
- Select a filesystem with enough free space (see requirements).
- HPA portal filesystem is referenced as
hpa_base_dir
- HPA portal filesystem is referenced as
- HPA controller archive :
hpa_controller-X.X.tar.gz
- HPA version :
X.X.X.tar.gz
Installation steps
- Transfer the archives to
hpa_base_dir
- Extract the controller :
tar xvf hpa_controller-1.8.tar.gz
-
A directory
hpa
is created inhpa_base_dir
-
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
-
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*
-
Copy new archive version in
{{hpa_base_dir}}/hpa/versions
-
List again
cd {{hpa_base_dir}}/hpa ./hpa_controller.sh l
Example of output :
Extracted version No versions detected Archived version 2022.06.04.tar.gz
-
Install version
cd {{hpa_base_dir}}/hpa ./hpa_controller.sh i 2022.06.04
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.
-
Configure version
-
Copy
environment.config
template file as described in the output of installationExample :
cp /home/hpa/hpa/environment.config.template /home/hpa/hpa/environment.config
-
Configure the ports and IP, see configure environment.config
-
Copy
security.config
template file as described in the output of installationExample :
cp /home/hpa/hpa/security.config.template /home/hpa/hpa/security.config
-
Configure the security configure security.config
-
Copy
environment.yml
template file as described in the output of installationExample :
cp /home/hpa/hpa/environment.yml.template /home/hpa/hpa/environment.yml
-
Configure the Calypso environments configure environment.yml
-
-
Finish installation
cd {{hpa_base_dir}}/hpa ./hpa_controller.sh i 2022.06.04
Example of output :
Loading environmentUnpacking for 2022.06.04 ... Directory exists, no extract : /home/hpa/hpa/versions/2022.06.04 Install log rotation Copy template version Install log rotation logrotation crontab is installed Loading environmentLaunching installation for 2022.06.04 ... Load version information for 2022.06.04 ... Loading 2022.06.04 configuration Installation 2022.06.04 ... Calling module_installation postgresql-9.6.2 ... Unpack postgresql-9.6.2 ... Archive exists : /home/hpa/hpa/versions/2022.06.04/postgresql-9.6.2/postgresql-9.6.2.tar.gz Extracting : /home/hpa/hpa/versions/2022.06.04/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/2022.06.04/database-introscope/database-introscope.tar.gz Extracting : /home/hpa/hpa/versions/2022.06.04/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/2022.06.04/database-hpa/database-hpa.tar.gz Extracting : /home/hpa/hpa/versions/2022.06.04/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/2022.06.04/Introscope/Introscope.tar.gz Extracting : /home/hpa/hpa/versions/2022.06.04/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/2022.06.04/hpa-extractor-1.16/hpa-extractor-1.16.tar.gz Extracting : /home/hpa/hpa/versions/2022.06.04/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/2022.06.04/hpa-portal-server-1.19/hpa-portal-server-1.19.tar.gz Extracting : /home/hpa/hpa/versions/2022.06.04/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 2022.06.04 ... 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 2022.06.04 ... No current version installed yet Activate version 2022.06.04 ... Write current version HPA version 2022.06.04 activated.
-
You can start/stop the environment