Fortinet black logo

Fresh Installation

Fresh Installation

Pre-Installation Checklist

Before you begin, check the following:

  • Ensure that your system can connect to the network. You will be asked to provide a DNS Server and a host that can be resolved by the DNS Server and responds to ping. The host can either be an internal host or a public domain host like google.com.

  • Choose deployment type – Enterprise or Service Provider. The Service Provider deployment provides multi-tenancy.
  • Determine whether FIPS should be enabled
  • Choose install type:
    • All-in-one with FortiSIEM Manager
    • All-in-one with Supervisor only, or
    • Cluster with Supervisor and Workers
  • Choose storage type for Supervisor, Worker, and/or Collector
    • Online storage - There are 4 choices
    • Archive storage – There are 2 choices
      • EventDB on NFS
      • HDFS
  • Determine hardware requirements:
Node vCPU RAM Local Disks

Manager

Minimum – 16
Recommended - 32

Minimum

  • 24GB

Recommended

  • 32GB

OS – 25GB

OPT – 100GB

CMDB – 60GB

SVN – 60GB

Supervisor (All in one) Minimum – 12
Recommended - 32

Minimum

  • without UEBA – 24GB
  • with UEBA - 32GB

Recommended

  • without UEBA – 32GB
  • with UEBA - 64GB

OS – 25GB

OPT – 100GB

CMDB – 60GB

SVN – 60GB

Local Event database – based on need

Supervisor (Cluster) Minimum – 12
Recommended - 32

Minimum

  • without UEBA – 24GB
  • with UEBA - 32GB

Recommended

  • without UEBA – 32GB
  • with UEBA - 64GB

OS – 25GB

OPT – 100GB

CMDB – 60GB

SVN – 60GB

Workers Minimum – 8
Recommended - 16

Minimum – 16GB

Recommended – 24GB

OS – 25GB

OPT – 100GB

Collector Minimum – 4
Recommended – 8 ( based on load)

Minimum – 4GB

Recommended – 8GB

OS – 25GB

OPT – 100GB

  • If your Online event database is external (e.g. EventDB on NFS or Elasticsearch), then you must configure external storage before proceeding to FortiSIEM deployment.

    • For NFS deployment, see here.

    • For Elasticsearch deployment, see here.

  • If your Online event database is internal, that is, inside Supervisor or Worker nodes, then you need to determine the size of the disks based on your EPS and event retention needs.

    • For EventDB on local disk, see here.

    • For ClickHouse, see here.

  • For OPT - 100GB, the 100GB disk for /opt will consist of a single disk that will split into 2 partitions, /OPT and swap. The partitions will be created and managed by FortiSIEM when configFSM.sh runs.

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.

Import FortiSIEM into KVM

  1. Go to the Fortinet Support website https://support.fortinet.com to download the KVM package FSM_Full_All_KVM_6.7.1_build1725.zip. See Downloading FortiSIEM Products for more information on downloading products from the support website.
  2. Download the packages for Super/Worker and Collector to the location where you want to install the image. For example: FSM_Full_All_KVM_6.7.1_build1725.zip .
  3. Unzip the .zip file to get the FortiSIEM-6.7.1.1725.qcow2 file.
  4. Copy the above unzipped qcow2 file into the storage image location separately for the installation of super, worker, and collector. For example:

    /var/lib/libvirt/images/super/FortiSIEM-6.7.1.1725.qcow2

    /var/lib/libvirt/images/worker/FortiSIEM-6.7.1.1725.qcow2

    /var/lib/libvirt/images/collector/FortiSIEM-6.7.1.1725.qcow2

  5. Start the KVM Manager for the KVM server by clicking Virtual Machine Manager.

  6. Click Create a new virtual machine from the Virtual Machine Manager.
  7. Select Import existing disk image (Architecture defaults to x86_64).

  8. Click Forward from the above step, and select the OS type as Linux and Verision to CentOS 7.0, then click Forward.

  9. Click Browse... from the New VM dialog box to find the location for the file (for example, FortiSIEM-6.7.1.1725.qcow2). Or, you can directly copy the path and the qcow2 file name under Provide the existing storage path. Click Forward.

  10. In the New VM dialog box, change Memory from 1024 to 32000 (32 GB). Change the CPUs from 1 to 8. Click Forward.

  11. Before clicking Finish, make sure to check that the Network selection is a Bridge, and Customize configuration before install is selected. Then, click Finish.

  12. Start to make the configuration. This is the place where you change the name from the default name centos 7.0 in the Overview.

    caution icon

    In every step in this configuration, you must click Apply to save your changes.

  13. Click VirtIO Disk 1 (the default disk) and check that the Source path is correct. Click Apply.
  14. Click Boot Options and make sure that VirtIO Disk 1 is checked. Click Apply.

  15. Add an extra three disks by clicking Add Hardware. Assign to them the disk image size to 100GB, 60GB, and 60GB respectively with the same Bus type of VirtIO. Click Finish to save the result.

    Disk

    Size

    Disk Name

    Hard Disk 2 100GB

    /opt

    For OPT - 100GB, the 100GB disk for /opt will consist of a single disk that will split into 2 partitions, /OPT and swap. The partitions will be created and managed by FortiSIEM when configFSM.sh runs.

    Hard Disk 3 60GB /cmdb
    Hard Disk 4 60GB /svn
    Hard Disk 5 60GB+ /data (see the following note)

    Note on Hard Disk 5:

    • Add the 5th disk only if using EventDB on local storage or ClickHouse. In all other cases, this disk is not required. ClickHouse is recommended for most deployments. Please see ClickHouse Reference Architecture for more information.

    • For EventDB on local disk, choose a disk based on your EPS and event retention policy. See EventDB Sizing Guide for guidance. 60GB is the minimum.

    • For ClickHouse, choose disks based on the number of Tiers and disks on each Tier. These depend on your EPS and event retention policy. See ClickHouse Sizing Guide for guidance. For example, you can choose 1 large disk for Hot Tier. Or you can choose 2 Tiers - Hot Tier comprised of one or more SSD disks and Warm Tier comprised of one or more magnetic hard disks.

  16. Click Begin Installation at the top of the dialog box to start the installation process.

  17. At the end of booting, log in with the default login credentials: User: root and Password: ProspectHills.

  18. 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.

