ReportPortal Linux installation

Description

ReportPortal.io is a service, that provides increased capabilities to speed up results analysis and reporting through the use of built-in analytic features.

ReportPortal is a great addition to the Continuous Integration and Continuous Testing process.

Supported OS

Required Services

PostgreSQL

How to install PostgreSQL 12.6 on Ubuntu LTS 18.04, 20.04 / Red Hat family 6, 7, 8 (RHEL, CentOS, etc)

After successful installation, you need to prepare the database for ReportPortal services sudo su - postgres -c "psql"

CREATE DATABASE reportportal; 
CREATE USER <your_rpdbuser> WITH ENCRYPTED PASSWORD '<your_rpdbuser_password>';
GRANT ALL PRIVILEGES ON DATABASE reportportal TO <your_rpdbuser>;
ALTER USER <your_rpdbuser> WITH SUPERUSER;

Change your PostgreSQL authentication methods. Edit the pg_hba.conf file, and change peer to md5 in the following lines:

# "local" is for Unix domain socket connections only
local   all             all                                     md5
# IPv4 local connections:
host    all             all             127.0.0.1/32            md5

File location:

Ubuntu: /etc/postgresql/12/main/pg_hba.conf
RHEL: /var/lib/pgsql/12/data/pg_hba.conf

After the changes above, restart the PostgreSQL service

sudo systemctl restart postgresql

Create the pgcrypto extantion for PostgreSQL reportportal database

psql -U rpuser -d reportportal -c "CREATE EXTENSION pgcrypto;"

RabbitMQ

How to install RabbitMQ 3.8.14 on Ubuntu LTS 18.04, 20.04 / Red Hat family 6, 7, 8 (RHEL, CentOS, etc)

After installation, enable RabbitMQ web management console:

sudo rabbitmq-plugins enable rabbitmq_management

Check and provide ownership of RabbitMQ files to the RabbitMQ user:

sudo chown -R rabbitmq:rabbitmq /var/lib/rabbitmq/

Create an admin user for the RabbitMQ web management console

sudo rabbitmqctl add_user admin <strong_password>
sudo rabbitmqctl set_user_tags admin administrator
sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"

Configure user, permissions, and vhost for ReportPortal. Run the following commands in order to configure your RabbitMQ work with ReportPortal. Please determine the name and the password for your ReportPortal Rabbitmq user in advance

sudo rabbitmqctl add_user <your_rpmquser> <your_rpmquser_password>
sudo rabbitmqctl set_user_tags <your_rpmquser> administrator
sudo rabbitmqctl set_permissions -p / <your_rpmquser> ".*" ".*" ".*"
sudo rabbitmqctl add_vhost analyzer
sudo rabbitmqctl set_permissions -p analyzer <your_rpmquser> ".*" ".*" ".*"

To check RabbitMQ look forward <you_IP>:15672

ElasticSearch

How to install ElasticSearch 7.10.1 on Ubuntu LTS 18.04, 20.04 / Red Hat family 6, 7, 8 (RHEL, CentOS, etc). Also you need to install openjdk-11-jre-headless and openjdk-8-jdk

To check ElsaticSearch use the curl -X GET "localhost:9200/". The output will be:

{
    "name" : "reportportal",
    "cluster_name" : "elasticsearch",
    "cluster_uuid" : "98xfWPnKQNSI1ql7q7y57w",
    "version" : {
        "number" : "7.10.1",
        "build_flavor" : "default",
        "build_type" : "deb",
        "build_hash" : "78722783c38caa25a70982b5b042074cde5d3b3a",
        "build_date" : "2021-03-18T06:17:15.410153305Z",
        "build_snapshot" : false,
        "lucene_version" : "8.8.0",
        "minimum_wire_compatibility_version" : "6.8.0",
        "minimum_index_compatibility_version" : "6.0.0-beta1"
    },
    "tagline" : "You Know, for Search"
}

Traefik

Create a working directory

sudo mkdir /opt/traefik && sudo chown $USER:$USER /opt/traefik && cd /opt/traefik

Download Traefik 1.7.29 release from official git repository and make binary executable

wget -c -N -O traefik https://github.com/traefik/traefik/releases/download/v1.7.29/traefik_linux-amd64 && chmod +x traefik

Download ReportPortal Traefik configuration file

curl -LO https://raw.githubusercontent.com/reportportal/linux-installation/master/data/traefik.toml

