参考指南 › 配置文件 › SSH 设备 XML 文件

SSH 设备 XML 文件

SSH 设备 XML 文件允许您配置 SAM 如何连接 SSH 设备端点、发现用户帐户，并更改端点上的特权帐户密码。

不同的 SSH 设备 XML 文件配置与不同类型的 SSH 设备端点的交互。 例如：aix_connector_conf.xml 文件配置与 AIX 端点的连接，device_connector_conf.xml 文件配置与 SSH 设备（如路由器）的连接。

注意：有关 SSH 设备 XML 文件类型的详细信息，请参阅《企业管理指南》。

SSH 设备 XML 文件位于以下目录：

ACServerInstallDir/Connector Server/conf/override/sshdyn

如果需要，可以根据自己企业的要求自定义 SSH 设备 XML 文件。

结构

SSH 设备 XML 文件包含以下元素：

• <class name="SSHConnectionManager">－包含管理 SSH 连接的参数
• <class name="CommandProcessor">－包含指定连接设置的参数
• <class name="CommandSet">－包含一些阵列元素，这些元素指定 SAM 在端点上执行的命令

<class name="CommandSet"> 元素包含组成命令集的阵列元素：

• <array name="oGetUsers">－包含 SAM 所执行以获取用户的命令
• <array name="oChangePassword">－包含 SAM 所执行的用于更改用户密码的命令
• <array name="oSubstituteUser">－包含 SAM 为使用 su 切换到其他用户而执行的命令

  注意：<array name="oSubstituteUser"> 元素仅对 aix_connector_conf.xml、checkpoint_connector_conf.xml 和 ssh_connector_conf.xml 文件有效。

每个阵列元素包含多个 <item> 元素。 <item> 元素定义 SAM 在端点上执行的专用命令的参数。 例如：<array name="oGetUsers"> 元素中的 <item> 元素可能指定：

• SAM 为获得本地用户而执行的命令
• SAM 等待响应的时间长度
• SAM 在继续之前等待接收的文本字符串
• 表示命令失败的响应中的文本字符串

注意：有关 SSH 设备 XML 文件中的 <item> 元素如何与 SSH 设备端点交互的示例，请参阅《企业管理指南》。

使用嵌套参数来为每个元素定义配置设置，如下所示：

• <class name="SSHConnectionManager"> 和 <class name="CommandProcessor"> 元素包含定义连接设置的参数
• <item> 元素中包含的一些参数可定义特定命令的参数

每个嵌套的参数具有以下格式：

<param name="name" value="value" />

SSH 设备 XML 文件的以下片段说明元素是如何嵌套的：

<package name="com.ca.jcs.sshdyn">
	<class name="SSHConnectionManager">
		<param name="name" value="value" />
	</class>
</package>
<package name="com.ca.sessame.conn.unix">
	<class name="CommandProcessor">
		<param name="name" value="value" />
	</class>
	<class name="CommandSet">
		<instance name="ssh">
			<array name="oGetUsers">
				<item>
					<param name="name" value="value" />
				</item>
			</array>
			<array name="oChangePassword">
				<item>
					<param name="name" value="value" />
				</item>
			</array>
			<array name="oSubstituteUser">
				<item>
					<param name="name" value="value" />
				</item>
			</array>
		</instance>
	</class>
</package>

元素

SSHConnectionManager

指定 SAM 用来管理 SSH 连接的设置。

该类元素包含以下参数：

I_CONNECTIONS

定义端点的并发连接数。

默认值：10

CommandProcessor

指定 SAM 用来连接到 SSH 设备端点的设置。

该类元素包含以下参数：

bToLog

指定 SAM 是否将消息写入 sLogFileName。

限制：true、false

默认值：true

sLogFileName

定义日志文件的相对路径名。

默认值：..\logs\uxlog.txt

limitResultCharsToLog

定义 CA ControlMinder 为每个连接写入日志文件中的最多字符数。

默认值：1500

bSkipOperationAdminTestConnection

指定

限制：true、false

默认值：true

maxTimeLimit

定义 SAM 等待值的最长时间（毫秒）。

默认值：1500

waitIntervalDefault

定义 SAM 等待的时间（毫秒）

默认值：500

login_str

指定用户名的 Telnet 请求命令。

示例;：login

password_str

指定密码的 Telnet 请求命令。

示例：password

AYT_answer

指定设备针对 Telnet 命令“Are You There”的回答

默认值：Solaris-Yes、Linux-yes、AIX-here

注意：由于不同配置，每个 SSH 设备可以针对 AYT 命令有唯一的回答。 您可以相应修改 SSH XML 文件。

要发现格式，请将 telnet 会话打开到设备并运行以下命令：

^+]
send ayt

iPort

定义 SSH 端口号。

注意：默认情况下，此参数将被注释掉。

默认值：22

CommandSet

指定 SAM 在端点上执行的命令。

该类元素包含将 SAM 在端点上执行的命令分组的阵列元素。

oGetUsers

指定 SAM为获取用户而执行的命令。

该阵列元素包含一些项目元素，这些元素定义 SAM 为获取用户而执行的特定命令的参数。

oChangePassword

指定 SAM 为更改用户密码而执行的命令。

该阵列元素包含一些项目元素，这些元素定义 SAM 为更改用户密码而执行的特定命令的参数。

oSubstituteUser

指定 SAM 为使用 su 切换到其他用户而执行的命令。

该阵列元素包含一些项目元素，这些元素定义 SAM 为使用 su 切换到其他用户而执行的特定命令。

注意：该元素仅对 aix_connector_conf.xml、checkpoint_connector_conf.xml 和 ssh_connector_conf.xml 文件有效。

item

指定 SAM 在端点上执行的特定命令的参数。

每个项目元素可以包含以下参数：

sCommand

定义 SAM 发送到端点的命令。

iWait

定义 SAM 在执行下一步前等待的时间间隔（毫秒）。

默认值：500

sWaitForText

定义 SAM 等待接收的文本字符串，以响应在 sCommand 中定义的命令。

sFailureResult

定义 SAM 从端点接收的指示命令失败的文本字符串。

sToFilterOut

定义 SAM 从端点输出删除的文本字符串。

bHideSentLog

指定是否将命令写入日志文件。

限制：true－SAM 不将命令写入日志文件，false－SAM 将命令写入日志文件

默认值：true

sTrueResultRegex

（可选）指定将命令结果与指定的字符串进行比较。 如果结果与字符串不匹配，则显示错误消息。

注意：默认情况下，此参数将被注释掉。

iXMLVersion

指出 XML 文件版本。 XML 版本不能比 SSL 连接程序中定义的 XML 版本新。

默认值：0

ToReport

指定是否将 XML 处理数据记录到 $XML_NAME..lodaing_report.xml 中。 该日志文件位于以下目录：

ACServerInstallDir/Connector Server/conf/override/sshdyn

限制：true、false

默认值：true

FileIsLoaded

表示已成功加载 XML 文件。

默认值：OK