Maintenance release 3.4.4#

Product

EclecticIQ Intelligence Center

Release version

3.4.4

Release date

November 2024

Time to upgrade

~40 minutes to upgrade an instance with 2.67 million entities, 1.85 million observables.

  • From the previous release

  • Using the installation script

  • For an instance running on one machine

Time to migrate

For an instance with 2.67 million entities, 1.85 million observables:

  • PostgreSQL migration: 13m30s

  • Elasticsearch migration: 18m40s

eclecticiq-extension-commons deprecated in 3.3, removed in 3.4

If you have written your own extension or modified an existing extension, that extension may contain references to the eclecticiq-extension-commons package.

In particular, if your extension:

  • depends on eclecticiq-extension-commons

  • imports from extension.common

Use our migration guide to remove or change those references in your extension before upgrading to release 3.4.

Improvements#

  • Ingestion performance improvement
    This release includes optimizations for complex data structures in feeds. This allows the Intelligence Center to attain a higher ingestion speed.

Fixes#

  • Add health check for database ID generation

The format of the IDs in the platform’s databases only allows for ~2.2M records, before returning an error. This release adds an health check that will tell you when your sequence generation is at risk of running out. See our mitigation steps if the health check indicates a risk to the sequence generators.

  • Implemented a Sequence Generator check

Databases in Intelligence Center have integers assigned to their records by sequence generation. It can generate up to 2 billion integers to index with, but had no logic to deal with exceeding this limit yet. Now, record creation will return an error when the sequence generation has exceeded its integer generation capacity.
Please notify us if this error is returned in your Intelligence Center instance.

  • Clean up Python libraries

Some empty directories left after upgrades broke earlier versions of the platform. This current package eliminates these empty directories and is reconfigured to not leave new ones.

  • Upgrades reset permission

Fixes a bug that would reset custom permission assignment to roles with earlier versions. Upgrading to this current version does not reset permission assignment to roles.

  • Increased limit on Outgoing feed dropdown for Dataset selector

Fixes an issue where the dropdown for selecting Datasets to be part of an Outgoing feed would only show 100 feeds, even if there were more feeds in the platform.
This limit has been increased to 1000 feeds.

  • Outgoing feed failure while fetching data

Fixes a bug that would occur when data for an Outgoing feed is present in ElasticSearch, but not in the IC’s own database.

  • IndexError in eiqjson packer

Fixes an index error that prevented packing Entities with specific outgoing relations in them into Outgoing eiqjson feeds. This meant the runs of these feeds were succesful but incomplete, dropping the Entities with those specific relations.

  • SFTP prefix not accepted in Outgoing feed

Fixes an issue where you could not create Outgoing feeds with an SFTP upload transport type.

  • Breaking Incoming feed page

Fixes an issue where sorting columns on the Incoming feed pages may cause the pages to break because of missing models.

Public API compatibility#

From EclecticIQ Intelligence Center 2.12.0 onward, the public API is packaged together with EclecticIQ Intelligence Center.

The following reference table lists the versions of the public API package and EclecticIQ Intelligence Center versions they are compatible with:

Intelligence Center version(s)

Public API package version(s)

Public API version

2.11 - 2.12

eclecticiq-extension-api==1.0.*

v1

2.13.0

eclecticiq-extension-api==1.*

v1

2.14.0 and newer

Now follows EclecticIQ Intelligence Center versioning scheme.

E.g., EclecticIQ Intelligence Center 2.14 is now compatible with eclecticiq-extension-api==2.14.*

v1

3.0.0 and newer

EclecticIQ Intelligence Center 3.0 and newer uses Public API v2.

Follows EclecticIQ Intelligence Center versioning scheme.

E.g., EclecticIQ Intelligence Center 3.0.2 is compatible with eclecticiq-extension-api==3.0.*, EclecticIQ Intelligence Center 3.1.0 is compatible with eclecticiq-extension-api==3.1.*, etc.

v2

Download#

For more information about setting up repositories, refer to the installation documentation for your target operating system.

EclecticIQ Intelligence Center and dependencies for Rocky Linux and RHEL

  • Platform packages: https://downloads.eclecticiq.com/platform-packages-centos/

  • Platform dependencies: https://downloads.eclecticiq.com/platform-dependencies-centos-2.9/

    Note

    The Intelligence Center dependencies URL for versions 2.9 and later is https://downloads.eclecticiq.com/platform-dependencies-centos-2.9/. It contains packages that are incompatible with versions 2.8 and earlier.

EclecticIQ Intelligence Center extensions

  • Platform extensions: https://downloads.eclecticiq.com/Extensions/

Upgrade#

In order to upgrade to EclecticIQ Intelligence Center 3.0 and later, you must:

  • Be running one of the supported operating systems.

    Upgrade to Red Hat Enterprise Linux 8 or Rocky Linux 8 if .

  • Upgrade from EclecticIQ Intelligence Center 2.14.

    If you are running an older version of EclecticIQ Intelligence Center, you must upgrade to 2.14 before attempting to upgrade to EclecticIQ Intelligence Center 3.0.

    See Install Configure Upgrade.

Upgrade diagram

Upgrade diagram#