Skip to content

Latest commit

 

History

History
100 lines (75 loc) · 3.7 KB

Move_a_Standard_Rack_Node.md

File metadata and controls

100 lines (75 loc) · 3.7 KB
Raw

Move a Standard Rack Node

Update the location-based xname for a standard rack node within the system.

Prerequisites

  • An authentication token has been retrieved.

    ncn-m001# function get_token () {
ADMIN_SECRET=$(kubectl get secrets admin-client-auth -ojsonpath='{.data.client-secret}' | base64 -d)
curl -s -d grant_type=client_credentials -d client_id=admin-client -d client_secret=$ADMIN_SECRET \
https://api-gw-service-nmn.local/keycloak/realms/shasta/protocol/openid-connect/token \
| python -c 'import sys, json; print json.load(sys.stdin)["access_token"]'
}

  • The Cray command line interface (CLI) tool is initialized and configured on the system.

Procedure

  1. Set variables for the new and old xname locations.

    The NEWPORT variable is the xname of the port that the node BMC will be connected to after it is moved. The xname is typically something similar to x3003c0w41j42. The OLDENDPOINT variable is the xname of the BMC at its old location, for example, x3006c0r41b0.

    ncn-m001# NEWPORT=x3003c0w41j42
ncn-m001# OLDENDPOINT=x3006c0r41b0

  2. Generate and upload new management switch port information to the System Layout Service (SLS) and save it to a file.

    This step may be skipped if this is a direct swap of nodes, where both the source and destination are already populated.

    1. Query SLS to generate content for the new file.

      Query the old port in SLS and replace the old xname (x3000c0w31j31 in this example) with the name of the current location of the hardware in the system.

      ncn-m001# cray sls hardware describe x3000c0w31j31 --format json
  {
    "TypeString": "MgmtSwitchConnector",
    "Parent": "x3000c0w31",
    "Type": "comptype_mgmt_switch_connector",
    "Xname": "x3000c0w31j31",
    "Class": "River",
    "ExtraProperties": {
      "NodeNics": [
        "x3000c0s24b0"
      ],
      "VendorName": "ethernet1/1/31"
    }
  }

    2. Create the new file with the updated location of the node.

      The following is an example file. The Parent, Xname, NodeNics, and VendorName properties must be adjusted to match the new location of the node. The VendorName property may be obtained by logging into the switch that the node will be connected to.

      ncn-m001# cat newport.json
  {
      "Parent": "x3003c0w41",
      "Xname": "x3003c0w41j42",
      "TypeString": "MgmtSwitchConnector",
      "Type": "comptype_mgmt_switch_connector",
      "Class": "River",
      "ExtraProperties": {
        "NodeNics": [
          "x3004c0r42b0"
        ],
        "VendorName": "ethernet1/1/42"
      }
  }

  3. Upload the updated node settings captured in the new JSON file.

    Replace the CUSTOM_FILE value in the following command with the name of the file created in the previous step.

    ncn-m001# curl -i -X PUT -H "Authorization: Bearer $(get_token)" \
https://api-gw-service-nmn.local/apis/sls/v1/hardware/$NEWPORT -d @CUSTOM_FILE

  4. Delete the existing redfishEndpoint and ethernetInterfaces from the Hardware State Manager (HSM).

    ncn-m001# cray hsm inventory redfishEndpoints delete $OLDENDPOINT
message = "deleted 1 entry"
code = 0

ncn-m001# for ID in $(cray hsm inventory ethernetInterfaces list \
--format json | jq -r ".[] | select(.ComponentID==\"$OLDENDPOINT\").ID"); \
do cray hsm inventory ethernetInterfaces delete $ID; done
message = "deleted 1 entry"
code = 0