Infrastructure

Sample input JSON - Servers

"servers": [
        {
               "description": "master node",
               "hostname": "master1",
               "hw_profile": "default_amd_master_profile",
               "role": "master",
               "serial": "2M201002RN",
               "user": "admin",
               "password": "<password>",
               "model": "DL325",
               "label_password": "<label password>",
               "custom_data": {
                       "host_ipaddress": "XX.XX.XX.XX",
                       "sriov_profile": "NA"
               }
        },
        {
               "description": "master node",
               "hostname": "master2",
               "hw_profile": "default_amd_master_profile",
               "role": "master",
               "serial": "2M201002RP",
               "user": "admin",
               "password": "<password>",
               "model": "DL325",
               "label_password": "<label password>",
               "custom_data": {
                       "host_ipaddress": "XX.XX.XX.XX",
                       "sriov_profile": "NA"
               }
        },
        {
               "description": "master node",
               "hostname": "master3",
               "hw_profile": "default_amd_master_profile",
               "role": "master",
               "serial": "2M201002RK",
               "user": "admin",
               "password": "<password>",
               "model": "DL325",
               "label_password": "<label password>",
               "custom_data": {
                       "host_ipaddress": "XX.XX.XX.XX",
                       "sriov_profile": "NA"
               }
        },
        {
               "description": "worker node",
               "hostname": "worker1",
               "hw_profile": "default_amd_worker_profile",
               "role": "worker",
               "serial": "2M20100425",
               "user": "admin",
               "password": "<password>",
               "model": "DL325",
               "label_password": "<label password>",
               "custom_data": {
                       "host_ipaddress": "XX.XX.XX.XX",
                       "sriov_profile": "2port-sriov"
               }
        },
        {
               "description": "bootstrap node",
               "hostname": "Bootstrap",
               "hw_profile": "default_amd_worker_profile",
               "role": "bootstrap",
               "serial": "2M20100424",
               "user": "admin",
               "password": "<password>",
               "model": "DL325",
               "label_password": "<label password>",
               "custom_data": {
                       "host_ipaddress": "XX.XX.XX.XX",
                       "sriov_profile": "4port-sriov"
               }
        }
],

Parameters - Servers

The following table describes the parameters in the Servers subsection.

Table 15: Servers
Parameters Description
hostname Enter the hostname provided by the customer.

This value is mapped to the server name of iLO. You can also accept the default or existing value by entering NA in this parameter.

Optional. If you do not need this parameter, delete the same from your Input JSON file.

hw_profile Enter the name of the hardware profile of the servers.
role Enter the name of the role of the corresponding servers. Role of the server.
ilo ILO network for managing servers.
serial Serial number of the iLO server. Only applicable if DHCP is used to allocate OOBM IP.
user Enter the corresponding username that is used to access iLO.
NOTE:

This user is a new Administrator user that is created when the Input JSON file is uploaded.

password Enter the corresponding password of the administrator user to access iLO.

This parameter is used in conjunction with the user parameter.

NOTE:

The password must conform to following conventions:

  • The minimum number of permissible characters is 7.

  • The maximum number of permissible characters is 20.

  • The password must contain at least 1 numeral.

  • The password must contain at least 1 lowercase alphabet.

  • The password must contain at least 1 uppercase alphabet.

model Type the model description of the corresponding servers.
label_password This field will be used when DHCP is assigned to iLO servers. It is the password for default user "Administrator"
host_ipaddress Specify the IP address assigned to host.
sriov_profile SR-IOV profile that needs to be applied to the iLO. Applicable for worker nodes only.

Sample input JSON - Switches

NOTE:

This example shows the parameters for the first data/leaf switch. The second data/leaf switch is similarly configured.

