IBM Support

Release of the QRadar 7.3.0 Patch 1 ISO (7.3.0.20170503143306) (Updated CVE Fixed Issue)

Release Notes


Abstract

A list of the installation instructions, new features, and resolved issues list for the release of IBM Security QRadar 7.3.0 Patch 1 (7.3.0.20170503143306) ISO.

Content

These instructions are intended to assist administrators with updating appliances from QRadar 7.2.8 to QRadar 7.3.0 Patch 1 using an ISO file. If you have a software installation, need the latest memory requirements, or are making use of offboard storage, it is recommended that you review the QRadar Upgrade Guide.


 

What's new in QRadar 7.3.0

  • Events per second and flows per minute are now combined in to shared license pools that can be distributed as administrators require across the deployment.
  • QRadar updates the core operating system to Red Hat Enterprise 7.3.
  • New installations can now use Logical Volume Management (LMV) for disk and partition management.
  • Activation keys are no required as administrators can select an installation type based on the performance of the appliance.
  • Log source limits are removed after updating to QRadar 7.3.0. Administrators can have an unlimited number of log sources in their deployment.
  • QRadar now uses TLS v1.2 for secure communications between hosts and for internal communications.
  • Tenants in QRadar can now create their own reference data collections.
  • Tenants in QRadar can now create their own custom event/flow properties; however, the MSSP administrator is the only user that can optimize these custom properties.
  • HA performance has been improved on Event Collector appliances (15xx) to reduce collection downtime during a failover.
  • HA now provides new sensors to detect new or unique failover scenarios.
  • A number of API updates have been made to support new features.
  • Ariel Query Language (AQL) now supports session queries, bitwise operators, and explicit start, stop, and begin functions.
  • An updated app framework and a new App Node are available to host QRadar apps off the Console to preserve resources.
  • Remote Networks and Remote Services user interfaces are now improved.
  • The Deployment Editor is now removed in QRadar 7.3.0.

About this upgrade & general information


QRadar 7.3.0 uses an ISO file to update hosts to the latest software version. A minimum of QRadar 7.2.8 Patch 1 (or later) is required to be able to upgrade to QRadar 7.3.0 Patch 1. Each host must be updated individually, this includes HA secondary appliances.

What to know
Current QRadar Version Updates to QRadar 7.3.0 Patch 1?
QRadar 7.2.8 Patch 1 to Patch 6 Yes, requires the QRadar 7.3.0 Patch 1 ISO to update. See instructions below.
QRadar 7.3.0 Yes, requires the QRadar 7.3.0 Patch 1 SFS to update.
  1. You must be on QRadar 7.2.8 Patch 1 or later to upgrade to QRadar 7.3.0 Patch 1.
  2. The upgrade from QRadar 7.3.8 Patch 1 to QRadar 7.3.0 Patch 1 will use a .ISO file. In the past, support has stated that ISOs are for new appliance installs only, but QRadar 7.3.0 is going to be an exception to this rule because of the Red Hat kernel update requirements.
  3. Each HA appliance must be updated individually by using the ISO file. The SFS file is capable of allowing the primary appliance to update the secondary, but the ISO file does not support this functionality. If you run the ISO setup on an HA primary, you should wait for the update to complete, then run the setup on the HA secondary.
  4. There is no patch "All" option as QRadar 7.3.0 uses an ISO file to upgrade. The ISO must be mounted to the appliance and run locally on each host. If you have a software install, you need your Red Hat Enterprise ISO and the QRadar ISO. Administrators with software installations on your own hardware MUST read the QRadar Upgrade Guide to understand how to partition their systems appropriately.
  5. For administrators with managed WinCollect agents, you must upgrade to WinCollect 7.2.5 before installing QRadar 7.3.0 Patch 1. WinCollect 7.2.5 is a prerequisite for QRadar 7.3.0. However, stand-alone WinCollect agents are not impacted by this requirement.
  6. The 7.3.0 upgrade will take longer than expected due to the kernel changes to Red Hat 7 Enterprise. Early upgrade customers are reporting 2 to 2.5 hours to upgrade the Console appliance. Administrators should be aware of this longer time frame to plan their maintenance windows.
  7. Utilities or custom scripts that power users might have created for their QRadar deployment should be copied off the system. During the 7.3.0 update a warning is displayed that only data in /store is going to be preserved. Therefore, scripts, 3rd party accounts, or utilities in /tmp, or /, or /root will be deleted.
     