Configure FortiSIEM

Follow these steps to configure FortiSIEM by using a simple GUI.

  1. Log in as user root with the password you set in Step 18 above.
  2. At the command prompt, go to /usr/local/bin and enter configFSM.sh, for example:

    # configFSM.sh

  3. In VM console, select 1 Set Timezone and then press Next.

  4. Select your Region, and press Next.

  5. Select your Country, and press Next.

  6. Select the Country and City for your timezone, and press Next.

  7. If installing a Supervisor, select 1 Supervisor, and press Next.
    If installing a Worker, select 2 Worker, and press Next.
    If installing a Collector, select 3 Collector, and press Next.
    If Installing FortiSIEM Manager, select 4 FortiSIEM Manager, and press Next.
    If Installing FortiSIEM Supervisor Follower, select 5 Supervisor Follower and press Next.
    Note: The appliance type cannot be changed once it is deployed, so ensure you have selected the correct option.


    note icon

    Regardless of whether you select FortiSIEM Manager,Supervisor, Supervisor Follower, Worker, or Collector, you will see the same series of screens with only the header changed to reflect your target installation, unless noted otherwise.

    A dedicated ClickHouse Keeper uses a Worker, so first install a Worker and then in later steps configure the Worker as a ClickHouse Keeper.

  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 network by entering the following fields. Press Next.

    OptionDescription
    IPv4 AddressThe Manager/Supervisor/Worker/Collector's IPv4 address
    NetMaskThe Manager/Supervisor/Worker/Collector's subnet
    GatewayNetwork gateway address
    DNS1, DNS2Addresses of the DNS servers

  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.
    OptionDescription
    IPv6 AddressThe Manager/Supervisor/Worker/Collector's IPv6 address
    prefix (Netmask)The Manager/Supervisor/Worker/Collector's IPv6 prefix
    Gateway ipv6IPv6 Network gateway address
    DNS1 IPv6, DNS2 IPv6Addresses 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.

  13. Configure Hostname for FortiSIEM Manager/Supervisor/Worker/Collector. Press Next.

    Note: FQDN is no longer needed.
  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.

    The options are described in the following table.

    OptionDescription
    -rThe FortiSIEM component being configured
    -zThe time zone being configured
    -iIPv4-formatted address
    -mAddress of the subnet mask
    -gAddress of the gateway server used
    --hostHost name
    -fFQDN address: fully-qualified domain name
    -tThe 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 (install_without_fips, install_with_fips, enable_fips, disable_fips, change_network_config*)
    *Option only available after installation.

    -zTime zone. Possible values are US/Pacific, Asia/Shanghai, Europe/London, or Africa/Tunis

    --testpinghost

    The URL used to test connectivity

  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.

Upload the FortiSIEM License

note icon

Before proceeding, make sure that you have obtained valid FortiSIEM license from Forticare. For more information, see the Licensing Guide.

You will now be asked to input a license.

  1. Open a Web browser and log in to the FortiSIEM UI. Use link https://<supervisor-ip> to login. Please note that if you are logging into FortiSIEM with an IPv6 address, you should input https://[IPv6 address] on the browser tab.
  2. The License Upload dialog box will open.

  3. Click Browse and upload the license file.

    Make sure that the Hardware ID shown in the License Upload page matches the license.

  4. For User ID and Password, choose any Full Admin credentials.

    For the first time installation, enter admin as the user and admin*1 as the password. You will then be asked to create a new password for GUI access.

  5. Choose License type as Enterprise or Service Provider.

    This option is available only for a first time installation. Once the database is configured, this option will not be available.
    For FortiSIEM Manager, License Type is not an available option, and will not appear. At this point, FortiSIEM Manager installation is complete. You will not be taken the Event Database Storage page, so you can skip Configure an Event Database.
    Note: The FortiSIEM Manager license allows a certain number of instances that can be registered to FortiSIEM Manager.

  6. Proceed to Configure an Event Database.

