After installing KonyMobileFabric on HTTPS import your SSL certificate (for example
domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority
If your SSL certificate is not configured the system displays an error - peer not authenticated
To enable communication between MobileFabric Console and other products such as Kony
MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow
l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and
l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony
To add an installer generated self-signed SSL certificate to cacerts follow these steps
1 From your MobileFabric installed system open the Linux terminal and run the following
16 Post-Installation Tasks Manual Installation GuideVersion13
Based on the hostname and keystore password provided at the SSL Certificate window the
preceding command exports the required certificate from the source keystore with the given
name - for example intermediatecrt
2 Run the following command to import theintermediatecrt certificate file into your
MobileFabric Installers JRE trusted certificate authority (CA) certificates file
ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -
alias ltHOST_URL_SSL_CONFgt -file
ltUSERINSTALLDIRgtintermediatecrt -keystore
ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit
1612 How to Add an Existing SSL Certificate to Cacerts
If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts
To add an existing SSL certificate to cacerts follow these steps
Use the following steps to import your existing certificate to cacerts with the proper value of alias
keystore location and keystore password
1 From your MobileFabric installed system open the Linux terminal and run the following
command to add anintermediatecrt file from the keystore
ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_
domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore
ltkeystore_locationgt-storepass ltPasssword_of_keystoregt
2 Run the below command to import theintermediatecrt certificate file into your
MobileFabric Installers JRE trusted certificate authority (CA) certificates file
copy 2014 by Kony Inc All rights reserved 169 of 185
16 Post-Installation Tasks Manual Installation GuideVersion13
ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -
alias ltyourcertificate_domaingt -file
ltUSERINSTALLDIRgtintermediatecrt -keystore
ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit
162 JDK Version Compatibility
In case if you upgrade your JDK version in your middleware server to enable JDK version
compatibility make the appropriate changes in an app servers middlewareproperties file
located in your middleware server installation folder
For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your
middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at
runtime the system throws an error message due to JDK version incompatibility
1 In your middleware server installation folder open the middlewareproperties file
located at the below path
l for JBoss ltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconfig
l for Tomcat ltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconfig
2 Make the following changes in the middlewareproperties file
l ssltrustStore=ltjava_homegtjrelibsecuritycacerts
l sslkeyStore=ltjava_homegtjrelibsecuritycacerts
163 How to Switch between JDK Versions
Ensure that youmake necessary changes in themiddlewareproperties file before you
switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)
copy 2014 by Kony Inc All rights reserved 170 of 185
16 Post-Installation Tasks Manual Installation GuideVersion13
To configure JDK version in middleware follow these steps
1 In your middleware server installation folder open the middlewareproperties file
located at the below path
l for JBoss ltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconfig
2 In themiddlewareproperties file do the following changes
l Java 6
sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI
mpl
sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo
cketFactoryImpl
l Java 7
sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo
cketFactoryImpl
sslServerSocketFactoryprovider=comsunnetsslinternalssl
SSLServerSocketFactoryImpl
164 How to Configure Memcached for Integration Service
If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the
middlewareproperties file to make service calls
1 Stop KonyMobileFabric services
2 In your middleware server installation folder open the middlewareproperties file
located at the below path
copy 2014 by Kony Inc All rights reserved 171 of 185
16 Post-Installation Tasks Manual Installation GuideVersion13
l for JBoss
ltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconfig
l for Tomcat
ltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconfig
3 In themiddlewareproperties file do the following changes
Memcache configuration
memcachecluster=
memcachecluster=
memcacheexpiry=1200
memcachestoreattempts=12
memcacheretriveattempts=3
memcachenoofclients=
memcachestoretime=300
Important Ensure that you uncomment thememcachecluster Key For example
memcachecluster=
4 Restart the KonyMobileFabric services
copy 2014 by Kony Inc All rights reserved 172 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
17 FAQs and Troubleshooting
This section lists the troubleshooting tips to resolve problems that youmay encounter during
installation
l Issue
If your service providers certificate is not configured the system displays an error - peer not
authenticated
Workaround
For trusted certification issues refer to SSLCertificate Issues
l Issue - MySQL DB error
If you use a common database for multiple tasks such as installingMobileFabric or accessing a
service from a device the system throws theMySQLDB error -- prepared statement needs to
be re-prepared-- in logs
Workaround
To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_
CACHEand MAX_CONNECTIONS of your MySQL
Kony recommends a dedicatedMySQLDB Server for MobileFabric
l Issue - App publishing error
If your app publish fails the system displays an error message
copy 2014 by Kony Inc All rights reserved 173 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
When IDE app publish fails with Error MessageInternal
server error occurred while publishing application More Details
null
ResponseHTTP11 500 Internal Server Error 500 Internal server
error more details null
Workaround
Restart middleware server and re-publish the app
l Issue
When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where
KonyMobileFabric (with integrated server) installed app publish fails
Workaround
Configure -D parameter for syncmiddleware home pointing to existingMobileFabric
middleware home which is created while installingMobileFabric
For example add the -Dsynchome=ltpath of the Kony MobilelFabric
middleware home directorygt parameter for syncmiddleware home
l Issue - Latest MobileFabric does not support old DB configured with lower versions of
MobileFabric
In Multinode environment user should be adding new node with same version of MobileFabric
and do the additional settings related to key
Workaround
copy 2014 by Kony Inc All rights reserved 174 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
1 Configure additional nodes into the existing environment by using the existing database
that is setup with MobileFabric
2 Replace the following key values in the new node with the key values in the existing
configuration
o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY
value should be configured with the same value as in all nodes
Path for theaccountsproperties file
ltInstaller FoldergttomcatwebappsaccountsWEB-
INFclasses
o TheAuthservicekey should be configured with the same value in all nodes
Path for the authservicekey file
ltInstaller FoldergttomcatwebappsauthServiceWEB-
INFclasses
o Theworkspaceservicekey value should be configured with the same
value in all nodes
Path for theworkspaceservicekey file
ltInstaller FoldergttomcatwebappsworkspaceWEB-
INFclasses
171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-
abric Products Running on JDK 16
If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3
(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration
KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement
By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for
example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)
the SSLv3 protocol from both client and server handshakeswith each other before exchanging data
copy 2014 by Kony Inc All rights reserved 175 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
If SSLv2Hello protocol is not configured the system does not allow requests between clientserver
such as exchanging data or publishing apps The system throws a handshake error
1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps
1 Open thestandalonexml file located in your MobileFabric install location
For example ltinstallation
foldergtjbossstandaloneconfigurationstandalonexml
2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with
SSLv2HelloTLSv1TLSv11TLSv12
The SSLv2Hello is added in the protocol list shown below
ltconnector name=HTTPS protocol=HTTP11
scheme=https socket-binding=https secure=truegt
ltssl name=https password=ltpasswordgt
certificate-key-file=ltcertificate-key-filegt
protocol=SSLv2HelloTLSv1TLSv11TLSv12gt
ltconnectorgt
3 Save thestandalonexml file
1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps
1 Open thedomainxmlfile located in your MobileFabric install location
For example ltinstallation foldergtjboss-eap-62-
masterdomainconfigurationdomainxml
copy 2014 by Kony Inc All rights reserved 176 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with
SSLv2HelloTLSv1TLSv11TLSv12
Important In thedomainxml file youmust replace the
SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your
MobileFabric console will not receive data properly from other KonyMobileFabric Servers
The SSLv2Hello is added in the protocol list shown below
ltconnector name=HTTPS protocol=HTTP11
scheme=https socket-binding=https secure=truegt
ltssl name=https password=ltpasswordgt
certificate-key-file=ltcertificate-key-filegt
protocol=SSLv2HelloTLSv1TLSv11TLSv12gt
ltconnectorgt
3 Save thedomainxmlfile
172 WebSphere FAQs
For more information seeWebSphere FAQs
173 FAQs and Troubleshooting
This section lists the troubleshooting tips to resolve problems that youmay encounter during
installation
l Issue
If your service providers certificate is not configured the system displays an error - peer not
authenticated
Workaround
copy 2014 by Kony Inc All rights reserved 177 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
For trusted certification issues refer to SSLCertificate Issues
l Issue - MySQL DB error
If you use a common database for multiple tasks such as installingMobileFabric or accessing a
service from a device the system throws theMySQLDB error -- prepared statement needs to
be re-prepared-- in logs
Workaround
To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_
CACHEand MAX_CONNECTIONS of your MySQL
Kony recommends a dedicatedMySQLDB Server for MobileFabric
l Issue - App publishing error
If your app publish fails the system displays an error message
When IDE app publish fails with Error MessageInternal
server error occurred while publishing application More Details
null
ResponseHTTP11 500 Internal Server Error 500 Internal server
error more details null
Workaround
Restart middleware server and re-publish the app
copy 2014 by Kony Inc All rights reserved 178 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
l Issue
When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where
KonyMobileFabric (with integrated server) installed app publish fails
Workaround
Configure -D parameter for syncmiddleware home pointing to existingMobileFabric
middleware home which is created while installingMobileFabric
For example add the -Dsynchome=ltpath of the Kony MobilelFabric
middleware home directorygt parameter for syncmiddleware home
l Issue - Latest MobileFabric does not support old DB configured with lower versions of
MobileFabric
In Multinode environment user should be adding new node with same version of MobileFabric
and do the additional settings related to key
Workaround
1 Configure additional nodes into the existing environment by using the existing database
that is setup with MobileFabric
2 Replace the following key values in the new node with the key values in the existing
configuration
o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY
value should be configured with the same value as in all nodes
Path for theaccountsproperties file
ltInstaller FoldergttomcatwebappsaccountsWEB-
INFclasses
o TheAuthservicekey should be configured with the same value in all nodes
Path for the authservicekey file
copy 2014 by Kony Inc All rights reserved 179 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
ltInstaller FoldergttomcatwebappsauthServiceWEB-
INFclasses
o Theworkspaceservicekey value should be configured with the same
value in all nodes
Path for theworkspaceservicekey file
ltInstaller FoldergttomcatwebappsworkspaceWEB-
INFclasses
1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products
Running on JDK 16
If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3
(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration
KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement
By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for
example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)
the SSLv3 protocol from both client and server handshakeswith each other before exchanging data
If SSLv2Hello protocol is not configured the system does not allow requests between clientserver
such as exchanging data or publishing apps The system throws a handshake error
17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps
1 Open thestandalonexml file located in your MobileFabric install location
For example ltinstallation
foldergtjbossstandaloneconfigurationstandalonexml
2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with
SSLv2HelloTLSv1TLSv11TLSv12
The SSLv2Hello is added in the protocol list shown below
copy 2014 by Kony Inc All rights reserved 180 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
ltconnector name=HTTPS protocol=HTTP11
scheme=https socket-binding=https secure=truegt
ltssl name=https password=ltpasswordgt
certificate-key-file=ltcertificate-key-filegt
protocol=SSLv2HelloTLSv1TLSv11TLSv12gt
ltconnectorgt
3 Save thestandalonexml file
17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps
1 Open thedomainxmlfile located in your MobileFabric install location
For example ltinstallation foldergtjboss-eap-62-
masterdomainconfigurationdomainxml
2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with
SSLv2HelloTLSv1TLSv11TLSv12
Important In thedomainxml file youmust replace the
SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your
MobileFabric console will not receive data properly from other KonyMobileFabric Servers
The SSLv2Hello is added in the protocol list shown below
ltconnector name=HTTPS protocol=HTTP11
scheme=https socket-binding=https secure=truegt
ltssl name=https password=ltpasswordgt
certificate-key-file=ltcertificate-key-filegt
copy 2014 by Kony Inc All rights reserved 181 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
protocol=SSLv2HelloTLSv1TLSv11TLSv12gt
ltconnectorgt
3 Save thedomainxmlfile
1732 WebSphere FAQs
For more information seeWebSphere FAQs
174 How to Change Log Levels
l For console and auth log files by default log level value is set toINFO
o mbaasportallog (for mbaas portal)
o accountsServicelog (for accounts)
o andworkspaceServicelog (for workspace)
o authServicelog
o For KMS the default log level is INFO
l For adminlog and sync log files by default log level value is set to ERROR
To change log levels for mbaasportallog follow these steps
1 Go toltMobileFabric install
directorygtdeploymentsmfconsolewarWEB-INFclasses and open
thelog4jproperties file
2 Change the log level to the required value
3 Redeploy themfconsolewar file
copy 2014 by Kony Inc All rights reserved 182 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
To change log levels for accountsServicelog follow these steps
1 Go toltMobileFabric install
directorygtdeploymentsaccountsServicewarWEB-INFclasses
and open thelog4jproperties file
2 Change the log level to the required value
3 Redeploy theaccountsServicewar file
To change log levels for workspaceServicelog follow these steps
1 Go toltMobileFabric install
directorygtdeploymentsaccountsServicewarWEB-INFclasses
and open thelog4jproperties file
2 Change the log level to the required value
3 Redeploy theworkspaceServicewar file
To change log levels for authServicelog follow these steps
1 Go toltMobileFabric install
directorygtdeploymentsauthServicewarWEB-INFclasses and
open thelog4jproperties file
2 Change the log level to the required value
3 Redeploy theauthServicewar file
To change log levels for adminlog follow these steps
copy 2014 by Kony Inc All rights reserved 183 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
1 Go toltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconfadmin and open theadmin-
log4jproperties file
2 Change the log level to the required value
3 Restart the server
To change log levels for middlewarelog follow these steps
1 Go toltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconf and open themiddleware-
log4jproperties file
2 Change the log level to the required value
3 Restart the server
To change log levels for metricslog follow these steps
1 Go toltinstaller foldergtmiddleware_
homemiddlewaremiddleware-bootconf and open themetrics-
log4jproperties file
2 Change the log level to the required value
3 Restart the server
To change log levels for KMS logs follow these steps
1 Go toltKMS install directorygtkpns-resources and open thekms-
log4jproperties file
copy 2014 by Kony Inc All rights reserved 184 of 185
17 FAQs and Troubleshooting Manual Installation GuideVersion13
2 Change the log level to the required value
3 Restart the server
To change log levels for Sync logs follow these steps
1 Go toltSync install directorygtconf and open the following properties files
l console-log4jproperties
l services-log4jproperties
2 Change the log level to the required value
3 Restart the server
copy 2014 by Kony Inc All rights reserved 185 of 185
- 1 Preface
-
- 11 Purpose
- 12 Intended Audience
- 13 Formatting Conventions
- 14 Related Documents
- 15 Contact Us
-
- 2 Prerequisites
-
- 21 Prerequisites for MobileFabric with Oracle
- 22 Software Requirements
- 23 Hardware Requirements
- 24 Required Setup Files
-
- 3 MobileFabric Topology and Components
- 4 Configuring Database for MobileFabric
-
- 401 Prerequisites Create Databases
- 41 Configuring Kony Identity Services Database
-
- 411 MySQL
- 412 Oracle
-
- 42 Configuring Kony Workspace Services Database
-
- 421 MySQL
- 422 Oracle
-
- 43 Configuring Kony Accounts Services Database
-
- 431 MySQL
- 432 Oracle
-
- 5 Creating Shared Library Folders for MobileFabric - WebSphere
- 6 Creating Data Source for MobileFabric Console - WebSphere
-
- 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
-
- 611 Creating a JAAS J2C Authentication
- 612 Creating a JDBC Provider
- 613 Creating a Data Source
- 614 Setting Custom Properties of Data Source
-
- 62 Creating Data Source for MobileFabric Console Schema (Oracle)
-
- 621 Creating a JAAS J2C Authentication
- 622 Creating a JDBC Provider
- 623 Creating a Data Source
- 624 Setting Custom Properties of Data Source
-
- 63 Creating Data Source for MobileFabric Console Schema (MySQL)
-
- 631 Creating a JAAS J2C Authentication
- 632 Creating a JDBC Provider
- 633 Creating a Data Source
- 634 Setting Custom Properties of Data Source
-
- 64 Configuring Data Source for Integration Service
-
- 7 Creating Data Source for MobileFabric Console Schema - WebLogic
- 8 Configuring Installation Mode
-
- 81 How to Configure Installation Modes - Tomcat
-
- 811 How to Configure Tomcat Multinode Installation
-
- 82 How to Configure Installation Modes - JBoss
-
- 821 How to Configure JBoss for Singlenode Installation
- 822 How to Configure JBoss for Multinode Installation
-
- 83 How to Configure Installation Modes - WebSphere
-
- 9 Configuring JNDI for a Database
-
- 91 How to Configure JNDI - Tomcat
-
- 911 For MySQL
-
- 92 How to Configure JNDI - JBoss
-
- 921 For MySQL
-
- 10 Configuring Connectors and WAR Deployment
-