The 7.3.0-QRADAR-QRSIEM-20170503143306 ISO can upgrade QRadar 7.2.8 Patch 1 and later to QRadar 7.3.0 Patch 1. If you are on a version of QRadar earlier than QRadar 7.2.8 Patch 1, you must upgrade to QRadar 7.2.8 Patch 1 or later before proceeding to install the QRadar 7.3.0 Patch 1 ISO to upgrade an appliance. For a list of every release note for QRadar, see the QRadar Master Software List. For older versions, customers can view the QRadar Upgrade Progression Guide.
 

Before you upgrade


Ensure that you take the following precautions:
 

  • Back up your data before you begin any software upgrade and verify that you have recent configuration backups that match your existing Console version. If required, take an on-demand configuration backup before you begin. For more information about backup and recovery, see the IBM Security QRadar Administration Guide.
  • HA appliances should have primaries in the online state and secondary as standby for their HA pair status.
  • If you have offboard storage configured, see the QRadar Upgrade Guide as there are special instructions for administrators with /store using offboard storage.
  • To avoid access errors in your log file, close all open QRadar sessions.
  • All appliances in the deployment must be at the same software & patch level in the deployment.
  • Verify that all changes are deployed on your appliances. The update cannot install on appliances that have changes that are not deployed.
  • A QRadar 7.3.0 Patch 1 ISO is available for administrators to want to upgrade from QRadar 7.2.8 Patch 1 or install a new appliance or virtual machine. Administrators who want to complete a new install need to review the QRadar Installation Guide.
  • If you are unsure of how to proceed when reading these instructions or the documentation, it is best to ask before starting your upgrade. To ask a question in our forums, see: http://ibm.biz/qradarforums.

Pretest your deployment (required)


It is important that administrators pretest their deployment to ensure that they will not experience unexpected upgrade issues when trying to install QRadar 7.3.0 Patch 1. A pretest is a common precaution that should be taken by all administrators before they enter their maintenance window to locate problems before the upgrade begins. This procedure allows administrators to run an SSH session to copy files, mount the ISO, and start the pretest all within a screen session. If for some reason your SSH session is disconnected, you can reconnect to the remote host using screen.


  • Procedure
    This procedure should be completed and output reviewed before you schedule maintenance windows or attempt to upgrade to QRadar 7.3.0 Patch 1.
    1. Download the ISO to install QRadar 7.3.0 Patch 1 from the IBM Fix Central website: http://www.ibm.com/support/fixcentral/swg/quickorder?parent=IBM%20Security&product=ibm/Other+software/IBM+Security+QRadar+SIEM&release=7.3.0&platform=Linux&function=fixId&fixids=7.3.0-QRADAR-QRFULL-20170503143306&includeRequisites=1&includeSupersedes=0&downloadMethod=http&source=fc
    2. Using SSH, log in to your Console as the root user.
    3. To verify you have enough space (5GB) in /tmp for the ISO on the Console, type:
      df -h /tmp
    4. Using SCP or WinSCP, copy the ISO file to the /tmp directory of the QRadar Console.
    5. Type the following command:
      screen
    6. To check disk space on /tmp for all QRadar appliances, type:
      /opt/qradar/support/all_servers.sh -k "df -h /tmp" | tee diskchecks.txt
      If the disk check command fails, retype the quotation marks from your terminal, then rerun the command. This command returns the details to both the command window and to a file on the Console named diskchecks.txt. Review this file to ensure that all appliances have at minimum 5GB of space available in /tmp before attempting to move the file to a managed host. If required, free up disk space on any host that fails to have less that 5GB available.

      Reminder: Utilities or custom scripts that power users might have created for their QRadar deployment should be copied off the system. During the 7.3.0 Patch 1 update a warning is displayed that only data in /store will be preserved. Therefore, scripts, 3rd party utilities in /tmp, or /, or /root will be deleted during the upgrade.

    7. From the / directory, type:
      /opt/qradar/support/all_servers.sh -k -p Rhe764QRadar7_3_0_20170503143306.stable-7-3-0.iso
      This command copies the ISO file to each managed host in the deployment, plus any HA secondary appliances in stand-by mode.

    8. To make the directory and mount the ISO, type: 
      /opt/qradar/support/all_servers.sh -k “mkdir -p /media/cdrom || umount /media/cdrom; mount -o loop /tmp/Rhe764QRadar7_3_0_20170503143306.stable-7-3-0.iso /media/cdrom; /media/cdrom/setup -t” | tee pretest.txt
      This command will create the /media/cdrom directory, mount the ISO file to the managed host, then run the pretest command on each managed host. The pretest output will be written to the command window and also to a file on the Console named pretest.txt.

    9. Wait for the results to be returned to the Console.

      Results
      Review the pretest.txt output file for the deployment looking for any failed pretest messages. If appliances in your deployment fail any of the pretest checks, the administrators can take the recommended action from the pretest utility. If there are messages you do not understand or want to discuss further, you can use our forums http://ibm.biz/qradarforums to get advice. Alternately, administrators can open a ticket directly with QRadar Support (http://ibm.biz/qradarsupport).

