Configuring the SSH adapter
For the SSH adapter, in addition to target computers defined in the adapter configuration, you can define dynamic target computers in each adapter request. If a dynamic target is defined in the SSH adapter request, use a configuration node, <config/>,
in the adapter configuration.
BMC recommends that you do not include unused elements in the adapter configuration because they might cause errors.
Adapter type: ro-adapter-ssh_20.15.02.00
Default adapter name: SSHAdapter
To configure the SSH adapter, see Configuring base adapters.
The following table describes the adapter configuration elements for the SSH adapter that you can specify by using the form view, XML view, or both. You cannot use the form view to configure elements and attributes that do not have an entry in the "UI label" column.
Configuration node elements of the SSH adapter
UI label | Element | Description | Required |
---|---|---|---|
Target |
| Specifies the host name or the IP address of the remote host computer Note You can specify an IPv6 address with a zone ID for the | Yes |
Port |
| Specifies the port on which the remote host listens | No |
User Name |
| Specifies the user name required for remote host authentication | Yes |
Password |
| Specifies the password corresponding to the specified user name Note If you provide the | No |
Encryption Type |
| Indicates whether the password specified is encrypted; is an attribute of the | No |
Private Key File |
| Identifies the path and file name of the local SSH key file Note If you provide the | Conditional; used if the |
Private Key Data |
| Specifies the private key data of the local SSH key file Note The | No |
Pass Phrase |
| Identifies the passphrase that protects the private key file | Conditional; used if the |
Encryption Type |
| Indicates whether the passphrase specified is encrypted; is an attribute of the | No |
Prompt |
| Specifies the console prompt displayed when the system is waiting for a command (the terminating string, typically ending with $, >, or #) | Conditional; required to use the proxy command feature |
Use Shell Mode | <use-shell-mode> | Specifies whether each command should be executed on a shell session without using a prompt Valid values: true, false (default) Do not use the | Conditional; do not use if you are already using the <prompt> element |
None |
| Determines whether the adapter must determine the target OS type soon after authentication is complete or a connection is established | No |
Timeout Secs |
| Specifies the time, in seconds, to wait for the expected prompt to be returned | No |
Known Hosts Config |
| Identifies the path to the local known_hosts file | No |
Allow Unknown Hosts |
| Determines whether a connection must continue if the key verification fails | No |
Preferred Pk Algorithm |
| Specifies the preference of the algorithm used to encrypt the public key | No |
Establish Connection Timeout Secs |
| Specifies the time, in seconds, that the adapter waits for user authentication on the target server | No |
Network Environment |
| Creates an extra channel session for use with Oracle Solaris 9 Note The value must be | No |
Line Termination |
| Specifies the line termination character used with the SSH command Typically, the value is a hexadecimal value for \r (&#D;) or \n (&#A;).
| No |
Character Set |
| Specifies the supporting CharSet | No |
Read Buffer Size |
| Specifies the buffer size, in bytes, which will be used to read from I/O Streams | No |
The following figure shows the XML template for SSH adapter configuration with password approach.
The following figure shows the XML template for SSH adapter configuration with private-key-file approach.
Recommendation
BMC recommends that you use the password or the private-key-file approach; not both the approaches together.
The following figure shows the XML template for SSH adapter configuration with private-key-data approach.
The following figure shows an XML sample for SSH adapter configuration with CharSet.
The following figure shows an XML sample for SSH adapter configuration by using the <use-shell-mode>
element
Comments
Log in or register to comment.