1. Home
  2. On-premises 6.0
  3. Guides
  4. Concepts
  5. Tools
    1. Alert Editor
    2. Alias Sync Tool
    3. Analyzer
    4. Apache Parquet Merge Tool
    5. Avro Extractor Tool
    6. Business Schema Designer
    7. Business Schema Manager
    8. Cluster Management Console
    9. CMC Logs Manager
    10. CMC Monitoring
    11. CMC Patch Manager
    12. CMC Scheduler
    13. CMC Tenant Manager
    14. Command Line Interface
    15. Content Manager
    16. Dashboard Filters Manager
    17. Dashboard Manager
    18. Data Agent
    19. Data APIs for External Notebooks
    20. Data Lineage Viewer
    21. Data Manager
    22. Formula Builder
    23. Inspector Tool
    24. Join Editor
    25. Load Job Details Viewer
    26. Model Update Viewer
    27. Notebook Editor
    28. Profile Manager
    29. Public API
    30. Query Plan Viewer
    31. Scheduler
    32. Schema Designer
    33. Schema Diagram Viewer
    34. Schema Manager
    35. Schema Wizard
    36. Security Manager
    37. Table Editor
    38. Tenant Management Tool
    39. Upload Service Command Line Interface (CLI)
    40. Versioning Migration Tool
  6. References
  7. Integrations
  8. Data applications
  9. Releases

Tools → CMC Patch Manager

Patch Manager Overview

The patch manager is available starting the 6.0.1 release. This feature aims to automate the patch installation process, which makes it easier for the Cluster Management Console (CMC) admins to install any patches provided by Incorta.

You can install, uninstall, and export patches to your Incorta nodes using a .zip file in the CMC.

Patch Manager Access Rights

Only a CMC administrator can access the Patch Manager in a cluster. To access the Patch Manager, sign in to the CMC, select the Clusters tab, select a cluster name, and then select the Patches tab.

Patch Manager Anatomy

The Patch Manager consists of the following:

Action Bar

The Action bar contains the Install New Patch button only.

List View

By default, the list view displays all the patches installed in a particular cluster. When the number of patches exceeds 20, pagination controls are shown below the list view.

The list view consists of the following properties:

PropertyControlDescription
Patches HistorylinkA link to display history of patches installed.
Patch NametextThe patch name.
Note: It must be unique.
Installation timetextThe date and time in which you installed the patch.
VersiontextPatch version installed.
DescriptiontextPatch description.
RollbackbuttonA rollback button to uninstall the patch.
Note: You can only rollback the latest installed patch.

Patch Manager Actions

Using the Patch Manager, you can perform the following actions:

Install a patch

Incorta support usually provides the patch that you need to install. The support team provides the patch to fix an existing issue you might have.

The following are the prerequisites that must be fulfilled to be able to proceed with the installation process:

  • The patch name is unique and has never been installed before.
  • The patch is compatible with the installed Incorta version.
  • Any prerequisite patches already exist.
  • The patch descriptor supplied by Incorta is valid.

To start installing a patch through the CMC, you need to apply the following steps:

  1. Sign in to the CMC, select the Clusters tab, and select a cluster name.

  2. Select the Patch tab, and then select the Install New Patch button.

  3. In the Install New Patch wizard, drag and drop or browse to the .zip file provided by Incorta.

  4. In the Upload File step, Incorta validates the patch compatibility, making sure of the following:

    • The patch name is unique and has never been installed before.
    • The patch prerequisites are fulfilled, such as the existing previous patch.
    • The patch matches the installed Incorta version.

  5. After the file is validated, select Next.

  6. In the Install step, review the patch information, select Install, and then select Finalize after installation completes.

Note

The CMC will stop all services during patch installation, so you must notify your users of the downtime.

  1. In the Finalize step, select Start All to start all services. Alternatively, you can select Close & Go to nodes and start services manually for each node.
  2. During patch installation, Incorta backs up all files and properties needed if you decide to roll back a patch, guaranteeing that the system will work correctly after rolling back.
  3. Backups are usually stored until you upgrade to another Incorta version.

Incorta will install a patch on all available nodes if you have multiple nodes.

Rollback a patch

You can always roll back patches, knowing that you must start by rolling back the latest installed patch and then go to the next one sequentially.

The rollback button will not be available for other patches except for the latest.

Rolling back a patch will guarantee having Incorta back working as expected on the version it was using before.

  1. Sign in to the CMC.
  2. Select the Clusters tab from the navigation bar, select a cluster name, and then select the Patches tab.
  3. Select the Rollback available beside the latest patch.

View patch history

To export a patch through the CMC, you need to apply the following steps:

  1. Sign in to the CMC.
  2. Select the Clusters tab from the navigation bar, select a cluster name, and then select the Patches tab.
  3. Select Patches History.
  4. Select an Incorta version.

You will be able to view all the patches installed for the version you have selected.

Export a patch

To export a patch through the CMC, you need to apply the following steps:

  1. Sign into the CMC.
  2. Select the Clusters tab from the navigation bar, select a cluster name, and then select the Patches tab.
  3. Select Patches History.
  4. In the Patches History pop-up, select an Incorta version, and then select the Export icon.

Incorta will export and download a .zip file with all the patches for this Incorta version.