Axon - Installation version 5.3

> Informatica Axon

1 - System

1.1 - Requirement

  • Disk: 200 GB
  • Memory: 24 GB
  • CPU Cores: 4
  • OS: RedHat Linux version 7.x

Memory at least 16 GB memory available

free -h
Advertising

1.2 - Creation

az.cmd vm create ^
    --resource-group  MyGroup ^
    --name INFA-AXON-01 ^
    --image RedHat:RHEL:7.4:7.4.2018010506 ^
    --size Standard_D4s_v3 ^
    --authentication-type password ^
    --admin-username adm ^
    --admin-password pwd ^
    --location westeurope
  • Applications: unzip, tar, RPM, In, setfacl, YUM, sed

rpm package:

  • apr-1.4.8
  • apr-util-1.5.2
  • glibc-2.17
  • libevent-2.0.21
  • libselinux-2.5
  • mailcap-2.1.41
  • openssl-libs-1.0.2k
  • systemd-219
  • yajl-2.0.4

1.3 - As root

sudo su -

1.3.1 - Create an Install User

The install user (also known as Axon Administrator) is a non-root user where the name is not one of the following:

  • axon,
  • axon_bulkupload,
  • axon_changerequest,
  • axon_data,
  • axon_docupload,
  • axon_notification,
  • camunda,
  • postgres,
  • unison

Example:

  • Group: ainstall - axon install
  • User: axon_install
groupadd ainstall
useradd -m axon_install -g ainstall
echo "Welcome1!" | passwd axon_install  --stdin 
Advertising

1.3.2 - "Install User" Resources limit

Linux - Resource Manager - Processes limitations (/etc/security/limits.conf)

vim  /etc/security/limits.conf
axon_install                 hard   nofile    32000
axon_install                 soft   nofile    1024

axon_install                 hard   nproc    4096
axon_install                 soft   nproc    1024

1.3.3 - Create the Axon base directory (Installation Directory)

INSTALLATION_DIRECTORY='/app/axon5.3.0'
mkdir -p $INSTALLATION_DIRECTORY
chown -R axon_install:ainstall $INSTALLATION_DIRECTORY
chmod -R 775 $INSTALLATION_DIRECTORY

1.3.4 - Create the install file directory

SOURCE_BINARIES_DIRECTORY='/tmp/axon_binary'
mkdir -p $SOURCE_BINARIES_DIRECTORY
chown -R axon_install:ainstall $SOURCE_BINARIES_DIRECTORY
chmod -R 775 $SOURCE_BINARIES_DIRECTORY
cd $SOURCE_BINARIES_DIRECTORY

1.3.5 - Firewall

firewall-cmd --zone=public --add-port=9999/tcp --permanent
firewall-cmd --reload

1.3.6 - Package

yum update -y
 
yum install libevent -y
yum install mailcap -y
yum install apr -y
yum install apr-util -y

1.3.7 - Disable secure linux and reboot

Disable secure linux by editing the /etc/selinux/config file

vim /etc/selinux/config
SELINUX=disabled
reboot
Advertising

1.3.8 - Validation

  • Get the tester
TESTER_FILE=axon-installer-prerequisite-tester_5.3.zip
WEB_BASE_URL=https://azurecontainer.blob.core.windows.net/install # An url where the file are located
wget -O $SOURCE_BINARIES_DIRECTORY/$TESTER_FILE $WEB_BASE_URL/$TESTER_FILE
unzip $TESTER_FILE
  • Validate
SOURCE_BINARIES_DIRECTORY='/tmp/axon_binary'
cd $SOURCE_BINARIES_DIRECTORY/installer-prerequisite-tester
sh ./validate.sh
######################### Verifying the system requirements for the Axon Installer ########################
System requirements verification passed...

########################## Verifying SELinux Configuration ####################################
SELinux verification passed...

############## Verifying internal RPMs ################
glibc
libevent
libselinux
mailcap
systemd
openssl-libs
apr
apr-util
yajl
Internal RPM verification passed...

The Axon pre-installation verification completed successfully. Proceed with running the Axon installer

1.4 - As axon_install

1.4.1 - Download and prepare the installation files

# The destination of the files
SOURCE_BINARIES_DIRECTORY='/tmp/axon_binary'
# An url where the file are located
WEB_BASE_URL=https://azurecontainer.blob.core.windows.net/install
 
AXON_INSTALL_FILE=Axon_5.3.0_linux-x64_1.tar
wget -O $SOURCE_BINARIES_DIRECTORY/$AXON_INSTALL_FILE $WEB_BASE_URL/$AXON_INSTALL_FILE
 
KEY_FILE=Axon_5.3.0.key
INSTALLATION_DIRECTORY='/app/axon5.3.0'
wget -O $INSTALLATION_DIRECTORY/$KEY_FILE $WEB_BASE_URL/$KEY_FILE
 
cd $SOURCE_BINARIES_DIRECTORY
tar -xvf $AXON_INSTALL_FILE

1.4.2 - Install

SOURCE_BINARIES_DIRECTORY='/tmp/axon_binary'
cd $SOURCE_BINARIES_DIRECTORY
  • console input mode
sh install.sh
  • Install Dir: /app/axon5.3.0/Axon_5.3.0.key
  • Key Location: /app/axon5.3.0/Axon_5.3.0.key

