Connecting to Existing Projects

  • Last update: 2024-10-31
  • Overview

    Version

    FineOps VersionFunctional Change
    V2.0.0

    Simplified the steps of connecting FanRuan projects (which were called O&M projects after connection) to FineOps.

    V2.8.0

    Added a server resource assessment for stability when deploying/connecting to multiple projects.

    Function Description

    The FineOps O&M platform provides solutions for the stable operation and comprehensive O&M management for FanRuan applications.

    FineOps supports the connection to deployed FineReport, FineBI, and FineDataLink projects.

    This document introduces how to connect a deployed project to FineOps.

    iconNote:
    FineOps only supports the operation and management of FineReport/FineBI/FineDataLink products. Non-FanRuan products are not supported by FineOps.

    Prerequisite

    Checking the App Deployment Method and the Version

    Requirement Description

    Application TypeRequirement

    FineBI

    1. Any FineOps-deployed FineBI project is supported.

    2. For non-FineOps deployed FineBI projects:

    • Ensure that the project is deployed in Tomcat on the Linux/Windows system.

    • Ensure the project is of V5.1.22 or later versions.

    FineReport

    1. Any FineOps-deployed FineReport project is supported.

    2. For non-FineOps deployed FineReport projects:

    • Ensure that the project is deployed in Tomcat on the Linux/Windows system.

    • Ensure the project is of V11.0.6 or later versions.

    FineDataLink

    1. Any FineOps-deployed FineDataLink project is supported.

    2. For non-FineOps deployed FineDataLink projects:

    • Ensure that the project is deployed in Tomcat on the Linux/Windows system.

    • Ensure the project is of V4.1.5 (2024.02.03) or later versions.

    Version Checking Method

    Log in to the FineReport/FineBI/FineDataLink project as the admin, and choose System Management > Registration Management > Version Information to view the minor version number of each module in the project.

    Solution

    Update the project to the latest version by referring to Minor Version Upgrade Guide for FineReport and Minor Version Upgrade Guide for FineBI.

    2024-10-28_10-41-27.png

    Checking the Function Point

    FineOps itself is free of charge. However, FanRuan projects must have the O&M Platform or Intelligent O&M function point registered to connect to FineOps.

    2024-10-28_10-46-56.png

    If Function Point Registered does not include O&M Platform, the error message "Currently lic is not authorized" will appear when you initiate connection requests.

    Checking the Internet Connection

    Ensure that the servers where FineOps and the project to be managed are located can communicate with each other over the intranet. Failure to connect FanRuan projects to FineOps or hindered function use will occur in case of connectivity failure.

    If specific port communication is required, ensure that at least the NGINX port of FineOps and the project port of FineReport/FineBI/FineDataLink can access each other.

    Checking the System O&M Plugin

    1. Ensure that the FineReport/FineBI/FineDataLink project is equipped with the System O&M plugin.

    iconNote:
    If the project is configured with CAS, you need to restart the project for it to connect to FineOps normally after installing the System O&M plugin.

    2. Confirm the required version of the System O&M plugin according to the FineOps version. You are advised to upgrade FineOps and the plugin to the latest version.

    FineOps Version
    Required Version of the System O&M Plugin

    V2.0 and earlier versions

    V3.0.0 and earlier versions

    V2.x

    V3.0.0 and later versions

    2024-10-31_15-52-21.png

    Checking the Resource Configuration of the FineOps Server

    Connecting projects to FineOps will consume some resources of the FineOps server.

    If the configured FineOps resources are insufficient, the new project cannot be deployed. It will prompt "The FineOps configuration has reached the upper limit, and no new projects are supported. Proceed as follows as soon as possible: Increase the Xmx value."

    1. Log in to FineOps as the admin and choose Platform Management > O&M Component.

    2. Locate the ops component and click Modify Configuration.

    2024-10-28_11-00-05.png

    3. Check the Xmx configuration of the ops component.

    • If no relevant prompt appears, no modification is needed.

    • If the prompt "Set the Xmx value to greater than N GB to ensure the normal connection to new projects." appears, modify the configuration accordingly.

    For details, see O&M Component Management.

    2024-10-28_11-29-54.png

    Connecting to a Project

    Initiating a Connection Request in the Project

    Log in to the FanRuan project as the admin, and choose System Management > System Setting > General.

    Set O&M Platform Address in O&M Platform Connection Setting, and click Save.

    The O&M platform address is in the format of http://IP address:Port number/ops/decision.

    2024-10-28_11-30-47.png

    Allowing the Connection in FineOps

    Log in to FineOps as the admin within five minutes. A prompt appears on FineOps, saying "Found New Project."

    ContentDescription

    Access Address

    It refers to the address of the FanRuan project mentioned above.

    Deployment Method

    docker: The project is deployed via FineOps.

    web: The project is deployed in Tomcat, not via FineOps.

    Type

    Standalone: The project has only one project node.

    Cluster: The project has multiple project nodes.

    Number of Nodes

    It refers to the number of nodes.

    2024-10-24_18-26-44.png

    2. Click Add Project, set Project Name, and click OK.

    • The project name must not be empty or be duplicated.

    • Only Chinese characters, English letters (upper and lower cases), and numbers are supported.

    • The project name length cannot exceed 12 digits.

    2024-10-31_15-42-39.png

    3. After the project is successfully connected to FineOps, the prompt "The project was deployed successfully. You can view newly added projects in Project Management." will appear.

     2024-10-31_15-43-10.png

    Confirming the Connection

    1. You can view the successfully connected project in Project Management in FineOps.

    2024-10-31_15-43-37.png

    2. You can view the address and the current access status of FineOps under System Management > System Setting > General in the O&M project.

    2024-10-31_15-50-17.png

    Attachment List


    Theme: Existing Project Manipulation
    Previous
    Next
    • Helpful
    • Not helpful
    • Only read