简介
本文档介绍对发现配置文件中使用的逗号分隔值(csv)文件格式进行的重大更改。这些更改旨在使客户能够更灵活、更强大地为机架服务器提供参数。此外,其目的是涵盖该字段中遇到的所有格式和格式中经常出现的错误。
背景信息
思科集成管理控制器管理引擎(IMCS)是一种管理软件,具有管理机架式服务器的强大功能。用户能够发现、清点、运行固件升级并执行多个其他操作。通过创建包含要发现的IP地址列表的发现配置文件,可以执行机架式服务器的发现。IP地址可以作为IP、IP范围、子网列表提供,也可以使用csv文件提供。本文档中提及的格式更改与此csv文件有关。
问题
在IMCS 2.0.0.2之前
IMCS 2.0.0.2(即2.0.0.1及更低版本)之前的csv文件格式仅包含IP地址。这些IP地址按行提供,如下表所示。
无效的格式:
用户有时按如下所示输入IP地址列。
IMCS 2.0.0.2到IMCS 2.1.0.2
格式更改为键值对,支持更多值作为csv文件的一部分提供。此外,还增加了以任意顺序提供条目的灵活性(即,在特定列中提供条目时没有严格限制)。 例如,可以在IP地址之前或之后提供联系信息。密钥是IP、说明、位置、联系人、标记、机架组。
注意:无需提供省略的密钥值对。
例如,如果Description不适用于服务器,则csv文件不需要输入Description=来指示值为空。此屏幕截图中的第一行是此使用案例的示例。
约束:
需要在csv文件的所有行中提供密钥。
无效的格式:
此处提供了一些在字段中遇到的无效格式。
没有值的密钥在csv文件中提供,这会导致异常并导致发现不发生。在此屏幕截图中,提供了“机架组”和“标记”键,但没有为它们提供值。
键以标题形式提供,以列条目形式提供,如下所示。这会导致第一行中没有IP可用的错误,从而不会创建发现配置文件。
解决方案
IMCS 2.2.0.0
此后,csv文件格式为逗号分隔值,如下所示。列为IP地址、说明、位置、联系人、机架组和标记。您可以选择省略,以提供在创建发现配置文件时不可用/未知的条目的值。
未提供的条目将留空,如此屏幕截图所示。但是,IP地址字段是必填项。
可以为多个标记值提供分号分隔值,如此屏幕截图所示。
在屏幕截图中,有2个标记(TagX和TagY),与机架服务器关联的每个标记的值分别为ValueX和ValueY。此外,联系人列可以是任何字符串值,即可以包含电子邮件ID、电话号码或任何其他字符串值。
屏幕截图中显示了一些示例条目。
注意:版本IMCS 2.2.0.0不支持旧格式
约束:
严格列限制。每列应仅包含该特定值。
常见问题
(问:如果用户尝试在IMCS 2.2中提供旧格式的csv,会发生什么情况?
(A)IMCS在上传时抛出错误,表示格式无效。
(Q)说明、位置和标记值是否接受空格?
(A)是。在“说明”、“位置”和“标记”值中接受空格。
(问)能否在第一列中指定主机名而不是IP?
(A)是。可以提供主机名。
(问:如果未提及机架组,会发生什么情况?
(A)如果未指定机架组,则机架服务器将添加到默认组机架组下。
(问)联系人应始终是电子邮件ID吗?您能提供电话号码或其他值吗?
(A)是,联系人可以是任何值。IMCS接受所有字符串值。