kony emm installion guide
TRANSCRIPT
-
Kony Management
Installation Guide- Linux
On-Premises
Release 4.3Document Relevance and Accuracy
This document is considered relevant to the Release stated on this title page and the document version stated on the Revision History page.
Remember to always view and download the latest document version relevant to the software release you are using.
2017 by Kony, Inc. All rights reserved 1 of 151
-
Copyright 2013 Kony, Inc.
All rights reserved.
August, 2017
This document contains information proprietary to Kony, Inc., is bound by the Kony license
agreements, andmay not be used except in the context of understanding the use andmethods of
Kony, Inc., software without prior, express, written permission. Kony, Empowering Everywhere, Kony
Nitro, and Kony Visualizer are trademarks of Kony, Inc. MobileFabric is a registered trademark of
Kony, Inc. Microsoft, theMicrosoft logo, Internet Explorer, Windows, andWindowsVista are
registered trademarks of Microsoft Corporation. Apple, the Apple logo, iTunes, iPhone, iPad, OS X,
Objective-C, Safari, Apple Pay, AppleWatch, and Xcode are trademarks or registered trademarks of
Apple, Inc. Google, the Google logo, Android, and the Android logo are registered trademarks of
Google, Inc. Chrome is a trademark of Google, Inc. BlackBerry, PlayBook, Research inMotion, and
RIM are registered trademarks of BlackBerry. SAP and SAP Business Suite are registered
trademarks of SAP SE in Germany and in several other countries. All other terms, trademarks, or
servicemarksmentioned in this document have been capitalized and are to be considered the
property of their respective owners.
Kony Management Linux Installation GuideVersion1.3
2017 by Kony, Inc. All rights reserved 2 of 151
-
Revision History
Date Document Version Description of Modifications/Release
04/10/2017 1.4 Document updated for 4.3
01/23/2017 1.3 Document updated for 4.2.5
11/07/2016 1.2 Document updated for 4.2
07/15/2016 1.1 Document updated for 4.1
02/25/2016 1.0 Document updated for 4.0
Kony Management Linux Installation GuideVersion1.3
2017 by Kony, Inc. All rights reserved 3 of 151
-
Table of Contents
1. Preface 6
1.1 Purpose 6
1.2 Intended Audience 6
1.3 Formatting Conventions 6
1.4 Contact Us 8
2. Installation Files 9
3. EMM Installation 11
4. EMM Installation Procedure 12
5. Uninstall EMM 86
6. EMM Upgrade Procedure 88
6.1 Automated Installation (single andmulti-node) 88
6.2 ManualMulti-node Installation 106
7. EMM Rollback Procedure 113
7.1 Single node Rollback 113
7.2 Multi-node Rollback 124
8. Post Installation Tasks 126
8.1 Start Services 126
8.2 Start services for Multinode 126
8.3 Database Changes (MySQL database) 126
8.4 Tomcat Services 128
Kony Management Linux Installation GuideVersion1.3
2017 by Kony, Inc. All rights reserved 4 of 151
-
8.5 WindowsMobile 6.x 129
8.6 Troubleshooting ADS Integration 137
8.7 TroubleshootingMac Issues 139
8.8 Other Tasks 140
8.9 How to Reset a User Account Password for Network Device Enrollment Service
(NDES) 141
8.10 How to encrypt an NDES User Account Password 142
8.11 How to encrypt Database Password (EMMOn-Premise build) 144
9. Post Upgrade Tasks 146
9.1 Upgrading Launchpad Details 146
9.2 Updating Tomcat Configuration 147
9.3 Replacing Apache Files 148
9.4 Updating Apache Files 148
10. Frequently Asked Questions 150
Kony Management Linux Installation GuideVersion1.3
2017 by Kony, Inc. All rights reserved 5 of 151
-
1. Preface Kony Management Linux Installation GuideVersion1.3
1. Preface
EnterpriseMobilityManagement (EMM) software is a policy configuration andmanagement tool for
hand-heldmobile devices and corresponding applications on smartphones and tablets. EMMhelps
enterprises tomanage complex communications betweenmobile devices by supporting security,
network services, and software and hardwaremanagement acrossmultiple OS platforms.
EMMalso supports bring your own device (BYOD) initiatives that has become the focus of many
enterprises. It can support corporate and personal devices, and helps to support a more complex and
heterogeneous environment. EMMsupportsMobile Content Management.
The Preinstallation Guide provides a list of resources that are to be kept ready prior to installation.
Having these in place ensures a smooth installation process and easy deployment of Kony EMM.
Details of installation of third-party software required shall not be provided in the document. Where
ever applicable, links to appropriate resources are provided.
Some elements described in this guide will be configured / consumed after successful installation and
start-up.
1.1 Purpose
This document provides detailed instructions on Kony EMMLinux installation. Installation, upgrade
and, rollback procedures are explained in this document.
1.2 Intended Audience
This document is intended for engineers or system administrators who will install and configure Kony
EMMConsole and Kony Enterprise Store. We assume that the reader of this document is familiar with
deploying Linux software (RHEL 6.6, OEL, Centos 6.X and, Ubuntu) and installing a database on
Linux Enterprise servers.
1.3 Formatting Conventions
The following formatting conventions are used throughout the document:
2017 by Kony, Inc. All rights reserved 6 of 151
-
1. Preface Kony Management Linux Installation GuideVersion1.3
Conventions Explanation
Monospace l User input text, system prompts and responses
l File path
l Commands
l Program code
l File names
Italic l Emphasis
l Names of books and documents
l New terminology
Bold l Windows
l Menus
l Buttons
l Icons
l Fields
l Tabs
l Folders
URL Active link to a URL.
Note Provides helpful hints or additional information.
Important Highlights actions or information that might cause problems to systems or data.
2017 by Kony, Inc. All rights reserved 7 of 151
-
1. Preface Kony Management Linux Installation GuideVersion1.3
1.4 Contact Us
Wewelcome your feedback on our documentation.Write to us at [email protected]. For technical
questions, suggestions, comments, or to report problems on Kony's product line, contact
2017 by Kony, Inc. All rights reserved 8 of 151
mailto:[email protected]?subject=Documentation Feedbackmailto:[email protected]
-
2. Installation Files Kony Management Linux Installation GuideVersion1.3
2. Installation Files
All installation files can be found at the community Portal:
http://community.kony.com/downloads/manual
Navigate to the KonyManagement section and click on the specific release related files you want to
download. For example, if you want to download KonyManagement 3.0, click on the Kony v3.0 GA
tab.
You can download EMM installer from the developer portal and obtain license from your sales
representative or partner.
Kony EMM
Installer for
Linux
Kony Management Suite software for installing on a Linux based computer.
Kony EMM
Installer for
Windows
Kony Management Suite software for installing on aWindows computer.
Exchange
Security
Services
Installer
Kony Exchange Service helps EMM server to control emails (block/unblock) on
end user's enrolled devices. Kony Exchange Servicemust be installed on a
Windows machine that supports Powershell remoting.
Windows
Mobile 6.x
Services
Installer
Windows Mobile 6.x Services help EMM server manageWindows Mobile 6.x
devices.
Group Policy
Management
Installer
Group Policy Management service helps EMM server manage policies for
Windows Mobile 6.x devices.
2017 by Kony, Inc. All rights reserved 9 of 151
http://community.kony.com/downloads/manual
-
2. Installation Files Kony Management Linux Installation GuideVersion1.3
Kony EMM
API Library
Kony EMM API Library comprises KonyEMM JS-SDK APIs, these are non-GUI
APIs that you can use on Kony Studio These APIs allow developers to build in
security into the apps by invoking several EMM policies and actions at form level.
Windows
SCEP
Installer
EMMWindows Components installer helps install the followingWindows
components together, Standalone CA Role, NDES(SCEP service), Exchange
Security Services, Group Policy Management.
Important: Go through the Pre-installation guide before you start the installation process. The pre-
installation guide also contains Hardware requirements and Software requirements.
2017 by Kony, Inc. All rights reserved 10 of 151
-
3. EMM Installation Kony Management Linux Installation GuideVersion1.3
3. EMM Installation
If you are installingmore than one instance of the Tomcat server on a computer, ensure to use an
appropriate naming convention for defining each instance. For example, as suggested, the first
instance is named as instance 1, second as instance 2, third as instance 3, and so on. Ensure that all
files and related applications configured for the Tomcat instance follow the same naming convention.
In this document, we use the sequential numbering convention. Youmay use own naming convention,
but ensure that the instance names are unique and their respective configurations are set
appropriately.
2017 by Kony, Inc. All rights reserved 11 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
4. EMM Installation Procedure
This section explains the installation procedure on a Linux platform.
Prerequisites
l You can download the EMM Installer from http://community.kony.com/downloads/manual with
your credentials.
l Ensure KonyEMM.bin file has execute permission.
l Ensure that the folder in which the executable .bin file is there does not contain any
installer.properties file.
To install the EMM application through an interactive mode, follow these steps:
1. Execute theKonyEMM-.GA.bin file as a root user. The files
required for the EMMConsole installation are extracted.
[root@emm builds]]$ ./KonyEMM-.GA.bin
Preparing to install...
Extracting the installation resources from the installer
archive...
Configuring the installer for this system's environment...
Launching installer...
=================================================================
=======
KonyEMM (created with
InstallAnywhere)
------------------------------------------------------------------
2017 by Kony, Inc. All rights reserved 12 of 151
http://community.kony.com/downloads/manual
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
------
Preparing CONSOLE Mode Installation...
=================================================================
=======
=================================================================
=======
Introduction
------------
InstallAnywhere will guide you through the installation of KonyEMM
It is strongly recommended that you quit all programs before
continuing with
this installation.
2017 by Kony, Inc. All rights reserved 13 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
It is also recommended that you install this on a server with at
least 4GB RAM.
Self-signed certificates are not allowed.
Respond to each prompt to proceed to the next step in the
installation. If you
want to change something on a previous step, type 'back'.
You may cancel this installation at any time by typing 'quit'.
PRESS TO CONTINUE:
2. Press Enter. The Software License Agreement details appear.
=================================================================
=======
License Agreement
-----------------
Installation and Use of KonyEMM Requires Acceptance of the
Following License
Agreement:
2017 by Kony, Inc. All rights reserved 14 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
KONY, INC.
SOFTWARE LICENSE AGREEMENT
THE TERMS AND CONDITIONS CONTAINED HEREIN CONSTITUTE A LEGAL
AGREEMENT.
THIS AGREEMENT ("AGREEMENT") CONTAINS THE ENTIRE AGREEMENT BETWEEN
YOU
("LICENSEE") AND KONY, INC. ("KONY") WITH RESPECT TO THE TERMS AND
CONDITIONS
DESCRIBED HEREIN. READ THIS AGREEMENT CAREFULLY BEFORE YOU CLICK
THE "I ACCEPT"
BUTTON BELOW. BY CLICKING ON THE "I ACCEPT" BUTTON, YOU
ACKNOWLEDGE THAT (1)
YOU ARE AUTHORIZED TO ENTER THIS AGREEMENT FOR AND ON BEHALF OF
YOUR COMPANY,
AND ARE DOING SO, AND (2) YOU HAVE READ, UNDERSTOOD, AND AGREE
THAT YOU AND THE
COMPANY SHALL BE BOUND BY THESE TERMS AND CONDITIONS AND ALL
MODIFICATIONS AND
ADDITIONS PROVIDED FOR. IF YOU DO NOT AGREE WITH THESE TERMS AND
CONDITIONS,
CLICK ON THE "I DO NOT ACCEPT" BUTTON BELOW AND INSTALLATION WILL
TERMINATE.
Software products included with this product that are not Kony
products are
2017 by Kony, Inc. All rights reserved 15 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
licensed to you by the software provider. Please refer to the
license contained
in the provider's product for the terms of use before using such
products.
1. License Grant. Kony grants you a limited, non-exclusive, non-
transferable
license to use, for developmental purposes only, the Kony software
program(s),
known as the KonyTM Platform (the "Software") and related product
documentation
at no charge subject to the terms and restrictions set forth in
this License
PRESS TO CONTINUE:
----------------- License Agreement Truncated -----------------
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):
Note: If you are usingMAMOnly or Store Only license, then you cannot use SCEP
services.
3. Press Y to accept the agreement. The installer tries to find any previously installed license. If the
installer does not find any license, it will provide the following options:
=================================================================
=======
License not found
-----------------
2017 by Kony, Inc. All rights reserved 16 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
No existing license found.
->1- Provide License file path
2- Abort Installation
ENTER THE NUMBER OF THE DESIRED CHOICE, OR
PRESS TO ACCEPT THE
DEFAULT:
4. Press Enter or type 1 to provide license information. The installer prompts for the customer
details as follows:
=================================================================
=======
Customer Information
--------------------
EMM License File (.lic)* (DEFAULT: ):
Title (DEFAULT: ):
First Name* (DEFAULT: ):
Last Name* (DEFAULT: ):
Email (DEFAULT: ):
Company* (DEFAULT: ):
5. A warning information appears to perform prerequisite steps before continuing. To perform
prerequisite steps, see EMMPre-Install Guide.
2017 by Kony, Inc. All rights reserved 17 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=================================================================
=======
Prerequisites
--------------
Please read the Pre-Install Guide to ensure that all the
prerequisites have been met.
->1- Continue with Installation
2- Abort Installation
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS TO ACCEPT
THE
DEFAULT:
6. To continue the installation, type 1. Or type 2 to abort and perform prerequisites. A warning
messagemight appear to disable the Iptables.
=================================================================
=======
New Installation or Upgrade
---------------------------
Provide empty folders for a New Installation. Do not attempt to do
a New
Installation in the same location as an existing installation of
EMM.
For an upgrade process ensure you provide the same details as the
initial
installation.
2017 by Kony, Inc. All rights reserved 18 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
->1- New Installation
2- Upgrade
3- Rollback
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
7. In the New Installation or Upgrade section, select Option 1, the following options appear.
l A warningmessagemight appear only when the Iptables is enabled.
=============================================================
===========
Warning - Iptables is enabled
-----------------------------
It is highly recommended to disable iptables to successfully
run EMM.
->1- Continue with Installation
2- Abort Installation
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS TO
ACCEPT THE
DEFAULT:
8. To continue the installation type 1 or type 2 to abort and disable the Iptables. The installer
prompts for the installation path as follows:
2017 by Kony, Inc. All rights reserved 19 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=================================================================
=======
Choose Install Folder
---------------------
NOTE: Please make sure that Install Folder does not have any
spaces.
Where would you like to install?
Default Install Folder: /home/user1/KonyEMM
ENTER AN ABSOLUTE PATH, OR PRESS TO ACCEPT THE DEFAULT
:
9. The folder path provided here is considered as the installation folder. All other subsequent
elements are installed within this folder.
Note: Remember this path as it may be needed in some steps of the installation process.
To continue with the default path, press Enter or type the path. The installer displays a warning
message to create a new folder as follows:
2017 by Kony, Inc. All rights reserved 20 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=================================================================
=======
Warning - Folder does not exist
-------------------------------
/home/user1/KonyEMM folder is not available, do you want to create
this
folder?
Choose appropriate option to proceed.
->1- Continue to create this folder
2- Go back to provide install folder again
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS TO ACCEPT
THE
DEFAULT:
10. To create the folder, press Enter or type 2 to set another path. The installer prompts for the
Tomcat Server Configuration Details as follows:
=================================================================
=======
Tomcat Server Configuration Details
2017 by Kony, Inc. All rights reserved 21 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
-----------------------------------
Press to retain default values.
Tomcat HTTP Port (DEFAULT: 8080):
Tomcat Shutdown Port (DEFAULT: 8005):
Tomcat HTTPS Port (DEFAULT: 8443):
11. Press Enter to set the default ports or type your desired port numbers. The installer prompts for
the JVM Details as follows:
=================================================================
=======
JVM Memory
-------------------
It is recommended to use a minimum of 2048 MB of Memory for ideal
performance.
JVM Maximum Memory (DEFAULT: 2048):
JVM Minimum Memory (DEFAULT: 2048):
2017 by Kony, Inc. All rights reserved 22 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
12. Press Enter to set the default ports or type your desired port numbers. The installer prompts for
the Apache Port Details as follows:
=================================================================
=======
Apache Port Details
-------------------
Apache HTTP Port (DEFAULT: 80):
Apache HTTPS Port (DEFAULT: 443):
13. In the Connection Details section, provide the host name or URL and host IP address.
=================================================================
=======
Connection Details
------------------
Provide hostname (ex: manage.domain.com) which is mapped to the
frontend server and System Private IP address of the server EMM is
being installed on.
2017 by Kony, Inc. All rights reserved 23 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
NOTE: Don't use localhost,
127.0.0.1, 0.0.0.0 for IP Address
Frontend Host name (DEFAULT: ):
Frontend HTTPS Port(DEFAULT: 443):
Local System Private IP address (DEFAULT: ):
Note: Frontend HTTPS Port (Default: 443): should be the same as Apache HTTPS port
number.
Enter the following file details:
l Host name URL: Ensure to add your domain URL. For example,
test.konylabs.net
Note: If you want to incorporate Load Balancer on EMM, provide your Load Balancer
domain name in the Host nameURL.
l IP address: Provide the private IPaddress of the EMM installation box (instance). The
application server, memcache, webserver and other third-party servers communicate
with the EMMserver through this private IP. For example, 10.10.4.6
14. Press Enter to set the default ports or type your desired port numbers. The installer prompts for
Apple server configuration as follows:
=================================================================
=======
Apple server configuration
--------------------------
2017 by Kony, Inc. All rights reserved 24 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Do you want to enable iOS app wrapping?
You can configure upto 4 MAC servers for iOS wrapping.
->1- yes
2- no
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
Note: If you selected 1, only then the SCEP server section appears after Get User Input .
You can configure SCEP server at SCEP Configuration.
15. Press Enter to provide Apple server details. Type 2 if iOS wrapping is not required.
a. The installer prompts for Apple server #1 details:
=============================================================
======
Apple server #1 details
-----------------------
Enter Details for Apple server used for iOS (iPhone, iPad)
app wrapping.
2017 by Kony, Inc. All rights reserved 25 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
NOTE: Press to retain default values.
Host (DEFAULT: ):
Port (DEFAULT: 22):
Username (DEFAULT: ):
b. Enter the host IP address, port number, and user name. The installer prompts for
password or .pem key as follows:
=============================================================
=======
Password or .pem key
--------------------
What do you have ?
->1- Password
2- .pem key
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT
THE DEFAULT::
2017 by Kony, Inc. All rights reserved 26 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
c. Press Enter to provide password or type 2 for .pem key path.
l If you press Enter, then provide the password that is set on theMacmachine:
=========================================================
======
Enter Password
--------------
Please Enter the Password for :
l If you type 2, then provide the .pem file path:
=========================================================
=====
Enter.pem key path
-------------------
Provide .pem key file full path (DEFAULT: ):
d. The installer prompts if you like to configure next iOS server. Type 1 to continue
configuring next iOS server, or type 2 tomove to the next step.
=============================================================
======
2nd Apple server configuration
2017 by Kony, Inc. All rights reserved 27 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
------------------------------
Do you want to configure one more Apple server?
->1- yes
2- no
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT
THE DEFAULT:: 2
16. Press Enter to set the default ports or type your desired port numbers. The installer prompts for
Windows Wrapping Server Configuration as follows:
=================================================================
=======
Windows Wrapping Server Configuration
--------------------------
Do you want to enable windows app wrapping?
2017 by Kony, Inc. All rights reserved 28 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
You can configure upto 4 Windows servers for windows app wrapping.
->1- yes
2- no
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
1. Press Enter to provideWindows server details. Type 2 if Windows app wrapping is not
required.
a. The installer prompts for Windows server #1 details:
=========================================================
==========
Windows server #1 details
-----------------------
Enter Details for Windows server used for windows app
wrapping.
NOTE: Press to retain default values.
Host (DEFAULT: ):
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
10.10.10.111>
Port (DEFAULT: 22):
Username (DEFAULT: ):
b. Enter the host IP address, port number, and user name. The installer prompts for
password or .pem key as follows:
=========================================================
===========
Password or .pem key
--------------------
What do you have ?
->1- Password
2- .pem key
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO
ACCEPT THE DEFAULT::
c. Press Enter to provide password or type 2 for .pem key path.
l If you press Enter, then provide the password that is set on theWindows
machine:
2017 by Kony, Inc. All rights reserved 30 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
====================================================
===========
Enter Password
--------------
Please Enter the Password for :
Validating PreRequisites on WIndows 8.1 Machine..
Please Enter the Password for :
l If you type 2, then provide the .pem file path:
====================================================
==========
Enter.pem key path
-------------------
Provide .pem key file full path (DEFAULT: ):
d. The installer prompts if you like to configure nextWindows server. Type 1 to
continue configuring nextWindows server, or type 2 tomove to the next step.
=========================================================
==========
2nd Windows server configuration
------------------------------
2017 by Kony, Inc. All rights reserved 31 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Do you want to configure one more Windows server?
->1- yes
2- no
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO
ACCEPT THE DEFAULT:: 2
17. If you wish to support Android, then following configuration ismandatory. In the Get User Input
section, press Enter to enable or type 2 to disable android wrapping.
=================================================================
=======
Get User Input
--------------
Do you want to enable android wrapping?
2017 by Kony, Inc. All rights reserved 32 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
->1- yes
2- no
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
18. In the SCEP Configuration section, press Enter to configure SCEP or type 2 to not configure
SCEP.
=================================================================
=======
SCEP Configuration
------------------
Do you want to configure SCEP ?
NOTE: If you choose not to configure SCEP, EMM will not support
iOS Devices and
Android Devices.
->1- Yes
2- No
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
19. If you have selected the option 1 in then, enter the following details for SCEP:
l All the certificates required by iOS for enrollment and Android devices for secure
communication between the child apps (SCEP Certificate) are distributed through SCEP
server at the time of enrollment. Provide the details of the SCEPserver, installed as per
instructions in the Kony EMMPre-Install Guide.
2017 by Kony, Inc. All rights reserved 33 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Important: If you choose not to configure SCEP, EMMwill not support iOS Devices.
On Android devices,SCEP (Two-WaySSL) will not be supported.
Note: If you are usingMAMOnly or Store Only license, then you cannot use SCEP
services.
=============================================================
=
Simple Certificate Enrollment Protocol (SCEP) Configuration
-----------------------------------------------------------
Enter SCEP details below.
NOTE: Press to retain default values.
SCEP Server URL (DEFAULT: ):
SCEP Keysize (DEFAULT: 2048):
SCEP Common Name (DEFAULT: ):
SCEP CA Instance Name (DEFAULT: ):
SCEP CHALLENGE URL (DEFAULT: ):
2017 by Kony, Inc. All rights reserved 34 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
SCEP CA DOMAIN (OPTIONAL: (DEFAULT: ):
SCEP CA USERNAME (DEFAULT: ): administrator
=============================================================
=
Enter Password
--------------
SCEP CA PASSWORD:
Provide the following details:
Note: SCEP CA user namemust not contain domain name. Provide only the user
name.
l SCEP Server URL: SCEP Service URL
l SCEP Keysize: RSA key size in bits either 1024 or 2048. Choosing the default
option will set to 2048.
l SCEP Common Name: Representation of X.500 name for example, O=Company
Name,CN=Foo.
l SCEP CA Instance Name: Certificate authority name used in SCEP installation.
l SCEP CHALLENGE URL: Pre-shared secret for automatic enrollment.
2017 by Kony, Inc. All rights reserved 35 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
l SCEP CA DOMAIN: Domain name of the user account used while installing
SCEP.
l SCEP CA USERNAME: Account user name used while installing SCEP service.
l SCEP CA PASSWORD: Password of the user account.
20. In the EMM configuration path section, provide android-sdk-linux folder path.The path you
define here is used to store all dynamic content created in the EMMapplication such as app
details and certificates of the respective device platform. And also installer copies SSL certs,
vendorsigningcert, and Android wrapping scripts.
=================================================================
=======
EMM Configuration Path
----------------------
Note: Please ensure that you have android-sdk-linux inside this
directory.
EMM Configuration directory (DEFAULT: ): for example, /data/
Note: If you do not provide support to Android devices, you can create a new folder to store
EMMconfigurations.
21. Press Enter to use the default path. The path defined here is used to store static data of the
EMM that includes certificates, binaries of the Kony EMMAgent and enterprise apps, images
2017 by Kony, Inc. All rights reserved 36 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
for branding andapp category. This is central to the functioning of EMM. In the Docroot path
section, provide docroot sub folder path from themain installation folder. For example, default
path is /home/user1/KonyEMM/docroot.
The docroot or docbase is the storage location which EMMuses to store all admin or user
uploaded content. For on-premises installations, the docroot is a hard-mounted location within
the application server; a local file-system or an SAN mounted device. The docroot can be
hosted on an Amazon Simple Storage Service.
The docroot comprises of four separate directories for the EMMmodules: Store, MAM,MDM,
MCM,MDM., and emm_common.
For local file systems, Static resources like screenshots or header images or icons are navigable
if one is familiar with directory structure and the generated filenames. There are no access
regulations. Access to secure assets like binaries are restricted via apache through secure
URLs over web. Ensure that unintended users do not have filesystem read/write permissions.
Access to critical assets like certificates are completely blocked. Theymay only be accessed
internally and never by a client.
For Amazon Simple Storage Service file systems, access to static resources is through static
URLswhich are available publicly. For secure assets (for example, binaries), access is
restricted through secure URLs generated with an expiry schedule. Links to critical assets like
certificates are never generated. Links are used internally through secure Amazon APIs.
=================================================================
=======
Docroot Path
------------
NOTE: Press to retain default values.
2017 by Kony, Inc. All rights reserved 37 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Docroot directory (DEFAULT: /home/user1/KonyEMM/docroot):
22. Press Enter to use the default path.
=================================================================
=======
SSL Configuration
-----------------
SSL certificates are used for secure communication between the
device and EMM server. Usually, SSL certificates are installed on
Load balancer. SSL certificates must be procured from trusted
Certificate Authorities, GoDaddy or VeriSign. You can configure
end to end SSL from device to App server. For SSL communication
between Load balancer and Web server, Web server and App server,
you can also use self signed SSL certificates. Load balancer SSL
certificates, including private key should be provided to the EMM
Server during installation. A check is performed on iOS devices to
ensure no tampering has been done. For iOS devices, EMM server
sends payload (enrollment or policy push) along with a message
digest. Private key is used to encrypt the message digest creating
a digitally signed message digest. This is sent along with the
payload to the device. At the device end, the device in-built MDM
agent uses the payload to create the message digest. Using its
public key, it decrypts the digitally signed message digest sent
by the server and compares these two. If the message digest is not
2017 by Kony, Inc. All rights reserved 38 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
signed with a private key, a Not verified message displays on the
device.
Where do you want to terminate HTTPS?
->1- HTTPS at Load Balancer
2- HTTPS at Apache
3- HTTPS for every layer (Load Balancer, Apache and Tomcat)
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
23. According to the option that you select, the following options appear:
Note: Load balancer SSL certificates, including private key should be provided to the EMM
Server during installation. A check is performed on iOS devices to ensure no tampering has
been done.For iOS devices, EMM server sends payload (enrollment or policy push) along
with amessage digest. Private key is used to encrypt themessage digest creating a digitally
signedmessage digest. This is sent along with the payload to the device. At the device end,
the device in-built MDMagent uses the payload to create themessage digest. Using its
public key, it decrypts the digitally signedmessage digest sent by the server and compares
these two. If themessage digest is not signed with a private key, a Not verifiedmessage
displays on the device.
l If you select option 1 (HTTPS at Load Balancer),
a. Enter the certificate details.
2017 by Kony, Inc. All rights reserved 39 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=========================================================
======================
Load Balancer Certificates
--------------------------
Please provide the full path to SSL certificates.
NOTE: Self-signed certificates are not allowed for
apache.
SSL certificate file (DEFAULT: ):
/downloads/CertificatesKony.com/platform.kony.com.crt
SSL certificate key file (DEFAULT: ):
/downloads/CertificatesKony.com/platform.kony.com.key
SSL certificate chain file (DEFAULT: ):
/downloads/CertificatesKony.com/gd_bundle.crt
ss
b. Proceed to step 20.
l If you select option 2(HTTPS at Apache),
2017 by Kony, Inc. All rights reserved 40 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
a. Enter Load Balancer details
=========================================================
======================LoadBalancer------------Will you be
using a LoadBalancer?->1-Yes 2- NoENTER THE NUMBER FOR
YOUR CHOICE, OR PRESS TO ACCEPT THE DEFAULT:: 1
b. Press Enter or 1. The following details appear. Provide Load Balancer SSL
certificate details.
=========================================================
======================LB SSL Certs------------Please
provide the full path to LoadBalancer SSL certificates.
These Frontendcerts are required for iOS profile signing.
SSL certificate file (DEFAULT: ): /data/certs/ssl_cert_
file.pem
SSL certificate key file (DEFAULT: ): /data/certs/ssl_
cert_key_file.key
SSL certificate chain file (DEFAULT: ): /data/certs/ssl_
cert_chain_file.crt
c. After you enter certificate paths, press Enter. Following details appear.
=========================================================
======================
Apache SSL Configuration
------------------------
Please provide the full path to SSL certificates.
2017 by Kony, Inc. All rights reserved 41 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
NOTE: Self-signed certificates are not allowed for
apache.
SSL certificate file (DEFAULT: ):
/downloads/CertificatesKony.com/platform.kony.com.crt
SSL certificate key file (DEFAULT: ):
/downloads/CertificatesKony.com/platform.kony.com.key
SSL certificate chain file (DEFAULT: ):
/downloads/CertificatesKony.com/gd_bundle.crt
d. Proceed to step 20.
l If you have selected option 3 (HTTPS for every layer (Load Balancer, Apache and
Tomcat)), the following options appear.
a. Enter Load Balancer details
==========================================================
=====================LoadBalancer------------Will you be
using a
LoadBalancer?
->1- yes
2- no
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO
ACCEPT THE DEFAULT:: 1
2017 by Kony, Inc. All rights reserved 42 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
b. Press Enter or 1. The following details appear. Enter Load Balancer SSL
certificate details.
=========================================================
======================LB SSL Certs------------ Please
provide the full path to LoadBalancer SSL certificates.
These Frontendcerts are required for iOS profile
signing. SSL certificate file (DEFAULT: ):
/data/certs/ssl_cert_file.pem SSL certificate key file
(DEFAULT: ): /data/certs/ssl_cert_key_file.key SSL
certificate chain file (DEFAULT: ): /data/certs/ssl_cert_
chain_file.crt
c. Once you have provided the paths, press Enter. The following details appear. Use
the SSL details created asmentioned in the Pre-Install Guide. This system does
not function with self signed SSL certificates.
Note: Ensure to provide appropriate certificate details.
d. In the SSL configuration section, provide the SSL certificate files path as follows:
==========================================================
==============
Apache SSL configuration
-----------------
It is mandatory to configure SSL on Apache.
Please provide the full path to SSL certificates.
2017 by Kony, Inc. All rights reserved 43 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
NOTE: Self-signed certificates are not allowed for apache.
SSL certificate file (DEFAULT: ):
SSL certificate key file (DEFAULT: ):
SSL certificate chain file (DEFAULT: ):
e. Enter the following file paths:
l SSL certificate file: Provide the file path. For example, /home/user1/ssl_
cert_file.pemSSL certificate key file:
l Provide the file path: For example, /home/user1/ssl_cert_key_file.key
l SSL certificate chain file: Provide the file path. For example,
/home/user1/ssl_cert_chain_file.crt
f. The following SSL configuration section appears.
=========================================================
==========SSL configuration-----------------Do you want
to use same SSL for tomcat also?->1- yes 2- noENTER
THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT
THE DEFAULT::
o If you select option:1, then enter the key store password you wish to use for tomcat.
The option will use the same SSL certificates for Tomcat. The installer will combine
the all three Apache SSL certificates into a single JKS keystore to be used by
Tomcat. The password entered here will be assigned to that JKS keystore.
2017 by Kony, Inc. All rights reserved 44 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=========================================================
=====
Enter Password
--------------
Destination Keystore Password
o If you select option: 2, the following option appears. Enter Tomcat SSL
Certificates.
=========================================================
=====
Tomcat SSL Configuration
------------------------
Please select appropriate option to proceed with
installation.
->1- Provide SSL Certificates
2- Create Self-Signed Certificates from Installer
2017 by Kony, Inc. All rights reserved 45 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO
ACCEPT THE DEFAULT::
i. If you select option 1, the following option appears:
====================================================
=====
Tomcat SSL configuration
------------------------
SSL certificate file (DEFAULT: ):
SSL certificate type (DEFAULT: JKS):
====================================================
=====
Enter Password
2017 by Kony, Inc. All rights reserved 46 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
--------------
SSL certificate Password:
ii. If you select option 2, the following option appears:
====================================================
=====
Tomcat SSL configuration
------------------------
Please provide below information to create Self-
signed certificates from
installer.
Organizational Unit (DEFAULT: ):
Company (DEFAULT: ):
2017 by Kony, Inc. All rights reserved 47 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
City (DEFAULT: ):
State (DEFAULT: ):
Country (DEFAULT: ):
====================================================
=====
Enter Password
--------------
SSL certificate Password:
24. The Proxy Server Details option appears. If you like to configure HTTP Proxy server, select an
appropriate option.
=================================================================
=======
Proxy Server Details
for Android
--------------------------------
Do you wish to configure a HTTP proxy server for Android push
notifications?
2017 by Kony, Inc. All rights reserved 48 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
->1- yes
2- no
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
a. If you select option 1, the HTTP Proxy Authentication option appears:
=============================================================
======
HTTP Proxy Authentication Choice
--------------------------------
Please select appropriate option to proceed.
->1- With Authentication
2- Without Authentication
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT
THE DEFAULT::
2017 by Kony, Inc. All rights reserved 49 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
l If you select option 1, the HTTP proxy server for Android push notifications option
appears:
=========================================================
=====
HTTP proxy server for Android push notifications
------------------------------------------------
Please Provide HTTP Proxy Server Details.
Hostname/IP Address (DEFAULT: ):
Port (DEFAULT: ):
Username (DEFAULT: ):
=========================================================
=====
Enter Password
--------------
2017 by Kony, Inc. All rights reserved 50 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Please Enter the Password for user kony:
l If you select option 2, the HTTP proxy server for Android push notifications option
appears:
=========================================================
=====
HTTP proxy server for Android push notifications
------------------------------------------------
Please Provide HTTP Proxy Server Details.
Hostname/IP Address (DEFAULT: ):
Port (DEFAULT: ):
25. The Proxy Server Details option appears. If you like to configure SOCKS Proxy server, select
an appropriate option.
=================================================================
=======
SOCKS Proxy Server Details
for Apple
--------------------------------------
2017 by Kony, Inc. All rights reserved 51 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Do you wish to configure a SOCKS proxy server for Apple push
notifications?
->1- yes
2- no
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
a. If you select option 1, the SOCKS Proxy Authentication option appears:
=============================================================
======
SOCKS Proxy Authentication Choice
--------------------------------
Please select appropriate option to proceed.
->1- With Authentication
2- Without Authentication
2017 by Kony, Inc. All rights reserved 52 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT
THE DEFAULT::
l If you select option 1, the SOCKS proxy server for Apple push notifications option
appears:
=========================================================
=====
SOCKS proxy server for Apple push notifications
------------------------------------------------
Please Provide SOCKS Proxy Server Details.
Hostname/IP Address (DEFAULT: ):
Port (DEFAULT: ):
Username (DEFAULT: ):
=========================================================
=====
Enter Password
2017 by Kony, Inc. All rights reserved 53 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
--------------
Please Enter the Password for user kony:
l If you select option 2, the SOCKS proxy server for Apple push notifications option
appears:
=========================================================
=====
SOCKS proxy server for Apple push notifications
------------------------------------------------
Please Provide SOCKS Proxy Server Details.
Hostname/IP Address (DEFAULT: ):
Port (DEFAULT: ):
26. In theMemcache Server Details section, press Enter to continue with default port or type your
desired port number.
=================================================================
======
Memcache Server Details
2017 by Kony, Inc. All rights reserved 54 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
-----------------------
NOTE: Press to retain default values.
memcache Port (DEFAULT: 11211):
27. In the Database server type section, type one of the options of your choice.
=================================================================
=======
Database server type
--------------------
Choose the database server type
->1- MySQL
2- MSSQL
3- Oracle
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
2017 by Kony, Inc. All rights reserved 55 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Note: Click on the database server type you want to configure to go to that section. MySQL,
MSSQL, Oracle.
28. In the Database server details section, provide database server details.
for MySQL:
=================================================================
=======
Database server details: MySQL
------------------------------
Please ensure the DB user has permissions to create/alter/delete
schemas.
NOTE: Press to retain default values.
Hostname or IP address (DEFAULT: localhost):
Port (DEFAULT: 3306):
Database Name (DEFAULT: konyemmmaster):
2017 by Kony, Inc. All rights reserved 56 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Username (DEFAULT: ):
=================================================================
=======
Enter Password
--------------
Please Enter the Password for dbclient:
Enter the following details:
l Hostname or IP address: Enter the host name used while creating the database user.
By default, it is set as localhost.
l Port: By default, it is set as 3306.
l Database Name: By default, it is set as konyemmmaster. konyemmmaster was created
when you performed pre-installation steps. For more information, see EMMPre-install
Guide.
l Username: Enter the user name used while creating the database user. For example,
dbclient.
l Password: Enter the database password used while creating the database user.
Note: Click here to proceed to next step.
2017 by Kony, Inc. All rights reserved 57 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
for MSSQL
=================================================================
==============
Database server details: MSSQL
------------------------------
Please ensure the DB user has permissions to create/alter/delete
schemas.
NOTE: Press to retain default values.
Hostname or IP address (DEFAULT: ):
Port (DEFAULT: 1433):
Database Name (DEFAULT: emmdb):
Username (DEFAULT: ):
2017 by Kony, Inc. All rights reserved 58 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=================================================================
==============
Enter Password
--------------
Please Enter the Password for (Username):
Enter the following details:
l Hostname or IP address: Enter the host name used while creating the database user.
By default, it is set as localhost.
l Port: By default, it is set as 1433.
l Database Name: By default, it is set as konyemmmaster. konyemmmaster was created
when you performed pre-installation steps. For more information, see EMMPre-install
Guide.
l Username: Enter the user name used while creating the database user. For example,
dbclient.
l Password: Enter the database password used while creating the database user.
Note: Click here to proceed to next step.
for Oracle
2017 by Kony, Inc. All rights reserved 59 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
==================================================
=============================
Database server details: Oracle
-------------------------------
Please ensure the DB user has permissions to
create/alter/delete schemas.
NOTE: Press to retain default values.
Hostname or IP address (DEFAULT: ):
Port (DEFAULT: 1521):
Service ID (DEFAULT: konydb):
DBA Username (DEFAULT: ):
User for EMM (DEFAULT: ): emmdb1
2017 by Kony, Inc. All rights reserved 60 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=================================================================
==============
Enter Password for system
-------------------------
This installation requires a password to continue.
Please Enter the Password:
=================================================================
==============
Enter Password for emmdb1
----------------------
This installation requires a password to continue.
Please Enter the Password:
Enter the following details:
l Hostname or IP address: Enter the host name used while creating the database user.
By default, it is set as localhost.
2017 by Kony, Inc. All rights reserved 61 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
l Port: By default, it is set as 1521.
l Service ID (DEFAULT: konydb): Service ID of your Oracle database.
l DBA Username: Enter the user name used while creating the database user. For
example, dbclient.
l User for EMM (DEFAULT): This user will be created during installation.
l Password for DBA user: Enter the database password used while creating the database
user.
l Password for EMM user: This password will be used by the new user created during
instillation.
Note: If you enter incorrect details for database server or database server is not reachable,
following error message appears.
=================================================================
==============
Database server connection failed
---------------------------------
Database server connection failed.
Reason: The TCP/IP connection to the host dbhost, port 1433 has
failed. Error:
"null. Verify the connection properties. Make sure that an
instance of SQL
Server is running on the host and accepting TCP/IP connections at
the port.
2017 by Kony, Inc. All rights reserved 62 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Make sure that TCP connections to the port are not blocked by a
firewall.".
PRESS TO CONTINUE:
29. After the JDBC is connected, the following warningmessage appears with options:
Note: If a database schema is already exists, this followingmessage appears while
upgrading or installing.
=================================================================
=======
Warning - Database already exists!!!
------------------------------------
Database test already exists!!!
->1- Go back to provide database details
2- Continue to drop and create database
3- Skip without creating database
2017 by Kony, Inc. All rights reserved 63 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS TO ACCEPT
THE
DEFAULT: 2
Enter the following details:
1. Go back to provide database details: Select this option to go back to previous step.
2. Continue to drop and create database: Select this option if you are creating the
database for the first time.
3. Skip without creating database: Select this option if you do not want to disturb the exiting
database.
30. In the User Information Details section, provide the following details:
=================================================================
=======
User Information Details
------------------------
Please provide below details to access Management and Self Service
Consoles.
NOTE: Press to retain default values.
2017 by Kony, Inc. All rights reserved 64 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Username (DEFAULT: admin):
First Name (DEFAULT: ):
Last Name (DEFAULT: ):
Email ID (DEFAULT: ):
=================================================================
=======
Enter Password
--------------
Please Enter Password for admin:
=================================================================
=======
Confirm Password
----------------
2017 by Kony, Inc. All rights reserved 65 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Please Confirm your Password:
Note: Youmaywant to save your user name and password details as you will need them to
login to the EMMconsole with admin privileges.
Enter the following details:
l Username: Enter your desired EMMconsole user name. By default, it will be set as
admin.
l First Name: Enter first name of EMMadministrator.
l Last Name: Enter last name of EMMadministrator.
l Email ID: Enter email ID of EMMadministrator.
l Password: Enter your desired EMMconsole user password for the user you created.
31. In theManagement configuration section, provide the following details:
Note: GoogleMaps are essential to provide features, such as to identify device location and
geo-fences. If you wish to have these features, youmust provide an appropriate license and
client ID details.
=================================================================
=======
Management configuration
------------------------
2017 by Kony, Inc. All rights reserved 66 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Google Maps API license type.
->1- Business
2- Free
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
Choose you desired option from the following:
1. Business: Choose this option if you have business license. Provide theGoogle Client ID
and press Enter.
=============================================================
======
Management configuration
------------------------
Google Client ID (DEFAULT: ):
2. Free: Choose this option to use free license.
2017 by Kony, Inc. All rights reserved 67 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=============================================================
======
Management configuration
------------------------
Free Google Maps API key (DEFAULT: ):
32. The Service User option appears. Provide group or persons namewho runs this service
(Tomcat, Apache, andMemcached).
==============================================================
Service user
------------
Please provide user and group who will run services.
User (DEFAULT: ):
Group (DEFAULT: ):
Port Number (Default:22):
2017 by Kony, Inc. All rights reserved 68 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Note: When you createMulti-nodes, make sure that you use sameUID on both nodes.
33. Press Enter. Authentication Choice screen details display.
===================================================================
============
Authentication Choice
---------------------
Please chose an authentication Method
->1- PASSWORD
2- PEM_KEY
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT:: 2
34. Press Enter or 1.
==============================================================
Enter Password for user1-----------------------
Please Enter the Password:
35. If you enter 2, following details appear.
Note: When you createMulti-nodes, make sure that you use sameUID on both nodes.
================================================================
===============
PEM Key
-------
Please provide the following Details for Pem Key.
2017 by Kony, Inc. All rights reserved 69 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
NOTE: If your Key does not have an associated Passphrase, please
keep the field
blank and proceed.
Absolute Path of Pem Key (DEFAULT: ): /home/user1/kony.pem
Passphrase for above Pem Key(Optional) (DEFAULT: ):
36. The Add Entries in visudo option appears. Select 1 to add entries to start Apache.
==============================================================
Add Entries in visudo
---------------------
Do you want to add entries for root in visudo through installer.
These are needed to start apache.
->1- Yes
2- No
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO
ACCEPT THE DEFAULT::
37. The Context Root option appears. Provide the context root you want to use and press Enter.
=================================================================
=======
Context Root
------------
Enter the context root that you want to use
2017 by Kony, Inc. All rights reserved 70 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Context Root (DEFAULT: emm):
38. In the InstallationMode section, select one of the options as required. If you selected 1, the
installer will proceed Pre-Installation Summary.
=================================================================
=======
Installation Mode
-----------------------
Please choose installation mode.
Default : Single instance of Apache & tomcat will be installed on
current
server.
Custom : You can configure number of nodes and number of Apache &
tomcat
instances on each server.
->1- Default
2- Custom
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT:: 1
2017 by Kony, Inc. All rights reserved 71 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Note: If you want to install multi-node, select 2. The Storage Server details screen appears.
If you select 1, the following screen appears.
39. Press Enter to continue installation.
=================================================================
=======
Pre-Installation Summary
------------------------
Please Review the Following Before Continuing:
Product Name:
KonyEMM
Install Folder:
/home/user1/KonyEMM
Disk Space Information (for Installation Target):
Required: 220.5 MegaBytes
2017 by Kony, Inc. All rights reserved 72 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Available: 23,825.53 MegaBytes
PRESS TO CONTINUE:
40. In the Storage Server Details, select one of the options. Select 1 if you want to create a new
shared storage or select 2 if you already have an existing shared storage.
==============================
Storage Server Details
----------------------
Do you wish to configure Storage Server?
->1- Yes
2- No
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
41. In the Storage Server Details if you selected 1, enter the following details:
2017 by Kony, Inc. All rights reserved 73 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=================================================================
=======
Storage Server Details
----------------------
Hostname/IP Address (DEFAULT: ):
Port (DEFAULT: 22):
Storage Path (DEFAULT: ): /mnt/MULT
42. In the Enter Password, enter the following details:
=================================================================
====
Enter Password
------------------------
Please Enter the Password for root:
Testing Connection...
Validating yum...
43. In the Storage Server Details if you selected 2, enter the following details:
=================================================================
==============
Storage Server Details
----------------------
Please make sure the NFS Server is up and please provide pre-
configured NFS
Server details below.
2017 by Kony, Inc. All rights reserved 74 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Hostname/IP Address (DEFAULT: ):
Storage Path (DEFAULT: ): /opy/rh
If the preconfigured NFS server details are not valid then the following error message appears:
=================================================================
==============
Shared Storage Path
-------------------
ERROR!! /opy/rh does not exists.
Please provide a valid storage path.
->1- Go back to provide valid path.
2- Abort installation.
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS TO ACCEPT
THE
DEFAULT:
44. In the Custom Installation section, enter the following details:
2017 by Kony, Inc. All rights reserved 75 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
=================================================================
=======
Custom Installation
------------------------
Current server configuration
----------------------------------
SSH Port: 22
Please select an authentication option for root user
->1- Password
2- Pem Key
Either Password or Pem Key is mandatory
Root user Password:
Num. of Apache instances in this server: 1
Num. of Tomcat instances in this server: 1
Checking for Free Apache Ports
Checking for Free Tomcat Ports
Checking for Free Memcache Ports
Apache HTTP Port(s): 80
Apache HTTPS Port(s): 443
Tomcat HTTP Port(s): 8080
Tomcat Shutdown Port(s): 8005
Tomcat HTTPS Port(s): 8443
Memcache Port(s): 11211
2017 by Kony, Inc. All rights reserved 76 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Validating yum ....
Validation Successful!!
45. In the Remote server configuration section, enter the following details:
=================================================================
=======
Remote server configuration
------------------------
Enter remote server details below.
(Either Password or Identity file is required)
Do you want to configure another server? (Y/N): y
Host name/IP address:
SSH Port: 22
Please select an authentication option for root user:
->1- Password
2- Pem Key
Either Password or Pem Key is mandatory
Root Password:
Please select an option for Authentication of user :
->1- Password
2017 by Kony, Inc. All rights reserved 77 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
2- Pem Key
Either Password or Pem Key is mandatory
Password for user :
Please select an option to proceed:
Root user Password:
Num. of Apache instances in this server: 1
Num. of Tomcat instances in this server: 1
Connection to remove host: SUCCESS
Validating prerequisites for
Warning: SELinux is EnabledIt is highly recommended to disable
SELinux to successfully run EMM.
Press any key to continue...
Checking for Free Apache Ports
Checking for Free Tomcat Ports
Checking for Free Memcache Ports
Apache HTTP Port(s): 80
Apache HTTPS Port(s): 443
Tomcat HTTP Port(s): 8080
Tomcat Shutdown Port(s): 8005
Tomcat HTTPS Port(s): 8443
Memcache Port(s): 11211
Validating yum ....
2017 by Kony, Inc. All rights reserved 78 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Validation Successful!!
Node details successfully collected.
Do you want to configure another server? (Y/N): n
Nodes Summary-------------
Total num. of Apache HTTP servers = 2, Total num. of Tomcat
servers = 2
46. Review the details provided for installing the EMMServer. If you like to change the installation
path or any other settings, you can typeback command, if necessary to edit any configuration
elements.
Once the SCEP details are verified, the following summarymessage appears:
=================================================================
=======
Pre-Installation Summary
------------------------
Please Review the Following Before Continuing:
Product Name:
KonyEMM
2017 by Kony, Inc. All rights reserved 79 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Install Folder:
/home/user1/KonyEMM
Disk Space Information (for Installation Target):
Required: 220.5 MegaBytes
Available: 23,825.53 MegaBytes
PRESS TO CONTINUE:
47. Press Enter to complete the installation. If theapktool.sh file and other files are already
available, you will be prompted that the files already exist. You can choose the option (1 to 4) to
overwrite or to retain the existing files.
=================================================================
==============
Installing...
-------------
[==================|==================|==================|=======
===========]
[------------------|------------------|------------------|--------
2017 by Kony, Inc. All rights reserved 80 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
-
Performing multi node installation...
Creating multinode installation files... DONE
Configuring server ... DONE
Configuring ... DONE
Configuring Local Server NFS ... DONE
Configuring NFS ... DONE
----]
48. Enter the user1 password. Once the installation is complete, the following details appear:
=================================================================
=======
Install Complete
----------------
Congratulations! KonyEMM has been successfully installed to:
2017 by Kony, Inc. All rights reserved 81 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
/home/user1/KonyEMM
Apache home: /home/user1/KonyEMM/apache
Tomcat home: /home/user1/KonyEMM/apache-tomcat-7.0.42
To start and stop Memcache
Navigate to /home/user1/KonyEMM/memcache and Run
./memcache.sh start
./memcache.sh stop
To Start and Stop Apache :
Navigate to /home/user1/KonyEMM/apache/bin and Run
2017 by Kony, Inc. All rights reserved 82 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
sudo ./apachectl start
sudo ./apachectl stop
To Start and Stop Tomcat :
Navigate to /home/user1/KonyEMM/apache-tomcat-7.0.42/bin and Run
./startup.sh
./shutdown.sh
PRESS TO CONTINUE:
Note: We recommend to note the details on the screen.
49. Press Enter to remove the sudo entries. The following Start Services message appears:
=================================================================
=======
Start Services
--------------
2017 by Kony, Inc. All rights reserved 83 of 151
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
Do you want to start services?
->1- Yes
2- No
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS TO ACCEPT
THE
DEFAULT:
50. Youmay choose to start the web servers, app servers andmemcache automatically or choose
to do it manually later. Instructions to do it manually are provided in the previous screen.
Press Enter to start the services. The List of URLs are displayed:
=================================================================
=======
List of URLs
------------
Please use the following URLs to access Management and Self
Service Consoles
respectively
Management Console : for example, https://
-
4. EMM Installation Procedure Kony Management Linux Installation GuideVersion1.3
URL>/emm/mgmt/login
Self Service Console : for example,https:///emm/login
Kindly logout and login again or run below command to update your
PATH
variable.
source ~/.bashrc
Warning: If you won't run this command, then android wrapping
would fail.
PRESS TO ACCEPT THE FOLLOWING (OK):
2017 by Kony, Inc. All rights reserved 85 of 151
-
5. Uninstall EMM Kony Management Linux Installation GuideVersion1.3
5. Uninstall EMM
Navigate to EMM Installer folder and execute following command from the command line.
-- $ Uninstaller/ Uninstall_KonyEMM
The uninstall process begins.
======================================================================
========
KonyEMM (created with
InstallAnywhere)
----------------------------------------------------------------------
--------
Preparing CONSOLE Mode Uninstallation...
======================================================================
========
Introduction
------------
InstallAnywhere will guide you through the installation of KonyEMM.
It is strongly recommended that you quit all programs before
continuing with this installation.
Respond to each prompt to proceed to the next step in the
installation. If you want to change something on a previous step,
type 'back'.
You may cancel this installation at any time by typing 'quit'.
PRESS TO CONTINUE:
======================================================================
=========
Delete Database
---------------
2017 by Kony, Inc. All rights reserved 86 of 151
-
5. Uninstall EMM Kony Management Linux Installation GuideVersion1.3
Do you want to delete Database ?
NOTE: You may lose important data if you delete database.
1- Yes
->2- No
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT::
If you select option 1, the uninstaller will delete your database from the database server.
======================================================================
========
Uninstalling...
---------------
...*
*
*************************
*************************
*************************
************************
...*
======================================================================
========
Uninstall Complete
------------------
All items were successfully uninstalled.
2017 by Kony, Inc. All rights reserved 87 of 151
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
6. EMM Upgrade Procedure
This section explains the upgrade procedure on a Linux platform.
Based, upon the type of installation you have, the upgrade procedure is two types.
l Automated installation (Single node, multi-node)
l Manual installationMulti-node
Important: After upgrading from one version of KonyManagement Suite to another version of
KonyManagement Suite, ensure that all Enterprise Apps (that launch directly from the
springboard) are re-wrapped and updated on user devices. If you do not re-wrap, app will not
launch.
6.1 Automated Installation (single and multi-node)
Prerequisites
l Download the EMM Installer from http://community.kony.com/downloads/manual with your
credentials. Navigate to the KonyManagement section and click on the specific release related
files you want to download. For example, if you want to download KonyManagement 3.0, click
on the Kony v3.0 GA tab.
l Ensure that you have a previous version of EMM installed.
l Ensure that the KonyEMM-4.3.GA.bin file has execute permission.
l Ensure that the folder in which the executable .bin file is there does not contain any
installer.properties file.
To upgrade the EMM application,
2017 by Kony, Inc. All rights reserved 88 of 151
http://community.kony.com/downloads/manual
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
1. Execute the KonyEMM-4.3.GA.bin file as a root user. Files required for the EMMConsole
installation are extracted.
[root@emm builds]]$ ./KonyEMM-4.3.GA.bin
Preparing to install...
Extracting the installation resources from the installer
archive...
Configuring the installer for this system's environment...
Launching installer...
=================================================================
=======
KonyEMM (created with
InstallAnywhere)
------------------------------------------------------------------
------
Preparing CONSOLE Mode Installation...
=================================================================
=======
2017 by Kony, Inc. All rights reserved 89 of 151
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
=================================================================
=======
Introduction
------------
InstallAnywhere will guide you through the installation of KonyEMM
It is strongly recommended that you quit all programs before
continuing with
this installation.
It is also recommended that you install this on a server with at
least 4GB RAM.
Self-signed certificates are not allowed.
Respond to each prompt to proceed to the next step in the
installation. If you
want to change something on a previous step, type 'back'.
You may cancel this installation at any time by typing 'quit'.
2017 by Kony, Inc. All rights reserved 90 of 151
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
PRESS TO CONTINUE:
2. Press Enter. Software License Agreement details appear.
=================================================================
=======
License Agreement
-----------------
Installation and Use of KonyEMM Requires Acceptance of the
Following License
Agreement:
KONY, INC.
SOFTWARE LICENSE AGREEMENT
THE TERMS AND CONDITIONS CONTAINED HEREIN CONSTITUTE A LEGAL
AGREEMENT.
THIS AGREEMENT ("AGREEMENT") CONTAINS THE ENTIRE AGREEMENT BETWEEN
YOU
("LICENSEE") AND KONY, INC. ("KONY") WITH RESPECT TO THE TERMS AND
2017 by Kony, Inc. All rights reserved 91 of 151
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
CONDITIONS
DESCRIBED HEREIN. READ THIS AGREEMENT CAREFULLY BEFORE YOU CLICK
THE "I ACCEPT"
BUTTON BELOW. BY CLICKING ON THE "I ACCEPT" BUTTON, YOU
ACKNOWLEDGE THAT (1)
YOU ARE AUTHORIZED TO ENTER THIS AGREEMENT FOR AND ON BEHALF OF
YOUR COMPANY,
AND ARE DOING SO, AND (2) YOU HAVE READ, UNDERSTOOD, AND AGREE
THAT YOU AND THE
COMPANY SHALL BE BOUND BY THESE TERMS AND CONDITIONS AND ALL
MODIFICATIONS AND
ADDITIONS PROVIDED FOR. IF YOU DO NOT AGREE WITH THESE TERMS AND
CONDITIONS,
CLICK ON THE "I DO NOT ACCEPT" BUTTON BELOW AND INSTALLATION WILL
TERMINATE.
Software products included with this product that are not Kony
products are
licensed to you by the software provider. Please refer to the
license contained
in the provider's product for the terms of use before using such
products.
1. License Grant. Kony grants you a limited, non-exclusive, non-
transferable
license to use, for developmental purposes only, the Kony software
program(s),
known as the KonyTM Platform (the "Software") and related product
documentation
2017 by Kony, Inc. All rights reserved 92 of 151
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
at no charge subject to the terms and restrictions set forth in
this License
PRESS TO CONTINUE:
----------------- License Agreement Truncated -----------------
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N):
3. Press Y to accept the agreement. Prerequisite details appear.
=================================================================
============== Prerequisites
-------------
Please read the Pre-Install Guide to ensure that all the
prerequisites have been met.
->1- Continue with Installation
2- Abort Installation
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS TO ACCEPT
THE DEFAULT: 1
4. Enter 1 to continue with installation. The following details appear.
New Installation or Upgrade
---------------------------
Provide empty folders for a New Installation. Do not attempt to do
a New
Installation in the same location as an existing installation of
EMM.
For an upgrade process ensure you provide the same details as the
2017 by Kony, Inc. All rights reserved 93 of 151
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
initial
installation.
->1- New Installation
2- Upgrade
3- Rollback
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS TO ACCEPT THE
DEFAULT:
2
5. Enter 2 to upgrade. Details of the previous installation folder path appear.
=================================================================
==============
Installation Folder Path
------------------------
Please specify the installation path. An absolute path is
required.
Installation Folder Path (DEFAULT: ): /downloads/KonyEMM
6. Press Enter. Database details appear.
=================================================================
==============
Database Details
2017 by Kony, Inc. All rights reserved 94 of 151
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
----------------
Hostname/IP :
Port : 3306
DB Name : konyemmmaster
Username : root
PRESS TO CONTINUE:
7. Press Enter. The installer prompts Enter Password for (for your database user name).
=================================================================
==============
Enter Password for
-----------------------
This installation requires a password to continue.
Please Enter the Password:
8. Enter Password, and press Enter. Apple Server details appear.
=================================================================
==============
Apple Server #1 Details
-----------------------
MAC Server Host : 10.10.19.98
MAC Server Port : 22
MAC Server User :
PRESS TO CONTINUE:
9. Press Enter. The password details page for theMAC server appears. The installer prompts you
to enter a password for MAC #1.
=================================================================
==============
Enter Password for MAC #1
-----------------------
This installation requires a password to continue.
Please Enter the Password:
2017 by Kony, Inc. All rights reserved 95 of 151
-
6. EMM Upgrade Procedure Kony Management Linux Installation GuideVersion1.3
10. Enter Password, and press Enter. Details for WindowsServer appear.
=================================================================
==============
Windows Server #1 Details
-----------------------
Windows Server Host