Scaling Components for Cluster Projects

  • Last update: 2026-10-20
  • Overview

    Version

    FineOps Version
    Functional Change
    V1.5.9/
    V1.9.0Allowed adding application nodes in Component Management, making the operation smoother.
    V2.15.0Optimized the page to display detailed information about each node.
    V2.40.0Allowed adding components or scaling components when the available node resources reach 7/8 of the estimated component requirements.

    Application Scenario

    After a project has been deployed successfully, you may need to add or scale project components. Choose a solution based on the actual scenario.

    Scenario
    Description

    Convert a standalone application to a cluster.


    Application scenario:

    You need to convert a FineBI 6.0, FineReport 11.0, or FineDataLink 4.1 project from a single-node application to a multi-node cluster.

    iconNote:
    This scenario does not apply to FineBI 6.1 or later because its minimum architecture is a cluster. For FineBI 6.1 projects, refer to the "Scale existing components in a cluster" scenario instead.

    Solution overview:

    1. First, switch the standalone application to a single-node cluster. For details, see Converting a Containerized Standalone to a Cluster. 

    Install cluster components such as Nginx, MinIO, and Redis.

    2. Then scale the single-node cluster to a multi-node cluster based on this document. 

    Install business components such as FineBI - Application Node, FineReport, and FineDataLink.

    Add components.

    Application scenario:

    Some components may not have been deployed during the initial project deployment, and you later need to use them. For example:

    • If you did not select Nginx during standalone deployment, you must add Nginx to configure SSL.

    • If you did not select Elasticsearch during standalone deployment, you must add Elasticsearch to replace Swift (LogDB) for log storage.

    Solution overview:

    Use the Add Component function to add these components to the project. For details, see Adding Components to O&M Projects.

    iconNote:
    Only Nginx is automatically connected to the project after it is added. You need to manually connect other components after they have been deployed. Adding other components is usually used when you convert a standalone application to a cluster. See the first scenario.
    Scale existing components in a cluster.

    Application scenario:

    • As business usage grows, the existing cluster configuration may no longer support service needs. You need to add business nodes or compute workers, such as scaling a two-node cluster to a three-node cluster.

    • For security reasons, you may need to scale an existing single-node internal gateway to two nodes to ensure high availability.

    Solution overview:

    Refer to this document.

    • Add main application nodes to increase the number of business component instances, such as bi-web, bi6, fr, and fdl.

    • Increase the number of bi-engine-worker instances. They can be deployed on existing main application nodes.

    • Scale the internal gateway from one node to two nodes. It can be deployed on existing main application nodes or component nodes.

    • Scale AI components to build high-availability AI services.

    This document details the "Scale existing components in a cluster" scenario.

    Deployment Preparation

    Prerequisites

    Check Item
    Description
    Deployment method

    The project must have been deployed via FineOps.

    The operations in this document do not apply to non-FineOps-deployed projects.

    Project type

    Before scaling business components such as FineBI - Application Node (bi6), FineReport, and FineDataLink, ensure that the project has been deployed and connected to the state server and file server.

    For standalone projects, first switch the project to a single-node cluster. For details, see Converting a Containerized Standalone to a Cluster. 

    Component image

    The image of the component to be scaled must exist in Maintenance Center > Image Management. If the image is missing, the container cannot be created.

    If no related image is available, FineOps must be able to pull images from the cloud. For details, see Ensuring Access to FanRuan Cloud Repository.

    Target nodeThe node type, number of same-type components, and available resources must pass validation. Nodes that fail validation cannot be selected.
    LicenseAfter scaling FineBI - Application Node (bi7-web, bi-web, and bi6), FineReport, and FineDataLink components, migrate or purchase the cluster license.

    Supported Components

    Component Type
    Supported Scaling Method
    bi7-web, bi-web, bi6, fr, and fdlAdd business component instances, such as scaling a two-node cluster to a three-node cluster.
    bi-engine-workerAdd compute worker instances, such as scaling from three to six instances.
    nginxScale a single-instance internal gateway to two or more instances for higher availability.
    fine-ai and fine-chat-bi-parserAdd AI service instances to build high-availability AI services.

    Scaling Components

    1. Log in to FineOps as the admin, select the project to be scaled, and choose Maintenance > Component Management.

    2. On the right of the target component, click Scale.

    Scalable containers include bi7-web, bi-web, bi-engine-worker, bi6, fr, fdl, nginx, fine-ai, and fine-chat-bi-parser.

    3. Select the deployment node for the new container.

    FineOps validates the node based on the following rules. Nodes that do not meet the conditions are grayed out. The reason why they cannot be selected is displayed.

    Check Item
    Pass ConditionFailure Prompt
    Same-type componentNo same-type component of bi7-web, bi-web, fr, fdl, or nginx has been deployed on the same node.The prompt "A service of the same type has been deployed on the current node." is displayed. Select another node.
    Node typebi7-web, bi-web, bi-engine-worker, fr, and fdl are deployed on main application nodes.The prompt "The node type is incorrect." is displayed. Select a main application node.
    Available resources

    The node passes validation when its available resources reach 7/8 of the estimated required resources of the component.

    For example, if the component is estimated to require 8 GB of memory, deployment is allowed when the node has 7 GB of available memory. 

    iconNote:

    The 7/8 rule does not remove the need for runtime monitoring. After deployment, keep monitoring node CPU, memory, and component status, and increase node resources if resource pressure persists.

    If available resources do not reach 7/8 of the estimated required resources, the node is grayed out. Free up resources on the node, or select another node and try again.

    If no available node exists, click Add Node and add a server.

    After the node is connected, FineOps automatically sets up the Docker environment, deploys OPS Agent, and sets up monitoring. You can then select this node for scaling.

    4. Adjust the host port of the container as needed.

    5. After confirming the target node and port, click Start Scaling.

    6. Wait until scaling is complete. If the new container appears in the Component Management list and the component status is normal, scaling is successful.

    Follow-Up Operation

    Scaling Object
    Follow-Up Operation
    bi7-web, bi-web, bi6, fr, and fdlContact sales to migrate or purchase the cluster license. New nodes may not work properly until licensing is complete.
    Other componentsCheck component runtime status and node resource changes, and confirm that project access and related services are normal.

    Attachment List


    Theme: Loading/Update/Migration/Capacity Expansion of Exi
    Previous
    Next
    • 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