Cluster Settings#

ClusterWareAI ™ cluster settings are managed via the cw-clusterctl command line tool or via the Cluster > Settings page in the ClusterWareAI graphical user interface (GUI).

Settings Page

Cluster ID#

The cluster ID is a serial number provided when you purchase a ClusterWareAI license. The cluster ID is used to access the Yum repositories to download and install the ClusterWareAI product. You can pull your cluster ID from the repository on the Settings page of the ClusterWareAI GUI. Your ClusterWareAI license is validated each time you log in to the ClusterWareAI GUI.

Cluster Name#

You can provide a cluster name on the Settings page of the ClusterWareAI GUI. Enter a name in the Cluster name field and click Submit to save your changes.

The name is for display purposes only and is not used in the command line tools.

Accepting Unknown Nodes#

You can configure ClusterWareAI head nodes to either accept or deny access to new nodes that were not created with the ClusterWareAI command line or GUI. This functionality is disabled by default. To allow node creation with unknown MAC addresses, toggle the Accept unknown nodes? switch on the Settings page and click Submit to save your changes. Alternatively, run the following command:

cw-clusterctl --set-accept-nodes True

For details, including how simultaneous node requests are handled, see Node Creation with Unknown MAC address(es).

Time Offset#

The Settings page displays a calculation of the time offset between the browser and the head node. A large time offset may require additional investigation. The time offset is not displayed in the command line, but may be manually calculated by reviewing the current time of a head node.

AI Settings#

If you are using the AI Factory Operations Agent, specify the LLM server location in the LLM Server URL field on the Settings page. Alternatively, run the following command:

cw-clusterctl --set-ai-agent-config endpoint=http://<IP Address>:11434

You can also set the network timeout for the AI Factory Operations Agent to adjust how long the page should wait for a response from the agent before reporting an error. Adjusting this value is often the first thing to troubleshoot if the AI Factory Operations Agent is not responding or if you get repeat network errors. If you continue to have timeout issues, check your Apache configuration.

See Configure LLM Server for the AI Factory Operations Agent for additional setup details.

ARS Watcher Settings#

The ARS Watcher is a ClusterWareAI backend service used to watch the MQTT feed for compute node Auto Remediation Service (ARS) state transitions. The service records the events to the database. The ARS Watcher service should not be disabled as it is required for normal cluster operations.

Use the Retention Period and Cleaning Interval fields to set how long the ARS event data is retained in the database and how frequently the database is checked for required clean-up.