Cluster Management

  • Last update: 2026-05-25
  • Overview

    Version

    FineOps VersionFunctional Change
    V2.7.0/
    V2.18.0Allowed switching the data storage service component for successfully deployed FineBI 6.1 projects.
    V2.30.0 Added a cluster file server exception detection mechanism to prevent content loss caused by component disconnection.

    Function Description

    The normal operation of a FanRuan project depends not only on the FineBI/FineReport/FineDataLink application, but also on the configuration database, log service, and cluster components.

    FineOps provides a Cluster Configuration page, on which you can manage, configure, and switch components.

    Log in to FineOps as the admin, click the target project, and choose Maintenance > Cluster Management, where you can perform basic connection configuration and advanced cluster configuration.

    Index

    1. The configurations in this section are linked with the configuration database and cluster management configurations in System Management on the FanRuan application platform. Modifications made on either side take effect on both.

    2. Some components require plugins to connect to the project. Ensure that you have installed the relevant plugins in the project before configuring the components.

    ComponentDocument Description
    External Configuration Database

    In FanRuan applications, you (the admin) typically set up users, mount directories, assign the permission, and configure timed scheduling on the platform.

    The configuration is stored in the configuration database.

    In a production environment, you can prepare a database and connect it to the FanRuan application for configuration storage.

    A stable external database ensures the stable operation of the FanRuan application under high load.

    Using MySQL as the External Configuration Database

    MySQL 5: 5.1.73, 5.5.31, 5.5.46, 5.5.56, 5.5.62, 5.6.22, 5.6.28, 5.6.31, 5.6.35, 5.6.37, 5.6.44, 5.7.16, 5.7.23, 5.7.26, and 5.7.33

    MySQL 8: 8.0.11, 8.0.16, 8.0.20, 8.0.21, and 8.2 (8.0.19 is not supported.)

    RDS MySQL: All versions

    Using Oracle as the External Configuration Database

    Oracle standalone

    10g (10.2) and 10.2.0.1.0

    11g (11.0.2.1), 11g (11.0.2.4), 11.0.2.4, and 11.2.0.2.0

    12c, 12c V12.2, and 19c

    Oracle cluster:

    11g and 12c

    Using SQL Server as the External Configuration Database2000, 2005, 2008, 2012, 2014, 2016, 2017, and 2019
    Using IBM Db2 as the External Configuration Database8.2, 9.7, 10.5, and 11.1
    Using PostgreSQL as the External Configuration Database9.2.3, 9.4.7, 9.5.0, 9.5.2, 9.6.0, and 13.0
    State Server

    The state server is primarily used to store and update application state data, enabling multiple clients to access and modify data concurrently.

    The state server of a FanRuan cluster mainly stores and caches login information, template locks, SessionIDs, and WebSocket connections while authenticating all access and operations.

    Redis Standalone

    Redis standalone is the simplest to deploy, as it requires deploying only one Redis application.

    It is also the simplest one to use, as you only need to configure the host, port, and password.

    • You do not need to consider data sharding or clustering issues. The O&M cost is low.

    • A single point of failure may occur. A single server cannot achieve high availability and load balancing.

    Redis Primary-Replica Cluster


    A Redis cluster adopts a shard-based architecture that distributes data across multiple nodes, enabling horizontal scaling and high availability.

    • If the primary node crashes, the corresponding replica node will be promoted as the new primary node.

    • All clients pointing to the original primary node are notified of the new primary node's address.

    • The new primary node synchronizes data from other replica nodes to ensure data consistency.

    Redis Sentinel Cluster

    Compared with the primary-replica mode, the sentinel mode offers higher availability.

    It involves primary nodes, replica nodes, and sentinel nodes.

    Redis Sentinel clusters require more resources, incurring higher O&M costs.

    TencentDB for Redis

    TencentDB for Redis is a cache and storage service built by Tencent Cloud that is compatible with the Redis protocol.

    It supports primary-replica hot standby and provides a full suite of database services, including automatic failover, data backup, instance migration, instance monitoring, online scaling, and data restoration.

    File Server In a FanRuan cluster project, a file server is used to store and share the files and data resources needed by the cluster, ensuring that each node can access and use them.
    Using the SFTP Service as the File ServerSFTP is an encrypted file transfer protocol based on the SSH protocol. It is simple to deploy and comes built-in with Linux systems. It is more secure and stable than FTP, as it encrypts all data and commands during transmission.
    Using the FTP Service as the File Server

    File Transfer Protocol (FTP) is a standard protocol for transferring files between computer networks. It is supported by most operating systems and FTP clients.

    icon

    Note

    :

    FTP transmits data and commands in plaintext, which makes them vulnerable to eavesdropping and tampering. The SFTP protocol, which is more secure, is recommended.
    Using Alibaba Cloud OSS as the File Server

    Manually building a local HDFS file system requires strong O&M capabilities, and it cannot satisfy the need for a highly available file server.

    By installing the S3 Resource Repository plugin, you can connect a FanRuan cluster to a cloud storage file system that supports the S3 protocol and use it as the file server.

    Supported cloud storage file systems include Alibaba Cloud OSS, Huawei Cloud OBS, and Amazon S3. Other self-built S3 platforms are not guaranteed to be supported.

    Using Huawei Cloud OBS as the File Server
    Using NAS as the File Server

    NAS is a file-level storage device that performs file access through standard network protocols (such as SMB/CIFS and NFS), suitable for large organizations that need centralized file management, backup, and sharing.

    A single NAS file system can be mounted to multiple nodes, allowing these nodes to share the file system, which saves significant copying and synchronization costs.

    HDFS Resource Repository/
    MinIO Resource Repository/
    Log ServerUsing Elasticsearch as the Log ServerFineOps-deployed FanRuan projects support connection to Elasticsearch, which can replace Swift (LogDB) to provide log storage services, collecting requests from nodes, external databases, business databases, and other cluster components in projects.
    Data Storage Service

    Using Huawei Cloud OBS as the Data Storage Server

    Using Alibaba Cloud OSS as the Data Storage Server

    For FineBI 6.1 projects, you can prepare an S3 component to store the basic tables and self-service datasets extracted in FineBI.

    FanRuan recommends that you prepare a cloud storage file system that supports the S3 protocol as the data storage server.

    Supported cloud storage file systems include Alibaba Cloud OSS, Huawei Cloud OBS, and Amazon S3. 

    iconNote:
    Other self-built S3 platforms are not guaranteed to be supported.
    Advanced Cluster ConfigurationAdvanced Cluster ConfigurationIt provides a visual page for adjusting the parameter settings of essential cluster components.

    Anomaly Detection for File Servers in Clusters

    If the file server of a cluster project is disconnected, business content during the disconnection period will be lost.

    From FineOps V2.30.0, anomaly detection has been added for file servers in clusters, which checks the file server configuration of cluster projects every two minutes.

    If the file server configuration of a cluster is abnormal, Exception will be displayed on the project card. Refer to the documents above to restore the connection to the file server.

    During the disconnection period, you (the admin) cannot use FineOps to perform operations such as restoring and upgrading projects or entering the developer mode.

    Attachment List


    Theme: Project Management
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy