Juniper Secure Analytics JSA 7.5.0 Update Package 5 Interim Fix 02 Release Notes

Published: 2023-06-26

Installing the JSA 7.5.0 Update Package 5 Interim Fix 02 Software Update

JSA 7.5.0 Update Package 5 Interim Fix 02 resolves reported issues from users and administrators from previous JSA versions. This cumulative software update fixes known software issues in your JSA deployment. JSA software updates are installed by using an SFS file. The software update can update all appliances attached to the JSA Console.

NOTE: Before you attempt to apply JSA 7.5.0 Update Package 5 Interim Fix 02, you must upgrade to JSA 7.5.0 Update Package 05.

This document does not cover all the installation messages and requirements, such as changes to appliance memory requirements or browser requirements for JSA. For more information, see the Juniper Secure Analytics Upgrading JSA to 7.5.0.

Ensure that you take the following precautions:

Back up your data before you begin any software upgrade. For more information about backup and recovery, see the Juniper Secure Analytics Administration Guide.
To avoid access errors in your log file, close all open JSA webUI sessions.
The software update for JSA cannot be installed on a managed host that is at a different software version from the Console. All appliances in the deployment must be at the same software revision to update the entire deployment.
Verify that all changes are deployed on your appliances. The update cannot install on appliances that have changes that are not deployed.
If this is a new installation, administrators must review the instructions in the Juniper Secure Analytics Installation Guide.

To install the JSA 7.5.0 Update Package 5 Interim Fix 02 software update:

Download the 7.5.0.20230301133107-IF02-20230503175608.sfs from the Juniper Customer Support website: https://support.juniper.net/support/downloads/
Using SSH, log into your system as the root user.
To verify you have enough space (5 GB) in /store/tmp for the JSA Console, type the following command:
```
df -h /tmp /storetmp /store/transient | tee diskchecks.txt
```

Installation Steps Continued

Best directory option: /storetmp. It is available on all appliance types at all versions. In JSA 7.5.0 versions /store/tmp is a symlink to the /storetmp partition.

If the disk check command fails, retype the quotation marks from your terminal, 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 GB of space available in a directory to copy the SFS before attempting to move the file to a managed host. If required, free up disk space on any host that fails to have less than 5 GB available.

NOTE: In JSA 7.3.0 and later, an update to directory structure for STIG compliant directories reduces the size of several partitions. This can impact moving large files to JSA.

To create the /media/updates directory, type the following command:
```
mkdir -p /media/updates
```
Using SCP, copy the files to the JSA Console to the /storetmp directory or a location with 5 GB of disk space.
Change to the directory where you copied the patch file. For example, cd /storetmp
Unzip the file in the /storetmp directory using the bunzip utility:
```
bunzip2 7.5.0.20230301133107-IF02-20230503175608.sfs.bz2
```

To mount the patch file to the /media/updates directory, type the following command:

mount -o loop -t squashfs /storetmp/7.5.0.20230301133107-IF02-20230503175608.sfs /media/updates

To run the patch installer, type the following command:
```
/media/updates/installer
```

NOTE: The first time that you run the software update, there might be a delay before the software update installation menu is displayed.

Using the patch installer, select all.
- The all option updates the software on all appliances in the following order:
  - Console
  - No order required for remaining appliances. All remaining appliances can be updated in any order the administrator requires.
- If you do not select the all option, you must select your console appliance.

Update Options and Resumption

As of the JSA 2014.6.r4 patch and later, administrators are only provided the option to update all or update the Console appliance. Managed hosts are not displayed in the installation menu to ensure that the console is patched first. After the console is patched, a list of managed hosts that can be updated is displayed in the installation menu. This change was made starting with the JSA 2014.6.r4 patch to ensure that the console appliance is always updated before managed hosts to prevent upgrade issues.

If administrators want to patch systems in series, they can update the console first, then copy the patch to all other appliances and run the software update installer individually on each managed host. The console must be patched before you can run the installer on managed hosts. When updating in parallel, there is no order required in how you update appliances after the console is updated.

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.

Installation Wrap-up

After the patch completes and you have exited the installer, type the following command:
```
umount /media/updates
```
Clear your browser cache before logging in to the Console.
Delete the SFS file from all appliances.

Results: A summary of the software update installation advises you of any managed host that were not updated. If the software update fails to update a managed host, you can copy the software update to the host and run the installation locally. 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 JSA.

Clearing the Cache

After you install the patch, you must clear your Java cache and your web browser cache before you log into the JSA appliance.

Before you begin

Ensure that you have only one instance of your browser open. If you have multiple versions of your browser open, the cache might fail to clear.

