Starting the Monitoring App

The monitoring app requires that it receives information from the nodes of the cluster. It is interested in information like the amount of RAM used, the CPU utilization, and network utilization. For this, on each node of the cluster, you must start a small application called EKHypervisor that gathers this information, and sends it to the monitoring app.

This task shows you how to:

See Also
Starting Distributed Rendering

Prepare the Monitoring App

The monitoring system starts on a cluster by launching first one Hypervisor as Bridge Node. Then, the Hypervisor starts on all remaining worker nodes, which connects to the Bridge Node. After this, the monitoring user interface starts and connects to the Bridge Node through a web socket.

  1. Start a first Hyperwisor as Bridge Node.
    For example: 
    EKHypervisor start <listening port> -listenOnWebSocket -privateIP <bridge_node hostname or IP>

    Concrete example on machine with IP 123.456.789.100:

    EKHypervisor start 5555 –listenOnWebSocket –privateIP 123.456.789.100
    Note: EKHypervisor is a service used to monitor a cluster machine.
    Program Options Description 
    -listenOnWebSocket
    		 The Hypervisor listens on a web socket port. 
    -linkWith
    		 Links the Hypervisor to the Hypervisor on hostname:port (the detach option is automatically defined). 
    -detach
    		 Launches the Hypervisor in another process. 
    -p file
    		 Writes the pid of the process into the given file, the file is deleted when the Hypervisor stops. 
    -o file
    		 Redirects the output into the given file. 
    -privateIP
    		Specifies which network IP the Hypervisor needs to use.
  2. Start Hypervisor on all remaining worker nodes, and specify the Bridge Node as an entry for joining the cluster.
    For example:

    EKHypervisor start -privateIP <cluster node hostname or IP> –linkWith <bridge_node hostname or IP address>:<bridge_node listening port>Concrete Example on machine with IP 123.456.789.101:EKHypervisor start –privateIP 123.456.789.101 –linkWith 123.456.789.100:5555

  3. To stop the service, run EKHypervisor stop listeningPort.

Launch the Monitoring App

You can start the monitoring app directly in the 3DEXPERIENCE.

  1. To start the web page of the monitoring user interface, enter c: StellarClusterMonitor in the power input box.

    The power input box is located in the right corner of the Status Bar. To display it, right-click the work area or the top bar, and then select Display > Status Bar.

  2. Connect to the bridge node Hypervisor.


    Note: The port used to connect to the Hypervisor is the web socket port (by default it is 2097). To make a Hypervisor listen to the web socket port, you need to start it with the -listenOnWebSocket option.
  3. Type the IP address of the cluster and the port reported by EKHypervisor.
  4. Click Connect.
    Example of a monitored cluster. Only CPU utilization (“C”) and network input/output utilization (“N”) are shown per node.