Appliance Setup
This document describes how to setup the FSM-500G appliance.
Fresh Installation
- Step 1: Rack mount the FSM-500G Appliance
- Step 2: Power On the FSM-500G Appliance
- Step 3: Verify System Information
- Step 4: Configure FortiSIEM via GUI
- Step 5: Register Collectors
- Step 6: Using FortiSIEM
Step 1: Rack mount the FSM-500G Appliance
- Follow FortiSIEM 500G QuickStart Guide to mount FSM-500G into rack.
- Connect FSM-500G to the network by connecting an Ethernet cable to Port1.
Before proceeding to the next step, connecting Ethernet cable to Port1 is required for Network configuration. |
Step 2: Power On the FSM-500G Appliance
- Make sure the FSM-500G device is connected to a Power outlet and an Ethernet cable is connected to Port1.
- Power On the FSM-500G device.
Step 3: Verify System Information
- Connect to the FSM-500G appliance using VGA port or Console port.
- Login as user
root
with passwordProspectHills
. - You will be asked to change your password. Once you change the password, you will be logged out. Login again with your new password.
Note this password—you will need it in a later step.
- Run
get
to check the available FortiSIEM commands. - Use the below commands to check the hardware information. After running each command, ensure that there are no errors in the displayed output.
Command Description get system status
Displays system name, version and serial number. diagnose hardware info
Displays system hardware information like CPUs, Memory and RAID information. diagnose interface detail port0
Displays interface status.
Step 4: Configure FortiSIEM via GUI
-
Log in as user root with the password you set in Step 3 above.
-
At the command prompt, go to
/usr/local/bin
, and enterconfigFSM.sh
. For example:# configFSM.sh
A simple GUI will open.
-
In the GUI, select 1 Set Timezone, and then press Next.
-
Select your Region, then press Next.
-
Select your Country, and press Next.
-
Select the Country and City for your timezone, and press Next.
-
Select 1 Collector. Press Next.
-
If you want to enable FIPS, then choose 2 install_with_fips. Otherwise, choose 1 install_without_fips. 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 configuration and/or host name. - 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.
- 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.
- When prompted, enter the information for these network components to configure the Static IP address: IP Address, Netmask, Gateway, DNS Server(s). Configure the network by entering the following fields. Press Next.
Note: Configuring a DNS Server to resolve external addresses as updates to remote repositories will be required in the future.Note the IP Address—you will need it in a later step.
Option Description IPv4 Address The Collector's IPv4 address NetMask The Collector's subnet Gateway Network gateway address DNS1, DNS2 Addresses of the DNS servers - 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 IPv6 Address The Collector's IPv6 address prefix (Netmask) The Collector's IPv6 prefix Gateway ipv6 IPv6 Network gateway address DNS1 IPv6, DNS2 IPv6 Addresses of the IPv6 DNS server 1 and DNS server2 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. - Configure Hostname for Collector. Press Next.
Note: FQDN is no longer needed. - Test network connectivity by entering a host name that can be resolved by your DNS Server (entered in the previous step) and responds to ping. The host can either be an internal host or a public domain host like
google.com
. For migration to complete, the system still needs https connectivity to FortiSIEM OS update servers:os-pkgs-cdn.fortisiem.fortinet.com
andos-pkgs-c8.fortisiem.fortinet.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. - 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.
The options are described in the following table.
Option Description -r The FortiSIEM component being configured -z The time zone being configured -i IPv4-formatted address -m Address of the subnet mask -g Address of the gateway server used --host Host name -t The IP type. The values can be either 4 (for ipv4) or 6 (for v6) or 64 (for both ipv4 and ipv6) .--dns1, --dns2
Addresses of the DNS servers
--i6
IPv6-formatted address
--m6
IPv6 prefix
--g6
IPv6 gateway
-o
Installation option.
--testpinghost
The URL used to test connectivity
Once the configuration is complete, the system reboots automatically.
Step 5: Register Collectors
Collectors can be deployed in Enterprise or Service Provider environments.
Enterprise Deployments
For enterprise deployments, follow these steps:
- Log in to Supervisor with Admin privileges.
- Go to ADMIN > Settings > System > Cluster Config.
- Enter the IP of the Worker node in the Event Upload Workers column. If a Supervisor node is only used, then enter the IP of the Supervisor node. Multiple IP addresses can be entered on separate lines. In this case, the Collectors will load balance the upload of events to the listed Event Workers.
Note: Rather than using IP addresses, a DNS name is recommended. The reasoning is, should the IP addressing change, it becomes a matter of updating the DNS rather than modifying the Event Worker IP addresses in FortiSIEM. - Click Save.
- Enter the IP of the Worker node in the Event Upload Workers column. If a Supervisor node is only used, then enter the IP of the Supervisor node. Multiple IP addresses can be entered on separate lines. In this case, the Collectors will load balance the upload of events to the listed Event Workers.
- Go to ADMIN > Setup > Collectors and add a Collector by entering:
- SSH to the Collector and run following script to register Collectors:
phProvisionCollector --add <user> '<password>' <Super IP or Host> <Organization> <CollectorName>
The password should be enclosed in single quotes to ensure that any non-alphanumeric characters are escaped.
- Set
user
andpassword
using the admin user name and password for the Supervisor. - Set
Super IP or Host
as the Supervisor's IP address. - Set
Organization
. For Enterprise deployments, the default name is Super. - Set
CollectorName
from Step 3a.
- Set
- Go to ADMIN > Health > Collector Health to see the Collector status.
The Collector will reboot during the Registration.
Service Provider Deployments
For Service Provider deployments, follow these steps.
- Log in to Supervisor with Admin privileges.
- Go to ADMIN > Settings > System > Cluster Config.
- Enter the IP of the Worker node in the Event Upload Workers column. If a Supervisor node is only used, then enter the IP of the Supervisor node. Multiple IP addresses can be entered on separate lines. In this case, the Collectors will load balance the upload of events to the listed Event Workers.
Note: Rather than using IP addresses, a DNS name is recommended. The reasoning is, should the IP addressing change, it becomes a matter of updating the DNS rather than modifying the Event Worker IP addresses in FortiSIEM. - Click Save.
- Enter the IP of the Worker node in the Event Upload Workers column. If a Supervisor node is only used, then enter the IP of the Supervisor node. Multiple IP addresses can be entered on separate lines. In this case, the Collectors will load balance the upload of events to the listed Event Workers.
- Go to ADMIN > Setup > Organizations and click New to add an Organization.
- Enter the Organization Name, Admin User, Admin Password, and Admin Email.
- Under Collectors, click New.
- 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.
- SSH to the Collector and run following script to register Collectors:
phProvisionCollector --add <user> '<password>' <Super IP or Host> <Organization> <CollectorName>
The password should be enclosed in single quotes to ensure that any non-alphanumeric characters are escaped.
- Set
user
andpassword
using the admin user name and password for the Organization that the Collector is going to be registered to. - Set
Super IP or Host
as the Supervisor's IP address. - Set
Organization
as the name of an organization created on the Supervisor. - Set
CollectorName
from Step 6 by command line, for example:# phProvisionCollector --add admin Admin*11 172.30.53.130 ORG1289 CO1289
A message will display after the completion:
Continuing to provision the Collector
This collector is registered successfully. Normal Exit and restart of phMonitor after collector license registration.
The Collector will reboot during the Registration.
- Set
- Go to ADMIN > Health > Collector Health to see the status of the Collector.
Step 6: Using FortiSIEM
Refer to the FortiSIEM User Guide for detailed information about using FortiSIEM.
Factory Reset
Follow the steps below to perform factory reset on FortiSIEM FSM-500G.
Step 1: Uninstall FortiSIEM application
- Connect FortiSIEM device using VGA or Console port.
- Login as ‘root’ user with password 'ProspectHills'.
- To check the available FortiSIEM commands, run
get
. - To uninstall FortiSIEM, run
execute fsm-clean
.
This script will uninstall FortiSIEM Collector.
Step 2: Reinstall FortiSIEM application
- Power on the hardware.
- Login as ‘root’ user with password 'ProspectHills'.
- To check Hardware status and RAID information, run
diagnose hardware info
.
Note: RAID Information is NOT applicable to FSM-500G model. - To install FortiSIEM Collector, run ‘
execute factoryreset
’.
Note: This script takes 5 minutes to complete FortiSIEM Collector installation.
Follow the steps under Appliance Setup to configure FSM-500G.
Upgrading FortiSIEM Collector
For upgrading FortiSIEM Collector, refer to the Upgrade Guide.
Appliance Re-image
Ensure that the following prerequisites are met before re-imaging FortiSIEM.
Hardware | Software |
---|---|
Peripherals
USB Thumbdrive
|
Follow the below steps to re-image FortiSIEM.
Step 1: Create Bootable Linux Image
- Connect 4 GB USB drive to the system (desktop or laptop).
- Open Rufus.
- Select the following settings for the USB:
- Partition scheme and target system type: MBR partition scheme for BIOS or UEFI
- File system: FAT32
- Cluster size: 4096 bytes (Default)
- Quick Format: Enable
- Create a bootable disk using: ISO image
- Click on the 'CD-ROM' icon and select the Ubuntu Setup ISO.
- Click Start and allow Rufus to complete.
Once finished, the disk is ready to boot.
Note: Alternatively, you can use the Ubuntu guide for creating a USB drive with Ubuntu.
Step 2: Staging the FortiSIEM Collector Image
Staging can be done in one of two ways. The first is through USB. The second is through an NFS server. Follow Step 2A for staging via USB. Follow Step 2B for staging via an NFS server.
Step 2A: USB Staging
- Connect an 8 GB USB Drive to the system (desktop or laptop).
- Open Windows Explorer > right-click Drive > click Format.
- Select the following options:
- File system: NTFS
- Allocation unit size: 4096 bytes
- Quick Format: Enable
- Copy the image file to USB drive. For example:
FSM_Full_All_RAW_HARDWARE_6.7.9.1763.zip
- Safely remove the USB drive from the desktop or laptop by unmounting it through the operating system.
Step 2B: NFS Staging
-
Prepare an NFS server. Information on setup can be found here.
-
Download
FSM_Full_All_RAW_HARDWARE_6.7.9.1763.zip
from the support site. -
Create and export
/FortiSIEM_HW_IMG
. -
Upload the
FSM_Full_All_RAW_HARDWARE_6.7.9.1763.zip
to/FortiSIEM_HW_IMG
. -
Go to the
/FortiSIEM_HW_IMG
directory by running the following command.cd /FortiSIEM_HW_IMG
-
run the following command to unzip the zip file.
unzip -c FSM_Full_All_RAW_HARDWARE_6.7.9.1763.zip
-
Verify that the NFS server is reachable by the 500G appliance and is allowed to mount the sharepoint on the NFS server.
Example:
mount -t nfs 10.0.0.1:/FortiSIEM_HW_IMG /mnt
Step 3: Prepare 500G by removing FSM
- Connect to the console/SSH of the FortiSIEM appliance.
- Run the following command:
execute fsm-clean
- Allow this command to run and power-off the FortiSIEM appliance.
Step 4: Configure 500G BIOS to Boot into USB Drive
- Connect the 4 GB USB drive to the FortiSIEM appliance.
- Power on the FortiSIEM appliance.
- During the boot screen, press F11 to login to the boot options.
- Select the option to enter into the BIOS set up.
- Select the option for Boot options.
- Select the 'USB drive'.
- Save the options and quit set up.
Step 5: Re-image the 500G
If you followed Step 2A USB Staging, continue with Step 5A here. If you followed Step 2B NFS Staging, follow Step 5B here.
Step 5A: Reimaging from USB Staging
-
Power on the FortiSIEM appliance.
-
Once the FortiSIEM appliance loads from the USB drive, click Try Ubuntu.
-
Connect the 8GB USB drive to the FortiSIEM appliance.
-
Open a terminal.
-
Type the following command to identify the FortiSIEM boot disk (29.5GB):
sudo fdisk –l
Note: This drive will be referred to as
/dev/sdb
in the following steps. -
Enter into root while in the terminal using the following command:
sudo -s
-
Determine the mount point of this drive by using the following command:
df -l
Note: For this guide, the assumption for the 8GB mount point is:
/media/ubuntu/123456789/*
-
Copy the image from the 8GB disk to the FortiSIEM boot disk.
- Extract the zipped raw image and copy the image into SATA disk (32GB). For example, use the command:
# unzip -c FSM_Full_All_RAW_HARDWARE_6.7.9.1763.zip | dd of=/dev/sdb bs=1M status=progress
-
Once this is completed, power off the FortiSIEM appliance using the following commands:
shutdown –h now
-
After shutdown, remove both USB drives from the FortiSIEM appliance.
-
Power on FortiSIEM appliance.
-
Reinstall FortiSIEM application (as in Factory Reset - step 2).
Step 5B: Reimaging from NFS Server Staging
-
Power on the FortiSIEM appliance.
-
Once the FortiSIEM appliance loads from the USB drive, click Try Unbuntu.
-
Open a terminal.
-
Type the following command to identify the FortiSIEM boot disk (29.5GB):
sudo fdisk -l
Note: This drive will be referred to as
/dev/sdb
in the following steps. -
Enter into root while in the terminal by using the following command:
sudo -s
-
Mount the NFS share to the ubuntu boot environment.
Note: Assuming the REMOTE site is 10.0.0.1, and remote share is:
/FortiSIEM_HW_IMG
, you would run:# mount -t nfs 10.0.0.1:/FortiSIEM_HW_IMG /mnt
-
Directly write the image from the NFS share to the local HDD. For example, use the command:
# dd if=/mnt/FSM_Full_All_RAW_HARDWARE_6.7.9.1763.img of=/dev/sdb bs=1M status=progress
-
Once this is completed, power off the FortiSIEM appliance using the following commands:
# shutdown –h now
-
After shutdown, remove both USB drives from the FortiSIEM appliance.
-
Power on the FortiSIEM appliance.
-
Reinstall the FortiSIEM application (as in Factory Reset - step 2).