This chapter describes package installation commands on different Linux distributions.

$ su - root
# emerge sync
# emerge -av indent asciidoc libxml2 cmake dia \
        flex bison zlib openssl dev-vcs/git

$ sudo apt-get update
$ sudo apt-get install indent asciidoc libxml2-dev \
        cmake dia flex bison gcc g++ zlib1g-dev \
        libssl-dev libcrypto++-dev libxml2-dev git

dpkg: error processing package tex-common (--configure)

$ sudo apt-get install  postgresql postgresql-client libecpg-dev \
 libpq-dev postgresql-server-dev-all

$ sudo systemctl enable postgresql
$ sudo systemctl start postgresql

$ sudo apt-get update
$ sudo apt-get install indent asciidoc libxml2-dev \
        cmake dia flex bison gcc g++ zlib1g-dev \
        libssl-dev libcrypto++9 libcrypto++-dev libxml2-dev git

$ sudo apt-get update
$ sudo apt-get install indent asciidoc libxml2-dev \
    cmake dia flex bison gcc g++ zlib1g-dev \
    libssl-dev libcrypto++-dev libxml2-dev libxml2-utils git

$ sudo apt-get install  postgresql postgresql-client libecpg-dev \
 libpq-dev postgresql-server-dev-all

$ sudo dpkg --add-architecture i386
$ sudo apt-get install gcc-multilib g++-multilib libicu-dev:i386 libxml32-dev:i386 libxml3-dev:i386

$ su - root
# wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
# rpm -Uvh epel-release*rpm

# yum update
# yum groupinstall 'Development Tools'
# yum install git cmake asciidoc \
        openssl openssl-devel dia libxml2-devel
# exit
$

$ su - root
# yum install  postgresql postgresql-devel postgresql-server postgresql-contrib
# service postgresql initdb
# chkconfig postgresql on
# service postgresql start

# yum install yum-utils
# yum-config-manager --enable ol7_optional_latest

# yum groupinstall 'Development Tools'
# yum install git cmake asciidoc openssl openssl-devel redhat-lsb libxml2-devel

# yum install -y cairo-gobject-devel gtk2 gtk2-devel gdk-pixbuf2-devel \
                libglade2-devel libgnomeui.x86_64 wget libgnomeui
# wget http://ftp.scientificlinux.org/linux/fedora/releases/19/Fedora/x86_64/os/Packages/d/dia-0.97.2-5.fc19.x86_64.rpm
# rpm -i --nodeps dia-0.97.2-5.fc19.x86_64.rpm

$ sudo rpm -i *.rpm
        file /usr/share/man from install of endurox-3.5.1-1.x86_64 conflicts with file from package filesystem-3.2-21.el7.x86_64
        file /usr/share/man/man3 from install of endurox-3.5.1-1.x86_64 conflicts with file from package filesystem-3.2-21.el7.x86_64
        file /usr/share/man/man5 from install of endurox-3.5.1-1.x86_64 conflicts with file from package filesystem-3.2-21.el7.x86_64
        file /usr/share/man/man8 from install of endurox-3.5.1-1.x86_64 conflicts with file from package filesystem-3.2-21.el7.x86_64

$ cmake --version
cmake version 2.8.12.2

$ su - root
# yum remove cmake
# exit
$ cd
$ wget https://cmake.org/files/v3.7/cmake-3.7.2.tar.gz
$ tar -xzf cmake-3.7.2.tar.gz
$ cd cmake-3.7.2
$ ./configure
$ make
$ su - root
# make install
# cmake --version
cmake version 3.7.2

CMake suite maintained and supported by Kitware (kitware.com/cmake).

$ su - root
# yum install  postgresql postgresql-devel postgresql-server postgresql-contrib
# postgresql-setup initdb
# systemctl start postgresql
# systemctl enable postgresql

# zypper install git-core cmake flex bison gcc libxml2 gcc-c++ \
libxml2-devel asciidoc cmake dia rpm-build

# zypper install postgresql postgresql-devel postgresql-server postgresql-contrib
# systemctl start postgresql
# systemctl enable postgresql
# systemctl status postgresql

$ su - root
# yum install yum-utils
# yum groupinstall 'Development Tools'
# yum install git cmake asciidoc openssl openssl-devel redhat-lsb libxml2-devel

# wget https://www.mavimax.com/sites/default/files/libart_lgpl-2.3.21-20.fc29.x86_64.rpm
# rpm -i libart_lgpl-2.3.21-20.fc29.x86_64.rpm
# wget https://www.mavimax.com/sites/default/files/dia-0.97.3-10.fc29.x86_64.rpm
# rpm -i --nodeps dia-0.97.3-10.fc29.x86_64.rpm

$ su - root
# yum install  postgresql postgresql-devel postgresql-server postgresql-contrib
# postgresql-setup initdb
# systemctl start postgresql
# systemctl enable postgresql

$ sudo mkdir /etc/asciidoc/filters/dia
$ sudo -s
# cat << EOF > /etc/asciidoc/filters/dia/dia-filter.conf
#
# AsciiDoc Dia filter configuration file.
#
# Version: 0.1