Start Traefik

sudo ./traefik --configFile=traefik.toml 2>&1 &

ReportPortal Services

Repositories

Preparation

How to install Python 3.7, Python 3.7 DEV and Python 3.7 VENV on Ubuntu LTS 18.04, 20.04 / Red Hat family 6, 7, 8 (RHEL, CentOS, etc).

For example for Ubuntu 18.04 OS:

sudo apt install python3.7 python3.7-dev python3.7-venv -y

Also you need to install ZIP, GCC and software-properties-common (for Ubuntu)

sudo apt install zip software-properties-common gcc -y

Add environment variables:

MAVEN_REPO="https://repo1.maven.org/maven2/com/epam/reportportal"

API_VERSION="5.3.5"
UAT_VERSION="5.3.5"
MIGRATIONS_VERSION="5.3.5"
UI_VERSION="5.3.5"
SERVICE_INDEX_VERSION="5.0.10"
SERVICE_ANALYZER="5.3.5"

SERVICE_API_JAVA_OPTS="-Xms1024m -Xmx2048m"
SERVICE_UAT_JAVA_OPTS="-Xms512m -Xmx512m"

RP_POSTGRES_USER=<your_rpdbuser>
RP_POSTGRES_PASSWORD=<your_rpdbuser_password>
RP_RABBITMQ_USER=<your_rpmquser>
RP_RABBITMQ_PASSWORD=<your_rpmquser_password>

Create a working directory

sudo mkdir /opt/reportportal/ && \
sudo chown -R $USER:$USER /opt/reportportal/ && \
cd /opt/reportportal/

Analyzer

Download last relaese of Analyzer service, unzip and enter to directory:

curl -LO https://github.com/reportportal/service-auto-analyzer/archive/refs/tags/${SERVICE_ANALYZER}.zip && \
unzip ${SERVICE_ANALYZER}.zip && \
cd /opt/reportportal/service-auto-analyzer-${SERVICE_ANALYZER}

Work with a virtual environment:

# Create a virtual environment with any name (for example /vrpanalyzer)
sudo python3.7 -m venv /vrpanalyzer

# Install python required libraries
sudo /vrpanalyzer/bin/pip install --no-cache-dir -r requirements.txt

# Activate the virtual environment
source /vrpanalyzer/bin/activate

# Install stopwords package from the nltk library
sudo /vrpanalyzer/bin/python3 -m nltk.downloader -d /usr/share/nltk_data stopwords

Start the uwsgi server, you can change properties, such as the worker's quantity for running the analyzer in several processes.

Set in app.ini your virtual environment specified above:

virtualenv = vrpanalyzer

Set in app.py RabbitMQ URL amqp://user:password@localhost:5672, binary store type filesystem, and directory name (for example rpstorage)

# "amqpUrl":           os.getenv("AMQP_URL", "amqp://user:password@localhost:5672").strip("/").strip("\\"),
# "binaryStoreType":   os.getenv("ANALYZER_BINARYSTORE_TYPE", "filesystem"),
# "filesystemDefaultPath": os.getenv("FILESYSTEM_DEFAULT_PATH", "rpstorage").strip()

Activate the virtual environment

source /vrpanalyzer/bin/activate

Install stopwords package from the nltk library

sudo /vrpanalyzer/bin/python3.7 -m nltk.downloader -d /usr/share/nltk_data stopwords

Start Analyzer

/vrpanalyzer/bin/uwsgi --ini app.ini > /dev/null 2>&1 &

Migration

Download service

cd /opt/reportportal/ && \
wget -c -N -O migrations.zip https://github.com/reportportal/migrations/archive/${MIGRATIONS_VERSION}.zip && unzip migrations.zip && mv migrations-${MIGRATIONS_VERSION} migrations && rm -f migrations.zip

Run service

You need to execute all up scripts to prepare your database for ReportPortal services:

