status#

dpsctl check status Usage Guide#

Get the status of specified nodes.

Usage#

dpsctl check status

Flags#

Includes global dpsctl options.

   --nodes value       Node names to get status for
   --help, -h          show help

Examples#

Check Single Node Status#

$ dpsctl check status --nodes node001
{
  "node_statuses": {
    "node001": {
      "last_successful_access_time": "2024-01-15T10:30:00Z",
      "current_state": {
        "resource_group": "ml-training-job",
        "allocated_policy_name": "ComputerSystemLimits.v1"
      }
    }
  }
}

Check Multiple Node Status#

$ dpsctl check status --nodes node001,node002,node003
{
  "node_statuses": {
    "node001": {
      "last_successful_access_time": "2024-01-15T10:30:00Z",
      "current_state": {
        "resource_group": "ml-training-job",
        "allocated_policy_name": "ComputerSystemLimits.v1"
      }
    },
    "node002": {
      "last_successful_access_time": "2024-01-15T09:45:00Z",
      "inaccessible_since": "2024-01-15T09:45:00Z",
      "last_access_error": "BMC connection failed",
      "current_state": {
        "resource_group": "",
        "allocated_policy_name": "ComputerSystemLimits.v1"
      }
    },
    "node003": {
      "last_successful_access_time": "2024-01-15T10:29:30Z",
      "current_state": {
        "resource_group": "dev-testing",
        "allocated_policy_name": "ComputerSystemLimits.v1"
      }
    }
  }
}

Check Status with Issues#

$ dpsctl check status --nodes node004
{
  "node_statuses": {
    "node004": {
      "last_successful_access_time": "2024-01-15T08:15:00Z",
      "inaccessible_since": "2024-01-15T08:15:00Z",
      "last_access_error": "BMC connection timeout",
      "current_state": {
        "resource_group": "",
        "allocated_policy_name": ""
      }
    }
  }
}

Check Non-Existent Node#

$ dpsctl check status --nodes non-existent-node
{
  "node_statuses": {}
}

Notes#

  • Node status reflects real-time connectivity and power management state

  • last_successful_access_time shows when the node was last accessible

  • inaccessible_since is included when the node has become inaccessible

  • last_access_error is included when the node has a recent access error

  • current_state contains the resource group and allocated policy identity

  • allocated_policy_name identifies the allocated policy object or type, such as ComputerSystemLimits.v1; it is not the selected policy bundle. Inspect policy_bundle with dpsctl topology list or dpsctl resource-group list

  • Empty node_statuses indicates no nodes were found or all nodes are inaccessible