Release Notes
Abstract
This technical note contains installation instructions, new features, and includes a resolved issues list for the release of QRadar Network Insights 7.3.1 Patch 1 ISO (7.3.1.20180119194650). These instructions are intended for administrators upgrading from QRadar 7.2.8 Patch 3 or later to QRadar Network Insights 7.3.1 Patch 1 by using an ISO file.
Content
What's new
For information on what's new in QRadar products for version 7.3.1, see the following information: https://www.ibm.com/support/knowledgecenter/SS42VS_7.3.1/com.ibm.qradar.doc/c_qradar_ov_whats_new_731.html
About this upgrade
These instructions are intended to assist administrators to update appliances from QRadar 7.2.8 to QRadar Network Insights 7.3.1 Patch 1 by using an ISO file. This ISO can update QRadar, QRadar Risk Manager, and QRadar Vulnerability Manager products from 7.2.8 to version 7.3.1 Patch 1.
QRadar 7.3.1 Patch 1 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 Network Insights 7.3.1 Patch 1. Each host must be updated individually.
Current Version | ISO Upgrades to QRadar Network Insights 7.3.1 Patch 1? |
QRadar Network Insights 7.2.8 Patch 3 or later | Yes, use these release notes to complete this process. |
QRadar Network Insights 7.3.0 (any patch version) | See the QRadar 7.3.1 Patch 1 SFS release notes. |
QRadar Network Insights 7.3.1 | See the QRadar 7.3.1 Patch 1 SFS release notes. |
Figure 1: Administrators on QRadar Network Insights 7.2.8 versions are not required to install each ISO to update to the latest version.
Administrator notes
- The QRadar Console must be updated before you update your QRadar Network Insights appliance.
- If you have a software installation, you need your Red Hat Enterprise ISO and the QRadar Network Insights ISO. Administrators with software installations on their own hardware must read the QRadar Network Insights Install Guide to understand how to partition their systems appropriately.
- QRadar Network Insights administrators much be on QRadar 7.2.8 Patch 3 or later to upgrade.
- The upgrade from QRadar 7.2.8 Patch 3 to QRadar Network Insights 7.3.1 Patch 1 will use a .ISO file. Previously, ISOs were for new appliance installations only, but QRadar 7.3.1 Patch 1 is an exception to this rule because of the Red Hat kernel update requirements.
- The ISO must be mounted to the appliance and run locally on each host.
- The 7.3.1 Patch 1 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 and plan their maintenance windows accordingly.
- If power users created utilities or custom scripts for their QRadar deployment, these files should be copied off the system. During the 7.3.1 Patch 1 update, a warning is displayed that only data in /store is going to be preserved. After the appliance reboots, any scripts, 3rd party accounts, or utilities in /tmp, or /, or /root will be deleted. This does not impact ISO files mounted initially using /root because this cleanup only occurs later in the installation procedure.
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 QRadar Administration Guide.
- All appliances in the deployment must be at the same software and patch level in the deployment.
- Verify that all changes are deployed on your appliances. The update cannot install on appliances that have undeployed changes.
- A QRadar Network Insights 7.3.1 Patch 1 ISO is available for administrators to want to upgrade from QRadar 7.2.8 Patch 3 or install a new appliance or virtual machine. Administrators who want to complete a new installation need to review the QRadar Network Insights Installation Guide.
- If you are unsure of the IP addresses or hostnames for the appliances in the deployment, run the utility /opt/qradar/support/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.
- 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.
Part 1. Staging files and pretesting your deployment (required)
It is important that administrators pretest their deployment to ensure that they will not experience unexpected issues when updating to QRadar 7.3.1 Patch 1. A pretest is a common precaution that should be taken by all administrators before they install an update so that they can locate potential issues. The pretest does not restart services and can be completed without scheduled downtime. The pretest typically takes between 3 to 5 minutes to complete on each appliance. If for some reason your SSH session is disconnected, you can reconnect to the remote host using screen.
Procedure
The pretest should be completed on all hosts by the administrator before you attempt to upgrade to QRadar 7.3.1 Patch 1.
- Download the QRadar Network Insights 7.3.1 Patch 1 ISO (5+ GB) from the IBM Fix Central website: http://www.ibm.com/support/fixcentral/swg/quickorder?parent=IBM%20Security&product=ibm/Other+software/IBM+QRadar+Network+Insights&release=7.3.0&platform=Linux&function=fixId&fixids=7.3.1-QRADAR-QIFFULL-20180119194650&includeSupersedes=0&source=fc
NOTE: QRadar Incident Forensics and QRadar Network Insights use the same ISO for both products to upgrade from 7.2.8 to 7.3.1 Patch 1, which is Rhe764forensics7_3_1_20180119194650.stable-7-3-1.iso.
- Using SSH, log in to your Console as the root user.
- Type the following command: screen
- To make the directory for the update, type: mkdir -p /media/cdrom
- To verify you have enough space (5.5 GB), type: df -h /root /var/log | tee diskchecks.txt
- Best directory option: /root
It is available on all appliance types, is the best option to host the ISO file. - 2nd best directory option: /var/log
This directory is available on all appliances, but there might not be the required space available. - DO NOT USE: /tmp, /store/tmp, or /store/transient for your ISO upgrade. These directories are partitioned as part of the upgrade and administrators cannot use them as storage locations or mount points for the ISO file.
If the disk check command fails, retype the quotation marks from your terminal, and then re-run 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 5.5 GB of space available in a directory to copy the ISO 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 5.5 GB available.
Reminder: Utilities or custom scripts that administrators have created for QRadar should be copied off the system. During the 7.3.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.
- If there is not 5.5GB of space in /root or /var/log, the administrator must make directory space for the ISO file.
- Using WinSCP or SCP, copy the ISO to the /root or /var/log directory on the QRadar Network Insights appliance with 5.5 GB of disk space for the ISO file.
- To mount the ISO on all appliances, type mount -o loop /root/Rhe764forensics7_3_1_20180119194650.stable-7-3-1.iso /media/cdrom
- To pretest the Console appliance, type: /media/cdrom/setup -t
The pretest output will be written to the command window. Review this output after the pretest completes. - Using SSH, open an SSH session to the other appliances in your deployment. QRadar Support recommends that all administrators run the pretest on each host to identify issues before the update begins.
- To pretest the managed host, type: /media/cdrom/setup -t
Results
If an appliance in your deployment fails the pretest, the administrators can take the recommended action from the pretest utility. The issue must be resolved before the update to 7.3.1 Patch 1 begins to prevent downtime for specific appliances. 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. Administrators can open a ticket directly with QRadar Support (http://ibm.biz/qradarsupport).
Part 2. Installing QRadar Network Insights 7.3.1 Patch 1
These instructions guide administrators through the process of upgrading an existing QRadar Network Insights install at 7.2.8 Patch 1 or later to QRadar 7.3.1 Patch 1. The update on the Console must be completed first, before you attempt to update QRadar Network Insights.
Procedure
- Use SSH to log in to the Console as the root user.
- Use SSH to log in to the QRadar Network Insights appliance.
- To run the ISO installer on the Console, type the following command: /media/cdrom/setup
Important: Upgrading from QRadar Network Insights 7.2.8 Patch 1 or later to QRadar Network Insights 7.3.1 Patch 1 can take approximately 1 to 2 hours.
- Wait for the update to complete.
Results
A summary of the ISO installation advises you of any issues. If there are no issues, administrators can now SSH to log in to managed hosts and start the installer on each host to run the setup in parallel.
Part 3. Installation wrap-up
- 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 QRadar SIEM.
- To unmount the /media/cdrom directory on all hosts, type: umount /media/cdrom"
- Administrators can delete the ISO from all appliances.
- Review any static routes or customized routing. As mentioned in the administrator notes, all routes were removed and will need to be reconfigured after the upgrade completes.
- Any iptable rules configured should be reviewed as the interface names have changed in QRadar 7.3.1 Patch 1 due to the Red Hat Enterprise 7 operating system updates. Any iptables rules that use Red Hat 6 interface naming conventions will need to be updated.
Resolved issues
Some APAR links in the table below might take 24 hours to display properly after a software release is posted to IBM Fix Central.
Product | Component | Number | Description |
---|---|---|---|
QRADAR | KERNEL | IJ02902 | RHEL KERNEL PANIC CAN CAUSE UNEXPECTED REBOOTS OF LENOVO X3550 M5 AND X3650 M5 APPLIANCES RUNNING QRADAR 7.3.1.X |
Where do I find more information?
![](/support/pages/system/files/support/swg/swgdocs.nsf/0/cbec56a421d88d37852582200068ce0b/Content/0.84D8.png)
![](/support/pages/system/files/support/swg/swgdocs.nsf/0/cbec56a421d88d37852582200068ce0b/Content/0.91DE.png)
![](/support/pages/system/files/support/swg/swgdocs.nsf/0/cbec56a421d88d37852582200068ce0b/Content/0.9DEA.png)
![](/support/pages/system/files/support/swg/swgdocs.nsf/0/cbec56a421d88d37852582200068ce0b/Content/0.AA72.png)
![](/support/pages/system/files/support/swg/swgdocs.nsf/0/cbec56a421d88d37852582200068ce0b/Content/1.C0E.png)
![](/support/pages/system/files/support/swg/swgdocs.nsf/0/cbec56a421d88d37852582200068ce0b/Content/1.17C4.png)
![](/support/pages/system/files/support/swg/swgdocs.nsf/0/cbec56a421d88d37852582200068ce0b/Content/1.24D2.png)
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg27050761