Skip to content

You are here: Installing Hotfix Archives for Volt Foundry - Windows

Installing Hotfix Archives for Volt Foundry - Windows

The Volt Foundry Patch Installer can be used to apply patches (software updates) to Volt Foundry components for a specific GA release.

For example:

To apply a 9.5.x patch to a version earlier than 9.5.x GA, you need to upgrade to 9.5.x GA by using the installer, and then apply the 9.5.x patch.

The Patch Installer uses hotfix archives and applies the software updates to an existing Volt Foundry 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 Volt Foundry installation.

Prerequisites

  • Ensure that you have a previous version of Volt Foundry 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 Volt Foundry GA version (for example, Volt Foundry 9.5.x) with required components installed on your system.
For example, if you are required to install hotfix archive for Console version V 9.5.x, you must have Foundry 9.5.x GA with Console installed on your system.

  • Ensure that VoltFoundryPatchInstaller-9.5.x.QA.exe file has execute permission

  • Please stop the windows Foundry service before applying the patch.

To download Volt Foundry Patch Installer and hotfixes, follow these steps:

  1. Login to the HCL License & Download Portal.

    If you do not have login credentials, follow the steps discussed in this article, How to register to HCLSoftware portals. For more info on the portal, refer to this article. or contact support by creating a Download Case.

  2. Locate HCL Volt MX in Your Downloads, and select HCL Volt Foundry v9.x.x.

  3. Download the required hotfix components.

To install Volt Foundry patch using the installer, follow these steps:

  1. Unzip the Volt Foundry-9.x.x.GA.zip file, and navigate to the Volt MX Foundry_Patch_Installer_Windowsfolder.

  2. Double-click VoltFoundryPatchInstaller-9.5.x.QA.exe to launch the installer.
    The InstallAnywhere dialog appears and displays the progress of the launching the installer.

    A dialog with the Volt Foundry logo appears.

  1. 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 Volt Foundry 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 Foundry components.
  • Please provide the location of existing installation. The default install location appears in this field. Provide the location of existing Volt Foundry installation that you wish to upgrade with the selected patch version.

  1. 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 VPNS.XXX, then the suffix of the backup folder will be _VPNS.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 Volt Foundry applications.

  1. Click Install. The Installing Volt Foundry window appears and the installation starts.

Once the installation completes, the Installation window appears with the confirmation message.

The installation of Volt Foundry 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:\VoltMXFoundry900\

  1. Click Done to complete the installation. After the installation is completed, the installer creates logs in the install folder.

For troubleshooting tips to resolve problems that you may encounter during installation, refer to the following:

FAQs and Troubleshooting

The < Install Location > directory contains the log files logging each invocation of the installer. To make problem identification easier, provide these log files to Volt Foundry when reporting an issue.

Creating a patch file for Foundry components

To create a patch file for Foundry 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 Foundry components, refer to the following sections.

Identity (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 (portal.zip)

  • portal.zip

  • portal (folder)

    • mbaasportal.war

Workspace (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 (accounts.zip)

  • accounts.zip

  • accounts (folder)

    • migrations-accounts-sqlserver.zip
    • migrations-accounts-oracle.zip
    • migrations-accounts-db2.zip
    • accountsdbmigration.zip
    • accountsAPI.war

Metrics Database Scripts (metricsflyway.zip)

  • metricsflyway.zip

  • metricsflyway (folder)

    • reportsdb_oracle.zip
    • reportsdb_mysql.zip
    • reportsdb_mssql.zip
    • reportsdb_db2.zip

Metrics Processing (metricsprocessing.zip)

  • metricsprocessing.zip

  • metricsprocessing (folder)

    • metrics.ear

Integration/Middleware (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
    • VoltMXWebController.jar
    • VoltMXWebCommons.jar
    • VoltMXLuaVM.jar
    • VoltMXLogger.jar
    • VoltMXLogger-debug.jar
    • VoltMXIoT.tar
    • voltmxcache-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

Engagement/Push Notification Service (vpns.zip)

  • vpns.zip

  • vpns (folder)

    • sqlserver.zip
    • sharedlib.tar
    • quartz-2.2.1.jar
    • oracle.zip
    • mysql.zip
    • vpns.war
  • vpns-resources.zip db2.zip