[blockdef-listing]
dia-style=template="dia-block",subs=(),posattrs=("style","file","target","size"),filter='dia -t png -e "{outdir={indir}}/{imagesdir=}{imagesdir?/}{target}" "{outdir}/{file}" {size?-s {size}} > /dev/null'

[dia-block]
template::[image-blockmacro]
EOF

# useradd -m user1
# su - user1
$ cd /home/user1
$ git clone https://github.com/endurox-dev/endurox endurox

This code bellow creates ndrx_home executable file which loads basic environment, so that you can use sample configuration provided by Enduro/X in sampleconfig directory. This also assumes that you are going to install to $HOME/endurox/dist folder.

$ cat << EOF > $HOME/ndrx_home
#!/bin/bash

# Where app domain lives
export NDRX_APPHOME=\$HOME/endurox
# Where NDRX runtime lives
export NDRX_HOME=\$HOME/endurox/dist/bin
# Debug config too
export NDRX_DEBUG_CONF=\$HOME/endurox/sampleconfig/debug.conf

# NDRX config too.
export NDRX_CONFIG=\$HOME/endurox/sampleconfig/ndrxconfig.xml

# Access for binaries
export PATH=\$PATH:\$HOME/endurox/dist/bin

# LIBPATH for .so
export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:\$HOME/endurox/dist/lib:\$HOME/endurox/dist/lib64

# UBF/FML field tables
export FLDTBLDIR=\$HOME/endurox/ubftest/ubftab

#  To complete unit tests:
export NDRX_MSGSIZEMAX=1049600

################################################################################
# In case if building with Oracle DB database testing support
# i.e. having flag -DENABLE_TEST47=ON
# or building endurox-java with Oracle DB tests (02_xaoracle), then
# configure bellow setting (demo values provided):
# If so - uncomment bellow
################################################################################
#export EX_ORA_HOST=localhost
#export EX_ORA_USER=exdbtest
#export EX_ORA_PASS=exdbtest1
#export EX_ORA_PORT=1521
#export EX_ORA_SID=XASVC
#export EX_ORA_OCILIB=/opt/oracle/product/18c/dbhomeXE/lib/libclntsh.so
#export ORACLE_HOME=/opt/oracle/product/18c/dbhomeXE
#export PATH=\$PATH:\$ORACLE_HOME/bin
#export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/product/18c/dbhomeXE/lib
#export TNS_ADMIN=\$ORACLE_HOME/network/admin
#Used for TCP Recon testing if tcpkill is installed (optional for Ora):
#export EX_ORA_IF=enp0s3
#export EX_ORA_PORT=1521
################################################################################
# In case if building with Postgresql DB database testing support
# or building endurox-java with Oracle DB tests (03_xapostgres), then
# configure bellow setting (demo values provided):
# If so - uncomment bellow
################################################################################
#export EX_PG_HOST=localhost
#export EX_PG_USER=exdbtest
#export EX_PG_PASS=exdbtest1
# currently uses default port
#export EX_PG_PORT=5432
#export EX_PG_DB=xe


EOF

$ chmod +x $HOME/ndrx_home

NOTE: If building with PostgreSQL support (-DENABLE_POSTGRES=ON) for RHEL/OL/Centos 8.x you need to specify Postgresql include folder manually, e.g. add "-DPostgreSQL_TYPE_INCLUDE_DIR=/usr/include/pgsql/internal" string to cmake line, otherwise error "Could NOT find PostgreSQL (missing: PostgreSQL_TYPE_INCLUDE_DIR)" will be given at configure.

$ cd /home/user1/endurox
# If you want to have install folder to /home/user1/endurox/dist
# if you want system level install then run just $ cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr .
$ cmake -DCMAKE_INSTALL_PREFIX:PATH=`pwd`/dist .
$ make
$ make install

$ cd /home/user1/endurox/ubftest
$ ./ubfunit1 2>/dev/null
Running "main"...
Completed "main": 5751 passes, 0 failures, 0 exceptions.

ATMI testing might take some time. Also ensure that you have few Gigabytes of free disk space, as logging requires some space. To run the ATMI tests do following:

$ cd /home/user1/endurox/atmitest
$ nohup ./run.sh &
$ tail -f /home/user1/endurox/atmitest/test.out
...
Setting domain 2
Server executable = tpbridge    Id = 101 :      Shutdown succeeded.
Server executable = convsv21    Id = 50 :       Shutdown succeeded.
Server executable = atmi.sv21   Id = 30 :       Shutdown succeeded.
Server executable = tmsrv       Id = 10 :       Shutdown succeeded.
Shutdown finished. 4 processes stopped.
atmiclt21: no process found
************ FINISHED TEST: [test021_xafull/run.sh] with 0 ************
Running "main"...
Running "main"...
Completed "main": 21 passes, 0 failures, 0 exceptions.

