Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

JSA Software Installations

Note:

Installing JSA software is only supported for Data Nodes.

A software installation is a JSA installation on your hardware that uses an RHEL operating system that you provide. You must configure partitions and perform other RHEL preparation before a JSA software installation.

Important

  • Ensure that your hardware meets the system requirements for JSA deployments.

  • Install no software other than JSA and RHEL on your hardware. Unapproved RPM installations can cause dependency errors when you upgrade JSA software and can also cause performance issues in your deployment.

  • Do not update your operating system or packages before or after JSA installation.

  • If you are installing JSA on a Unified Extensible Firmware Interface (UEFI) system, secure boot must be disabled.

Complete the following tasks in order:

Prerequisites for Installing JSA on Your Hardware

Before you install Red Hat Enterprise Linux (RHEL) operating system on your hardware, ensure that your system meets the system requirements.

JSA and RHEL version compatibility

The following table describes the version of Red Hat Enterprise Linux used with the JSA version.

Table 1: Red Hat Version

JSA Version

Red Hat Enterprise Linux Version

JSA 7.5.0

Red Hat Enterprise Linux V7.9 64-bit

The following table describes the system requirements:

Table 2: System Requirements for RHEL Installations on your own Hardware

Requirements

Description

Kickstart disks

Not supported

Network Time Protocol (NTP) package

Optional

If you want to use NTP as your time server, ensure that you install the NTP package.

Firewall configuration

WWW (http, https) enabled

SSH-enabled

Hardware

See the tables below for memory, processor, and storage requirements.

Memory and CPU Requirements

If you use hardware not provided by Juniper, ensure that your hardware meets or exceeds the specifications for memory and CPU of the corresponding JSA appliance.

Note:

You can change the memory or the CPU of your appliance by shutting down the appliance and making the changes. When you restart the appliance the system detects the changes and adjusts the performance related configuration. You must maintain the minimum requirements.

Storage requirements

Your appliance must have at least 256 GB of storage available.

The following table shows the storage requirements for installing JSA on your hardware.

Note:

The minimum required storage size varies, based on factors such as event size, events per second (EPS), and retention requirements.
Table 3: Minimum Storage Requirements for Software Only Installations

System classification

Appliance Information

IOPS

Data transfer rate (MB/s)

Minimum performance

Supports XX05 licensing

800

500

Medium performance

Supports XX29 licensing

1200

1000

High Performance

Supports XX48 licensing

10,000

2000

Installing RHEL on Your System

Download the Red Hat Enterprise Linux Server ISO x86_64 Boot ISO from https://access.redhat.com.

Refer to the Red Hat version table to choose the correct version.

Table 4: Red Hat Version

JSA Version

Red Hat Enterprise Linux version

7.4.0

Red Hat Enterprise Linux Server V7.6 x86_64 Boot ISO

7.4.1

Red Hat Enterprise Linux Server V7.7 x86_64 Boot ISO

7.4.2

Red Hat Enterprise Linux Server V7.7 x86_64 Boot ISO

You can provide your own RHEL, or acquire entitlement to a JSA Software Node. To acquire entitlement to a JSA Software Node, contact your JSA Sales Representative.

If there are circumstances where you need install to RHEL separately, proceed with the following instructions.

  1. Map the ISO to a device for your appliance by using the bootable USB flash drive with the ISO.

    For information about creating a bootable USB flash drive, see USB Flash Drive Installations.

  2. Insert the portable storage device into your appliance and restart your appliance.

  3. From the starting menu, do one of the following options:

    • Select the device that you mapped the ISO to, or the USB drive, as the boot option.

    • To install on a system that supports Extensible Firmware Interface (EFI), you must start the system in legacy mode.

  4. When prompted, log in to the system as the root user.

  5. Follow the instructions in the installation wizard to complete the installation:

    1. Set the language to English (US).

    2. Click Date & Time and set the time for your deployment.

    3. Click Software selection and select Minimal Install.

    4. Click Installation Destination and select the I will configure partitioning option.

    5. Select LVM from the list.

    6. Click the Add button to add the mount points and capacities for your partitions, and then click Done. For more information about RHEL7 partitions, see Linux Operating System Partition Properties for JSA Installations on Your Own System.

    7. Click Network & Host Name.

    8. Enter a fully qualified domain name for your appliance host name.

    9. Select the interface in the list, move the switch to the ON position, and click Configure.

    10. On the General tab, select Automatically connect to this network when it is available option.

    11. On the IPv4 Settings tab, select Manual in the Method list.

    12. Click Add to enter the IP address, Netmask, and Gateway for the appliance in the Addresses field.

    13. Add two DNS servers.

    14. Click Save > Done > Begin Installation.

  6. Set the root password, and then click Finish configuration.

  7. After the installation finishes, disable SELinux by modifying the /etc/selinux/config file, and restart the appliance.

