Devices CSV File Requirements

The devices CSV file defines the devices, ports, and their details required to add them to CC-SG.

• For devices that support power strips connected to a port (SX, KX, KX2, KSX2), configuring the port will configure the power strip.
• If device ports are configured, CC-SG also adds a node with out-of-band KVM or out-of-band Serial interface for each port.
• To add blades, the blade server must be connected to a KX2 device via a CIM. The KX2 device must either already be added to CC-SG, or be included in the same CSV file.
• When adding IPv6 enabled KX2 devices, see Discovering and Adding IPV6 Network Devices for details on support.
• Export a file from CC-SG to view the Comments, which include all tags and parameters needed to create a valid CSV file. See Export Devices.
• Follow the additional requirements for all CSV files. See Common CSV File Requirements.

• To add a device to the CSV file:

  Column number	Tag or value	Details
  1	ADD	The first column for all tags is the command.
  2	DEVICE	Enter the tag as shown. Tags are not case sensitive.
  3	Device Type	Required field. Enter the device type as shown here: KX, KX2, KSX, KSX2, KX101, KX2-101, IP-Reach, SX, or PX
  4	Device Name	Required field. Device names cannot contain spaces or certain special characters. Dominion PX device names cannot include periods. Upon import, periods are converted to hyphens.
  5	IP Address or Hostname	Required field. IPv4 or IPv6 address for supported devices.
  6	Username	Required field.
  7	Password	Required field.
  8	Heartbeat	Default is configured in the Admin Client in Administration > Configuration > Device Settings tab.
  9	TCP Port	Default is configured in the Admin Client in Administration > Configuration > Device Settings tab.
  10	Configure All Ports	TRUE or FALSE Default is TRUE for Dominion PX devices. Default is FALSE for all other device types. When set to TRUE, all ports are configured and nodes with the appropriate out-of-band interface are created. When set to FALSE, only ports that have a corresponding ADD DEVICE-PORT record in the CSV file are configured.
  11	Allow Direct Access	TRUE or FALSE Default is FALSE. This setting is for SX and KX2 version 2.2 or later devices only.
  12	Description	Optional.

• To add a port to the CSV file:

Use the DEVICE-PORT tag only if you add a device with Configure All Ports set to FALSE, and you want to specify ports individually. The ports you add must be un-configured in CC-SG when you import the CSV file.

• To add a blade to the CSV file:

  Column number	Tag or value	Details
  1	ADD	The first column for all tags is the command.
  2	DEVICE-BLADE	Enter the tag as shown. Tags are not case sensitive.
  3	Device Name	Required field.
  4	Port Number	Required field.
  5	Blade Number	Required field.
  6	Blade Name	Optional. If left blank, the name assigned at the device level is used. If a name is entered in the CSV file, it will be copied to the device level.
  7	Node Name	Enter a name for the node that will be created when this blade is configured.

• To add a tiered KVM switch connected to a KX2:

  KX2 ports with tiered KVM switches connected must be imported as type "KVM".

  Column number	Tag or value	Details
  1	ADD	The first column for all tags is the command ADD.
  2	DEVICE-KVMSWITCHPORT	Enter the tag as shown. Tags are not case sensitive.
  3	Device Name	Required field.
  4	Port Number	The port that the KVM Switch is connected to. Required field.
  5	KVM Switch Port Number	Required field.
  6	KVM Switch Port Name	Optional. If left blank, the name assigned at the device level is used. If a name is entered in the CSV file, it will be copied to the device level.
  7	Node Name	Enter a name for the node that will be created when this KVM Switch port is configured.

• To assign a category and element to a device to the CSV file:

Categories and elements must already be created in CC-SG.

You can assign multiple elements of the same category to a device in the CSV file.