Node

For an overview of clusters and nodes, refer to Overview. In Settings > Cluster > Node, you can view the registered node pairs that make up the Logpresso cluster and add or modify the node pairs used for cluster configuration. In this screen, redundant nodes are managed as a node pair.

Only cluster administrators can use this menu.

View node pair list

You can view the registered node pair list in Settings > Cluster > Node.

Example of Cluster Node List

The node pair list shows the following information:

  • Status: Connection state of the node pair (green: connected, gray: not connected)
  • Name: Unique name of the node pair
  • Type: Role of the node pair (Control, Collect, or Forwarder)
  • Virtual IP Addr.: Virtual IP address and port shared by Node A and Node B
  • Node ID: Node A ID and Node B ID, displayed on separate lines
  • Node Address: Node A address and Node B address, displayed on separate lines
  • Description: Description of the node pair

To narrow the node pair list, use the search box in the toolbar. The search text is matched against the name or the description (node ID is not searched).

Download node list

To save the node pair list as a file, follow these steps.

  1. Click download on the toolbar.

  2. In the Download Cluster Node List dialog, specify the properties of the file to download, then click Download.

    Download Node List

    • File Name: The name of the file to download (default: Cluster Node).
    • Columns: The fields to include in the download. Choose from Status, Name, Type, Virtual IP Addr., Virtual IP Port, Node A ID, Node A Addr., Node A Port, Node B ID, Node B Addr., Node B Port, and Description (default: all selected).
    • File Format: Choose from CSV, XML, Microsoft Word, HTML, JSON, and PDF (default: CSV).
    • Encoding: The character encoding of the file. This field appears only when File Format is CSV or JSON, and you can choose from UTF8, UTF16, and Latin 1 (default: UTF8).
    • Range: The start and end number of the range to download (default: the first row number on the current page through the total count). Numbers follow the order shown in the list.
Refresh node list

To refresh the node pair list with the latest information, click refresh on the toolbar.

Add node pair

A node pair is the basic unit used to configure a cluster. You can register only Node A first and add Node B later if needed.

To add a node pair:

  1. In Settings > Cluster > Node, click Add in the toolbar.

  2. In the Add Cluster Node screen, configure the general settings.

    Add Node - General Settings

    • Type: Role of the node pair (Data Node, Control Node, or Forwarder Node; default: Data Node)
    • Name: Unique name that identifies the node pair (required, up to 50 characters). Forwarder Nodes look up the node pair to send logs to by this name. During installation, you enter the name of each node pair that receives logs (the Data Node pair, or the Control Node pair in a 2-tier architecture) exactly in the forwarder.addBasepair command in the Logpresso shell on the Forwarder Node (see Configuring collected log forwarding). As in the installation guide examples, use a short identifier of letters and digits without spaces (for example, c1, d1, f1).
    • Description: Description of the node pair (up to 2,000 characters)
    • TLS: Whether to use TLS for REST API communication between nodes (default: enabled)
    • Certification Verification: Whether to verify certificates during TLS communication (default: disabled)
    • Connection Timeout: Maximum time to wait for a connection, in milliseconds (default: 10,000; range: 0 to 3,600,000)
    • Read Timeout: Maximum time to wait for a response, in milliseconds (default: 10,000; range: 0 to 3,600,000)
    • Use HA Mode: Whether to enable high-availability redundancy. When enabled, Virtual IP and Node B Settings become available.
    • Virtual IP: Virtual IP address and port shared by Node A and Node B. Available only when Use HA Mode is enabled. If you enter either the address or the port, you must enter both.
    Note
    The virtual IP must not overlap with the address of Node A or Node B.

  3. In Node A Settings and, if needed, Node B Settings, enter the node-specific properties. Node B Settings are available only when Use HA Mode is enabled.

    Add Node - Node A/B Settings

    • GUID: GUID of the node. This value is displayed after the node pair is created.
    • Node ID: Unique identifier of the node (required, up to 255 characters). The field is labeled Node A ID under Node A Settings and Node ID under Node B Settings. You use this value as-is to specify a node in queries (for example, table d1a:WEB_ACCESS) and in the forwarder.setGuid and sentry.setGuid commands in the Logpresso shell during installation, so use a short identifier of letters and digits without spaces (for example, c1a, c1b).
    • Address: Actual IP address or domain address of the node and its port (required; port range: 0 to 65535; default: 443 — the default is the same regardless of node type or Node A/Node B). Enter 443 for a control node, and 8443 for a data node or forwarder node (see Register the Control Node pair, Registering the data node pair, Registering the Forwarder Node pair).
    • Login Name: Account ID used for node communication (required, up to 50 characters; default: root)
    • Password: Password for the node communication account (required when creating the node pair, up to 50 characters)

  4. Review the settings and click Save. To cancel, click the back button and close the side panel.

Edit node pair

To modify a node pair, add Node B to an existing node pair, or remove the standby configuration:

  1. In the node pair list, click the Name of the node pair that you want to edit.

  2. In the Edit Cluster Node screen, change the required properties. For the fields to configure, refer to Add node pair.

    Edit Node

    • The Type and the existing Node ID values are read-only after the node pair is created.
    • The Name of a node pair that receives logs is referenced by the base node pair name on the Forwarder Node (forwarder.addBasepair) and by the settings of loggers that are already deployed, so keep the original name after you start operation. If you need to change the name, contact technical support.
    • Existing GUID values for Node A and Node B are displayed only in the edit screen.
    • To stop using Node B, clear Use HA Mode.

  3. Review the updated settings and click Save.

Delete node pair

To delete a node pair:

  1. Check whether any loggers depend on the node pair that you want to remove.

  2. Select the checkbox for the node pair and click Delete in the toolbar.

  3. In the Delete Cluster Node dialog, review the node pair and click Delete. To keep the node pair, click Cancel.

    Delete Node

If one or more selected node pairs cannot be removed, the screen shows a failure dialog with the node name and the reason for the failure, and none of the selected node pairs are deleted. Remove the dependent loggers shown in the dialog, then delete the node pair again.

Caution
Deleting a node pair is not a routine task in an operational cluster. If you need to remove a node pair from a production environment, contact technical support first.
Storage management

When you add or edit a node pair, configure the Manage Storage section to define how the node pair responds when available disk space becomes low.

Add Node - Storage Management Settings

  • Define the threshold for minimum free disk space.
    • When the unit is %, the default is 5 and the valid range is 1 to 50.
    • When the unit is MB, the default is 100 and the valid range is 100 to 9,999,999,999.
  • Select the action to perform when the remaining disk capacity falls below the configured threshold.
    • Delete old data: Deletes older data first to recover free space (default)
    • Stop Logger: Stops logging on the node pair
Note
Storage management works independently of lifecycle-based retention settings.