Configure an Event Database

Choose the event database.

If the Event Database is one of the following options, additional disk configuration is required.

Final Check

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, Supervisor Follower, Worker and Collector, the response should be similar to the following.



For FortiSIEM Manager, the response should look similar to the following.

Cluster Installation

For larger installations, you can choose Worker nodes, Collector nodes, and external storage (NFS, ClickHouse, or Elasticsearch).

Install Supervisor

Follow the steps in All-in-one Installation, except with the following differences.

  1. Event Database choices are EventDB on NFS, ClickHouse, or Elasticsearch.

  2. If you choose EventDB on NFS

    1. Disk 5 is not required (From Import FortiSIEM into KVM Step 15).

    2. You need to configure NFS after license upload.



  3. If you choose ClickHouse

    1. You need to create disks during Import FortiSIEM into KVM Step 15 based on the role of the Supervisor node in the ClickHouse cluster. See the ClickHouse Sizing Guide for details.

    2. You need to configure disks after license upload.



  4. If you choose Elasticsearch, define Elasticsearch endpoints after license upload. See the Elasticsearch Sizing Guide for details.

Install Workers

Once the Supervisor is installed, take the same steps in All-in-one Installation to install a Worker with the following differences.

  1. Choose appropriate CPU and memory for the Worker nodes based on Sizing guide.

  2. Two hard disks for Operating Systems and FortiSIEM Application:

    • OS – 25GB

    • OPT – 100GB

      For OPT - 100GB, the 100GB disk for /opt will consist of a single disk that will split into 2 partitions, /OPT and swap. The partitions will be created and managed by FortiSIEM when configFSM.sh runs.

  3. If you are running ClickHouse, then create additional data disks based on the role of the Worker in ClickHouse topology. If it is a Keeper node, then a smaller disk is needed. If it is a data node, then a bigger disk is needed based on your EPS and retention policy. See ClickHouse Sizing Guide for details.

Sizing Guide References:

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 Mode drop-down list and enter the following information:

    1. In the Host Name field, enter the Worker's host name.

    2. In the IP Address field, enter the Worker's IP address.

    3. If you are running ClickHouse, then select the number for Storage Tiers from the Storage Tiers drop-down list, and input disk paths for disks in each Tier in the Disk Path fields.

      For Disk Path, use one of the following CLI commands to find the disk names.

      fdisk -l

      or

      lsblk

      When using lsblk to find the disk name, please note that the path will be /dev/<disk>. As an example KVM, the 3rd disk (hot) will be /dev/vdc and the 4th disk (warm) will be /dev/vdc.

    4. Click Test.

    5. If the test succeeds, then click Save.

  3. See ADMIN > Health > Cloud Health to ensure that the Workers are up, healthy, and properly added to the system.


Create ClickHouse Topology (Optional)

If you are running ClickHouse, you need to configure ClickHouse topology by specifying which nodes belong to ClickHouse Keeper and Data Clusters. Follow the steps in Configuring ClickHouse Topology.

Install Collectors

Once Supervisor and Workers are installed, follow the same steps in All-in-one Install to install a Collector except you need to only choose OS and OPT disks.

Collector in Regular IT Environments

The recommended settings for Collector node are:

  • CPU = 4
  • Memory = 8GB
  • Two hard disks:
    • OS – 25GB
    • OPT – 100GB
      For OPT - 100GB, the 100GB disk for /opt will consist of a single disk that will split into 2 partitions, /OPT and swap. The partitions will be created and managed by FortiSIEM when configFSM.sh runs.

Collector with Reduced Disk in OT Environments

FortiSIEM installations require the disk for OPT+SWAP 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.

    • /usr/local/syslib/config/disksConfig.json

    • /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.

      "FSIEMKVM": {
        "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"
        }
      },
    
  5. Save the disksConfig.json file.

  6. Load the /usr/local/install/roles/fsm-disk-mgmt/tasks/disks.yml file via a text editor. You can choose to adjust only the (step a) OPT disk or (step b) adjust the swap disk and OPT disk. To change only the OPT disk, proceed with step a, then skip to step 7. To adjust the swap disk and reduce the OPT disk, skip step a and proceed with step b.

    1. ADJUST OPT DISK ONLY

      Navigate to line 54 in the /usr/local/install/roles/fsm-disk-mgmt/tasks/disks.yml file and change the line.

      Original 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 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

      Skip step b and c, and proceed to step 7.

    2. ADJUST SWAP DISK and REDUCE OPT DISK

      Reduce the Swap Disk by changing the following original line (The original line assumes swap disk to be 25GB).

      parted -a optimal --script "{{ item.disk }}" mklabel gpt mkpart primary linux-swap 1G 25G && sleep 5

      Change to (in this example 10G), marked in blue:

      parted -a optimal --script "{{ item.disk }}" mklabel gpt mkpart primary linux-swap 1G 10G && sleep 5
    3. 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
  7. Save the disks.yml file.

  8. Run configFSM.sh to install the collector. When it reboots, you can provision it using the phProvisionCollector command. Your partition output should appear similar to the following.

    Partition Output of deployment:
    sdb           8:16   0   35G  0 disk 
    ├─sdb1        8:17   0  8.4G  0 part [SWAP]
    └─sdb2        8:18   0 22.4G  0 part /opt
    
    # 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