Installing the QRadar 7.3.0 Patch 1 ISO on the Console Appliance


These instructions guide administrators through the process of upgrading an existing QRadar install at 7.2.8 Patch 1 or later to QRadar software version 7.3.0 Patch 1.

  • Procedure
    1. Using SSH, log in to the Console as the root user.
    2. To run the ISO installer, type the following command:
      /media/cdrom/setup
      Important: Upgrading from QRadar 7.2.8 Patch 1 or later to QRadar 7.3.0 Patch 1 should take approximately 2 hours. Upgrades for managed hosts should take approximately 1.5 hours. If you experience extended upgrade times, you can contact QRadar Support for more information (http://ibm.biz/qradarsupport).
    3. After the patch completes and you have exited the installer, type the following command:
      
      umount /media/updates
    4. Administrators and users should clear their browser cache before logging in to the Console.

      If your Secure Shell (SSH) session is disconnected while the upgrade is in progress, the upgrade continues. When you reopen your SSH session and rerun the installer, the patch installation resumes.


      Results
      A summary of the ISO installation advises you of any issues. If there are no issues, administrators can now SSH and run the ISO setup on the Console HA secondary appliance, if you have an HA pair. If you do not have a Console in HA, you can then start SSH sessions to each host and run the setup in parallel.

      After all hosts are updated, administrators can send an email to their team to inform them that they will need to clear their browser cache before logging in to the QRadar SIEM interface.
 

Installing the QRadar 7.3.0 Patch 1 ISO on all other managed hosts


After the Console and Console HA secondary are updated to QRadar 7.3.0 Patch 1, then the rest of the deployment can upgraded. There is no order required for updating appliances after the Console and Console secondary are updated. Customers can start the ISO update in parallel on multiple hosts. However, you must open an SSH session to each host. The all_servers.sh utility is not supported for parallel ISO installations.

NOTE: If you are unsure of the IP addresses or hostnames for the appliances in the deployment, run the utility deployment_info.sh to get a .CSV file with information about the QRadar deployment. The .CSV file will contain a list of IP addresses for each managed host.

  • Procedure
    1. Using SSH, log in to the Console as the root user.
    2. Open an SSH session to each managed host and type the following command:
      
      /media/cdrom/setup
      Important: Upgrading from QRadar 7.2.8 Patch 1 or later to QRadar 7.3.0 Patch 1 should take approximately 2 hours. Upgrades for managed hosts should take approximately 1.5 hours. If you experience extended upgrade times, you can contact QRadar Support for more information (http://ibm.biz/qradarsupport).
    3. After the patch completes and you have exited the installer, type the following command:
      
      umount /media/updates
    4. Administrators and users should clear their browser cache before logging in to the Console.

      If your Secure Shell (SSH) session is disconnected while the upgrade is in progress, the upgrade continues. When you reopen your SSH session and rerun the installer, the patch installation resumes.

      Results
      A summary of the ISO installation advises you of any issues. If there are no issues, administrators can now run the ISO setup on the Console HA secondary appliance, if you have an HA pair. If you do not have a Console in HA, you can then start SSH sessions to each host and run the setup in parallel.

      After all hosts are updated, administrators can send an email to their team to inform them that they will need to clear their browser cache before logging in to the QRadar SIEM interface.


Resolved issues

Note: Some APAR links in the table below might take 24 hours to display properly after a software release. A full APAR link for all QRadar versions is available
 

Issues resolved in QRadar 7.3.0 Patch 1
Number Description
SECURITY BULLETIN IBM JAVA AS USED IN IBM QRADAR SIEM IS VULNERABLE TO MULTIPLE CVES
IV95246 THERE ARE NOT ENOUGH UNALLOCATED EPS IN THE POOL TO MAINTAIN THE EVENT RATE LIMITS THAT ARE ASSIGNED TO THE MANAGED HOSTS
IV94784 QRADAR USER INTERFACE OUTAGES WITH LOGS DISPLAYING HOSTCONTEXT '...TOO MANY OPEN FILES' MESSAGES
IV94700 FORENSICS APPLIANCE UPGRADE TO QRADAR 7.3 CAN SOMETIMES FAIL
IV93961 'DELETE LISTED' OPTION WHILE FILTERED ON A REFERENCE SET DATA LIST CAN DELETE ALL REFERENCE SET DATA
IV93459 SYSTEM AND LICENSE MANAGEMENT CAN TAKE A LONGER THAN EXPECTED TIME TO LOAD IN LARGE QRADAR DEPLOYMENTS
IV92977 VULNERABILITY SEARCH DASHBOARD ITEMS CHANGES DO NOT PERSIST AFTER LOG OUT OF THE QRADAR USER INTERFACE
IV92852 REPORTS RUNNING ON 'ACCUMULATED DATA' CAN SOMETIMES FAIL DUE TO THE GLOBAL VIEW DAILY ROLLUPS FAILING
IV92466 QRADAR SEARCHES CAN FAIL TO COMPLETE AND/OR DASHBOARD DATA CAN FAIL TO LOAD DUE TO AN ARIEL CONNECTION LEAK
IV91679 I/O ERROR FOR MANAGED HOST(S) DISPLAYED IN THE SEARCH WINDOW WHILE RUNNING LOG AND/OR NETWORK ACTIVITY SEARCHES
IV91675 AN 'APPLICATION ERROR' CAN BE DISPLAYED FOR NEW USERS LOGGING INTO THE QRADAR USER INTERFACE INSTEAD OF A DEFAULT DASHBOARD
IV91634 ARIEL SEARCHES THAT ARE RUN USING API VERSION 7.0+ DO NOT RETURN PAYLOAD PROPERLY FOR PARSING
IV91615 'ERROR: COULD NOT FIND OR LOAD MAIN CLASS COM.Q1LABS.CORE.UTIL . PASSWORDENCRYPT' WHEN CONFIGURING LDAP HOVER FEATURE
IV91607 'UNEXPECTED ERROR WHILE RETRIEVING GET_LOGS STATUS' WHEN A NON-ADMIN USER ACCESSES SYSTEM AND LICENCE MANAGEMENT
IV90795 DRILLING INTO A SEARCH THAT WAS GROUPED BY A CUSTOM EVENT PROPERTY WITH PARENTHESIS DOES NOT WORK AS EXPECTED
IV90792 USERS WITH DEFAULT DOMAIN PERMISSIONS CANNOT VIEW LOG SOURCE AND LOG SOURCE GROUP EVENT FILTERS
IV90791 'APPLICATION ERROR' WHEN OPENING SOME OFFENSES
IV89591 LARGE CSV EXPORTS FROM QVM 'SCAN RESULTS' CAN TAKE AN UNEXPECTEDLY LONG TIME TO COMPLETE
IV89558 FILTERING BY PHRASE OR VENDOR IN A SCAN POLICY VULNERABILITY SEARCH RETURNS INCOMPLETE RESULTS
IV77665 SOME QRADAR ADVANCED SEARCHES DO NOT COMPLETE, DISPLAYING 'IN PROGRESS 0% COMPLETE'
IV75242 NETFLOW FORWARDING CAN BE INCONSISTENT FROM A HIGH AVAILABILITY PAIR
Issues resolved in QRadar 7.3.0
Number Description
IV94244 QRADAR PATCHING TO 7.3.0 CAN FAIL AT 'ERROR: THE UPGRADE PHASE SCRIPT 40-PRESERVE_PROTECTED_SEARCH_RESULTS.SH FAILED...'
IV91030 QRADAR APPS THAT REQUIRE SPECIFIC USER ROLE PERMISSIONS CAN STOP WORKING AFTER PATCHING TO QRADAR 7.2.8 PATCH 1
IV88705 ASSET UI SCREEN APPLICATION ERROR DISPLAYED DUE TO DELETED ASSET SEARCH
IV89204 QRADAR ASSET PROFILER TREATS HOSTNAMES WITH DIFFERENT CASE CHARACTERS AS SEPARATE ASSETS
IV84736 TOMCAT OUT OF MEMORY CAN OCCUR CAUSING THE USER INTERFACE TO BECOME INACCESSIBLE
IV91288 OFFENSES CAN SOMETIMES STOP GENERATING WHEN OFFENSES ARE INDEXED ON CUSTOM PROPERTIES
IV88270 USING COMPLEX FILTERS ON LOG AND/OR NETWORK ACTIVITY PAGE SEARCHES CAN CAUSE PIPELINE PERFORMANCE ISSUES/NOTIFICATION
IV90364 SETTING A CUSTOMIZED 'RULE RESPONSE' NAME/DESCRIPTION FOR THE 'LACK OF DEVICE' RULE TEST DOES NOT WORK AS EXPECTED
IV78366 THE ECS-EC PROCESS CAN SOMETIMES RUN OUT OF MEMORY WHEN A LARGE NUMBER OF EVENTS WITH CUSTOM PROPERTIES ARE RECEIVED
IV89556 ECS-EP PROCESS RUNNING, BUT EVENT/FLOW PROCESSING NOT OCCURING ON A QRADAR APPLIANCE
IV90906 TIMES SERIES NOT WORKING FOR SOME NON-ADMIN QRADAR USERS
IV91098 INVAILD SUPER INDEXES CAN CAUSE 'GENERAL FAILURE. PLEASE TRY AGAIN' MESSAGES WHEN USED IN A FILTER IN SEARCHES
IV89015 APPLICATION ERROR WHEN DOUBLE CLICKING THE RESULTS OF AN 'ADVANCED SEARCH' (AQL)
IV90007 TIMESERIES ACCUMULATION AND/OR REPORTS CAN FAIL TO GENERATE IN SOME INSTANCES AFTER PATCHING TO QRADAR 7.2.7.X
IV89209 REPEATED ARIEL PROCESS OUT OF MEMORY OCCURANCES WITH LARGE VOLUMES OF DATA IN /STORE/TRANSIENT
IV89207 OPENING AN EVENT FROM AN ADVANCED SEARCH (AQL) RESULTS LIST CAN OPEN THE INCORRECT EVENT IF A COLUMN SORT HAS BEEN PERFORMED
IV90601 FLOW RETENTION WINDOW DOES NOT ACCURATELY DISPLAY DISTRIBUTION USAGE PERCENTAGES
IV73227 INTERMITTENT AND/OR FREQUENT QRADAR SYSTEM NOTIFICATIONS: 'ACCUMULATOR FALLING BEHIND'
IV87313 'SOURCE' AND 'DESTINATION' NETWORK GROUP SHOW FULL NETWORK HIERARCHY NAME WHEN ADDED AS A COLUMN TO DISPLAY
IV90633 QRADAR DATABASE REPLICATION PROCESS CAN TAKE A LONGER THAN EXPECTED AMOUNT OF TIME
IV89022 CUSTOM PROPERTIES SAVED TO ADVANCED SEARCHES (AQL) WITH INVALID SYNTAX ARE UNABLE TO BE DELETED
IV91638 IMPORTING VULNERABILITY SCAN DATA FROM XML INTO QRADAR CAN SOMETIMES FAIL WITH AN EXCEPTION IN THE LOGS
IV85834 EMAIL ADDRESS VALIDATION IN QRADAR ONLY ALLOWS FOUR CHARACTERS IN THE LAST SECTION OF THE DOMAIN
IV89662 UNABLE TO EDIT BULK ADDED LOG SOURCES AFTER A QRADAR CONFIGURATION RESTORE IS PERFORMED
IV90376 SECURITY APP EXCHANGE APPLICATIONS CAN FAIL TO COMMUNICATE IN SOME HIGH AVAILABILITY QRADAR CONFIGURATIONS
IV91071 QRADAR XX48 APPLIANCE ISO BUILDS CAN FAIL WITH 'INVALID ACTIVATION KEY' MESSAGE
IV90089 HOSTCONTEXT PROCESS NAME IS NOT CONSISTENT IN ALL AREAS OF QRADAR
IV86682 SYSTEM NOTIFICATIONS STATING 'THE PRIMARY HIGH AVAILABILITY SYSTEM FAILED' WHEN NO FAILOVER HAS OCCURRED
IV85384 HIGH AVAILABILITY STANDBY APPLIANCE USING CROSSOVER CABLE CAN HAVE ROUTING INCORRECTLY UPDATED
IV85366 QRADAR CONSOLE CONTINUES TO PING THE IP OF A MANAGED HOST CLUSTER AFTER IT IS REMOVED FROM THE DEPLOYMENT
IV87497 IO ERRORS WHEN PERFORMING SEARCHES AFTER A DEPLOY FUNCTION WHERE AN ENCRYPTED MANAGED HOST EXISTS IN THE DEPLOYMENT
IV74231 QRADAR ADMIN TAB DISPLAYS MESSAGE 'THERE ARE UNDEPLOYED CHANGES...' WHEN NO CHANGES HAVE BEEN MADE
IV87856 QRADAR PATCHES THAT INCLUDE A JAVA VERSION UPDATE DO NOT MOVE THE US EXPORT JAR FILES INTO THE APPROPRIATE DIRECTORY
IV89587 KEYBOARD CURSOR/ARROW KEYS AND CTRL-A FUNCTIONS ARE INCONSISTENT ACROSS THE QRADAR USER INTERFACE
IV76165 FLOW SOURCE ALIASES DO NOT APPEAR IN THE ADD FILTER, FLOW INTERFACE, 'VALUE:' DROP DOWN FOR NETWORK ACTIVITY SEARCHES
IV90069 LIST OF OPERATING SYSTEMS AVAILABLE TO SELECT FOR ASSETS IS MISSING SOME OS VERSION ENTRIES
IV90066 'GENERAL FAILURE. PLEASE TRY AGAIN' WHEN PERFORMING A 'GROUP BY' SEARCH OF A PROPERTY, FILTERED AGAINST A REFERENCE SET
IV93147 NETWORK HIERARCHY SEARCH ATTEMPT RESULTS IN POP UP MESSAGE 'AN ERROR OCCURRED, ARGUMENT TYPE MISMATCH'
IV89519 RULES THAT TEST AGAINST REFERENCE MAP OF DATA SETS CAN SOMETIMES FIRE UNEXPECTEDLY
IV89341 SINGLE RUN HOURLY REPORT CAN SOMETIMES RUN TWICE
IV88805 DOMAINS BASED ON CEP VALUE BROKEN STARTING IN QRADAR 7.2.7
IV89363 MULTIPLE SIMULTANEOUS REFERENCE DATA ADDITIONS AND/OR DELETIONS USING THE API CAN CAUSE THE QRADAR UI TO BECOME UNRESPONSIVE
IV87507 SOME DASHBOARD ITEMS NO LONGER DISPLAY IN THE QRADAR USER INTERFACE

[{"Product":{"code":"SSBQAC","label":"IBM Security QRadar SIEM"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Documentation","Platform":[{"code":"PF016","label":"Linux"}],"Version":"7.2","Edition":"All Editions","Line of Business":{"code":"LOB24","label":"Security Software"}}]

Document Information

Modified date:
05 July 2022

UID

swg27049808