Understanding the Roles of O&M Project Components

  • Last update: 2025-07-17
  • Overview

    Version

    FineOps Version
    Functional Change
    V2.0.0/
    V2.3.0

    Supported deployment of the Nginx cluster for multi-application projects (clusters), which would serve as the FanRuan internal gateway.

    V2.3.0Allowed connecting a self-prepared Elasticsearch of V7.10 and later versions to the project to provide log services.
    V2.16.0Removed Nginx-related description from the name of the FanRuan internal gateway component to prevent misunderstanding.
    V2.18.0

    1. Supported self-provided S3 as the data storage service only. Removed support for the self-provided shared storage directory.

    2. Allowed changing the data storage service component for deployed projects.

    Application Scenario

    Projects (FineBI, FineReport, FineDataLink) deployed via FineOps include not only the projects, but also associated components such as the external configuration database, cluster components, and O&M components.

    This document details the role of each component. The following table shows a brief introduction.

    ComponentRequired or OptionalDescription
    FineBI - Application NodeIt must be installed for FineBI.FineBI application node

    Engine - Metadata Node

    It must be installed for FineBI.The metadata node of the FineBI engine

    Engine - Calculation Node

    It must be installed for FineBI.The calculation node of the FineBI engine

    FineBI MinIO

    It must be installed for FineBI.

    A self-provided component is supported and recommended.

    The data storage component of FineBI

    FineReport

    It must be installed for FineReport.FineReport application node
    FineDataLinkIt must be installed for FineDataLink.FineDataLink application node
    OPS AgentIt must be installed.It is used for managing components, upgrading containers, and collecting various metric information of physical servers and components.
    FanRuan Internal GatewayIt is optional for standalone projects, but required for cluster projects.

    It serves as the entry for services provided by other project components and cluster components, ensuring load-balanced request forwarding.

    ElasticsearchIt is optional for standalone projects, but required for cluster projects.Log storage
    FilebeatIt should be installed together with Elasticsearch.Log collection
    MySQLIt must be installed. A self-provided component is supported.It serves as the external configuration database, storing project configuration information.
    RedisIt is required for cluster projects only.It serves as the state server for clusters.
    MinIOIt is required for cluster projects only.It serves as the file server for clusters.
    Kafka

    It is optional for FineDataLink.

    The Pipeline Task function in FineDataLink is unavailable without this component.
    NacosIt is required for FineDataLink clusters only.Service registry
    Nacos_MySQLIt should be installed together with NacosIt is the MySQL component required for providing Nacos services.

    Required Component

    These components will be installed by default as they are required under all circumstances. They will not appear under Project Setting > Basic Component when you deploy a project.

    FineBI - Application Node/Engine - Metadata Node/Engine - Calculation Node

    The following components will be installed only when you deploy a FineBI project.


    Description
    Component Role

    FineBI - Application Node/Engine - Metadata Node/Engine - Calculation Node

    They are components of the FineBI 6.1 project node and its engine nodes. No demo data is included.

    One Engine - Metadata Node component must be deployed. FineBI - Application Node and Engine - Calculation Node must be deployed in a ratio of 1:1 or 1:2.

    Required or OptionalThey must be installed.
    Installation Location

    They are installed on the main application node.

    The number of main application servers must be no fewer than the number of the FineBI - Application Node components, each hosting these three components.

    FineReport

    The following components will be installed only when you deploy a FineReport project.


    Description
    Component Role

    It is a component of the FineReport project node.  No demo data is included.

    Required or OptionalIt must be installed.
    Installation Location

    It is installed on the main application node.

    Each main application node of the project should host a FineReport component.

    FineDataLink

    The following components will be installed only when you deploy a FineDataLink project.


    Description
    Component Role

    It is a component of the FineDataLink project node.  No demo data is included.

    Required or OptionalIt must be installed.
    Installation Location

    It is installed on the main application node.

    Each main application node of the project should host a FineDataLink component.

    OPS Agent


    Description
    Component Role

    This component is installed on each physical server node.

    It is used for managing components, upgrading containers, and collecting various metric information of physical servers and components.

    Required or OptionalIt must be installed.
    Installation Location

    It is installed on each main application node and component node of the project.

    Basic Component

    FanRuan Internal Gateway


    Description
    Component Role

    Roles:

    • It serves as the entry for services provided by other project components, ensuring load-balanced request forwarding.

    • It enforces HTTPS via SSL certificate termination.

    • It gathers gateway-layer link trace metrics.

    Notes:

    The FanRuan internal gateway has experienced custom development based on FanRuan business to balance user requests and improve performance. Therefore, external provisioning or customization is not supported.

    If you need to use external load balancers, such as F5, SLB, and ELB, you should configure forwarding rules to direct client requests to your self-provided gateway first, then to the FanRuan internal gateway, and finally to various application nodes.

    Required or Optional

    1. For single-application projects, this component is optional.

    • You can install a single-node internal gateway, which is the default option.

    • You are advised to install it if you use FineOps for SSL configuration.

    • If the internal gateway component is not installed, the entry of external access will be changed from the port of the internal gateway component to that of the FineBI - Application Node/FineReport/FineDataLink component.

    2. For multi-application projects, this component must be installed.

    • You can install a single-node internal gateway or a dual-node internal gateway. Note that the dual-node internal gateway is not a Nginx cluster.

    • The default option is Deploy Single-Node Internal Gateway.

    • The FanRuan internal gateway has experienced custom development based on FanRuan business to balance user requests and improve performance. Therefore, external provisioning is not supported.

    Installation Location

    It is typically installed on the component node. If there are multiple component nodes, it will be installed on a random one.

    The following are special cases:

    1. When you deploy a single-application project with no component node, Nginx will be installed on the main application node if you select Deploy Single-Node Internal Gateway in FanRuan Internal Gateway.

    2. When you deploy a multi-application project with only one component node, one Nginx node will be installed on the component node and the other on a random main application node if you select Deploy Dual-Node Internal Gateway (Non-cluster) in FanRuan Internal Gateway.

    Log Service

    The log service components include Elasticsearch and Filebeat.

    Elasticsearch


    Description
    Component Role

    It provides log storage services.

    It replaces the built-in Swift (LogDB) for recording user activity logs.

    Required or Optional

    1. For single-application projects, this component is optional.

    • If it is not installed, the built-in Swift (LogDB) will be enabled for log storage.

    • You can install Elasticsearch or connect an existing self-provided Elasticsearch of V8.to the project.

    • Do not pause the component after successful deployment/connection. Otherwise, the project operation log will be lost.

    2. For multi-application projects, this component must be installed.

    • You can install Elasticsearch or connect an existing self-provided Elasticsearch of V8.to the project.

    • Do not pause the component after successful deployment/connection. Otherwise, the project operation log will be lost.

    Installation Location

    It is typically installed on the component node.

    If there are multiple component nodes, it will be installed on a random one.

    Special case: For single-application projects with no component node, it will be installed on the main application node.

    Filebeat


    Description
    Component Role

    It provides the log collection service and should be used with the Elasticsearch component.

    Required or OptionalIt should be installed together with the Elasticsearch component.
    Installation Location

    Each main application node of the project should host a Filebeat component.

    File Server


    Description
    Component Role

    It is used to store and share files and resources required by each application node, ensuring that every node can access and utilize them.

    Required or Optional

    1. For single-application projects, this component is not required.

    2. For multi-application projects, this component must be installed.

    • The default option is Deploy MinIO.

    • You can install a MinIO file server or connect an existing self-provided file server (such as SFTP, FTP, and an external shared directory) to the project.

    • If you need to use other types of file servers, you can log in to the project after it is successfully deployed and switch the file server.

    Installation Location

    If you choose to install a MinIO file server, it is typically installed on the component node.

    If there are multiple component nodes, it will be installed on a random one.

    External Configuration Database


    Description
    Component Role

    It is used to store and maintain configuration information and parameters of each application node. These parameters must be set reasonably to ensure coordinated operation among nodes.

    Required or Optional

    It must be installed.

    • The default option is to deploy MySQL 8.

    • You can install a MySQL 8 database or connect an existing self-provided database (such as MySQL 5, MySQL 8, Amazon RDS for MySQL, and Oracle) to the project.

    • If you need to use other types of databases as the configuration database, you can log in to the project after it is successfully deployed and switch the database.

    Installation Location

    If you choose to install a MySQL 8 database, it is typically installed on the component node.

    If there are multiple component nodes, it will be installed on a random one.

    Special case: For single-application projects with no component node, it will be installed on the main application node.

    State Server


    Description
    Component Role

    It monitors the running status of each node and the whole cluster, records logs and error messages, and coordinates communication and task allocation among nodes.

    Required or Optional

    1. For single-application projects, this component is not required.

    2. For multi-application projects, this component must be installed.

    • The default option is Deploy Redis Standalone.

    • You can install a Redis standalone state server or connect an existing self-provided state server (such as Redis Standalone and Redis Cluster to the project.

    • If you need to use other types of state servers, you can log in to the project after it is successfully deployed and switch the state server.

    Installation Location

    If you choose to install a Redis standalone state server, it is typically installed on the component node.

    If there are multiple component nodes, it will be installed on a random one.

    Data Storage Service

    This component must be installed only when you deploy a FineBI 6.1 project.


    Description
    Component Role

    It is used to store and share data resources within FineBI, ensuring that every node can access and utilize them.

    Required or Optional

    It must be installed.

    • You can install the MinIO component and use it for data storage.

    • Self-provided S3 is recommended and supported, such as cloud storage service systems like Alibaba Cloud OSS, Huawei Cloud OBS, and Amazon S3.

    iconNote:

    1. The data storage service cannot be provided by shared external directories starting from FineOps V2.18.0.

    2. Changing the data storage service is supported starting from FineOps V2.18.0.

    For projects previously using shared external directories, you are advised to change the data storage service provider to the S3 component.

    3. If MinIO is used as the data storage component, you are advised to use a host server with the XFS disk file system.

    Installation Location

    If you choose to install a MinIO data storage component, it is typically installed on the main application node.

    It will be installed on the first main application node added to the project.

    Pipeline Task

    Consider whether to install this component only when deploying a FineDataLink project.


    Description
    Component Role

    It monitors the running status of each node and the whole cluster, records logs and error messages, and coordinates communication and task allocation among nodes.

    Required or Optional

    It is optional for FineDataLink projects.

    • The default option is to deploy Kafka, an open-source stream processing platform.

    • If the Kafka component is not installed, the Pipeline Task function in FineDataLink will be unavailable.

    • External provisioning is not supported.

    Installation Location

    When you choose to install Kafka, it is typically installed on the component node.

    If there are multiple component nodes, it will be installed on a random one.

    Special case: For single-application projects with no component node, it will be installed on the main application node.

    Nacos

    Consider whether to install the following components only when deploying a FineDataLink project.

    The Nacos components include Nacos and Nacos_MySQL.

    Nacos


    Description
    Component Role

    It serves as the service registry that ensures users' scheduling requests are reasonably distributed across cluster nodes, achieving high-availability and high-concurrency scheduling of nodes in scheduled tasks.

    Required or Optional

    1. For single-application FineDataLink projects, it is not required.

    2. For multi-application FineDataLink projects, it must be installed.

    • The default option is to deploy Nacos, a service registry.

    Installation Location

    When you choose to install Nacos, it is typically installed on the component node.

    If there are multiple component nodes, it will be installed on a random one.

    Nacos_MySQL


    Description
    Component Role

    It is the MySQL component required for providing Nacos services.

    Required or OptionalIt should be installed together with the Nacos component.
    Installation Location

    It will be installed at the same place as the Nacos component.


    Attachment List


    Theme: FanRuan Project Deployment
    • Helpful
    • Not helpful
    • Only read