Collectors can be deployed in Enterprise or Service Provider environments.

Enterprise Deployments

For Enterprise deployments, follow these steps.

  1. Log in to Supervisor with 'Admin' privileges.
  2. Go to ADMIN > Settings > System > Cluster Config.
    1. 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.
    2. Click Save.
    3. In the Supervisors column, enter the IP of the Supervisor node and click Save.
  3. Go to ADMIN > Setup > Collectors and add a Collector by entering:
    1. Name – Collector Name
    2. Guaranteed EPS – this is the EPS that Collector will always be able to send. It could send more if there is excess EPS available.
    3. Start Time and End Time – set to Unlimited.
  4. 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.

    1. Set user and password using the admin user name and password for the Supervisor.
    2. Set Super IP or Host as the Supervisor's IP address.
    3. Set Organization. For Enterprise deployments, the default name is Super.
    4. Set CollectorName from Step 2a.

      The Collector will reboot during the Registration.

  5. Go to ADMIN > Health > Collector Health for the status.

Service Provider Deployments

For Service Provider deployments, follow these steps.

  1. Log in to Supervisor with 'Admin' privileges.
  2. Go to ADMIN > Settings > System > Cluster Config.
    1. 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.
    2. Click Save.
    3. In the Supervisors column, enter the IP of the Supervisor node and click Save.

  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.

  7. 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.

    1. Set user and password using the admin user name and password for the Organization that the Collector is going to be registered to.
    2. Set Super IP or Host as the Supervisor's IP address.
    3. Set Organization as the name of an organization created on the Supervisor.
    4. Set CollectorName from Step 6.

      The Collector will reboot during the Registration.

  8. Go to ADMIN > Health > Collector Health and check the status.

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 to Manager. See Register Instances to Manager.

Register Instances to Manager

To register your Supervisor instance with Manager, you will need to do two things in the following order.

Note that Communication between FortiSIEM Manager and instances is via REST APIs over HTTP(S).

Adding Instance to Manager

You can add an instance to Manager by taking the following steps.
Note: Make sure to record the FortiSIEM Instance Name, Admin User and Admin Password, as this is needed when you register your instance.

  1. Login to FortiSIEM Manager.

  2. Navigate to ADMIN > Setup.

  3. Click New.

  4. In the FortiSIEM Instance field, enter the name of the Supervisor instance you wish to add.

  5. In the Admin User field, enter the Account name you wish to use to access Manager.

  6. In the Admin Password field, enter the Password that will be associated with the Admin User account.

  7. In the Confirm Admin Password field, re-enter the Password.

  8. (Optional) In the Description field, enter any information you wish to provide about the instance.

  9. Click Save.

  10. Repeat steps 1-9 to add any additional instances to Manager.
    Now, follow the instructions in Register the Instance Itself to Manager for each instance.

Register the Instance Itself to Manager

To register your instance with Manager, take the following steps.

  1. From your FortiSIEM Supervisor/Instance, navigate to ADMIN > Setup > FortiSIEM Manager, and take the following steps.

    1. In the FortiSIEM Manager FQDN/IP field, enter the FortiSIEM Manager Fully Qualified Domain Name (FQDN) or IP address.

    2. If the Supervisor is under a Supervisor Cluster environment, in the FortiSIEM super cluster FQDN/IP field, enter the Supervisor Cluster Fully Qualified Domain Name (FQDN) or IP address.

    3. In the FortiSIEM Instance Name field, enter the instance name used when adding the instance to Manager.

    4. In the Account field, enter the Admin User name used when adding the instance to Manager.

    5. In the Password field, enter your password to be associated with the Admin User name.

    6. In the Confirm Password field, re-enter your password.

    7. Click Test to verify the configuration.

    8. Click Register.
      A dialog box displaying "Registered successfully" should appear if everything is valid.

    9. Login to Manager, and navigate to any one of the following pages to verify registration.

      • ADMIN > Setup and check that the box is marked in the Registered column for your instance.

      • ADMIN > Health, look for your instance under FortiSIEM Instances.

      • ADMIN > License, look for your instance under FortiSIEM Instances.

Install Log

The install ansible log file is located here: /usr/local/fresh-install/logs/ansible.log.

