Arcsight Platform 22.1 Release Notes
Arcsight Platform 22.1 Release Notes
Page 1 of 36
Legal Notices
Copyright Notice
© Copyright 2001 - 2022 Micro Focus or one of its affiliates
Confidential computer software. Valid license from Micro Focus required for possession, use or copying. The information
contained herein is subject to change without notice.
The only warranties for Micro Focus products and services are set forth in the express warranty statements accompanying such
products and services. Nothing herein should be construed as constituting an additional warranty. Micro Focus shall not be
liable for technical or editorial errors or omissions contained herein.
No portion of this product's documentation may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose other than the
purchaser's internal use, without the express written permission of Micro Focus.
Notwithstanding anything to the contrary in your license agreement for Micro Focus ArcSight software, you may reverse
engineer and modify certain open source components of the software in accordance with the license terms for those particular
components. See below for the applicable terms.
U.S. Governmental Rights. For purposes of your license to Micro Focus ArcSight software, “commercial computer software” is
defined at FAR 2.101. If acquired by or on behalf of a civilian agency, the U.S. Government acquires this commercial computer
software and/or commercial computer software documentation and other technical data subject to the terms of the
Agreement as specified in 48 C.F.R. 12.212 (Computer Software) and 12.211 (Technical Data) of the Federal Acquisition
Regulation (“FAR”) and its successors. If acquired by or on behalf of any agency within the Department of Defense (“DOD”), the
U.S. Government acquires this commercial computer software and/or commercial computer software documentation subject
to the terms of the Agreement as specified in 48 C.F.R. 227.7202-3 of the DOD FAR Supplement (“DFARS”) and its successors.
This U.S. Government Rights Section 18.11 is in lieu of, and supersedes, any other FAR, DFARS, or other clause or provision that
addresses government rights in computer software or technical data.
For information about legal notices, trademarks, disclaimers, warranties, export and other use restrictions, U.S.Government
rights, patent policy, and FIPS compliance, see https://www.microfocus.com/about/legal/.
Support
Contact Information
Phone A list of phone numbers is available on the Technical Support
Page: https://softwaresupport.softwaregrp.com/support-contact-information
Page 2 of 36
ArcSight Platform Release Notes
Contents
What's New 7
ArcSight Database Has Now Become Smarter! 7
Updates for ArcSight Command Center for Enterprise Security Manager 8
Updates for ArcSight Intelligence 9
Non-MSSP Licensing Enhancements 9
Overall Risk Page Updates 9
Common ArcSight Masthead 9
Updates for ArcSight Management Center 9
Updates for ArcSight Recon 9
Updates for ArcSight SOAR 10
Updates for ArcSight Fusion 10
Widget for Database Storage Utilization 10
Updates Related to ArcMC 10
Updates Related to SOAR 10
Updates for ArcSight Platform Installer 11
Updates for ArcSight Transformation Hub 11
Reporting EPS Usage for MSSPs 11
Backing Up and Restoring Configuration Data for Deployed Capabilities 12
Technical Requirements 12
Downloading the ArcSight Platform Installation Files 13
Understanding the Files to Download 13
Downloading the Installation Files 15
Deploying or Upgrading Intelligence and Recon with the Enhanced Database 16
Upgrading from Intelligence 6.3 or Recon 1.2 16
Deploying Intelligence or Recon for the First Time in an Upgraded ArcSight Platform
Environment 17
Deploying Intelligence or Recon in a New ArcSight Platform Environment 17
Licensing Information 18
Known Issues 18
Database in 22.1 Release Will Not Support FIPS 19
ArcSight Post-installation Command Fails with Errors 19
Deploying Fusion in AWS Environment with a Load Balancer Requires Proxy Host
Configuration 19
Pods Might Not Run During Fusion Reinstall 20
Page 3 of 36
ArcSight Platform Release Notes
Page 4 of 36
ArcSight Platform Release Notes
Saved Query or Criteria Can Overwrite the Query in a Saved Results that Has the
Same Name 30
Time Range Loads Incorrectly When Selecting the Default Option “DD/MM/YY
hh:mm:ss:ms” 31
Search Fails to Load All Saved Search Criteria Settings 31
Scheduled Searches Sometimes Fail to Export to CSV 31
CSV File Export Fails after You Change the Date and Time Format 32
Fieldset Fails to Revert to its Original Setting 32
Cannot Change the Time Range if Your Preferred Time Range is a Static Value 32
Scheduled Search Appends Erroneous Values to the Run Interval 32
Search Join Fails when Lookup List has 'User' as a Value 33
Cannot Change the Start or End Date While a Notification Banner is Present 33
Cannot Use Search Operators in the Name of a Saved Query or Criteria 33
Search Query Might Return Incorrect Results if the Query is not Explicitly Stated 34
Resolved Issues 34
Post Upgrade fusion-metadata-rethinkdb Pod Might Go Into a Crash Loop 34
Contacting Micro Focus 34
Additional Documentation 34
Page 5 of 36
ArcSight Platform Release Notes
This release includes the following versions of the ArcSight Platform primary components:
Component Version
The documentation for this product is available on the documentation website in HTML and
PDF formats. If you have suggestions for documentation improvements, click comment or
support on this topic at the bottom of any page in the HTML version of the documentation
Page 6 of 36
ArcSight Platform Release Notes
posted at the ArcSight Platform Documentation page or the documentation pages for the
included products.
What's New
The following sections outline the key features and functions provided in this release. For more
information about these enhancements, please see the release notes for the specific product
solution.
The database keeps the primary copy of your data in the communal storage, and the local
cache serves as the secondary copy. This means that adding and removing nodes does not
redistribute the primary copy. This shared storage model enables elasticity, meaning it is both
time and cost effective to adapt the cluster resources to fit the usage pattern of the cluster. If a
node goes down, other nodes are not impacted because of shared storage. Node restarts are
fast and no recovery is needed. Thus, you do not need to keep track of and load/unload long-
term retention event data explicitly. The ArcSight Database can bring them to the cache on
demand automatically then move data out when not in use.
Within communal storage, data is divided into portions called shards. Shards are how the
database divides the data among the nodes. Nodes subscribe to particular shards, with
subscriptions balanced among the nodes. When loading or querying data, each node is
responsible for the data in the shards it subscribes to.
To take advantage of this capability, you must install a new version of the database. You cannot
upgrade from a previous version.
Updates for ArcSight Command Center for Enterprise Security Manager Page 8 of 36
ArcSight Platform Release Notes
average EPS (events per second) ingested and referred to as usage. Micro Focus bases the
usage fee on a tiered rate. The more usage you have, the less each event costs. You must
configure an SMTP server for emails to work and distribute Fusion usage reports.
In the Platform, you can view daily and monthly average EPS usage and enable the feature to
automatically send reports to Micro Focus. You simply enable the Managed Security Services
Provider (MSSP) feature, create an MSSP profile, and add your pay-per-use contracts.
For more information, see "Managing Your Service Provider Contracts" in the ArcSight Platform
Help or in the User's Guide for Fusion in the ArcSight Platform. For more information about the
Partner Pay Per Use Program, see the Reporting EPS Usage Quick Start Guide.
Technical Requirements
For more information about the software and hardware requirements required for a successful
deployment, see theTechnical Requirements for ArcSight Platform.
These Technical Requirements include guidance for the size of your environment based on
expected workload. Micro Focus recommends the tested platforms listed in this document.
Customers running on platforms not provided in this document or with untested configurations
will be supported until the point Micro Focus determines the root cause is the untested platform
or configuration. According to the standard defect-handling policies, Micro Focus will prioritize
and fix issues we can reproduce on the tested platforms.
To understand the files that you might need for your ArcSight Platform deployment, review the
descriptions in the following table:
All Deployments - Images esm-7.6.0.37.tar Contains the images for deploying ESM
Command Center
fusion-1.5.0.37.tar and arcsight- Contains the images for deploying the Fusion
fusion-1.5.0-license.txt capability
3. Download all the necessary product installer files from the Micro Focus Downloads
website along with their associated signature files (.sig). Micro Focus provides a digital
public key that is used to verify that the software you downloaded from the Micro Focus
software entitlement site is indeed from Micro Focus and has not been tampered with by a
third party. For more information and instructions on validating the downloaded software,
visit the Micro Focus Code Signing site. If you discover a file does not match its
corresponding signature (.sig), attempt the download again in case there was a file transfer
error. If the problem persists, please contact Micro Focus Customer Support.
4. Begin the installation. For more information, see "Using the ArcSight Platform Installer" in
the Administrator’s Guide for ArcSight Platform.
Because this release significantly changes the ArcSight Database, you cannot upgrade the
database. It must be installed as new. However, this release does allow you to upgrade Recon
and Intelligence in your environment, as well as install either capability for the first time. This
section provides guidance for upgrading or deploying these capabilities:
l "Upgrading from Intelligence 6.3 or Recon 1.2" below
l "Deploying Intelligence or Recon for the First Time in an Upgraded ArcSight Platform
Environment" on the next page
l Deploying Intelligence or Recon in a New ArcSight Platform Environment
l "Deploying or Upgrading Intelligence and Recon with the Enhanced Database" above
You can upgrade to this release from Intelligence 6.3 and Recon 1.2. However, you cannot
upgrade the ArcSight Database because this release supports a cost-effective long-term
storage solution that is not available with the previous database version.
Deploying or Upgrading Intelligence and Recon with the Enhanced Database Page 16 of 36
ArcSight Platform Release Notes
For more information about installing this new version of the database, see the following
sections in the Administrator’s Guide for ArcSight Platform provided at the ArcSight
Documentation site:
l For an automated installation in an on-premises environment, see Using the ArcSight
Platform Installer
l For a manual installation in an on-premises environment, see Installing the Database
l For an AWS environment, see Installing the Database in AWS
l For an Azure environment, see Installing the Database in Azure
To prevent the current and new databases from ingesting duplicate data, complete the steps
outlined for Stopping Event Ingestion on the current database.
To start data ingestion on the new database after upgrading the ArcSight Platform, continue to
Completing the Database and Kafka Setup.
Deploying Intelligence or Recon for the First Time in an Upgraded ArcSight Page 17 of 36
ArcSight Platform Release Notes
Licensing Information
For information about activating a new license, see Installing Your License Key in the
Administrator’s Guide for ArcSight Platform.
Known Issues
These issues apply to common or several components in your ArcSight Platform deploy. For
more information about issues related to a specific product, please see that product's release
notes.
Micro Focus strives to ensure that our products provide quality solutions for your enterprise
software needs. If you need assistance with any issue, visit Micro Focus Support
(https://www.microfocus.com/support-and-services/), then select the appropriate product
category.
l "Database in 22.1 Release Will Not Support FIPS" on the next page
l "ArcSight Post-installation Command Fails with Errors" on the next page
l "Deploying Fusion in AWS Environment with a Load Balancer Requires Proxy Host
Configuration" on the next page
l "Pods Might Not Run During Fusion Reinstall" on page 20
l "Installation, Upgrade, or Adding Additional Capabilities Fails Due to Comma Character in
On-Premises Docker Container Registry Admin Password" on page 21
l "CDF Management Portal Admin Password Change Fails to Update Registry Admin
Password" on page 21
l "On Multi-master Non-root Install, itom-cdf-keepalived Pod Restarting and Suite Fails
to Deploy" on page 21
l After Upgrade from Patch, Error Message Returned: Failed to upgrade Internal Server Error
l "Accessing the CDF Management Portal Reconfigure Page" on page 22
l "Contract & Usage Page Throws an Ingress Router Error and Does Not Load" on page 23
l Displays an Erroneous Warning about a Recon License
l "Backup Failures in S3 While Deleting Obsolete Files" on page 24
l "Event Integrity Query for Large Time Range Indicates Insufficient Disk Space (AWS/Azure)"
on page 24
l "Event Integrity Query Indicates Insufficient Disk Space (AWS/Azure) " on page 24
<Tenant
xmlns="uri.osp.xml.config.05.2015"
id="default"
displayName="Hercules Tenant"
>
<HTTPInterface
id="default-http-domain"
displayName="Hercules HTTP"
path="/osp"
port="${HTTP_INTERFACE_PORT:443}"
tls="${HTTP_INTERFACE_SSL:true}"
domainName="${HTTP_INTERFACE_DOMAIN}"
cookieDomain="${HTTP_INTERFACE_DOMAIN}"
proxyPort="443"
proxyTls="true"
proxyDomain="{--external-access-host}"
/>
<HTTPInterface
id="default-http-svc"
displayName="Hercules HTTP"
path="/osp"
port="${HTTP_INTERFACE_PORT:443}"
tls="${HTTP_INTERFACE_SSL:true}"
ipAddress="${HTTP_INTERFACE_IP}"
cookieDomain="${HTTP_INTERFACE_IP}"
proxyPort="443"
proxyTls="true"
proxyDomain="{--external-access-host}"
/>
manually via install.sh, you will notice only the itom-cdf-keepalived pod in single replica
count and crashing, even before you try to deploy the capabilities.
Workaround: Use kubectl edit ds/itom-cdf-keepalived -n kube-system to edit the
daemonset definition of cdf-keepalived. Locate the "nodeSelector" section and change its
value (make sure to honor the spacing) to master: "true". Save and exit as a normal vi session.
Make sure command kubectl get ds/itom-cdf-keepalived -n kube-system returns now
the current/desired replica count of 3.
After an Upgrade from the Patch Release, Error Returned: "Failed to upgrade. Page 22 of 36
ArcSight Platform Release Notes
(OCTCR33I372067)
Workaround: Refresh the page to load the Contract & Usage page.
Contract & Usage Page Throws an Ingress Router Error and Does Not Load Page 23 of 36
ArcSight Platform Release Notes
Specified Sizes for Dashboard Table Cells do not Work in a SaaS Environment Page 26 of 36
ArcSight Platform Release Notes
l "Scheduled Tasks Do Not Allow Default Printer Selection" on the next page
l "Scheduled Tasks Can be Saved Even if the User Closes the Dialog Box" on the next page
l "Load Modal Does Not Load Search Criteria When the Fieldset is Deleted" on the next page
l "Saved Query or Criteria Can Overwrite the Query in a Saved Results that Has the Same
Name" on the next page
l "Time Range Loads Incorrectly When Selecting the Default Option “DD/MM/YY
hh:mm:ss:ms”" on page 31
l "Search Fails to Load All Saved Search Criteria Settings" on page 31
l "Scheduled Searches Sometimes Fail to Export to CSV" on page 31
l "CSV File Export Fails after You Change the Date and Time Format" on page 32
l "Fieldset Fails to Revert to its Original Setting" on page 32
l "Cannot Change the Time Range if Your Preferred Time Range is a Static Value" on page 32
l "Scheduled Search Appends Erroneous Values to the Run Interval" on page 32
l "Search Join Fails when Lookup List has 'User' as a Value" on page 33
l "Cannot Change the Start or End Date While a Notification Banner is Present" on page 33
l "Cannot Use Search Operators in the Name of a Saved Query or Criteria" on page 33
l "Search Query Might Return Incorrect Results if the Query is not Explicitly Stated" on
page 34
l "Fieldsets Default to Base Event Fields After an Upgrade" below
l "Fieldsets Display Database Names" below
Workaround: To identify the coding-style names, see “Mapping Database Names to their
Appropriate Search Fields” in the Help or the User Guide for ArcSight Recon.
Query or Criteria with the specified name. For example, you execute a search and save the
results as Checking Log4J Vulnerabilities. If you create and save a new search Query or
Criteria with that same name, you have changed the query in the saved Results. The next time
that you run Checking Log4J Vulnerabilities, Search will use the newly saved query
instead of your original query. (OCTCR33I369158)
Workaround: Before saving a new Query or Criteria, review the existing saved Results to ensure
that you do not use the same name.
Time Range Loads Incorrectly When Selecting the Default Option “DD/MM/YY Page 31 of 36
ArcSight Platform Release Notes
CSV File Export Fails after You Change the Date and
Time Format
Issue: After modifying the date and time format in preferences, the CSV export function for
saved searches runs before the preference change fails. (OCTCR33I113040)
Workaround: Run the scheduled search again, then save it. Select the CSV icon to download
the file.
CSV File Export Fails after You Change the Date and Time Format Page 32 of 36
ArcSight Platform Release Notes
For example, you might select Every 2 hours and choose Starting From at 01:15 am. Search
will run every 2 hours at 2:15 am, 4:15 am, 6:15 am, and so on.
Workaround: To run the Search at a selected hour and minutes, specify a specific hour for the
Starting From setting.
& No workaround
| No workaround
and Use without spaces before or after the term. For example: UsersAndDevices
or Use without spaces before or after the term. For example: UsersORdevices
Search Join Fails when Lookup List has 'User' as a Value Page 33 of 36
ArcSight Platform Release Notes
Resolved Issues
These issues apply to common or several components in your ArcSight Platform deploy. For
more information about issues related to a specific product, please see that product's release
notes.
Additional Documentation
The ArcSight Platform documentation library includes the following resources.
Search Query Might Return Incorrect Results if the Query is not Explicitly Page 34 of 36
ArcSight Platform Release Notes
l Administrator's Guide for ArcSight Platform, which contains installation, user, and
deployment guidance for the ArcSight software products and components that you deploy
in the containerized platform.
l Technical Requirements for ArcSight Platform, which provides information about the
hardware and software requirements and tuning guidelines for the ArcSight Platform and
the deployed capabilities.
l User’s Guide for Fusion 1.5 in the ArcSight Platform, which is embedded in the product to
provide both context-sensitive Help and conceptual information.
l Product Support Lifecycle Policy, which provides information on product support policies.