"switches": [
        {
               "description": "management1",
               "type": "management",
               "oob_mgmt_ip": "XX.XX.XX.XX",
               "name": "management-1",
               "user": "admin",
               "password": "<password>",
               "protocol": "vxlan"
        },
        {
               "description": "data1",
               "type": "data",
               "oob_mgmt_ip": "XX.XX.XX.XX",
               "name": "leaf-1",
               "user": "admin",
               "password": "<password>",
               "loopback_address": "NA",
               "anycast_ip": "NA",
               "bgp_autonomous_system_num": "NA",
               "protocol": "vxlan",
               "custom_data": {
                       "LoopbackRange": "XX.XX.XX.0-XX.XX.XX.100",
                       "FabricLinkRange": "XX.XX.XX.0-XX.XX.XX.100",
                       "location": "R03-N2840-U34",
                       "ports": [
                              {
                                      "ConnectDesttype": "server",
                                      "ConnectDestName": "Master-mgmt-1",
                                      "PortCable": "JL488A",
                                      "PortRole": "Downlink",
                                      "PortSpeedActual": "25G",
                                      "PortSpeedEffective": "25G",
                                      "ConnectSource": "1/1/1",
                                      "ConnectDestIP": "NA",
                                      "ConnectSerial": "2M201002RN",
                                      "ConnectDestPort": "Slot 10, Port 1",
                                      "ConnectDestLoc": "R03-N2840-U28",
                                      "vlan_list": [
                                              {
                                                     "vlan_id": "3401",
                                                     "tagged": false
                                              }
                                      ],
                                      "bonded": "1/1/1"
                              },
                              {
                                      "ConnectDesttype": "server",
                                      "ConnectDestName": "Worker-mgmt-1",
                                      "PortCable": "JL488A",
                                      "PortRole": "Downlink",
                                      "PortSpeedActual": "25G",
                                      "PortSpeedEffective": "25G",
                                      "ConnectSource": "1/1/4",
                                      "ConnectDestIP": "NA",
                                      "ConnectSerial": "2M20100425",
                                      "ConnectDestPort": "Slot 10, Port 1",
                                      "ConnectDestLoc": "R03-N2840-U25",
                                      "vlan_list": [
                                              {
                                                     "vlan_id": "3401",
                                                     "tagged": false
                                              }
                                      ],
                                      "bonded": "1/1/4"
                              },
                              {
                                      "ConnectDesttype": "external_storage",
                                      "ConnectDestName": "TG2A",
                                      "PortCable": "J9283D",
                                      "PortRole": "Downlink",
                                      "PortSpeedActual": "25G",
                                      "PortSpeedEffective": "10G",
                                      "ConnectSource": "1/1/13",
                                      "ConnectDestIP": "NA",
                                      "ConnectDestMac": "3C:FD:FE:BB:08:60",
                                      "ConnectSerial": "empty",
                                      "ConnectDestPort": "empty",
                                      "ConnectDestLoc": "empty",
                                      "vlan_list": [
                                              {
                                                     "vlan_id": "3401",
                                                     "tagged": false
                                              }
                                      ],
                                      "bonded": "NA"
                              },
                              {
                                      "ConnectDesttype": "server",
                                      "ConnectDestName": "worker1-pci-1",
                                      "PortCable": "JL488A",
                                      "PortRole": "Downlink",
                                      "PortSpeedActual": "25G",
                                      "PortSpeedEffective": "25G",
                                      "ConnectSource": "1/1/25",
                                      "ConnectDestIP": "NA",
                                      "ConnectSerial": "2M20100425",
                                      "ConnectDestPort": "Slot 1, Port 1",
                                      "ConnectDestLoc": "R03-N2840-U25",
                                      "vlan_list": [
                                              {
                                                     "vlan_id": "3450-3460",
                                                     "tagged": true
                                              }
                                      ],
                                      "bonded": "NA"
                              },
                              {
        {
               "description": "spine1",
               "type": "spine",
               "oob_mgmt_ip": "XX.XX.XX.XX",
               "name": "spine-1",
               "user": "admin",
               "password": "<password>",
               "protocol": "vxlan"
        },
        {
               "description": "borderleaf1",
               "type": "borderleaf",
               "oob_mgmt_ip": "XX.XX.XX.XX",
               "name": "borderleaf-1",
               "user": "admin",
               "password": "<password>",
               "protocol": "vxlan",
               "custom_data": {
                       "location": "R03-N2840-U37"
               }
        },
],
"description": "List of all physical infrastructure elements configured by code"
},

Parameters - Switches

The following table describes the parameters in the switches subsection.

Table 16: Switches
Parameters Description
description Enter the descriptive information of the corresponding switch.

Optional. If you do not need this parameter, delete the same from your Input JSON file.

type Enter the description of the corresponding switch type.
oob_mgmt_ip Enter the available IP address from the iLO-OOBM network.
name Enter the descriptive name of the corresponding switch.
user Enter the username that is used to access the corresponding switch.
password Enter the password that is used to access the corresponding switch.
protocol Enter the protocol for switch configuration.
loopback_address Enter the available IP address for Loopback IP.
anycast_ip Enter the anycast IP address.
bgp_autonomous_system_num Enter the BGP autonomous system number from the network topology.
LoopbackRange Enter the IPv4 address ranges that can be used to assign IPs to the Overlay interfaces.
FabricLinkRange Enter the IPv4 address ranges that can be used to assign IPs to the Underlay interfaces.
location Enter the rack location for a starter kit.
ConnectDesttype Enter the destination device type.
ConnectDestName Enter the device hostname.
PortCable Enter the connected cable part number.
PortRole Specify the type of connection. Connected to either device server or switch.
PortSpeedActual Enter the maximum speed on the port.
PortSpeedEffective Enter the speed based on the transceiver (1G/10G/25G)
ConnectSource Specify the connected device type (master or worker).
ConnectDestIP Enter the destination device IP address.
ConnectSerial Enter the serial number of the destination device.
ConnectDestPort Enter the destination device port.
ConnectDestLoc Enter the destination device location.
vlan_id Enter the VLAN number.
tagged Indicate whether the port is tagged.
bonded Enter the interface (for example, 1/1/4) that is bonded with the connect source. NA means not bonded.