Flexmonster Admin Panel is a cross-platform desktop application that provides a graphical user interface for Flexmonster Data Server used as a Windows/Unix service. With the Admin Panel, you can conveniently manage indexes, security, and other configs.
In this guide, you can find a description of the Admin Panel’s functionality.
Name. This field defines the index name. It will be used to configure the connection on the client side.
Type. This drop-down menu contains possible data source types: JSON, CSV, or Database.
Database type. The database name: MySql, MSSQL, PostgreSQL, or Oracle. Only for the Database data source type.
Path to file. In this field, specify the path to the file with your data. You can click the folder icon to choose the needed file using Explorer. Only for JSON and CSV data source types.
Connection string. Specify the connection string to your database here. Click Test to check whether the provided connection string is correct. Only for the Database data source type.
Query. Specify an SQL query to define the subset of data that the Data Server should fetch. Only for the Database data source type.
Delimiter. Specify the field delimiter if anything other than , separates СSV fields. Only for the CSV data source type.
Decimal separator. It defines the specific character used to separate decimal parts of numbers. For example, if commas separate decimal parts of numbers (e.g., 3,14), set the decimal separator to ,. Only for the CSV data source type. Default value: ..
Thousands separator. Defines the specific character used to separate groups of digits in numbers. For example, if periods separate groups of digits in numbers (e.g., 1.000 for one thousand), set the thousands separator to .. Only for the CSV data source type. Default value: ,.
Refresh time. It defines how often the Data Server should reload the data from the data source. The refresh time should be specified in minutes. By default, the refresh time is 0, which means the Data Server will not reload the data.
When the index configuration is complete, click Create to add the index to your index pool.
Edit or delete indexes
To edit an index, click the index name or Details:
You can make changes to everything except the data source type.
Click Save to apply the changes.
To delete the index, click Delete Index. Before deleting, you will be prompted to confirm the action.
The Data Server reloads data in indexes based on the Refresh time configuration. However, you can refresh an index manually by clicking Reload:
This action will update the data in the index.
The Data Server will not reloaddisabled indexes.
Each index can be disabled. The Data Server does not preload disabled indexes, and you cannot use them in the component.
To disable an index, click Disable:
Check Status to make sure the index is disabled.
To enable the index, click Enable.
This tab contains the Data Server’s configs. They are visually divided into the following parts:
This block contains general Data Server configurations:
Port. The Data Server’s port number. By default, it is 9500.
Minimum log level. Defines a minimum log level for the Data Server: INFO, WARN, ERROR, or FATAL. Setting a minimum log level to WARN or a higher level can improve the Data Server’s performance. Learn more about these log levels in the Microsoft documentation. This configuration will not affect info-level logs that appear when the Data Server is started, or the data is reloaded. Default value: INFO.
This block allows configuring options for data storage. It contains the following configuration:
Cache size limit. The maximum number of cached server responses for every index. When set to 0, the Data Server does not cache the responses. Default value: 100.
Keep data on refresh. When enabled, the Data Server keeps a copy of index data while the index is being refreshed. As a result, the index is available to Flexmonster Pivot even during index reload. Note that this feature requires more RAM. As soon as the index is refreshed, the Data Server deletes its copy. If Keep data on refresh is disabled, the index will be unavailable while refreshing. Default state: enabled.
This block allows configuring the HTTPS protocol. It contains the following configurations:
HTTPS. A toggle switch to enable or disable the HTTPS protocol.
Certificate type. Allows choosing the certificate type: Path-Password, Subject-Store, or None. A Path-Password certificate is added by specifying its path and password. A Subject-Store certificate is added by specifying its subject and store. Default value: None. This configuration is available only when HTTPS is enabled.
Path to PFX certificate. Allows adding an SSL/TLS certificate by specifying a path to it. Click on the folder icon to choose the needed certificate using Explorer. Note that Flexmonster Data Server supports only .pfx certificates. This configuration is available only when the certificate type is Path-Password.
Certificate password. A password needed to access the SSL/TLS certificate. This configuration is available only when the certificate type is Path-Password.
Subject name. The certificate subject name. This configuration is available only when the certificate type is Subject-Store.
Store. The store from which the certificate is loaded. This configuration is available only when the certificate type is Subject-Store.
Location. The location of the store from which to load the certificate. It can be either Current User or Local Machine. Default value: Current User. This configuration is available only when the certificate type is Subject-Store.
Allow invalid. Indicates whether to allow using invalid certificates (e.g., self-signed certificates). Default value: Block. This configuration is available only when the certificate type is Subject-Store.
Protocols. Establishes the HTTP protocols enabled on a connection endpoint or for the server. It can be one of the following values: HTTP1, HTTP2, and HTTP1 and HTTP2. Default value: HTTP1 and HTTP2. This configuration is available only when HTTPS is enabled.
This block allows configuring the data access security. It contains the following configurations:
Basic auth. A toggle switch to enable or disable basic authorization. To manage users for basic authorization, go to the Security tab. Learn more about built-in basic authorization in the Security and authorization guide.
Allow origin. An input field to configure CORS (i.e., specify origins that can send requests to the Data Server). If basic authorization is enabled, define specific origins in Allow origin. To specify several origins, separate them with a comma.
Endpoint. Indicates whether the endpoint to share reports is enabled in the Data Server. Default value: disabled.
Custom path to folder. This configuration is available only when the endpoint is enabled. Defines the folder to which the Data Server saves reports. By default, reports are saved to the following locations:
On Windows – C:/ProgramData/FlexmonsterDataServer/reports/.
On macOS and Ubuntu/Linux – ~/.local/share/FlexmonsterDataServer/reports/ (will resolve to /home/[current_user]/.local/share/FlexmonsterDataServer/reports/).
Report expiration time. Defines how long the saved reports are stored. The time is set in minutes. Default value: 0 (reports are stored permanently). This configuration is available only when the endpoint is enabled.
Max folder size. The maximum memory size available for report saving (in MB). Default value: 0 (unlimited). This configuration is available only when the endpoint is enabled.
Auto delete. Should be used with the Max folder size configuration. Defines whether to delete older reports when the folder is full. If enabled, older reports will be deleted automatically until there is enough memory for a new report. Default value: disabled (older reports are not deleted). This configuration is available only when the endpoint is enabled.
Besides setting the mentioned configurations, you can import the existing flexmonster-config.json file: just specify the path to flexmonster-config.json in the Import configuration file section and click Apply: