FortiSIEM 6.6.2 ESX Installation Guide
FortiSIEM 6.6.2 ESX Installation Guide
FortiSIEM 6.6.2
FORTINET DOCUMENT LIBRARY
https://docs.fortinet.com
FORTINET BLOG
https://blog.fortinet.com
NSE INSTITUTE
https://training.fortinet.com
FORTIGUARD CENTER
https://www.fortiguard.com
FEEDBACK
Email: techdoc@fortinet.com
10/20/2022
FortiSIEM 6.6.2 ESX Installation Guide
TABLE OF CONTENTS
Change Log 4
Fresh Installation 6
Pre-Installation Checklist 6
All-in-one Installation 7
Set Network Time Protocol for ESX 7
Import FortiSIEM into ESX 8
Edit FortiSIEM Hardware Settings 11
Start FortiSIEM from the VMware Console 12
Configure FortiSIEM via GUI 12
Upload the FortiSIEM License 18
Choose an Event Database 19
Cluster Installation 21
Install Supervisor 21
Install Workers 23
Register Workers 24
Install Collectors 24
Register Collectors 28
Install Manager 31
Register Instances to Manager 31
Installing on ESX 6.5 33
Importing a 6.5 ESX Image 33
Resolving Disk Save Error 35
Adding a 5th Disk for /data 36
Install Log 37
03/29/2019 Revision 1: updated the instructions for registering the Collector on the
Supervisor node.
04/22/2021 Revision 11: Added Installing on ESX 6.5 content to 6.1.0. Minor update to
Pre-Installation Checklist to 6.1.0.
4/28/2021 Revision 12: Updated Pre-Installation Checklist for 6.1.0, 6.1.1 and 6.2.0.
l Pre-Installation Checklist
l All-in-one Installation
l Cluster Installation
l Installing on ESX 6.5
Pre-Installation Checklist
Note: FortiSIEM Manager installation has slight differences from the Supervisor/Worker/Collector installation.
l Cluster with Manager, Supervisor and Workers
l Before beginning FortiSIEM deployment, you must configure external storage excluding FortiSIEM Manager.
l Determine hardware requirements:
Note: compared to FortiSIEM 5.x, you need one more disk (OPT) which provides a cache for FortiSIEM.
Before proceeding to FortiSIEM deployment, you must configure the external storage.
l For NFS deployment, see FortiSIEM - NFS Storage Guide here.
l For Elasticsearch deployment, see FortiSIEM - Elasticsearch Storage Guide here.
All-in-one Installation
This is the simplest installation with a single Virtual Appliance. If storage is external, then you must configure external
storage before proceeding with installation.
l Set Network Time Protocol for ESX
l Import FortiSIEM into ESX
l Edit FortiSIEM Hardware Settings
l Start FortiSIEM from the VMware Console
l Configure FortiSIEM via GUI
l Upload the FortiSIEM License
l Choose an Event Database
FortiSIEM needs accurate time. To do this you must enable NTP on the ESX host which FortiSIEM Virtual Appliance is
going to be installed.
1. Log in to your VCenter and select your ESX host.
2. Click the Configure tab.
4. Click Edit.
5. Enter the time zone properties.
1. Go to the Fortinet Support website https://support.fortinet.com to download the ESX package FSM_FULL_ALL_
ESX_6.6.2_Build1637.zip. See Downloading FortiSIEM Products for more information on downloading
products from the support website.
2. Uncompress the packages for Super/Worker and Collector (using 7-Zip tool) to the location where you want to
install the image. Identify the .ova file.
3. Right-click on your own host and choose Deploy OVF Template.
The Deploy OVA Template dialog box appears.
4. In 1 Select an OVF template select Local file and navigate to the .ova file. Click Next. If you are installing from a
URL, select URL and paste the OVA URL into the field beneath URL.
5. In 2 Select a Name and Folder, make any needed edits to the Virtual machine name field. Click Next.
6. In 3 Select a compute resource, select any needed resource from the list. Click Next.
10. In 7 Select networks, select the source and destination networks from the drop down lists. Click Next.
13. Right-click your installed OVA (example: FortiSIEM-611.1637.ova) and select Edit Settings > VM Options >
General Options . Setup Guest OS and Guest OS Version (Linux and 64-bit).
14. Open the Virtual Hardware tab. Set CPU to 16 and Memory to 64GB.
15. Click Add New Device and create a device.
Add additional disks to the virtual machine definition. These will be used for the additional partitions in the virtual
appliance. An All In One deployment requires the following additional partitions.
higher EPS deployments. See the FortiSIEM Sizing Guide for additional information.
l NFS or Elasticsearch event DB storage is mandatory for multi-node cluster deployments.
After you click OK, a Datastore Recommendations dialog box opens. Click Apply.
16. Do not turn off or reboot the system during deployment, which may take 7 to 10 minutes to complete. When the
deployment completes, click Close.
l Memory = 64 GB
l OPT – 100GB
l CMDB – 60GB
l SVN – 60GB
1. In the VMware vSphere client, select the Supervisor, Worker, or Collector virtual appliance.
2. Right-click to open the options menu and select Power > Power On.
3. Open the Summary tab for the , select Launch Web Console.
Network Failure Message: When the console starts up for the first time you may see a Network eth0 Failed
message, but this is expected behavior.
4. Select Web Console in the Launch Console dialog box.
5. When the command prompt window opens, log in with the default login credentials – user: root and Password:
ProspectHills.
6. You will be required to change the password. Remember this password for future use.
At this point, you can continue configuring FortiSIEM by using the GUI.
6. Select the Country and City for your timezone, and press Next.
8. If you want to enable FIPS, then choose 2. Otherwise, choose 1. You have the option of enabling FIPS (option 3) or
disabling FIPS (option 4) later.
Note: After Installation, a 5th option to change your network configuration (5 change_network_config) is
available. This allows you to change your network settings and/or host name.
9. Determine whether your network supports IPv4-only, IPv6-only, or both IPv4 and IPv6 (Dual Stack). Choose 1 for
IPv4-only, choose 2 for IPv6-only, or choose 3 for both IPv4 and IPv6.
10. If you choose 1 (IPv4) or choose 3 (Both IPv4 and IPv6), and press Next, then you will move to step 11. If you
choose 2 (IPv6), and press Next, then skip to step 12.
11. Configure the IPv4 network by entering the following fields, then press Next.
Option Description
12. If you chose 1 in step 9, then you will need to skip to step 13. If you chose 2 or 3 in step 9, then you will configure the
IPv6 network by entering the following fields, then press Next.
Option Description
Note: If you chose option 3 in step 9 for both IPv4 and IPv6, then even if you configure 2 DNS servers for IPv4 and
IPv6, the system will only use the first DNS server from IPv4 and the first DNS server from the IPv6 configuration.
Note: In many dual stack networks, IPv4 DNS server(s) can resolve names to both IPv4 and IPv6. In such
environments, if you do not have an IPv6 DNS server, then you can use public IPv6 DNS servers or use IPv4-
mapped IPv6 address.
13. Configure Hostname for FortiSIEM Manager/Supervisor/Worker/Collector. Press Next.
14. Test network connectivity by entering a host name that can be resolved by your DNS Server (entered in the
previous step) and can respond to a ping. The host can either be an internal host or a public domain host like
google.com. Press Next.
Note: By default, “google.com” is shown for the connectivity test, but if configuring IPv6, you must enter an
accessible internally approved IPv6 DNS server, for example: “ipv6-dns.fortinet.com"
Note: When configuring both IPv4 and IPv6, only testing connectivity for the IPv6 DNS is required because the IPV6
takes higher precedence. So update the host field with an approved IPv6 DNS server.
15. The final configuration confirmation is displayed. Verify that the parameters are correct. If they are not, then press
Back to return to previous dialog boxes to correct any errors. If everything is OK, then press Run.
Option Description
-i IPv4-formatted address
Option Description
16. It will take some time for this process to finish. When it is done, proceed to Upload the FortiSIEM License. If the
VM fails, you can inspect the ansible.log file located at /usr/local/fresh-install/logs to try and
identify the problem.
Before proceeding, make sure that you have obtained valid FortiSIEM license from Forticare.
For more information, see the Licensing Guide.
For a fresh installation, you will be taken to the Event Database Storage page. From the Event Database drop-down list,
choose EventDB on Local Disk, EventDB on NFS, ClickHouse, or Elasticsearch. For more details, see Configuring
Storage.
After the License has been uploaded, and the Event Database Storage setup is configured, FortiSIEM installation is
complete. If the installation is successful, the VM will reboot automatically. Otherwise, the VM will stop at the failed task.
You can inspect the ansible.log file located at /usr/local/fresh-install/logs if you encounter any issues
during FortiSIEM installation.
After installation completes, ensure that the phMonitor is up and running, for example:
# phstatus
For the Supervisor, Worker and Collector, the response should be similar to the following.
Cluster Installation
For larger installations, you can choose Worker nodes, Collector nodes, and external storage (NFS, ClickHouse, or
Elasticsearch).
l Install Supervisor
l Install Workers
l Register Workers
l Install Collectors
l Register Collectors
l Install Manager
l Register Instances to Manager
Install Supervisor
ClickHouse
Elasticsearch
Install Workers
Once the Supervisor is installed, follow the same steps in All-in-one Install to install a Worker except only choose OS and
OPT disks. The recommended settings for Worker node are:
l CPU = 8
l Memory = 24 GB
l Two hard disks:
l OS – 25GB
l OPT – 100GB
Register Workers
Once the Worker is up and running, add the Worker to the Supervisor node.
1. Go to ADMIN > License > Nodes.
2. Select Worker from the drop-down list and enter the Worker's IP address and host name. Click Add.
3. See ADMIN > Health > Cloud Health to ensure that the Workers are up, healthy, and properly added to the
system.
Install Collectors
Once Supervisor and Workers are installed, follow the same steps in All-in-one Install to install a Collector except in Edit
FortiSIEM Hardware Settings, only choose OS and OPT disks.
l OPT – 100GB
FortiSIEM installations require the OPT drive to have exactly 100 GB. This is valid for all three node options (Supervisor,
Worker and Collectors).
Certain environments such as Operational Technology (OT) may find it difficult to dedicate 125 GB to a log collector. The
steps here explain how to bypass the requirement for Collector install. Be aware that reducing the size of the disk also
reduces the size of the available cache when there is a connection interruption between Collector and
Workers/Supervisor, and may result in loss of logs.
1. Follow the installation guide but instead of adding a 100 GB disk for OPT, add a disk of whatever size you require.
2. In this example, we will assume the OPT disk is 35 GB, so in total, the Collector VM will have 70 GB (25 for OS + 35
for OPT).
3. After you boot the VM and change the password, you will be editing the following files.
l /usr/local/syslib/config/disksConfig.json
l /usr/local/install/roles/fsm-disk-mgmt/tasks/disks.yml
Note: You must make changes to these files before running the configureFSM.sh installer.
4. The disksConfig.json file contains a map of installation types and node types. It defines the required sizes of
disks so that the installer can validate them. Since we are changing the KVM Collector opt disk requirement to 35
GB in this example, we must reflect that size in this file. Using a text editor, modify the "opt" line in the
disksConfig.json file, shown in blue to your requirement.
"FSIEMVMWARE": {
"SUPER": {
"number": "3",
"opt": "100",
"svn": "60",
"cmdb": "60"
},
"FSMMANAGER": {
"number": "2",
"opt": "100",
"cmdb": "60"
},
"WORKER": {
"number": "1",
"opt": "100"
},
"COLLECTOR": {
"number": "1",
"opt": "35"
}
},
Change this line to reflect the size of your OPT disk (in this example 35 GB), marked in blue.
parted -a optimal --script "{{ item.disk }}" mkpart primary "{{ item.fstype }}" 26G
35G && sleep 5
c. Reduce /OPT disk: by changing the following line (The original line assumes the drive is 100 GB).
parted -a optimal --script "{{ item.disk }}" mkpart primary "{{ item.fstype }}" 26G
100G && sleep 5
Change to reflect the size of your OPT disk (in this example 35 GB), marked in blue.
parted -a optimal --script "{{ item.disk }}" mkpart primary "{{ item.fstype }}" 11G
35G && sleep 5
# df -h
Filesystem Size Used Avail Use% Mounted on
devtmpfs 12G 0 12G 0% /dev
tmpfs 12G 0 12G 0% /dev/shm
tmpfs 12G 17M 12G 1% /run
tmpfs 12G 0 12G 0% /sys/fs/cgroup
/dev/mapper/rl-root 22G 8.1G 14G 38% /
/dev/sdb2 23G 4.3G 19G 19% /opt
/dev/sda1 1014M 661M 354M 66% /boot
tmpfs 2.4G 0 2.4G 0% /run/user/500
tmpfs 2.4G 0 2.4G 0% /run/user/0
Register Collectors
Enterprise Deployments
b. Click OK.
c.
3. Go to ADMIN > Setup > Organizations and click New to add an Organization.
4. Enter the Organization Name, Admin User, Admin Password, and Admin Email.
5. Under Collectors, click New.
6. Enter the Collector Name, Guaranteed EPS, Start Time, and End Time.
The last two values could be set as Unlimited. Guaranteed EPS is the EPS that the Collector will always be able to
send. It could send more if there is excess EPS available.
a. Set user and password using the admin user name and password for the Organization that the Collector is
going to be registered to.
b. Set Super IP or Host as the Supervisor's IP address.
c. Set Organization as the name of an organization created on the Supervisor.
d. Set CollectorName from Step 6.
Install Manager
Starting with release 6.5.0, you can install FortiSIEM Manager to monitor and manage multiple FortiSIEM instances. An
instance includes a Supervisor and optionally, Workers and Collectors. The FortiSIEM Manager needs to be installed on
a separate Virtual Machine and requires a separate license. FortiSIEM Supervisors must be on 6.5.0 or later versions.
Follow the steps in All-in-one Install to install Manager. After any Supervisor, Workers, and Collectors are installed, you
add the Supervisor instance to Manager, then Register the instance itself to Manager. See Register Instances to
Manager.
To register your Supervisor instance with Manager, you will need to do two things in the following order.
l First, add the instance to Manager
l Then register the instance itself to Manager
Note that Communication between FortiSIEM Manager and instances is via REST APIs over HTTP(S).
h. Login to Manager, and navigate to any one of the following pages to verify registration.
l ADMIN > Setup and check that the box is marked in the Registered column for your instance.
l ADMIN > Health, look for your instance under FortiSIEM Instances.
l ADMIN > License, look for your instance under FortiSIEM Instances.
When installing with ESX 6.5, or an earlier version, you will get an error message when you attempt to import the image.
To resolve this import issue, you will need to take the following steps:
1. Install 7-Zip.
2. Extract the OVA file into a directory.
3. In the directory where you extracted the OVA file, edit the file FortiSIEM-VA-6.6.2.1637.ovf, and replace all
references to vmx-15 with your compatible ESX hardware version shown in the following table.
Note: For example, for ESX 6.5, replace vmx-15 with vmx-13.
Compatibility Description
EXSi 6.5 and This virtual machine (hardware version 13) is compatible with ESXi 6.5.
later
EXSi 6.0 and This virtual machine (hardware version 11) is compatible with ESXi 6.0 and ESXi 6.5.
later
EXSi 5.5 and This virtual machine (hardware version 10) is compatible with ESXi 5.5, ESXi 6.0, and ESXi
later 6.5.
EXSi 5.1 and This virtual machine (hardware version 9) is compatible with ESXi 5.1, ESXi 5.5, ESXi 6.0, and
later ESXi 6.5.
EXSi 5.0 and This virtual machine (hardware version 8) is compatible with ESXI 5.0, ESXi 5.1, ESXi 5.5,
later ESXi 6.0, and ESXi 6.5.
ESX/EXSi 4.0 This virtual machine (hardware version 7) is compatible with ESX/ESXi 4.0, ESX/ESXi 4.1,
and later ESXI 5.0, ESXi 5.1, ESXi 5.5, ESXi 6.0, and ESXi 6.5.
EXS/ESXi 3.5 This virtual machine (hardware version 4) is compatible with ESX/ESXi 3.5, ESX/ESXi 4.0,
and later ESX/ESXi 4.1, ESXI 5.1, ESXi 5.5, ESXi 6.0, and ESXi 6.5. It is also compatible with VMware
Server 1.0 and later. ESXi 5.0 does not allow creation of virtual machines with ESX/ESXi 3.5
and later compatibility, but you can run such virtual machines if they were created on a host
with different compatibility.
ESX Server 2.x This virtual machine (hardware version 3) is compatible with ESX Server 2.x, ESX/ESXi 3.5,
and later ESX/ESXi 4.0, ESX/ESXi 4.1, and ESXI 5.0. You cannot create, edit, turn on, clone, or migrate
virtual machines with ESX Server 2.x compatibility. You can only register or upgrade them.
8. Click Next.
You may encounter an error message asking you to select a valid controller for the disk if you attempt to add an
additional 4th disk (/opt, /cmd, /svn, and /data). This is likely due to an old IDE controller issue in VMware, where
you are normally limited to 2 IDE controllers, 0, 1, and 2 disks per controller (Master/Slave).
If you are attempting to add 5 disks in total, such as this following example, you will need to take the following steps:
Disk Usage
1. Go to Edit settings, and add each disk individually, clicking save after adding each disk.
When you reach the 4th disk, you will receive the "Please select a valid controller for the disk" message. This is
because the software has failed to identify the virtual device node controller/Master or Slave for some unknown
reason.
2. Expand the disk setting for each disk and review which IDE Controller Master/Slave slots are in use. For example, in
one installation, there may be an attempt for the 4th disk to be added to IDE Controller 0 when the Master/Slave
slots are already in use. In this situation, you would need to put the 4th disk on IDE Controller 1 in the Slave position,
as shown here. In your situation, make the appropriate configuration setting change.
When you need to add a 5th disk, such as for /data, and there is no available slot, you will need to add a SATA
controller to the VM by taking the following steps:
1. Go to Edit settings.
2. Select Add Other Device, and select SCSI Controller (or SATA).
You will now be able to add a 5th disk for /data, and it should default to using the additional controller. You should be
able to save and power on your VM. At this point, follow the normal instructions for installation.
Note: When adding the local disk in the GUI, the path should be /dev/sda or /dev/sdd. You can use one of the
following commands to locate:
# fdisk -l
or
# lsblk
Install Log
Copyright© 2022 Fortinet, Inc. All rights reserved. Fortinet®, FortiGate®, FortiCare® and FortiGuard®, and certain other marks are registered trademarks of Fortinet, Inc., and other Fortinet names herein
may also be registered and/or common law trademarks of Fortinet. All other product or company names may be trademarks of their respective owners. Performance and other metrics contained herein were
attained in internal lab tests under ideal conditions, and actual performance and other results may vary. Network variables, different network environments and other conditions may affect performance
results. Nothing herein represents any binding commitment by Fortinet, and Fortinet disclaims all warranties, whether express or implied, except to the extent Fortinet enters a binding written contract,
signed by Fortinet’s General Counsel, with a purchaser that expressly warrants that the identified product will perform according to certain expressly-identified performance metrics and, in such event, only
the specific performance metrics expressly identified in such binding written contract shall be binding on Fortinet. For absolute clarity, any such warranty will be limited to performance in the same ideal
conditions as in Fortinet’s internal lab tests. Fortinet disclaims in full any covenants, representations, and guarantees pursuant hereto, whether express or implied. Fortinet reserves the right to change,
modify, transfer, or otherwise revise this publication without notice, and the most current version of the publication shall be applicable.