Informatica®

5.0

Axon Installation Guide

Informatica Axon Installation Guide
5.0
September 2017
© Copyright Informatica LLC 2015, 2017

This software and documentation are provided only under a separate license agreement containing restrictions on use and disclosure. No part of this document may be
reproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica LLC.

Informatica and the Informatica logo are trademarks or registered trademarks of Informatica LLC in the United States and many jurisdictions throughout the world. A
current list of Informatica trademarks is available on the web at https://www.informatica.com/trademarks.html. Other company and product names may be trade
names or trademarks of their respective owners.

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial
computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such,
the use, duplication, disclosure, modification, and adaptation is subject to the restrictions and license terms set forth in the applicable Government contract, and, to the
extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License.

Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies. All rights
reserved. Copyright © Sun Microsystems. All rights reserved. Copyright © RSA Security Inc. All Rights Reserved. Copyright © Ordinal Technology Corp. All rights
reserved. Copyright © Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright © Meta
Integration Technology, Inc. All rights reserved. Copyright © Intalio. All rights reserved. Copyright © Oracle. All rights reserved. Copyright © Adobe Systems Incorporated.
All rights reserved. Copyright © DataArt, Inc. All rights reserved. Copyright © ComponentSource. All rights reserved. Copyright © Microsoft Corporation. All rights
reserved. Copyright © Rogue Wave Software, Inc. All rights reserved. Copyright © Teradata Corporation. All rights reserved. Copyright © Yahoo! Inc. All rights reserved.
Copyright © Glyph & Cog, LLC. All rights reserved. Copyright © Thinkmap, Inc. All rights reserved. Copyright © Clearpace Software Limited. All rights reserved. Copyright
© Information Builders, Inc. All rights reserved. Copyright © OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved. Copyright Cleo
Communications, Inc. All rights reserved. Copyright © International Organization for Standardization 1986. All rights reserved. Copyright © ej-technologies GmbH. All
rights reserved. Copyright © Jaspersoft Corporation. All rights reserved. Copyright © International Business Machines Corporation. All rights reserved. Copyright ©
yWorks GmbH. All rights reserved. Copyright © Lucent Technologies. All rights reserved. Copyright © University of Toronto. All rights reserved. Copyright © Daniel
Veillard. All rights reserved. Copyright © Unicode, Inc. Copyright IBM Corp. All rights reserved. Copyright © MicroQuill Software Publishing, Inc. All rights reserved.
Copyright © PassMark Software Pty Ltd. All rights reserved. Copyright © LogiXML, Inc. All rights reserved. Copyright © 2003-2010 Lorenzi Davide, All rights reserved.
Copyright © Red Hat, Inc. All rights reserved. Copyright © The Board of Trustees of the Leland Stanford Junior University. All rights reserved. Copyright © EMC
Corporation. All rights reserved. Copyright © Flexera Software. All rights reserved. Copyright © Jinfonet Software. All rights reserved. Copyright © Apple Inc. All rights
reserved. Copyright © Telerik Inc. All rights reserved. Copyright © BEA Systems. All rights reserved. Copyright © PDFlib GmbH. All rights reserved. Copyright ©
Orientation in Objects GmbH. All rights reserved. Copyright © Tanuki Software, Ltd. All rights reserved. Copyright © Ricebridge. All rights reserved. Copyright © Sencha,
Inc. All rights reserved. Copyright © Scalable Systems, Inc. All rights reserved. Copyright © jQWidgets. All rights reserved. Copyright © Tableau Software, Inc. All rights
reserved. Copyright© MaxMind, Inc. All Rights Reserved. Copyright © TMate Software s.r.o. All rights reserved. Copyright © MapR Technologies Inc. All rights reserved.
Copyright © Amazon Corporate LLC. All rights reserved. Copyright © Highsoft. All rights reserved. Copyright © Python Software Foundation. All rights reserved.
Copyright © BeOpen.com. All rights reserved. Copyright © CNRI. All rights reserved.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and/or other software which is licensed under various
versions of the Apache License (the "License"). You may obtain a copy of these Licenses at http://www.apache.org/licenses/. Unless required by applicable law or
agreed to in writing, software distributed under these Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.