Linux Operating System Partition Properties for JSA Installations on Your Own System

If you use your own appliance hardware, you can delete and re-create partitions on your Red Hat Enterprise Linux operating system rather than modify the default partitions.

Use the values in the following table as a guide when you re-create the partitioning on your Red hat Enterprise Linux Operating system. You must use these partition names. Using other partition names can cause the installation to fail and other issues.

The file system for each partition is XFS.

Table 5: Partitioning Guide for RHEL

Mount Path

LVM Supported?

Exists on Software Installation?

Size

/boot

No

Yes

1 GB

/boot/efi

No

Yes

200 MB

/recovery

No

No

8 GB

/var

Yes

Yes

5 GB

/var/log

Yes

Yes

15 GB

/var/log/audit

Yes

Yes

3 GB

/opt

Yes

Yes

13 GB

/home

Yes

Yes

1 GB

/storetmp

Yes

Yes

15 GB

/tmp

Yes

Yes

3 GB

swap

N/A

Yes

swap formula:

Configure the swap partition size to be 75 percent of RAM, with a minimum value of 12 GB and a maximum value of 24 GB

/

Yes

Yes

Upto 15 GB

/store

Yes

Yes

80% of remaining space

/transient

Yes

Yes

20 % of remaining space

Console Partition Configurations for Multiple Disk Deployments

For systems with multiple disks, configure the following partitions for JSA.

Disk 1

boot, swap, OS, JSA temporary files, and log files

Remaining Disks

  • Use the default storage configurations for JSA appliances as a guideline to determine what RAID type to use.

  • Mounted as /store

  • Store JSA data

The following table shows the default storage configuration for JSA appliances.

Table 6: Default Storage Configurations for JSA Appliances

JSA host role

Storage Configuration

Flow processor

RAID1

Data Node

Event processor

Flow processor

Event and flow processor

All-in-one console

RAID6

Event collector

RAID10

Installing JSA After the RHEL Installation

Install Security JSA on your own device after you install RHEL.

A fresh software install erases all data in /store as part of the installation process. If you want to preserve the contents of /store when performing a software install (such as when performing a manual retain), back up the data you want to preserve apart from the host where the software is to be installed.

  1. Copy the JSA ISO to /root or /storetmp directory of the device.

  2. Create the /media/cdrom/ directory by typing the following command:

    mkdir /media/cdrom

  3. Mount the JSA ISO by using the following command:

    mount - o loop <path_to_iso>/<qradar.iso> / media/cdrom

  4. Run the JSA setup by using the following command:

    /media/cdrom/setup

    Note:

    A new kernel might be installed as part of the installation, which requires a system restart. Repeat the commands in steps 3 and 4 after the system restart to continue the installation.

  5. Select the disk drive type:

    • Software Install

    • High Availability Appliance

  6. Select the disk drive assignment, and then select Next.

  7. If you selected an disk drive for high-availability (HA), select whether the disk drive is a console.

  8. For the type of setup, select Normal Setup (default) or HA Recovery Setup, and set up the time.

  9. If you selected HA Recovery Setup, enter the cluster virtual IP address.

  10. Select the Internet Protocol version.

  11. If you selected ipv6, select manual or auto for the Configuration type.

  12. Select the bonded interface setup, if required.

  13. Select the management interface.

  14. In the wizard, enter a fully qualified domain name in the Hostname field.

    Note:

    The hostname must not contain only numbers.

  15. In the IP address field, enter a static IP address, or use the assigned IP address.

    Note:

    If you are configuring this host as primary host for a high availability (HA) cluster, and you selected Yes for auto-configure, you must record the automatically-generated IP address. The generated IP address is entered during HA configuration.

    For more information, see Juniper Security Analytics High Availability Guide.

  16. If you do not have a email server, enter localhost in the Email server name field.

  17. Leave the root password as it is.

  18. If you are installing a Console, enter an admin password that meets the following criteria:

    • Contains at least 5 characters

    • Contains no spaces

    • Can include the following special characters: @, #, ^, and *.

  19. Click Finish.

  20. Follow the instructions in the installation wizard to complete the installation.

    The installation process might take several minutes.

  21. If you are installing a Console, apply your license key.

    1. Log in to JSA as the admin user:

    2. Click Login.

    3. In the navigation menu, click Admin.

    4. In the navigation pane, click System configuration.

    5. Click the System and License Management icon.

    6. From the Display list box, select Licenses, and upload your license key.

    7. Select the unallocated license and click Allocate System to License.

    8. From the list of systems, select a system, and click Allocate System to License.

    9. Click Deploy License Changes.

  22. If you want to add managed hosts, see Juniper Security Analytics Administration Guide.