Axon - Installation version 5.3

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 

“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

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

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

Firewall

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

Package

yum update -y

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

Disable secure linux and reboot

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

vim /etc/selinux/config

SELINUX=disabled

reboot

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

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

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

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

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) :

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. |
  --------------------------------------------------

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

First login, change the admin password

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

• [email protected]
• changeme

And you need to change the password.

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

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

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

Must be

bulk_upload_host: INFA-AXON-02

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>