This product includes software which was developed by Mozilla (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved; software
copyright © 1999-2006 by Bruno Lowagie and Paulo Soares and other software which is licensed under various versions of the GNU Lesser General Public License
Agreement, which may be found at http:// www.gnu.org/licenses/lgpl.html. The materials are provided free of charge by Informatica, "as-is", without warranty of any
kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose.

The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California,
Irvine, and Vanderbilt University, Copyright (©) 1993-2006, all rights reserved.

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and
redistribution of this software is subject to terms available at http://www.openssl.org and http://www.openssl.org/source/license.html.

This product includes Curl software which is Copyright 1996-2013, Daniel Stenberg, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations regarding this
software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for any purpose with or
without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

The product includes software copyright 2001-2005 (©) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http://www.dom4j.org/ license.html.

The product includes software copyright © 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to
terms available at http://dojotoolkit.org/license.

This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations
regarding this software are subject to terms available at http://source.icu-project.org/repos/icu/icu/trunk/license.html.

This product includes software copyright © 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at
http:// www.gnu.org/software/ kawa/Software-License.html.

This product includes OSSP UUID software which is Copyright © 2002 Ralf S. Engelschall, Copyright © 2002 The OSSP Project Copyright © 2002 Cable & Wireless
Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php.

This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software
are subject to terms available at http:/ /www.boost.org/LICENSE_1_0.txt.

This product includes software copyright © 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms available at
http:// www.pcre.org/license.txt.

This product includes software copyright © 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http:// www.eclipse.org/org/documents/epl-v10.php and at http://www.eclipse.org/org/documents/edl-v10.php.

This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?License, http://
www.stlport.org/doc/ license.html, http://asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://
httpunit.sourceforge.net/doc/ license.html, http://jung.sourceforge.net/license.txt , http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/
release/license.html, http://www.libssh2.org, http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, http://fusesource.com/downloads/
license-agreements/fuse-message-broker-v-5-3- license-agreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/
licence.html; http://www.jgraph.com/jgraphdownload.html; http://www.jcraft.com/jsch/LICENSE.txt; http://jotm.objectweb.org/bsd_license.html; . http://www.w3.org/
Consortium/Legal/2002/copyright-software-20021231; http://www.slf4j.org/license.html; http://nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/
license.html; http://forge.ow2.org/projects/javaservice/, http://www.postgresql.org/about/licence.html, http://www.sqlite.org/copyright.html, http://www.tcl.tk/
software/tcltk/license.html, http://www.jaxen.org/faq.html, http://www.jdom.org/docs/faq.html, http://www.slf4j.org/license.html; http://www.iodbc.org/dataspace/
iodbc/wiki/iODBC/License; http://www.keplerproject.org/md5/license.html; http://www.toedter.com/en/jcalendar/license.html; http://www.edankert.com/bounce/
index.html; http://www.net-snmp.org/about/license.html; http://www.openmdx.org/#FAQ; http://www.php.net/license/3_01.txt; http://srp.stanford.edu/license.txt;
http://www.schneier.com/blowfish.html; http://www.jmock.org/license.html; http://xsom.java.net; http://benalman.com/about/license/; https://github.com/CreateJS/
EaselJS/blob/master/src/easeljs/display/Bitmap.js; http://www.h2database.com/html/license.html#summary; http://jsoncpp.sourceforge.net/LICENSE; http://
jdbc.postgresql.org/license.html; http://protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; https://github.com/rantav/hector/blob/master/
LICENSE; http://web.mit.edu/Kerberos/krb5-current/doc/mitK5license.html; http://jibx.sourceforge.net/jibx-license.html; https://github.com/lyokato/libgeohash/blob/
master/LICENSE; https://github.com/hjiang/jsonxx/blob/master/LICENSE; https://code.google.com/p/lz4/; https://github.com/jedisct1/libsodium/blob/master/
LICENSE; http://one-jar.sourceforge.net/index.php?page=documents&file=license; https://github.com/EsotericSoftware/kryo/blob/master/license.txt; http://www.scala-
lang.org/license.html; https://github.com/tinkerpop/blueprints/blob/master/LICENSE.txt; http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/
intro.html; https://aws.amazon.com/asl/; https://github.com/twbs/bootstrap/blob/master/LICENSE; https://sourceforge.net/p/xmlunit/code/HEAD/tree/trunk/
LICENSE.txt; https://github.com/documentcloud/underscore-contrib/blob/master/LICENSE, and https://github.com/apache/hbase/blob/master/LICENSE.txt.

This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), the Common Development and
Distribution License (http://www.opensource.org/licenses/cddl1.php) the Common Public License (http://www.opensource.org/licenses/cpl1.0.php), the Sun Binary
Code License Agreement Supplemental License Terms, the BSD License (http:// www.opensource.org/licenses/bsd-license.php), the new BSD License (http://
opensource.org/licenses/BSD-3-Clause), the MIT License (http://www.opensource.org/licenses/mit-license.php), the Artistic License (http://www.opensource.org/
licenses/artistic-license-1.0) and the Initial Developer’s Public License Version 1.0 (http://www.firebirdsql.org/en/initial-developer-s-public-license-version-1-0/).

This product includes software copyright © 2003-2006 Joe WaInes, 2006-2007 XStream Committers. All rights reserved. Permissions and limitations regarding this
software are subject to terms available at http://xstream.codehaus.org/license.html. This product includes software developed by the Indiana University Extreme! Lab.
For further information please visit http://www.extreme.indiana.edu/.

This product includes software Copyright (c) 2013 Frank Balluffi and Markus Moeller. All rights reserved. Permissions and limitations regarding this software are subject
to terms of the MIT license.

See patents at https://www.informatica.com/legal/patents.html.

DISCLAIMER: Informatica LLC provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied
warranties of noninfringement, merchantability, or use for a particular purpose. Informatica LLC does not warrant that this software or documentation is error free. The
information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation
is subject to change at any time without notice.

NOTICES

This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies, an operating company of Progress Software
Corporation ("DataDirect") which are subject to the following terms and conditions:

1. THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT INFORMED OF THE POSSIBILITIES
OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT LIMITATION, BREACH OF CONTRACT, BREACH
OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS.

The information in this documentation is subject to change without notice. If you find any problems in this documentation, please report them to us in writing at
Informatica LLC 2100 Seaport Blvd. Redwood City, CA 94063.

Informatica products are warranted according to the terms and conditions of the agreements under which they are provided. INFORMATICA PROVIDES THE
INFORMATION IN THIS DOCUMENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT ANY WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY OR CONDITION OF NON-INFRINGEMENT.

Publication Date: 2017-09-14

Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Product Availability Matrixes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica Velocity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 1: Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Introduction to Axon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Installation Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Installation Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Chapter 2: Before You Run the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Port Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Before You Run the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Disable SELinux and Configure Port Access. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Run the Validation Utility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Obtain the Informatica Domain Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
SSL Communication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Obtain the License Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Disable Database Backup Cron Job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Create Directories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Extract the Installer Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installer Directory Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Chapter 3: Running the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Running the Installer Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Running the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Installing Axon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Installing the Axon Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Installing Axon and the Axon Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Chapter 4: After You Run the Installer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Post-Installation Task. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Configure Access to Enterprise Information Catalog. . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Connecting to an SSL Enabled Enterprise Information Catalog Instance. . . . . . . . . . . . . . . . 20

4 Table of Contents
 Configure Access to Informatica Data Quality. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Configure SSL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Configure User Systems for Bulk Upload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Check the Status of the Micro Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Configuring Email Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Configure Email Delivery Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Create a Daily Email Notification Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Create a Weekly Email Notification Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Create a Monthly Email Notification Schedule. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Create a Email Notification Schedule With Frequency in Minutes. . . . . . . . . . . . . . . . . . . . 24
Logging In To Axon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Chapter 5: Uninstallation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Running the Axon Uninstaller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Running the Axon Agent Uninstaller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Appendix A: Appendix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Install the Internal RPM Package Manager Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Unable to Connect to Axon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Incorrect Hostname. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Validation Utility Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Operating System User Accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Table of Contents 5
Preface
The Axon Installer Guide is intended to help an administrator in an enterprise to install Axon.

This guide covers the tasks that you can perform using the Axon installer.

Informatica Resources

Informatica Network
Informatica Network hosts Informatica Global Customer Support, the Informatica Knowledge Base, and other
product resources. To access Informatica Network, visit https://network.informatica.com.

As a member, you can:

• Access all of your Informatica resources in one place.

• Search the Knowledge Base for product resources, including documentation, FAQs, and best practices.
• View product availability information.
• Review your support cases.
• Find your local Informatica User Group Network and collaborate with your peers.

Informatica Knowledge Base

Use the Informatica Knowledge Base to search Informatica Network for product resources such as
documentation, how-to articles, best practices, and PAMs.

To access the Knowledge Base, visit https://kb.informatica.com. If you have questions, comments, or ideas
about the Knowledge Base, contact the Informatica Knowledge Base team at
KB_Feedback@informatica.com.

Informatica Documentation
To get the latest documentation for your product, browse the Informatica Knowledge Base at
https://kb.informatica.com/_layouts/ProductDocumentation/Page/ProductDocumentSearch.aspx.

If you have questions, comments, or ideas about this documentation, contact the Informatica Documentation
team through email at infa_documentation@informatica.com.

6
Informatica Product Availability Matrixes
Product Availability Matrixes (PAMs) indicate the versions of operating systems, databases, and other types
of data sources and targets that a product release supports. If you are an Informatica Network member, you
can access PAMs at
https://network.informatica.com/community/informatica-network/product-availability-matrices.

Informatica Velocity
Informatica Velocity is a collection of tips and best practices developed by Informatica Professional
Services. Developed from the real-world experience of hundreds of data management projects, Informatica
Velocity represents the collective knowledge of our consultants who have worked with organizations from
around the world to plan, develop, deploy, and maintain successful data management solutions.

If you are an Informatica Network member, you can access Informatica Velocity resources at
http://velocity.informatica.com.

If you have questions, comments, or ideas about Informatica Velocity, contact Informatica Professional
Services at ips@informatica.com.

Informatica Marketplace
The Informatica Marketplace is a forum where you can find solutions that augment, extend, or enhance your
Informatica implementations. By leveraging any of the hundreds of solutions from Informatica developers
and partners, you can improve your productivity and speed up time to implementation on your projects. You
can access Informatica Marketplace at https://marketplace.informatica.com.

Informatica Global Customer Support

You can contact a Global Support Center by telephone or through Online Support on Informatica Network.

To find your local Informatica Global Customer Support telephone number, visit the Informatica website at
the following link:
http://www.informatica.com/us/services-and-training/support-services/global-support-centers.

If you are an Informatica Network member, you can use Online Support at http://network.informatica.com.

Preface 7
Chapter 1

Overview
This chapter includes the following topics:

• Introduction to Axon, 8
• Installation Overview, 8
• Installation Process, 8

Introduction to Axon
Axon is a knowledge repository and governance tool that stores the core data items and the business context
of your organization. Owners, Stewards, Subject Matter Experts and other responsible stakeholders
collaborate to progressively chart the business reality of data, its lineage, and usage across processes,
policies, projects, and regulation.

Installation Overview
Informatica provides a pre-validation utility to verify if your system meets the software requirements for
installation and an installer to install Axon. Use the installer to install only Axon, only the Axon Agent, or both
of them.

The Axon Agent is required by Axon to connect to Informatica Data Quality. You can install the Axon Agent on
the same machine where you install Axon, or on a different machine. You must provide the details of your
Informatica domain when you install the Axon Agent.

Installation Process
The installation of the Axon consists of multiple phases.

The installation process consists of the following phases:

Preparation

Set up the system to meet the operating system requirements to ensure that you can successfully install
and run Axon. Run the pre-validation utility to check if your system meets the requirements.

8
Planning

Before you run the Axon installer, you must plan your deployment.

The following table lists the choices that the Axon installer provides. Plan your deployment based on
these choices before you run the installer:

Choice Planning Task

Integration with Informatica Data Quality Keep the details of your Choose to install the
Informatica domain Axon Agent when you run
ready. the installer.

Integration with Informatica Enterprise Information Keep the details of your Choose the advanced
Catalog Enterprise Information configuration step when
Catalog deployment you run the installer and
ready. choose to install Axon or
Axon and the Axon Agent.

Perform the preparatory steps described in the Before You Run the Installer section, before you run the
Axon installer.

Post Installation

After you run the installer, perform the post-installation tasks. Access Axon by typing the URL in a web
browser. Log in to verify if the installation is successful. Read the troubleshooting steps if you have
issues with your installation.

Installation Process 9
Chapter 2

Before You Run the Installer

This chapter includes the following topics:

• System Requirements, 10
• Before You Run the Installer, 12
• Installer Directory Structure, 14

System Requirements
Verify that the system where you plan to install Axon meets the minimum requirements for the installation
process. Ensure that the external ports are open.

The following table lists the system requirements for Axon:

Component Description

Disk 200 GB

Memory 16 GB

CPU Cores 4

OS RedHat Linux version 7.x

You cannot install Axon on the same server where Informatica Internal Cluster (IHS) is installed.

Important: Informatica recommends that you use a dedicated system to deploy Axon.

Port Requirements
The packages and micro services that Axon installs use unique ports. You can choose to change some of the
port numbers during installation. The installer sets up the ports for some of the third party services and
designates a range of dynamic ports to use for some application services. Verify that the port numbers are
available before you start the installation process.

The internal ports are only used by Axon internally. Axon uses external ports for external communication.

10
The following table describes the default ports used by the micro services:

Port Type Default Port Number

Workflow Service (Camunda) 8081

Doc Upload Service 4000

Change Request Service 5000

Bulk Upload Service 7000

Bulk Upload PreValidator 7010

Bulk Upload Validator 7020

Bulk Upload Commiter Port 7030

Notification Service Port 3000

Memcache 11211

Apache Server HTTP Port. This is an external port. 80

Apache Server HTTPS Port. This is an external port. Axon uses this port if you enable SSL 443
communication.

The following table describes the ports used by Enterprise Information Catalog:

Port Type Default Port Number

Enterprise Information Catalog 9085

The following table describes the ports used by the process map configuration:

Port Type Default Port Number

Process Configuration HTTP 2480

Process Configuration Internal Port 2424

The following table describes the ports used by the message broker:

Port Type Default Port Number

Message Broker 5672

The following table describes the port used by Solr:

Port Type Description

Solr Index Port 8080

System Requirements 11
Before You Run the Installer
Perform the pre-installation tasks before you run the Axon installer. Contact the IT department of your
organization if any of these tasks require additional resources.

Disable SELinux and Configure Port Access

Verify that SELinux is disabled before you run the Axon installer. Configure your firewall to allow the Axon
installer and the application that it installs to access the external ports. Optionally, disable the firewall.

Run the following command to verify if SELinux is disabled on the system where you intend to run the Axon
installer:

getenforce

The command should return the following result if SELinux is disabled:

Disabled

If SELinux is not disabled, contact the IT department of your organization.

Run the Validation Utility

Informatica provides a validation utility which you can run to verify if your system meets the requirements to
run the Axon installer.

You can download the validation utility from the following URL:
https://download.informatica.com/infa/downloads/Axon/installer-prerequisite-tester.zip

Execute the following command as a root user to run the validation utility:

sh validate.sh <PATH_EXTRACTED_AXON_INSTALLER>

Optionally, execute the following command as a sudo user to run the validation utility:

sudo sh validate.sh <PATH_EXTRACTED_AXON_INSTALLER>

The validation utility checks if your system meets the following requirements:

• System requirements
• SELinux configuration
• Internal RPMs
• Application RPMs

The following image shows the validation utility:

12 Chapter 2: Before You Run the Installer

 The validation utility displays messages when it runs. Follow the instructions given in the messages before
you proceed with running the Axon installer. You can also check the log directory present in the same
directory as the validate.sh file for log messages after you run the validation utility.

Axon installs PHP version 5.6. Uninstall any other version of PHP from your system before you run the
installer.

If any of the application RPMs that are installed by the Axon installer are already present in your system,
uninstall them before you run the installer.

For a list of RPMs required by the Axon installer, see the Install the Internal RPM Package Manager Files
section in the Appendix.

Obtain the Informatica Domain Details

Axon can connect to the Informatica domain to extract profile and scorecard information from Data Quality.
Axon can extract enterprise metadata information from Enterprise Information Catalog.

You must provide the following details of your Informatica domain if you choose to install the Axon Agent
when you run the Axon installer:

• Domain name
• Port number
• Model Repository Service domain host name
• Model Repository Service domain username and password
• Model Repository Service name
• Model Repository Service security domain
• Model Repository Service SSL details
• Data Integration Service username and password
• Data Integration Service name
• Data Integration Service security domain
• Data Integration Service SSL details

You must provide the following details of your Enterprise Information Catalog installation if you choose to do
an advanced installation:

• Enterprise Information Catalog server name

• Port number
• Username and password
• Namespace
• Resource name

SSL Communication
Axon can use HTTP and HTTPS for communication. To use HTTPS communication, you must configure SSL
during installation. Keep the SSL certificate and key file ready before you start the installation.

You must have the following information ready before you start the installation:

• HTTPS port information

• SSL certificate and the path to the file
• Key file and the path to the file

Before You Run the Installer 13

 Obtain the License Key
Before you install Axon, verify that you have a valid license key. Contact Informatica Global Customer Support
to obtain a license key. You must provide the location of the license key file during the installation process.

Disable Database Backup Cron Job

You can prevent automatic database backup during your Axon installation.

To disable the cron job that backs up your database periodically, set the following environment variable to
false:

AXON_ENABLE_CRON_JOB=false

Create Directories
Create the following directories before you run the installer:

1. Create an installation directory. The Axon installer creates a home directory inside the installation
directory. The installer installs Axon in the home directory. The installer stores the uninstaller.sh and
other files in the installation directory. The installation directory is referred to as
<INSTALLATION_DIRECTORY> in this document.
2. Create a temporary directory. Extract the installer files to this directory. Make sure that you download the
installer zip file to a local directory or a shared network drive that is mapped on your machine. You can
then securely copy the installer file to the installer folder and extract the installer files.
3. Optionally, create a directory for the Axon installer to install the Axon Agent.

Extract the Installer Files

The installer files are compressed and distributed as a tar file. Use an extraction utility to untar the installer
files to the installation directory on your machine. When you untar the file, verify that the extraction utility
also extracts empty folders.

Installer Directory Structure

You must decompress the Axon installer file to a directory on the system before you run the installer.

The installer file decompresses the following files to the installation directory:

• Messages
• install.sh
• Server
• properties
• source

14 Chapter 2: Before You Run the Installer

Chapter 3

Running the Installer

This chapter includes the following topics:

• Running the Installer Overview, 15

• Running the Installer, 15

Running the Installer Overview

Informatica provides an installer to install Informatica Axon on a machine running RedHat Linux version 7.x.
Run the installer using a shell. You can run only one instance of Axon on a machine at any given point of time.

The Axon installer provides an interactive wizard. Use the wizard to configure the installation parameters.
You can choose to install the Axon agent when you install Axon. Install the Axon agent to enable
communication between Axon and Informatica Data Quality.

Run the install.sh file from the folder where you untarred the installer as one of the following users:

• root
• sudo

Running the Installer

Install Axon using a console. When you run the installer, the words Quit and Back are reserved words. Do not
use them as input text.

1. Log in to the machine with a root user or sudo user.

2. Close all other applications.
3. Ensure that there are no Axon-related services running and uninstall any previous versions of Axon that
you may have.
4. From the command line, run the install.sh file.
• To run the command as a root user, execute the sh install.sh command.
• To run the command as a sudo user, execute the sudo sh install.sh command.

15
 5. Type the number corresponding to one of the following options to continue:

Option Description

1. Install Axon. Run the installer to install Axon.

2. Install Axon Agent. Run the installer to install the Axon Agent.

3. Install both Axon and Axon Agent. Run the installer to install both Axon and the Axon Agent.

Installing Axon
Select the option to install Axon if you do not wish to install the Axon Agent. Informatica recommends that
you run the validation utility before you run the Axon installer.

Run install.sh and select the option to install Axon before you proceed.

1. In step one of the wizard, review the information on the screen and hit the Enter key to continue.
2. In step two of the wizard, enter the path to the installation directory and the license key. The installer
performs a check to validate the system requirements and verifies if the license key file in the
installation directory. The installer copies the license key from the location you have provided.
3. In step three of the wizard, review the pre-installation summary information. Press the Enter key to
continue. If you want to make changes to the information you provided, type Back and press Enter.
4. In step four of the wizard, review the installation progress.
5. After the installation progress reaches 100%, you can choose to perform some advanced configurations.
Type 1 to continue with the advanced configuration.
• In step 5A of the advanced configuration, choose to enable HTTPS. Specify the port number, and
provide the path to the SSL certificate, SSL key. Specify the Memcache port number.
• In step 5B of the advanced configuration, specify the port numbers of the micro services.
• In step 5C of the advanced configuration, specify the port number of the process configuration.
• In step 5D of the advanced configuration, specify the port number for the message broker.
• In step 5E of the advanced configuration, specify the port number for Solr.
• Type 1 to configure Enterprise Information Catalog.
• In step 5F of the advanced configuration, provide the details of your Enterprise Information Catalog
installation.
This process may take some time to complete. You can track the progress of this step by viewing the
logs available at <INSTALLATION_DIRECTORY>/Configure.log.
6. In step six of the wizard, review the post-installation summary information. After installation, the console
is refreshed and the details of the Axon installation is cleared from your screen. Make a note of all
important information on this screen.
7. Press the Enter key to exit the installer wizard.

Installing the Axon Agent

Select the option to install the Axon Agent if you already installed Axon and you want to extract profile and
scorecard information from Informatica Data Quality. Informatica recommends that you run the validation
utility before you run the Axon installer. You can install the Axon Agent on the same system where you have

16 Chapter 3: Running the Installer

 installed Axon or on any other system. You must know the details of the Informatica domain before you
proceed.

Run install.sh and select the option to install the Axon Agent before you proceed.

1. In step one of the wizard, review the information on the screen and press Enter to continue.
2. In step two of the wizard, choose the version of the Informatica domain that you want Axon to connect
to.
3. In step three of the wizard, enter the path to the directory where you want the installer to install the Axon
Agent.
4. In step four of the wizard, review the pre-installation summary information. Press the Enter key to
continue. If you want to make changes to the information you provided, type Back and press the Enter
key.
5. In step five of the wizard, review the installation progress.
6. In step six of the wizard, enter the details of your Informatica domain.
7. In step seven of the wizard, enter the details of the Data Integration Service.
8. In step eight of the wizard, choose to enable HTTPS. Specify the details of the Axon installation and the
HTTP port.
9. In step nine of the wizard, review the summary message.
10. Press the Enter key to exit the installer.

Installing Axon and the Axon Agent

Select the option to install Axon and the Axon Agent to enable communication with Informatica Data Quality.
Informatica recommends that you run the validation utility before you run the Axon installer.

1. In step one of the wizard, review the information on the screen and hit the Enter key to continue.
2. In step two of the wizard, enter the path to the installation directory and the license key. The installer
performs a check to validate the system requirements and verifies if the license key is valid. The installer
copies the license key from the location you have provided.
3. In step three of the wizard, review the pre-installation summary information. Press the Enter key to
continue. If you want to make changes to the information you provided, type Back and press Enter.
4. In step four of the wizard, review the installation progress. This process may take some time to
complete. You can track the progress of this step by viewing the logs available at
<INSTALLATION_DIRECTORY>/Configure.log
5. After the installation progress reaches 100%, you can choose to perform an advanced configuration.
Type 1 to continue with the advanced configuration.
• In step 5A of the advanced configuration, choose to enable HTTPS. Specify the port number, and
provide the path to the SSL certificate, SSL key. Specify the Memcache port number.
• In step 5B of the advanced configuration, specify the port numbers of the micro services.
• In step 5C of the advanced configuration, specify the port number of the process configuration.
• In step 5D of the advanced configuration, specify the port number for the message broker.
• In step 5E of the advanced configuration, specify the port number for Solr.
• Type 1 to configure Enterprise Information Catalog.
• In step 5F of the advanced configuration, provide the details of your Enterprise Information Catalog
installation.

Running the Installer 17

 6. In step six of the wizard, review the post-installation summary information. After installation, the console
is refreshed and the details of the Axon installation is cleared from your screen. Make a note of all
important information on this screen.
7. Continue with the installation of the Axon Agent.
8. In step one of the wizard, review the information on the screen and press Enter to continue.
9. In step two of the wizard, choose the version of the Informatica domain that you want Axon to connect
to.
10. In step three of the wizard, enter the path to the directory where you want the installer to install the Axon
Agent.
11. In step four of the wizard, review the pre-installation summary information. Press the Enter key to
continue. If you want to make changes to the information you provided, type Back and press the Enter
key.
12. In step five of the wizard, review the installation progress.
13. In step six of the wizard, enter the details of your Informatica domain.
14. In step seven of the wizard, enter the details of the Data Integration Service.
15. In step eight of the wizard, choose to enable HTTPS. Specify the details of the Axon installation and the
HTTP port.
16. In step nine of the wizard, review the summary message.
17. Press the Enter key to exit the installer.

18 Chapter 3: Running the Installer

Chapter 4

After You Run the Installer

This chapter includes the following topics:

• Post-Installation Task, 19
• Check the Status of the Micro Services, 21
• Configuring Email Notifications, 22
• Logging In To Axon, 24

Post-Installation Task
Perform the post-installation task after you run the Axon installer.

Configure Access to Enterprise Information Catalog

You must update the parameters.yml file to view Enterprise Information Catalog resources in Axon. Do not
add unwanted spaces or tabs to the parameters.yml file.

1. Open the parameters.yml file available in the following location:

<INSTALLATION_DIRECTORY>/axonhome/axon/app/config/parameters.yml
2. Configure the following properties:

Option Description

eic_server_host Host address of the Enterprise Information Catalog system

eic_server_port Port number of the Enterprise Information Catalog system

eic_server_login_username User name to log in to Enterprise Information Catalog

eic_server_login_namespace User security domain of Enterprise Information Catalog

eic_axon_resources_name Resource name in Enterprise Information Catalog that is configured to connect to

Axon

3. Run the following command to clear the cache:

rm -rf <INSTALLATION_DIRECTORY>/axonhome/axon/app/cache/*

19
 4. Type the following commands to restart the micro services:
service memcached restart
service httpd restart

Connecting to an SSL Enabled Enterprise Information Catalog

Instance
To connect Axon to an instance of Enterprise Information Catalog that has SSL enabled, you must update
curl and the related libraries after you install Axon. Else, the facets in Axon will not display objects.

Use YUM to upgrade CURL and the related libraries in your instance of Axon.

Run the following command to check the version of CURL and the related libraries:

curl -V

You can connect to an SSL enabled instance of Enterprise Information Catalog if the console displays the
following information after you run the command:

curl 7.29.0 (x86_64-redhat-linux-gnu) libcurl/7.29.0 NSS/3.21 Basic ECC zlib/1.2.7 libidn/

1.28 libssh2/1.4.3

Protocols: dict file ftp ftps gopher http https imap imaps ldap ldaps pop3 pop3s rtsp scp
sftp smtp smtps telnet tftp

Features: AsynchDNS GSS-Negotiate IDN IPv6 Largefile NTLM NTLM_WB SSL libz unix-sockets

Configure Access to Informatica Data Quality

You must update the parameters.yml file to connect to Informatica Data Quality. Do not add unwanted
spaces or tabs to the parameters.yml file.

1. Open the parameters.yml file available in the following location:

<INSTALLATION_DIRECTORY>/axonhome/axon/app/config/parameters.yml
2. Configure the following properties:

Option Description

agent_host IP address of the system where you installed the Axon Agent

agent_port Port number of the system where you installed the Axon Agent

3. Run the following command to clear the cache:

rm -rf <INSTALLATION_DIRECTORY>/axonhome/axon/app/cache/*
4. Type the following commands to restart the micro services:
service memcached restart
service httpd restart

20 Chapter 4: After You Run the Installer

 Configure SSL
You must configure Axon to use SSL security.

1. Open the diaku_web.conf file available in the following location:

/etc/httpd/conf.d/diaku_web.conf
2. For the SSLCaCertificateFile property, delete the comment and enter the full path to your SSL CA file.

Configure User Systems for Bulk Upload

You must modify the hosts file in each Axon user's system for the bulk upload feature to work.

For each Axon user who uses the bulk upload feature, perform the following tasks.

1. Open the hosts file available in the following location:

C:\Windows\System32\drivers\etc
2. At the end of the hosts file, add the IP address and domain name address for your Axon host. Open the
parameters.yml file to see the domain name address for your Axon host. Alternatively, run the hostname
-f command to see the domain name address for your Axon host.
For example, if the parameters.yml file says bulk_upload_host: AXONL70VM01.informatica.com, add
the entry 192.0.2.5 AXONL70VM01.informatica.com to the hosts file.
To bulk upload data, you must enter this domain name address in your browser to open Axon.

Check the Status of the Micro Services

You can verify if all the micro services installed by Axon have started after you finished running the installer.

The following table lists the micro services and the command you must run in the console to check their
status:

Service Name Status Check

Document Upload service axon_document_upload_microservice status

Notification service axon_notification_microservice status

Change Request service axon_changerequest_microservice status

OrientDB service orientdb status

Camunda service camunda status

RabbitMQ service rabbitmq-server status

Httpd service httpd status

OdbConsumer service OdbConsumer status

Memcached service memcached status

Check the Status of the Micro Services 21

 Service Name Status Check

Solr service tomcat-solr status

PostgreSQL service postgresql-9.4 status

DaemonTools service daemontools status

Bulk Upload service axon_bulk_upload_microservice status

Configuring Email Notifications

You can create a time-based job scheduler to receive emails from Axon. You must enter the details of your
email system in the parameters.yml file. You must also create and configure a crontab (cron table) file to
specify shell commands that run periodically on a given schedule.

You can schedule email notifications in the following time intervals:

• Daily
• Weekly
• Monthly
• Once in five minutes

Configure Email Delivery Options

You must update the parameters.yml file with the details of your email server.

1. Open the parameters.yml file available in the following location:

<INSTALLATION_DIRECTORY>/axonhome/axon/app/config/parameters.yml
2. Configure the following properties:

Property Description

mailer_transport Email protocol

mailer_host Your email host address

mailer_user Your email user name

mailer_password Your email password

mailer_port Email server port

disable_delivery Set to false

3. Run the following command to clear the cache:

rm -rf <INSTALLATION_DIRECTORY>/axonhome/axon/app/cache/*

22 Chapter 4: After You Run the Installer

 4. Type the following commands to restart the micro services:
service memcached restart
service httpd restart

Create a Daily Email Notification Schedule

Perform the following steps to create a daily email notification schedule.

1. Go to the following location /etc/cron.daily.

2. Create a new file with the name script.sh.
3. Add the following code to the file:
#!/bin/sh
php /opt/axon/app/console diaku:process-notifications --timeframe=daily --env=prod
4. From the console, type crontab -e
The console displays the crontab editor.
5. Type the following command:
<min> <hr> * * * /etc/cron.daily/script.sh
For example, to receive email notifications at 10.30 pm every day, type the following command:
30 22 * * * /etc/cron.daily/script.sh
6. Hit the ESC key and type wq to save your changes.

Create a Weekly Email Notification Schedule

Perform the following steps to create a weekly email notification schedule.

1. Go to the following location /etc/cron.daily.

2. Create a new file with the name script.sh.
3. Add the following code to the file:
#!/bin/sh
php /opt/axon/app/console diaku:process-notifications --timeframe=weekly --env=prod
4. From the console, type crontab -e
The console displays the crontab editor.
5. Type the following command:
<min> <hr> * * <day> /etc/cron.daily/script.sh
For example, to receive email notifications at 6.30 am every Sunday, type the following command:
30 6 * * 0 /etc/cron.weekly/script.sh
6. Hit the ESC key and type wq to save your changes.

Create a Monthly Email Notification Schedule

Perform the following steps to create a monthly notification schedule.

1. Go to the following location /etc/cron.daily.

2. Create a new file with the name script.sh.

Configuring Email Notifications 23

 3. Add the following code to the file:
#!/bin/sh
php /opt/axon/app/console diaku:process-notifications --timeframe=monthly --env=prod
4. From the console, type crontab -e
The console displays the crontab editor.
5. Type the following command:
<min> <hr> <date> * * /etc/cron.daily/script.sh
For example, to receive email notifications at 6.30 am on the 28th of every month, type the following
command:
30 6 28 * * /etc/cron.monthly/script.sh
6. Hit the ESC key and type wq to save your changes.

Create a Email Notification Schedule With Frequency in Minutes

Perform the following steps to create a notification schedule with frequency in minutes.

1. Go to the following location /etc/cron.daily.

2. Create a new file with the name script.sh.
3. Add the following code to the file:
#!/bin/sh
php /opt/axon/app/console diaku:process-notifications --timeframe=monthly --env=prod
4. From the console, type crontab -e
The console displays the crontab editor.
5. Type the following command:
*/<min> * * * * /etc/cron.daily/script.sh
For example, to receive email notifications every five minutes, type the following command:
*/5 * * * * /etc/cron.daily/script.sh
6. Hit the ESC key and type wq to save your changes.

Logging In To Axon
If you have not configured Single Sign-On, use the URL displayed by the Axon installer after the installation
completes, to log in to Axon from a browser. To configure Single Sign-On for authentication, see the Enabling
Single Sign-on in Axon How-to Article.

1. Open a browser.
2. In the address field, type the URL for the Axon login page in the following format: http(s)://
<host>:<port>/
3. From the Axon home page, on the top right corner of the toolbar, click Login.
4. Enter your login credentials. The following are the default login credentials for the Super Admin user:
Username: root@diaku.com
Password: changeme

24 Chapter 4: After You Run the Installer

5. Click Login.
6. Axon refreshes the page and displays your username in the toolbar. This indicates that you have
successfully logged in.
7. Modify the password for your login credentials.

Logging In To Axon 25
Chapter 5

Uninstallation
This chapter includes the following topics:

• Running the Axon Uninstaller, 26

• Running the Axon Agent Uninstaller, 26

Running the Axon Uninstaller

Run the uninstaller file to remove all the Axon files present in the Axon home and installation directories.
Important: The Axon uninstaller removes the the PostgreSQL database and the backup files stored in the
<INSTALLATION_DIRECTORY>/axonhome/db-backups/postgres_backups directory. Copy these files to another
location if you require these files after uninstalling Axon.

1. Use the root user or sudo user credentials and log in to the machine where you have installed Axon.
2. Navigate to the following directory to access the uninstaller.sh file.
<INSTALLATION_DIRECTORY>/Uninstaller_axon
3. Run the uninstaller. The uninstaller stops the Axon services that are currently running and removes all
the Axon and third-party packages and tar files from the machine.
• To run the uninstaller as a root user, type sh uninstaller.sh
• To run the uninstaller as a sudo user, type sudo sh uninstaller.sh
4. Review the uninstallation summary file at the following location: <user_home_directory>/
Configure.log

Running the Axon Agent Uninstaller

Run the Axon Agent uninstaller to remove the Axon Agent from your system.

1. Navigate to the following directory

<AXONAGENT_INSTALLATION>/Uninstaller_agent
2. Run the uninstaller.sh file as a root user or sudo user.
3. in the Uninstallation step, review the information and hit Enter to continue with the uninstallation of the
Axon Agent.
4. In the Uninstalling step, review the progress of the uninstallation.

26
5. In the Post-Uninstallation Summary screen, review the information.
6. Hit the Enter key to complete the uninstallation.

Running the Axon Agent Uninstaller 27

Appendix A

Appendix
This appendix includes the following topics:

• Install the Internal RPM Package Manager Files , 28

• Troubleshooting, 29
• Operating System User Accounts, 30

Install the Internal RPM Package Manager Files

Prepare the system before you run the Axon installer. Install the required RPM Package Manager files (RPMs)
required by Axon.

Ensure that the following RPMs are available in your system before you run the Axon installer:

• apr-1.4.8
• apr-util-1.5.2
• autoconf-2.69
• automake-1.13.4
• glibc-2.17
• graphviz-2.30.1
• libevent-2.0.21
• libjpeg-turbo-1.2.90
• libmcrypt-2.5.8
• libpng-1.5.13
• libselinux-2.5
• libtool-ltdl-2.4.2
• libX11-1.6.3
• lksctp-tools-1.0.17
• mailcap-2.1.41
• mesa-libGLU-9.0.0
• pcre-devel-8.32
• systemd-219
• systemd-sysv-219

28
 • t1lib-5.1.2
• tk-8.5.13
• wxBase-2.8.12
• wxGTK-2.8.12
• wxGTK-gl-2.8.12
• xorg-x11-fonts-75dpi-7.5
• xorg-x11-fonts-Type1-7.5
• openssl-libs-1.0.1e
• socat-1.7.2.2
If any of these RPMs are missing, contact the IT department of your organization.

Troubleshooting
The following sections provide information that will help you troubleshoot your Axon instance if it does not
work as expected.

Unable to Connect to Axon

You should be able to access Axon by typing the Fully Qualified Domain name or the IP address of the server
and the port number in the address bar of a web browser. If you are unable to access Axon, perform the
following steps:

Verify the Firewall Settings

You must enable the firewall of the machine where you installed Axon to allow requests for the port.

Verify that the Micro Services are Running

Ensure that all the micro services are running after the installation. If Axon or any of the micro services
is not running, run the startup.sh script. If you want to manually stop the Axon services, run the
shutdown.sh script.

The startup.sh and shutdown.sh files are available in the <INSTALLATION_DIRECTORY>/bin/ directory.

Incorrect Hostname
If you encounter an error with the hostname during installation, verify that Axon is using the correct
hostname.

Run the following command to verify the hostname settings: .

hostname -i

If Axon returns 127.0.0.1 or an incorrect IP address as the hostname, verify that you have entered the correct
IP address of your Axon installation.

Troubleshooting 29
 Validation Utility Errors
You may see errors relating to some package libraries when you run the validation utility. Perform the tasks
described here to resolve errors displayed during the validation check.

Perform the following tasks if you see these errors:

OpenSSL Error

Upgrade your version of openssl-libs if you see the following error when you run the validation utility:
error: Failed dependencies:

openssl-libs >= 1:1.0.1e-37 is needed by mod_ssl-1:2.4.6-45.el7.centos.x86_64

PHP Library Error

The validation utility may display the following error if you have a version of PHP which is lower than the
one required by Axon.
error: Failed dependencies:php-common < 5.6 conflicts with php56w-
common-5.6.31-1.w7.x86_64

To resolve this error, uninstall the lower version of the PHP library from your system before you run the
installer.

Operating System User Accounts

The following are the Operating System user accounts that are created by third-party packages. Axon uses
these user accounts during installation.

User Name Description Home Directory User Shell

epmd Erlang Port Mapper Daemon /tmp /sbin/nologin

rabbitmq RabbitMQ messaging server /var/lib/rabbitmq /bin/bash

postgres PostgreSQL Server /var/lib/pgsql /bin/bash

memcached Memcached daemon /run/memcached /sbin/nologin

apache Apache /usr/share/httpd /sbin/nologin

30 Appendix A: Appendix