Release notes - i2 Analyze 4.4.0
A high level overview of the release, listing new features, the system requirements and any known issues.
Release highlights
- i2 Analyze
- The following new and updated features are available in this release:The following defects have been resolved:
- Privacy message and acceptance – A system administrator can configure i2 Analyze to require the user to read and accept a privacy message when connecting to the i2 Analyze server. Users who do not accept the privacy message will be unable to access the system.
- Audit login and logout – The i2 Analyze auditing system records when a user logs into the system, and when the user logs out or is logged out of the system due to inactivity. In addition, where the privacy message has been configured it will log acceptance of privacy conditions.
- Updated Public REST API –The existing i2 Analyze public REST APIs hosted by the i2 Analyze server have been updated to use the OpenAPI v3 specification.
- REST API discovery endpoints - A new set of discovery endpoints has been added to the public REST API. These endpoints allow clients to run fuzzy text searches or complex geospatial searches within the Information Store database. Retrieval of the result sets is also possible via a new paged results endpoint.
- Public REST API version negotiation – i2 Analyze now provides an API version negotiation mechanism to allow server and clients to agree which supported API version they use to interact with the server.
- Privacy and license usage reporting – A new reporting capability
allows an administrator to check the numbers of users who have
accepted or rejected the privacy agreement and to view metrics
that show the number of users using licensed features of i2
Analyze.
- Administrators can view and print reports using a pair of third-party tools, Prometheus and Grafana. Example configurations are provided to gather the metrics and to display them in a graphical dashboard.
DATE_AND_TIME
facets now respect timezones. [DT0004]- Incorrect Visual Query counts fixed. [DT0007]
- The time zone of machine used to run ingestion no longer modifies fully qualified values for Date and Time. [DT00014]
- Improved the database user requirement documentation. [DT00026]
- Improved documentation for running Db2 commands on a remote server. [DT00027]
- Document ulimit setting for IBM Db2. [DT00042]
- Creating a SQL Server Information Store database using the instance name no longer causes errors. [DT00051]
- Documented the
setSolrAutoscalingClusterPolicy
toolkit task. [DT00061] - Visual Query configuration - implicit all valid operators now allows 'Between' for DateTime. [DT00065]
- Updating records via ETL must not update the item_id column value in the SQL statement. [DT00074]
- Updating records by using Submit and Share no longer updates the
item_id
value in the Information Store database. [DT00073] - Initialization logic changed to ensure that both the schema manager and charting scheme manager are started, and that if no URLs are defined, an empty schema is created. [DT00076]
- Ingesting data into Db2 11.1 no longer causes correlation errors. [DT00080]
- Correlation ingestion no longer causes errors if you have not yet converted CLOB columns to VARCHAR columns. [DT00082]
System requirements
The following system requirements should be used to ensure that the setup you are running is fully supported. Ensure that existing deployments are upgraded to currently supported versions of all the software required.
Operating systems
To run i2 products, you must ensure that you are using a supported operating system.
- Red Hat Enterprise Linux (RHEL) 8
- Red Hat Enterprise Linux (RHEL) 7
- Windows 10 Enterprise
- Windows 10 Professional
- Windows Server 2019 Datacenter Edition
- Windows Server 2019 Essentials Edition
- Windows Server 2019 Standard Edition
- Windows Server 2016 Datacenter Edition
- Windows Server 2016 Essentials Edition
- Windows Server 2016 Standard Edition
- Windows Server 2012 R2 Datacenter Edition
- Windows Server 2012 R2 Essentials Edition
- Windows Server 2012 R2 Standard Edition
Software
To run i2 products, you must ensure that your environment includes the listed prerequisite software. In addition you may need to install companion software to enhance your work flow.
Co-packaged software
- i2 Enterprise Insight Analysis 2.5.0
- i2 Analyst's Notebook Premium 9.4.0
- i2 Connect 1.2.0
Compatible companion products
Analyst's Notebook Premium 9.4.0 or later can be used to connect to this version of i2 Analyze.
Prerequisites
- Application Servers
- WebSphere Application Server Liberty 22.0.0.3
- Development Tools
- Temurin 11
- Web Browsers
-
- Google Chrome (latest version)
- Microsoft Edge (latest version)
- Mozilla Firefox (latest version)
- Mozilla Firefox ESR (latest version)
Supported software
- Databases
-
- IBM Db2 Advanced Workgroup Server Edition (minimum version 11.1.3.3)
- IBM Db2 Enterprise Server Edition (minimum version 11.1.3.3)
- IBM Db2 Workgroup Server Edition (minimum version 11.1.3.3)
- IBM Db2 Advanced Enterprise Server Edition (minimum version 11.1.3.3)
- IBM Db2 Advanced Edition VPC option (minimum version 11.5.0.0)
- IBM Db2 Standard Edition VPC Option (minimum version 11.5.0.0)
- Microsoft SQL Server Enterprise Edition 2019
- Microsoft SQL Server Standard Edition 2019
- Microsoft SQL Server Enterprise Edition 2017
- Microsoft SQL Server Standard Edition 2017
- Network Communications
- IBM HTTP Server 9.0.5
Hardware
Ensure that the hardware you are installing onto meets the minimal system requirements. Depending on your environment you may wish to increase these values to improve system performance.
i2 Analyze server
- Disk space
-
A minimum of 4 GB total disk space is recommended for installation based on following minimum requirements:
- 1 GB free disk space for installation for i2 Analyze
- 2 GB free disk space for installation for WebSphere Application Server
- 1 GB free disk space for installation for IBM DB2
Note:An additional 20 GB free disk space is temporarily required to download and unpack the installation media. - Memory RAM
-
In a production environment, a minimum of 16 GB of RAM is required for the application server and 8 GB of RAM is required for the i2 Analyze JVM. The recommended amount of memory is 32 GB for the application server and 16 GB for the i2 Analyze JVM.
- Processor
-
- Minimum: 2 GHz x86-64 dual-core processor
- Network
- Transport Layer Security (TLS)1.2 or later is required. TLS 1.0 and 1.1 are not supported.
Language support
i2 products are tested on a number of various regional variations of operating systems. In addition they are translated into a number of different languages.
Operating system support
Language Group/Language | Language Collection | Support Status |
---|---|---|
Western Europe and USA | Basic | Supported |
Central Europe | Basic | Supported |
Baltic | Basic | Supported |
Cyrillic | Basic | Supported |
Turkic | Basic | Supported |
Arabic | Complex Script | Supported |
Japanese | East Asian | Supported |
Korean | East Asian | Supported |
Traditional Chinese | East Asian | Supported |
Simplified Chinese | East Asian | Supported |
Thai | Complex Script | Unsupported |
Vietnamese | Complex Script | Unsupported |
Greek | Basic | Unsupported |
Hebrew | Complex Script | Unsupported |
Indic | Complex Script | Unsupported |
Georgian | Complex Script | Unsupported |
Armenian | Complex Script | Unsupported |
Dhivehi | Complex Script | Unsupported |
Galician | Complex Script | Unsupported |
Gujararti | Complex Script | Unsupported |
Kannada | Complex Script | Unsupported |
Krgyz | Complex Script | Unsupported |
Mongolian (Cyrillic) | Complex Script | Unsupported |
Punjabi | Complex Script | Unsupported |
Syriac | Complex Script | Unsupported |
Telagu | Complex Script | Unsupported |
Data support
i2 products support unicode data.
Translations
Analyze (Server messages, web clients, and UI hosted in the desktop clients) | Analyst's Notebook Premium (Desktop client including Schema Designer) | |
---|---|---|
Arabic | ✓ | ✓ |
Czech | ✓ | ✓ |
French | ✓ | ✓ |
German | ✓ | ✓ |
Hebrew | ||
Hungarian | ||
Italian | ✓ | ✓ |
Japanese | ✓ | |
Korean | ✓ | |
Polish | ✓ | ✓ |
Portuguese (Brazilian) | ✓ | ✓ |
Russian | ||
Simplified Chinese | ✓ | |
Slovak | ||
Spanish | ✓ | ✓ |
Traditional Chinese | ✓ | |
Turkish | ✓ |
Download information
Customers who have entitlement can request copies of i2 products.
For more information, see Where can I download the latest i2 products?
Known issues
The following issues are currently reported:
- Web clients
-
Table 1. Table 1. Web clients Problem Description Importing entity types that do not have source reference schema fragments set up can cause the import to fail If you have made use of source reference schema fragments to have different schemas for individual items types or groups of item types, it is not advisable to add source references to imported records. Only 500,000 records can be added to a i2 Notebook chart in a single operation Charting more than 500,000 records results in the first 500,000 records being added to the i2 Notebook chart, and no notification is provided that some of the items were not charted. Keyboard navigation does not work within visualizations Attempting to navigate around records that contain visualizations, the visualization cannot be accessed using the tab key. If the tab key is pressed when an item in the visualization is selected, focus is removed from the visualization. Blocks of text are clipped when printing in Firefox If large amounts of text (more than will fit on a printed page) are entered into a record property, note, or source reference, the text will be clipped if the record is printed. Using reserved terms in the highlight-queries-configuration.xml file can cause issues when results are expanded in the Show More view Reserved terms should not be used as the id
value in the highlight-queries-configuration.xml for example:
If reserved terms are added to the<highlightQuery title="Suspects"> <path> <segments> <segment> <Listed_In-I /> <Person-I> <exportFields> <propertyField propertyType="last_name-P" aggregatingFunction="MAX" id="term" /> </exportFields> </Person-I> </segment> </segments> </path> <sortBy> <field id="term" order="ASC" /> </sortBy> </highlightQuery>
id
value, the system will try and interpret them as system specific commands causing unexpected behavior. The following list of reserved terms should not be used as values forid
in the highlight-queries-configuration.xml file:version, id, full_text, full_text_reversed, item_type_id, link_from_id, link_to_id, is_link, link_direction, merged_record_info, record_version, data_source_created, data_source_modified, data_source_seen, data_source_name, data_store_created, data_store_modified, data_store_seen, record_first_uploaded_by, record_last_uploaded_by, record_id, text_facet, source_references_id, source_references_ref_type, source_references_source_name, source_references_location,source_references_image, source_references_description, source_references_is_modifiable
- Information Store
-
Table 2. Table 2. Information Store Problem Description Some non-English characters are replaced in the Information Store table and column names This replacement of characters can change the names that you expect to see, when you are completing operations such as ingesting data. For example, the German language esszett character (written 'ß') is replaced by an underscore in Information Store table and column names. Information Store does not support Read Cloaked The security classification Read Cloaked
is not supported in the Information Store. - i2 Analyze services
-
Table 3. Table 3. i2 Analyze - services Problem Description Visual Query timeout for Geospatial searches of large datasets Depending on the scale and geographic distribution of geospatial data in the system, Visual Query searches can return results slowly, or even timeout. To improve the performance of Visual Queries that use geospatial information, you can create geospatial indexes manually. The message Enter fewer characters is displayed in the Record Inspector when a user enters data into a single-line string The number of characters is less than the limit set in the i2 Analyze schema but contains special characters (for example 'ä'). When data is used in the client, some special characters use more bytes than standard characters. This can cause a validation error because the size of the string is too long. Messages when Solr starts or stops If you are using third-party tools that contain a find
executable, you might see messages that indicate files cannot be found:
These messages might indicate that the system variable that defines the environment path has the path to the third-party tool before the system files. Verify that thefind: unable to access "TCP ": The system cannot find the file specified. find: unable to access ":0 ": The system cannot find the file specified. find: unable to access ":8983 ": The system cannot find the file specified.
Path=
system variable contains paths that point to the third-party command line tools added after the paths that point to the system folders.Searches can stop running after i2 Analyze is restarted If the WebSphere® Liberty Application Server is restarted while searches are running, the search might time out. To prevent this issue, ensure that the HTTP server is restarted when you restart the Application Server.