Ensure that the Java Runtime Environment is installed on the desktop system that you use to view the user interface. You can download Java version 1.7 from the Java website: http://java.com/.

About this task

If you use the Microsoft Windows 7 operating system, the Java icon is typically located under the Programs pane.

To clear the cache:

Clear your Java cache:
1. On your desktop, select Start > Control Panel.
2. Double-click the Java icon.
3. In the Temporary Internet Files pane, click View.
4. On the Java Cache Viewer window, select all Deployment Editor entries.
5. Click the Delete icon.
6. Click Close.
7. Click OK.
Open your web browser.
Clear the cache of your web browser. If you use the Mozilla Firefox web browser, you must clear the cache in the Microsoft Internet Explorer and Mozilla Firefox web browsers.
Log in to JSA.

Known Issues and Limitations

The known issues addressed in the JSA 7.5.0 Update Package 5 Interim Fix 02 are listed below:

Upgrades to JSA 7.5.0 Update Package 5 might take an extended amount of time to complete due to glusterfs file cleanup. You must allow the upgrade to continue uninterrupted.
After upgrading to JSA 7.5.0 Update Package 5, WinCollect 7.X agents can experience management or configuration change errors.
It is possible for autoupdates to revert to a previous version of autoupdates after upgrading. This causes autoupdate to not work as intended. After you upgrade to QRadar 7.5.0 or later, type the following command to check your autoupdate version:
```
/opt/qradar/bin/UpdateConfs.pl -v
```
Docker services fail to start on JSA appliances that were originally installed at JSA release 2014.8 or earlier, then upgraded to 7.5.0 Update Package 2 Interim Fix 02 or 7.5.0 Update Package 3. Before updating to JSA 7.5.0 Update Package 2 Interim Fix 02, run the following command from the JSA Console:
```
xfs_info /store | grep ftype
```
Review the output to confirm the ftype setting. If the output setting displays "ftype=0", do not proceed with the upgrade to 7.5.0 Update Package 2 Interim Fix 02 or 7.5.0 Update Package 3. See KB69793 for additional details.
After you install JSA 7.5.0, your applications might go down temporarily while they are being upgraded to the latest base image.
When adding a Data Node to a cluster, it must either all be encrypted, or all be unencrypted. You cannot add both encrypted and unencrypted Data Nodes to the same cluster.

Resolved Issues

The resolved issue addressed in the JSA 7.5.0 Update Package 5 Interim Fix 02 are listed below:

JSA unparsed logs incorrectly go to the consoles SIM generic log source.
Geographic data rules cause search and event pipeline issues when the location cache exceeds the spillover threshold.
Tuning changes can slow ecs-ec components resulting in delays and events routing to storage.

	JSA 7.5.0 Update Package 12 Interim Fix 03 Release Notes Release notes for Juniper JSA 7.5.0 Update Package 12 Interim Fix 03, detailing installation, wrap-up, cache clearing, known issues, and resolved issues.
	Juniper JSA 7.3.3 Fix Pack 11 Interim Fix 01 Release Notes Release notes for Juniper Secure Analytics (JSA) 7.3.3 Fix Pack 11 (Patch 11) Interim Fix 01, detailing installation, wrap-up, cache clearing, known issues, and resolved issues.
	Juniper Secure Analytics Ariel Query Language (AQL) Guide A comprehensive guide to Juniper Secure Analytics (JSA) Ariel Query Language (AQL) for version 7.3.0, detailing syntax, functions, operators, and query examples for data analysis.
	Junos Space Security Director Release 16.2R1 Release Notes This document provides release notes for Junos Space Security Director Release 16.2R1, detailing new features, enhancements, known issues, and installation/upgrade instructions for managing Juniper Networks security devices.
	Junos OS Release 17.3R1 for vSRX Release Notes Explore the latest updates and important information regarding Juniper Networks' Junos OS Release 17.3R1 for the vSRX virtual security appliance. This document covers new features, changes, known issues, and resolutions.
	Juniper Networks Contrail Cloud Release Notes - Version 13.7 Official release notes for Juniper Networks Contrail Cloud, version 13.7. This document details new features, enhancements, known issues, security advisories, and comprehensive update instructions for the integrated Telco cloud platform.
	Junos OS Release 15.1X53-D496 for NFX250 Release Notes Official release notes for Juniper Networks Junos OS Release 15.1X53-D496 for NFX250 devices, detailing new features, changes, known issues, resolved issues, and product compatibility.
	Juniper Security Director Installation and Upgrade Guide Comprehensive guide for installing and upgrading Juniper Networks Security Director, covering JA2500 hardware, Junos Space virtual appliances, and Log Collector integration for network security policy management.