If EX_ORA_ settings are loaded int the ndrx_home environment file and project is started with -DENABLE_TEST47=ON setting, then before running the tests, user and tables needs to be created for testing.

User scheme can be created in following way (may differ if you have other procedures):

# su - oracle
$ sqlplus / nolog
SQL> connect / as sysdba
SQL> alter session set "_ORACLE_SCRIPT"=true;
SQL> CREATE USER exdbtest IDENTIFIED BY exdbtest1;
SQL> GRANT CONNECT, RESOURCE, DBA TO exdbtest;
SQL> COMMIT;
SQL> QUIT;

The testing user must have access to tnsnames.ora, thus user "user1" must be added to "oinstall" group. On linux that can be done in this way:

# gpasswd -a user1 oinstall

Tables can be loaded in with help of Oracle sqlplus tool:

$ cd /home/user1/endurox/atmitest/test047_oradb
$ ./sqlplus.run

SQL*Plus: Release 18.0.0.0.0 - Production on Sun May 26 16:46:53 2019
Version 18.4.0.0.0

Copyright (c) 1982, 2018, Oracle.  All rights reserved.

Last Successful login time: Sun May 26 2019 16:42:36 +03:00

Connected to:
Oracle Database 18c Express Edition Release 18.0.0.0.0 - Production
Version 18.4.0.0.0

SQL> @tables.sql

Table created.

SQL> quit

Once this is done, the test shall execute without the problems.

$ su - root
# yum install oraclelinux-developer-release-el7
# yum install oracle-epel-release-el7
# yum install dsniff

export EX_ORA_IF=enp0s3
export EX_ORA_PORT=1521

$ su - root
# sudoedit /etc/sudoers

-- At the end of the file add

#
# For Enduro/X RECON testing
#
user1   ALL=(ALL)       NOPASSWD:SETENV: /sbin/tcpkill,/bin/xadmin,/home/user1/endurox/dist/bin/xadmin

$ su - root

# cat << EOF >> /etc/sysctl.conf

net.ipv4.tcp_keepalive_time = 15
net.ipv4.tcp_keepalive_intvl = 15
net.ipv4.tcp_keepalive_probes = 1


EOF

# sysctl -f /etc/sysctl.conf

XASVC =
 (DESCRIPTION=
 (FAILOVER=on)
 (ENABLE=broken)
 (ADDRESS=(PROTOCOL=tcp)(HOST=rac1-vip)(PORT=1521))
 (ADDRESS=(PROTOCOL=tcp)(HOST=rac2-vip)(PORT=1521))
 (CONNECT_DATA=
 (SERVICE_NAME=XASVC)
 (FAILOVER_MODE=
 (TYPE=SESSION)
 (METHOD=BASIC)
 (RETRIES=10)
 (DELAY=15)
 )
 )

Enduro/X supports PosgreSQL Two Phase commit mode. In general PosgreSQL have light version of two phase commit. I.e. only that session which did work can leave the work in prepared state with some id. Thus to working in XA mode when process calls xa_end(), it needs to prepare the transaction. As Enduro/X writes the transaction manager logs at start of every active transaction, thus tmsrv will know about this transaction, thus it will be able to reverse it in case of crashes. There is slight chance that this might slip in case if transaction times out, tmsrv reverts it (no XID found, thus assume committed/reverted), but after a while process performs the xa_end()/xa_prepare(). In that case transaction will be left in prepare state. These cases can be resolved manually by performing ‘xadmin recoverlocal’ and perform ‘xadmin abortlocal’ on these.

To configure PosgreSQL, for tests, following need to be done:

To create the user for tests, perform following

$ sudo -s
# su - postgres
$ createuser exdbtest
$ createdb xe
$ psql

> alter user exdbtest with encrypted password 'exdbtest1';
> grant all privileges on database xe to exdbtest;
> \q

To enable prepared transactions, edit postgresql.conf and set ‘max_prepared_transactions’ greater than 0, e.g. 1000.

-- for debian/ubuntu
# vi /etc/postgresql/*/main/postgresql.conf
-- for RedHat, SLES
# vi /var/lib/pgsql/data/postgresql.conf

-- Edit the max_prepared_transactions

max_prepared_transactions = 1000                # zero disables the feature

Network connection shall be enabled too for Posgres auth, edit the pg_hba.conf (for RHEL, SLES /var/lib/pgsql/data/pg_hba.conf. For debian/ubuntu these shall be already correctly set by default (according to ubuntu 20.04))

Ensure that it contains following lines (for password auth):

local   all             all                                     peer
host    all             all             127.0.0.1/32            md5
host    all             all             ::1/128                 md5

After that restart PostgreSQL (according to OS):

# systemctl restart postgresql

If Postgresql does not boot, then try "trust" for the "local/all".

After these steps test database table shall be created. That could be done in following way:

$ source ~/ndrx_home
$ cd /home/user1/endurox/atmitest/test067_postgres
$ cat tables.sql | ./psql.run
CREATE TABLE

Now PostgreSQL is ready for Enduro/X testing.