Errors can be found at the end of the file.

Fresh Installation

Pre-Installation Checklist

Before you begin, check the following:

  • Ensure that your system can connect to the network. You will be asked to provide a DNS Server and a host that can be resolved by the DNS Server and responds to ping. The host can either be an internal host or a public domain host like google.com.

  • Choose deployment type – Enterprise or Service Provider. The Service Provider deployment provides multi-tenancy.
  • Determine whether FIPS should be enabled
  • Choose install type:
    • All-in-one with FortiSIEM Manager
    • All-in-one with Supervisor only, or
    • Cluster with Supervisor and Workers
  • Choose storage type for Supervisor, Worker, and/or Collector
    • Online storage - There are 4 choices
    • Archive storage – There are 2 choices
      • EventDB on NFS
      • HDFS
  • Determine hardware requirements:
Node vCPU RAM Local Disks

Manager

Minimum – 16
Recommended - 32

Minimum

  • 24GB

Recommended

  • 32GB

OS – 25GB

OPT – 100GB

CMDB – 60GB

SVN – 60GB

Supervisor (All in one) Minimum – 12
Recommended - 32

Minimum

  • without UEBA – 24GB
  • with UEBA - 32GB

Recommended

  • without UEBA – 32GB
  • with UEBA - 64GB

OS – 25GB

OPT – 100GB

CMDB – 60GB

SVN – 60GB

Local Event database – based on need

Supervisor (Cluster) Minimum – 12
Recommended - 32

Minimum

  • without UEBA – 24GB
  • with UEBA - 32GB

Recommended

  • without UEBA – 32GB
  • with UEBA - 64GB

OS – 25GB

OPT – 100GB

CMDB – 60GB

SVN – 60GB

Workers Minimum – 8
Recommended - 16

Minimum – 16GB

Recommended – 24GB

OS – 25GB

OPT – 100GB

Collector Minimum – 4
Recommended – 8 ( based on load)

Minimum – 4GB

Recommended – 8GB

OS – 25GB

OPT – 100GB

  • If your Online event database is external (e.g. EventDB on NFS or Elasticsearch), then you must configure external storage before proceeding to FortiSIEM deployment.

    • For NFS deployment, see here.

    • For Elasticsearch deployment, see here.

  • If your Online event database is internal, that is, inside Supervisor or Worker nodes, then you need to determine the size of the disks based on your EPS and event retention needs.

    • For EventDB on local disk, see here.

    • For ClickHouse, see here.

  • For OPT - 100GB, the 100GB disk for /opt will consist of a single disk that will split into 2 partitions, /OPT and swap. The partitions will be created and managed by FortiSIEM when configFSM.sh runs.

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.

Import FortiSIEM into KVM

  1. Go to the Fortinet Support website https://support.fortinet.com to download the KVM package FSM_Full_All_KVM_6.7.1_build1725.zip. See Downloading FortiSIEM Products for more information on downloading products from the support website.
  2. Download the packages for Super/Worker and Collector to the location where you want to install the image. For example: FSM_Full_All_KVM_6.7.1_build1725.zip .
  3. Unzip the .zip file to get the FortiSIEM-6.7.1.1725.qcow2 file.
  4. Copy the above unzipped qcow2 file into the storage image location separately for the installation of super, worker, and collector. For example:

    /var/lib/libvirt/images/super/FortiSIEM-6.7.1.1725.qcow2

    /var/lib/libvirt/images/worker/FortiSIEM-6.7.1.1725.qcow2

    /var/lib/libvirt/images/collector/FortiSIEM-6.7.1.1725.qcow2

  5. Start the KVM Manager for the KVM server by clicking Virtual Machine Manager.

  6. Click Create a new virtual machine from the Virtual Machine Manager.
  7. Select Import existing disk image (Architecture defaults to x86_64).

  8. Click Forward from the above step, and select the OS type as Linux and Verision to CentOS 7.0, then click Forward.

  9. Click Browse... from the New VM dialog box to find the location for the file (for example, FortiSIEM-6.7.1.1725.qcow2). Or, you can directly copy the path and the qcow2 file name under Provide the existing storage path. Click Forward.

  10. In the New VM dialog box, change Memory from 1024 to 32000 (32 GB). Change the CPUs from 1 to 8. Click Forward.

  11. Before clicking Finish, make sure to check that the Network selection is a Bridge, and Customize configuration before install is selected. Then, click Finish.

  12. Start to make the configuration. This is the place where you change the name from the default name centos 7.0 in the Overview.

    caution icon

    In every step in this configuration, you must click Apply to save your changes.

  13. Click VirtIO Disk 1 (the default disk) and check that the Source path is correct. Click Apply.
  14. Click Boot Options and make sure that VirtIO Disk 1 is checked. Click Apply.

  15. Add an extra three disks by clicking Add Hardware. Assign to them the disk image size to 100GB, 60GB, and 60GB respectively with the same Bus type of VirtIO. Click Finish to save the result.

    Disk

    Size

    Disk Name

    Hard Disk 2 100GB

    /opt

    For OPT - 100GB, the 100GB disk for /opt will consist of a single disk that will split into 2 partitions, /OPT and swap. The partitions will be created and managed by FortiSIEM when configFSM.sh runs.

    Hard Disk 3 60GB /cmdb
    Hard Disk 4 60GB /svn
    Hard Disk 5 60GB+ /data (see the following note)

    Note on Hard Disk 5:

    • Add the 5th disk only if using EventDB on local storage or ClickHouse. In all other cases, this disk is not required. ClickHouse is recommended for most deployments. Please see ClickHouse Reference Architecture for more information.

    • For EventDB on local disk, choose a disk based on your EPS and event retention policy. See EventDB Sizing Guide for guidance. 60GB is the minimum.

    • For ClickHouse, choose disks based on the number of Tiers and disks on each Tier. These depend on your EPS and event retention policy. See ClickHouse Sizing Guide for guidance. For example, you can choose 1 large disk for Hot Tier. Or you can choose 2 Tiers - Hot Tier comprised of one or more SSD disks and Warm Tier comprised of one or more magnetic hard disks.

  16. Click Begin Installation at the top of the dialog box to start the installation process.

  17. At the end of booting, log in with the default login credentials: User: root and Password: ProspectHills.

  18. 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.

