Installing Hotfix Archives for Quantum Fabric - Windows
The Quantum Fabric Patch Installer can be used to apply patches (software updates) to Quantum Fabric components for a specific GA release.
For example:
To apply a 9.2.1.x
patch to a version earlier than 9.2.1 GA
, you need to upgrade to 9.2.1 GA
by using the installer, and then apply the 9.2.1.x
patch.
The Patch Installer uses hotfix archives and applies the software updates to an existing Quantum Fabric Installation. A hotfix archive (which is a .zip
file) can have artifacts for one or more components. While installing hotfix archives, all components in the archive are installed to your existing Quantum Fabric installation.
Prerequisites
- Ensure that you have a previous version of Quantum Fabric GA installed on your system at an accessible network location.
IMPORTANT: If you are required to install hotfix archives to a set of components for a specific release, you must have the supported Quantum Fabric GA version (for example, Quantum Fabric 9.2.1) with required components installed on your system.
For example, if you are required to install hotfix archive for Console version V 9.2.1, you must have Fabric 9.2.1 GA with Console installed on your system. - Download the
patchinstaller(binary)
andhotfix archives
from http://community.kony.com/downloads/manual/ with your credentials. - Ensure that
QuantumFabricPatchInstaller.exe
file has execute permission.Click here for more details about downloading the patch installer and hotfix archives:
To download Quantum Fabric Patch Installer and hotfixes, follow these steps:
- Log in to http://community.kony.com/downloads/manual/. You can obtain a user name and password from your sales representative or partner.
- Navigate to the Quantum Fabric section.
- From the Quantum Fabric Patch Installer, select the specific release from the Version drop-down list and then click on the specific release related files you want to download based on your platform (Windows or Linux).
For example, if you want to downloadQuantum Fabric Patch Installer 9.0 GA
, select the9.0 GA
version from the drop-down list, and then click the Installer_Windows link. - For the required hotfix components, select the specific release from the Version drop-down list and then click Download. The following is a sample screen.
To install Quantum Fabric patch using the installer, follow these steps:
- Unzip the
QuantumFabricSetup-9.x.x.GA.zip
file, and navigate to the QuantumFabric_Patch_Installer_Windowsfolder. - Double-click
QuantumFabricPatchInstaller-9.x.x.GA.exe
to launch the installer.
The InstallAnywhere dialog appears and displays the progress of the launching the installer.A dialog with the Quantum Fabric logo appears.
- Next, the Introduction window appears asking for following details: Enter the details to proceed with the upgrade:
Please provide the location of the patch file: Provide the patch file location of the Quantum Fabric component that you wish to install to current version. For example,
middleware.zip
.
For information about creating a patch file, refer to Creating a patch file for Fabric components.- Please provide the location of existing installation . The default install location appears in this field.
Provide the location of existing Quantum Fabric installation that you wish to upgrade with the selected patch version.
- Click Next. The Pre-Installation Summary window appears.
The installer takes backup of the current install folder. The backup folder will have a suffix of
_{Patch_File_Name}
. For example, if the hotfix name is KPNS.XXX, then the suffix of the backup folder will be_KPNS.XXX
.IMPORTANT: The Installer does not support automatic backups of database and other artifacts. The Installer does not support rollback in case of a failure during the upgrade.
- You must take backup of your database and other artifacts before upgrading.
- After the upgrade, republish your Quantum Fabric applications. - Click Install. The Installing Quantum Fabric window appears and the installation starts.
Once the installation completes, the Installation window appears with the confirmation message.
The installation of Quantum Fabric is finished. In case of any errors during the installation, refer to the installation log for details. Installation log is located at below location: For example,
C:\QuantumFabric900\
- Click Done to complete the installation. After the installation is completed, the installer creates logs in the install folder.
The <Install Location> directory contains the log files logging each invocation of the installer. To make problem identification easier, provide these log files to Quantum when reporting an issue.
For troubleshooting tips to resolve problems that you may encounter during installation, refer to the following:
Creating a patch file for Fabric components
To create a patch file for Fabric components, you need to create a zip file with the relevant files. The contents for the zip must be downloaded from the link to the build artifacts.
For information about the files and file structure for individual Fabric components, refer to the following sections.

auth.zip
)
auth.zip
auth
(folder)authService.war
migrations.jar
jboss-logging-3.1.0.CR2.jar
mysql-connector-java-5.1.48.jar
db.sql
auth_config.zip
migrations-auth-db2.zip
migrations-auth-oracle.zip
migrations-auth-sqlserver.zip
migrations.zip

portal.zip
)
portal.zip
portal
(folder)mbaasportal.war

waas.zip
)
waas.zip
waas
(folder)workspaceService.war
waasdb.sql
migrations.zip
migrations-waas-db2.zip
migrations-waas-oracle.zip
migrations-waas-sqlserver.zip
configfiles.zip

accounts.zip
)
accounts.zip
accounts
(folder)migrations-accounts-sqlserver.zip
migrations-accounts-oracle.zip
migrations-accounts-db2.zip
accountsdbmigration.zip
accountsAPI.war

metricsflyway.zip
)
metricsflyway.zip
metricsflyway
(folder)reportsdb_oracle.zip
reportsdb_mysql.zip
reportsdb_mssql.zip
reportsdb_db2.zip

metricsprocessing.zip
)
metricsprocessing.zip
metricsprocessing
(folder)metrics.ear

middleware.zip
)
middleware.zip
middleware
(folder)websphere_metainf.zip
shared-libraries-was8.x.tar
services.war
schema.zip
middleware.war
middleware-system.jar
middleware-libraries.zip
middleware-libraries.tar
middleware-bootconfig.tar
KonyWebController.jar
KonyWebCommons.jar
KonyLuaVM.jar
KonyLogger.jar
KonyLogger-debug.jar
KonyIoT.tar
konycache-derby.jar
jboss-client.jar
install.zip
devicestore-MIDDLEWARE.tar
devicedb_sqlserver.zip
devicedb_oracle.zip
devicedb_mysql.zip
devicedb_db2.zip
derby.jar
admindb_sqlserver.zip
admindb_oracle.zip
admindb_mysql.zip
admindb_db2.zip
admin.war

kpns.zip
)
kpns.zip
kpns
(folder)sqlserver.zip
sharedlib.tar
quartz-2.2.1.jar
oracle.zip
mysql.zip
kpns.war
kpns-resources.zip
db2.zip