Log Forwarder Control Script

Perform operations on the cluster using the Log Forwarder Control Script

The cluster_logforwarderctrl.sh script, in the <installation_directory>/cluster_utils directory, manages the Log Forwarder services on all the nodes in the cluster that are listed in the BDP hosts file.

The utility provides the following options:

  • Start – Starts the Log Forwarder on all the nodes in the cluster.
  • Stop – Stops the Log Forwarder on all the nodes in the cluster.
  • Restart – Restarts the Log Forwarder on all the nodes in the cluster.
  • Status – Reports the status of the Log Forwarder on all the nodes in the cluster.

Note: When you run the Log Forwarder Control utility, the script will prompt to enter the path of the SSH private key file to securely login into the cluster nodes.

Verifying the Status of Log Forwarder

To verify the status of the Log Forwarder on all the nodes in the cluster:

  1. Log in to the lead or Primary node.

  2. Navigate to the <installation_directory>/cluster_utils directory.

  3. Run the following command:

    ./cluster_logforwarderctrl.sh
    
  4. Press ENTER.

    The prompt to enter the path of the private key file appears.

    Enter the path of the Private Key (.PEM) file:
    
  5. Enter the location of the Private Key (.PEM) file.

  6. Press ENTER.

    The script verifies the connectivity on the cluster nodes and the options appear.

    Checking connectivity of cluster nodes...
    
    Select option:
        1) Start
        2) Stop
        3) Restart
        4) Status
    Option(1-4):
    
  7. To verify the status of the Log Forwarder on all the nodes, type 4.

  8. Press ENTER.

    The script checks the status of the Log Forwarder on all the nodes and appends the event details to a log file.

    Checking status of Logforwarder on current node...
    
    Checking status of Logforwarder on all nodes...
    
    The script's logs and operation results are logged in /opt/protegrity/logs/cluster_logforwarderctrl.log
    

Starting the Log Forwarder

To start the Log Forwarder on all the nodes in the cluster:

  1. Log in to the lead or Primary node.

  2. Navigate to the <installation_directory>/cluster_utils directory.

  3. Run the following command:

    ./cluster_logforwarderctrl.sh
    
  4. Press ENTER.

    The prompt to enter the path of the private key file appears.

    Enter the path of the Private Key (.PEM) file:
    
  5. Enter the location of the Private Key (.PEM) file.

  6. Press ENTER.

    The script verifies the connectivity on the cluster nodes and the options appear.

    Checking connectivity of cluster nodes...
    
    Select option:
        1) Start
        2) Stop
        3) Restart
        4) Status
    Option(1-4):
    
  7. To start the Log Forwarder on all the nodes, type 1.

  8. Press ENTER.

    The script starts the Log Forwarder on all the nodes and appends the event details to a log file.

    Starting Logforwarder on current node...
    
    Logforwarder started on current node
    
    Starting Logforwarder on all nodes...
    
    Logforwarder started on all nodes
    
    The script's logs and operation results are logged in /opt/protegrity/logs/cluster_logforwarderctrl.log
    

Stopping the Log Forwarder

To stop the Log Forwarder on all the nodes in the cluster:

  1. Log in to the lead or Primary node.

  2. Navigate to the <installation_directory>/cluster_utils directory.

  3. Run the following command:

    ./cluster_logforwarderctrl.sh
    
  4. Press ENTER.

    The prompt to enter the path of the private key file appears.

    Enter the path of the Private Key (.PEM) file:
    
  5. Enter the location of the Private Key (.PEM) file.

  6. Press ENTER.

    The script verifies the connectivity on the cluster nodes and the options appear.

    Checking connectivity of cluster nodes...
    
    Select option:
        1) Start
        2) Stop
        3) Restart
        4) Status
    Option(1-4):
    
  7. To stop the Log Forwarder on all the nodes, type 2.

  8. Press ENTER.

    The script stops the Log Forwarder on all the nodes and appends the event details to a log file.

    Stopping Logforwarder on current node...
    
    Logforwarder stopped on current node
    
    Stopping Logforwarder on all nodes...
    
    Logforwarder stopped on all nodes
    
    The script's logs and operation results are logged in /opt/protegrity/logs/cluster_logforwarderctrl.log
    

Restarting the Log Forwarder

To restart the Log Forwarder on all the nodes in the cluster:

  1. Log in to the lead or Primary node.

  2. Navigate to the <installation_directory>/cluster_utils directory.

  3. Run the following command:

    ./cluster_logforwarderctrl.sh
    
  4. Press ENTER.

    The prompt to enter the path of the private key file appears.

    Enter the path of the Private Key (.PEM) file:
    
  5. Enter the location of the Private Key (.PEM) file.

  6. Press ENTER.

    The script verifies the connectivity on the cluster nodes and the options appear.

    Checking connectivity of cluster nodes...
    
    Select option:
        1) Start
        2) Stop
        3) Restart
        4) Status
    Option(1-4):
    
  7. To restart the Log Forwarder on all the nodes, type 3.

  8. Press ENTER.

    The script restarts the Log Forwarder on all the nodes and appends the event details to a log file.

    Stopping Logforwarder on current node...
    
    Logforwarder stopped on current node
    
    Starting Logforwarder on current node...
    
    Logforwarder started on current node
    
    Stopping Logforwarder on all nodes...
    
    Logforwarder stopped on all nodes
    
    Starting Logforwarder on all nodes...
    
    Logforwarder started on all nodes
    
    The script's logs and operation results are logged in /opt/protegrity/logs/cluster_logforwarderctrl.log
    

Last modified : October 03, 2025