Configure FortiSIEM

Follow these steps to configure FortiSIEM by using a simple GUI.

  1. Log in as user root with the password you set in Step 18 above.
  2. At the command prompt, go to /usr/local/bin and enter configFSM.sh, for example:

    # configFSM.sh

  3. In VM console, select 1 Set Timezone and then press Next.

  4. Select your Region, and press Next.

  5. Select your Country, and press Next.

  6. Select the Country and City for your timezone, and press Next.

  7. If installing a Supervisor, select 1 Supervisor, and press Next.
    If installing a Worker, select 2 Worker, and press Next.
    If installing a Collector, select 3 Collector, and press Next.
    If Installing FortiSIEM Manager, select 4 FortiSIEM Manager, and press Next.
    If Installing FortiSIEM Supervisor Follower, select 5 Supervisor Follower and press Next.
    Note: The appliance type cannot be changed once it is deployed, so ensure you have selected the correct option.


    note icon

    Regardless of whether you select FortiSIEM Manager,Supervisor, Supervisor Follower, Worker, or Collector, you will see the same series of screens with only the header changed to reflect your target installation, unless noted otherwise.

    A dedicated ClickHouse Keeper uses a Worker, so first install a Worker and then in later steps configure the Worker as a ClickHouse Keeper.

  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 network by entering the following fields. Press Next.

    OptionDescription
    IPv4 AddressThe Manager/Supervisor/Worker/Collector's IPv4 address
    NetMaskThe Manager/Supervisor/Worker/Collector's subnet
    GatewayNetwork gateway address
    DNS1, DNS2Addresses of the DNS servers

  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.
    OptionDescription
    IPv6 AddressThe Manager/Supervisor/Worker/Collector's IPv6 address
    prefix (Netmask)The Manager/Supervisor/Worker/Collector's IPv6 prefix
    Gateway ipv6IPv6 Network gateway address
    DNS1 IPv6, DNS2 IPv6Addresses 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.

  13. Configure Hostname for FortiSIEM Manager/Supervisor/Worker/Collector. Press Next.

    Note: FQDN is no longer needed.
  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.

    The options are described in the following table.

    OptionDescription
    -rThe FortiSIEM component being configured
    -zThe time zone being configured
    -iIPv4-formatted address
    -mAddress of the subnet mask
    -gAddress of the gateway server used
    --hostHost name
    -fFQDN address: fully-qualified domain name
    -tThe 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 (install_without_fips, install_with_fips, enable_fips, disable_fips, change_network_config*)
    *Option only available after installation.

    -zTime zone. Possible values are US/Pacific, Asia/Shanghai, Europe/London, or Africa/Tunis

    --testpinghost

    The URL used to test connectivity

  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.

Upload the FortiSIEM License

note icon

Before proceeding, make sure that you have obtained valid FortiSIEM license from Forticare. For more information, see the Licensing Guide.

You will now be asked to input a license.

  1. Open a Web browser and log in to the FortiSIEM UI. Use link https://<supervisor-ip> to login. Please note that if you are logging into FortiSIEM with an IPv6 address, you should input https://[IPv6 address] on the browser tab.
  2. The License Upload dialog box will open.

  3. Click Browse and upload the license file.

    Make sure that the Hardware ID shown in the License Upload page matches the license.

  4. For User ID and Password, choose any Full Admin credentials.

    For the first time installation, enter admin as the user and admin*1 as the password. You will then be asked to create a new password for GUI access.

  5. Choose License type as Enterprise or Service Provider.

    This option is available only for a first time installation. Once the database is configured, this option will not be available.
    For FortiSIEM Manager, License Type is not an available option, and will not appear. At this point, FortiSIEM Manager installation is complete. You will not be taken the Event Database Storage page, so you can skip Configure an Event Database.
    Note: The FortiSIEM Manager license allows a certain number of instances that can be registered to FortiSIEM Manager.

  6. Proceed to Configure an Event Database.