PGPASSWORD=$RP_POSTGRES_PASSWORD psql -U $RP_POSTGRES_USER -d reportportal -a -f migrations/migrations/0_extensions.up.sql -f migrations/migrations/1_initialize_schema.up.sql -f migrations/migrations/2_initialize_quartz_schema.up.sql -f migrations/migrations/3_default_data.up.sql -f migrations/migrations/4_size_limitations.up.sql -f migrations/migrations/5_test_case_id_type.up.sql -f migrations/migrations/6_retries_handling.up.sql -f migrations/migrations/7_auth_integration.up.sql -f migrations/migrations/8_sender_case_enabled_field.up.sql -f migrations/migrations/9_analyzer_params.up.sql -f migrations/migrations/10_attachment_size.up.sql -f migrations/migrations/11_password_encoding.up.sql -f migrations/migrations/12_remove_ticket_duplicates.up.sql -f migrations/migrations/13_add_allocated_storage_per_project.up.sql -f migrations/migrations/14_test_case_id_size_increase.up.sql -f migrations/migrations/15_statistics_decreasing.up.sql -f migrations/migrations/16_remove_unused_indexes.up.sql -f migrations/migrations/17_status_enum_extension.up.sql -f migrations/migrations/18_job_attributes.up.sql -f migrations/migrations/19_retries_handling_extension.up.sql -f migrations/migrations/20_deep_merge_statistics_handling.up.sql -f migrations/migrations/21_deep_merge_retries_fix.up.sql -f migrations/migrations/22_deep_merge_nested_steps_fix.up.sql -f migrations/migrations/23_rerun_item_statistics_fix.up.sql -f migrations/migrations/24_widget_views_cleanup.up.sql -f migrations/migrations/25_deep_merge_nested_steps_path_fix.up.sql 2>&1 &

Index

Download service

cd /opt/reportportal/ && \
wget -c -N -O service-index https://github.com/reportportal/service-index/releases/download/$SERVICE_INDEX_VERSION/service-index_linux_amd64

Run service

sudo chmod +x service-index && \
sudo RP_SERVER_PORT=9000 LB_URL=http://localhost:8081 ./service-index 2>&1 &

API

Download API service

cd /opt/reportportal/ && \
curl -L $MAVEN_REPO/service-api/$API_VERSION/service-api-$API_VERSION-exec.jar -o service-api.jar

Run API service

sudo RP_AMQP_HOST=localhost RP_AMQP_APIUSER=$RP_RABBITMQ_USER RP_AMQP_APIPASS=$RP_RABBITMQ_PASSWORD RP_AMQP_USER=$RP_RABBITMQ_USER RP_AMQP_PASS=$RP_RABBITMQ_PASSWORD RP_DB_USER=$RP_POSTGRES_USER RP_DB_PASS=$RP_POSTGRES_PASSWORD RP_DB_HOST=localhost java $SERVICE_API_JAVA_OPTS -jar service-api.jar 2>&1 &

UAT

Download service

cd /opt/reportportal/ && \
curl -L $MAVEN_REPO/service-authorization/$UAT_VERSION/service-authorization-$UAT_VERSION-exec.jar -o service-uat.jar

Run service

RP_DB_HOST=localhost RP_DB_USER=$RP_POSTGRES_USER RP_DB_PASS=$RP_POSTGRES_PASSWORD java $SERVICE_UAT_JAVA_OPTS -jar service-uat.jar 2>&1 &

UI

Create UI work directory

mkdir -p /opt/reportportal/ui && cd /opt/reportportal/

Download UI service

curl -L https://github.com/reportportal/service-ui/releases/download/$UI_VERSION/service-ui_linux_amd64 -o service-ui && \
mv service-ui ui/ && \
chmod -R +x ui/* && \
curl -LO https://github.com/reportportal/service-ui/releases/download/5.3.5/ui.tar.gz && \
mkdir public && \
tar -zxvf ui.tar.gz -C public && rm -f ui.tar.gz

Run service

cd ui/ && RP_STATICS_PATH=../public RP_SERVER_PORT=3000 ./service-ui 2>&1 &

Check availability of ReportPortal

Name		Name	Last commit message	Last commit date
Latest commit History 17 Commits
data		data
img		img
LICENSE		LICENSE
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

ReportPortal Linux installation

Description

Supported OS

Table of contents

Required Services

PostgreSQL

RabbitMQ

ElasticSearch

Traefik

ReportPortal Services

Repositories

Preparation

Analyzer

Migration

Index

API

UAT

UI

About

Releases

Packages

Contributors 2

License

reportportal/linux-installation

Folders and files

Latest commit

History

Repository files navigation

ReportPortal Linux installation

Description

Supported OS

Table of contents

Required Services

PostgreSQL

RabbitMQ

ElasticSearch

Traefik

ReportPortal Services

Repositories

Preparation

Analyzer

Migration

Index

API

UAT

UI

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Packages