Introduction

This procedure covers the action to install BOA in a development environment from scratch.

Note: References to s2boa included for completeness regarding the installation of a tailored BOA.

Pre-conditions

1. Ubuntu and docker installed in a development environment. See the following procedures to accomplish this pre-condition:
   1. For windows using WSL: Prepare development environment using WSL2 in Windows to install BOA from scratch
   2. For virtualbox: Prepare development environment using Virtualbox to install BOA from scratch
   3. For Ubuntu: Prepare development environment using Ubuntu to install BOA from scratch

Procedure

1. Start the BOA development environment
2. Create the following folder in the development environment:

cd
mkdir workspace

1. Clone BOA repositories into the workspace folder (plus the repository of the tailored BOA if available):

   Note: use the develop branch for all repositories.

cd ~/workspace/
git clone https://stash.elecnor-deimos.com/scm/boa/eboa.git
cd ~/workspace/eboa/
git checkout develop
cd ~/workspace/
git clone https://stash.elecnor-deimos.com/scm/boa/vboa.git
cd ~/workspace/vboa/
git checkout develop

(plus the repository of the tailored BOA if available, for example, s2boa):

cd ~/workspace/
git clone https://stash.elecnor-deimos.com/scm/boa/s2boa.git
cd ~/workspace/s2boa/
git checkout develop

1. Download ORC into the workspace folder: 

   1. Download the following folder: https://drive.google.com/drive/folders/1_9C36f4TDNH_iOgSk3XUy0x8S6JPIxlN?usp=sharing

   2. Extract the zip.

unzip latest_release-20210204T082737Z-001.zip

1. Rename the folder latest_release as orc_minarc.

mv latest_release orc_minarc

1. Move the folder orc_minarc into the workspace folder.

mv orc_minarc/ ~/workspace

1. (Step needed for the s2boa tailored BOA) Download the EOP CFI into the workspace folder:

   1. Download the following tar file: https://drive.google.com/file/d/1-Xvj7cZe4VPalvrd1tWrKF9fedpV3RUc/view?usp=sharing

   2. Extract the archive.

tar xzvf eopcfi.tgz

1. Move the folder eopcfi into the workspace folder.

mv eopcfi ~/workspace

1. (Instructions for installing the tailored BOA, s2boa, where the host user created is boa) Execute the following commands to install the BOA development environment:

cd ~/workspace/orc_minarc
for file in `ls *gem.tar`; do mv $file `basename $file .tar`; done
sudo su -
cd /home/boa/workspace/s2boa/
export FOLDER=/home/boa; ./init_docker_dev_environment.sh -e $FOLDER/workspace/eboa -v $FOLDER/workspace/vboa -d $FOLDER/workspace/vboa/Dockerfile.dev -o $FOLDER/workspace/orc_minarc -u boa -f $FOLDER/workspace/eopcfi -p 80 -t $FOLDER/workspace/s2boa -l dev -a s2vboa

Expected output (for example, for s2boa):

The development environment for s2vboa has been initialized :-)

1. Change permissions on ORC configuration's folder to allow tests to overwrite ORC configuration if needed:

docker exec -it -u root boa_app_dev /bin/bash
chmod -R o+w `orcValidateConfig -C`

1. Now, the BOA portal should be available through the following address: https://localhost:80

   Default credentials to access: Default credentials

   

2. Access through the console should be available with the following command (using the specific host user created, for example, boa):

docker exec -it -e HOME=/home/boa -u boa boa_app_dev /bin/bash