Configure an Event Database

Choose the event database.

If the Event Database is one of the following options, additional disk configuration is required.

Final Check

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, Supervisor Follower, Worker and Collector, the response should be similar to the following.



For FortiSIEM Manager, the response should look similar to the following.

Cluster Installation

For larger installations, you can choose Worker nodes, Collector nodes, and external storage (NFS, ClickHouse, or Elasticsearch).

Install Supervisor

Follow the steps in All-in-one Installation, except with the following differences.

  1. Event Database choices are EventDB on NFS, ClickHouse, or Elasticsearch.

  2. If you choose EventDB on NFS

    1. Disk 5 is not required (From Import FortiSIEM into KVM Step 15).

    2. You need to configure NFS after license upload.



  3. If you choose ClickHouse

    1. You need to create disks during Import FortiSIEM into KVM Step 15 based on the role of the Supervisor node in the ClickHouse cluster. See the ClickHouse Sizing Guide for details.

    2. You need to configure disks after license upload.



  4. If you choose Elasticsearch, define Elasticsearch endpoints after license upload. See the Elasticsearch Sizing Guide for details.

Install Workers

Once the Supervisor is installed, take the same steps in All-in-one Installation to install a Worker with the following differences.

  1. Choose appropriate CPU and memory for the Worker nodes based on Sizing guide.

  2. Two hard disks for Operating Systems and FortiSIEM Application:

    • OS – 25GB

    • OPT – 100GB

      For OPT - 100GB, the 100GB disk for /opt will consist of a single disk that will split into 2 partitions, /OPT and swap. The partitions will be created and managed by FortiSIEM when configFSM.sh runs.

  3. If you are running ClickHouse, then create additional data disks based on the role of the Worker in ClickHouse topology. If it is a Keeper node, then a smaller disk is needed. If it is a data node, then a bigger disk is needed based on your EPS and retention policy. See ClickHouse Sizing Guide for details.

Sizing Guide References:

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 Mode drop-down list and enter the following information:

    1. In the Host Name field, enter the Worker's host name.

    2. In the IP Address field, enter the Worker's IP address.

    3. If you are running ClickHouse, then select the number for Storage Tiers from the Storage Tiers drop-down list, and input disk paths for disks in each Tier in the Disk Path fields.

      For Disk Path, use one of the following CLI commands to find the disk names.

      fdisk -l

      or

      lsblk

      When using lsblk to find the disk name, please note that the path will be /dev/<disk>. As an example KVM, the 3rd disk (hot) will be /dev/vdc and the 4th disk (warm) will be /dev/vdc.

    4. Click Test.

    5. If the test succeeds, then click Save.

  3. See ADMIN > Health > Cloud Health to ensure that the Workers are up, healthy, and properly added to the system.


Create ClickHouse Topology (Optional)

If you are running ClickHouse, you need to configure ClickHouse topology by specifying which nodes belong to ClickHouse Keeper and Data Clusters. Follow the steps in Configuring ClickHouse Topology.

Install Collectors

Once Supervisor and Workers are installed, follow the same steps in All-in-one Install to install a Collector except you need to only choose OS and OPT disks.

Collector in Regular IT Environments

The recommended settings for Collector node are:

  • CPU = 4
  • Memory = 8GB
  • Two hard disks:
    • OS – 25GB
    • OPT – 100GB
      For OPT - 100GB, the 100GB disk for /opt will consist of a single disk that will split into 2 partitions, /OPT and swap. The partitions will be created and managed by FortiSIEM when configFSM.sh runs.

Collector with Reduced Disk in OT Environments

FortiSIEM installations require the disk for OPT+SWAP 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.

    • /usr/local/syslib/config/disksConfig.json

    • /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.

      "FSIEMKVM": {
        "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"
        }
      },
    
  5. Save the disksConfig.json file.

  6. Load the /usr/local/install/roles/fsm-disk-mgmt/tasks/disks.yml file via a text editor. You can choose to adjust only the (step a) OPT disk or (step b) adjust the swap disk and OPT disk. To change only the OPT disk, proceed with step a, then skip to step 7. To adjust the swap disk and reduce the OPT disk, skip step a and proceed with step b.

    1. ADJUST OPT DISK ONLY

      Navigate to line 54 in the /usr/local/install/roles/fsm-disk-mgmt/tasks/disks.yml file and change the line.

      Original 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 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

      Skip step b and c, and proceed to step 7.

    2. ADJUST SWAP DISK and REDUCE OPT DISK

      Reduce the Swap Disk by changing the following original line (The original line assumes swap disk to be 25GB).

      parted -a optimal --script "{{ item.disk }}" mklabel gpt mkpart primary linux-swap 1G 25G && sleep 5

      Change to (in this example 10G), marked in blue:

      parted -a optimal --script "{{ item.disk }}" mklabel gpt mkpart primary linux-swap 1G 10G && sleep 5
    3. 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
  7. Save the disks.yml file.

  8. Run configFSM.sh to install the collector. When it reboots, you can provision it using the phProvisionCollector command. Your partition output should appear similar to the following.

    Partition Output of deployment:
    sdb           8:16   0   35G  0 disk 
    ├─sdb1        8:17   0  8.4G  0 part [SWAP]
    └─sdb2        8:18   0 22.4G  0 part /opt
    
    # 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