After Step 4 - it will install

Product Name             :      Axon Data Governance 5.3.0
Installation Type:       :      New Installation
Installation Directory   :      /app/axon5.3.0
Axon Home Directory      :      /app/axon5.3.0/axonhome
Required Disk Space      :      10,290 MB
Available Disk Space     :      22,215 MB

1.4.3 - Port

  • HTTP Port: (default :- 9999) : ??? HTTP Port: This port number must be a number in the range 1025 - 65535.
  • Memcache Port: (default :- 11211) :

Microservices Configuration

  • Workflow Service Port: (default :- 8081) :
  • Document Upload Service Port: (default :- 4000) :
  • Change Request Service Port: (default :- 5000) :
  • Bulk Upload Service Port: (default :- 7000) :
  • Bulk Upload Pre-validator Port: (default :- 7010) :
  • Bulk Upload Validator Port: (default :- 7020) :
  • Bulk Upload Committer Port: (default :- 7030) :
  • Notification Service Port: (default :- 3000) :
  • Value List Service Port: (default :- 7050) :
  • Unison Port: (default :- 7060) :

Process map:

  • Process Configuration HTTP Port: (default :- 2480) :
  • Process Configuration Internal Port: (default :- 2424) :

Message broker:

  • Message Broker Configuration Port: (default :- 5672) :
  • Solr Configuration Port: (default :- 8080) :

1.4.4 - Follow Configuration Process

tail -f /app/axon5.3.0/Configure.log
  --------------------------------------------------
 |               Axon Component Status              |
  --------------------------------------------------
 | SL  Status Component                         PID |
  --------------------------------------------------
 | 01  #  1 # TOMCAT_SOLR                #     3781 |
 | 02  #  1 # RABBIT_MQ                  #     4122 |
 | 03  #  1 # POSTGRES                   #     3689 |
 | 04  #  1 # ORIENTDB                   #     3749 |
 | 05  #  1 # MEMCACHED                  #    32949 |
 | 06  #  1 # JOBBER                     #     3883 |
 | 07  #  1 # HTTPD                      #    32982 |
 | 08  #  1 # DAEMONTOOLS                #    32961 |
 | 09  #  1 # CAMUNDA                    #     3825 |
 | 10  #  1 # ODB_CONSUMER               #    32986 |
 | 11  #  1 # NOTIFICATION_MS            #    22873 |
 | 12  #  1 # DOC_UPLOAD_MS              #    21003 |
 | 13  #  1 # CHANGE_REQUEST_MS          #    18570 |
 | 14  #  1 # UNISON_MS                  #    34115 |
 | 15  #  1 # VALUE_LIST_MS              #    33620 |
 | 16  #  1 # BULK_UPLOAD_SRVC           #    33861 |
 | 17  #  1 # BULK_UPLOAD_PRE_VALDTR     #    33909 |
 | 18  #  1 # BULK_UPLOAD_VALDTR         #    33959 |
 | 19  #  1 # BULK_UPLOAD_COMMTR         #    34004 |
  --------------------------------------------------
 | Status (0) - Component is NOT running.           |
 | Status (1) - Component is running.               |
 | Status(-1) - Component DEAD but pid file exists. |
  --------------------------------------------------

1.4.5 - Summary

******************************************************************************************************
Post-Installation Summary - Step 7 of 7
******************************************************************************************************
Installation Status: Success

The Axon Data Governance 5.3.0 installation is complete.

For more information about the installation, see the debug log file available here:
/app/axon5.3.0/Informatica_Axon_5.3.0.log

Product Name:Axon Data Governance 5.3.0
Installation Type:New Installation


You can access Axon from the following URL:
http://hostname:9999

1.4.6 - First login, change the admin password

Now you can connect to your machine on the port 9999 with the following credentials:

And you need to change the password.

1.5 - Admin

1.5.1 - Services

  • Status
cd $INSTALLATION_DIR/axonhome/third-party-app/scripts
sh axonStatus
  • Start all
cd $INSTALLATION_DIR/axonhome/third-party-app/scripts
sh axonStatus reattempt

2 - Support

2.1 - Unison Microservice: Unknown::Service is unavailable

2.2 - Error! Request has been terminated Possible causes

Error when bulk upload:

Error! Request has been terminated Possible causes: the network is offline, Origin is not allowed by Access-Control-Allow-Origin, the page is being unloaded, etc

2.2.1 - Bulk parameters

See: https://kb.informatica.com/solution/23/Pages/66/532429.aspx

Example on Azure of Bad Hostname in the file axonhome/axon/app/config/parameters.ymlc

parameters.ymlc
bulk_upload_host: INFA-AXON-02.3qy32mhqlj1ubaea5iyw5joamf.ax.internal.cloudapp.net

Must be

parameters.ymlc
bulk_upload_host: INFA-AXON-02

2.2.2 - Apache server name

The ServerName parameters must also have the name that you call in the URL. ie if you are calling http://hostname/, it must be hostname

<VirtualHost *:9999>
  ...........
  ServerName hostname
  ............
</VirtualHost>

3 - Documentation / Reference

axon/installation_5.3.txt · Last modified: 2019/02/07 14:19 by gerardnico