Collectors can be deployed in Enterprise or Service Provider environments.

Enterprise Deployments

For Enterprise deployments, follow these steps.

  1. Log in to Supervisor with 'Admin' privileges.
  2. Go to ADMIN > Settings > System > Cluster Config.
    1. 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.
    2. Click Save.
    3. In the Supervisors column, enter the IP of the Supervisor node and click Save.
  3. Go to ADMIN > Setup > Collectors and add a Collector by entering:
    1. Name – Collector Name
    2. Guaranteed EPS – this is the EPS that Collector will always be able to send. It could send more if there is excess EPS available.
    3. Start Time and End Time – set to Unlimited.
  4. 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.

    1. Set user and password using the admin user name and password for the Supervisor.
    2. Set Super IP or Host as the Supervisor's IP address.
    3. Set Organization. For Enterprise deployments, the default name is Super.
    4. Set CollectorName from Step 2a.

      The Collector will reboot during the Registration.

  5. Go to ADMIN > Health > Collector Health for the status.

Service Provider Deployments

For Service Provider deployments, follow these steps.

  1. Log in to Supervisor with 'Admin' privileges.
  2. Go to ADMIN > Settings > System > Cluster Config.
    1. 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.
    2. Click Save.
    3. In the Supervisors column, enter the IP of the Supervisor node and click Save.

  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.

  7. 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.

    1. Set user and password using the admin user name and password for the Organization that the Collector is going to be registered to.
    2. Set Super IP or Host as the Supervisor's IP address.
    3. Set Organization as the name of an organization created on the Supervisor.
    4. Set CollectorName from Step 6.

      The Collector will reboot during the Registration.

  8. Go to ADMIN > Health > Collector Health and check the status.

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 to Manager. See Register Instances to Manager.

Register Instances to Manager

To register your Supervisor instance with Manager, you will need to do two things in the following order.

Note that Communication between FortiSIEM Manager and instances is via REST APIs over HTTP(S).

Adding Instance to Manager

You can add an instance to Manager by taking the following steps.
Note: Make sure to record the FortiSIEM Instance Name, Admin User and Admin Password, as this is needed when you register your instance.

  1. Login to FortiSIEM Manager.

  2. Navigate to ADMIN > Setup.

  3. Click New.

  4. In the FortiSIEM Instance field, enter the name of the Supervisor instance you wish to add.

  5. In the Admin User field, enter the Account name you wish to use to access Manager.

  6. In the Admin Password field, enter the Password that will be associated with the Admin User account.

  7. In the Confirm Admin Password field, re-enter the Password.

  8. (Optional) In the Description field, enter any information you wish to provide about the instance.

  9. Click Save.

  10. Repeat steps 1-9 to add any additional instances to Manager.
    Now, follow the instructions in Register the Instance Itself to Manager for each instance.

Register the Instance Itself to Manager

To register your instance with Manager, take the following steps.

  1. From your FortiSIEM Supervisor/Instance, navigate to ADMIN > Setup > FortiSIEM Manager, and take the following steps.

    1. In the FortiSIEM Manager FQDN/IP field, enter the FortiSIEM Manager Fully Qualified Domain Name (FQDN) or IP address.

    2. If the Supervisor is under a Supervisor Cluster environment, in the FortiSIEM super cluster FQDN/IP field, enter the Supervisor Cluster Fully Qualified Domain Name (FQDN) or IP address.

    3. In the FortiSIEM Instance Name field, enter the instance name used when adding the instance to Manager.

    4. In the Account field, enter the Admin User name used when adding the instance to Manager.

    5. In the Password field, enter your password to be associated with the Admin User name.

    6. In the Confirm Password field, re-enter your password.

    7. Click Test to verify the configuration.

    8. Click Register.
      A dialog box displaying "Registered successfully" should appear if everything is valid.

    9. Login to Manager, and navigate to any one of the following pages to verify registration.

      • ADMIN > Setup and check that the box is marked in the Registered column for your instance.

      • ADMIN > Health, look for your instance under FortiSIEM Instances.

      • ADMIN > License, look for your instance under FortiSIEM Instances.

Install Log

The install ansible log file is located here: /usr/local/fresh-install/logs/ansible.log.

Errors can be found at the end of the file.