| <html> |
| |
| <head> |
| <meta http-equiv="Content-Language" content="en-us"> |
| <title>SSHEXEC Task</title> |
| </head> |
| |
| <body> |
| |
| <h2><a name="sshexec">SSHEXEC</a></h2> |
| <h3>Description</h3> |
| |
| <p>Runs a command on a remote machine running SSH daemon. |
| </p> |
| |
| <p><b>Note:</b> This task depends on external libraries not included |
| in the Ant distribution. See <a |
| href="index.html#librarydependencies">Library Dependencies</a> |
| for more information. This task has been tested with jsch-0.1.7 to |
| jsch-0.1.12 and won't work with versions of jsch earlier than |
| 0.1.7.</p> |
| |
| <h3>Parameters</h3> |
| <table border="1" cellpadding="2" cellspacing="0"> |
| <tr> |
| <td valign="top"><b>Attribute</b></td> |
| <td valign="top"><b>Description</b></td> |
| <td align="center" valign="top"><b>Required</b></td> |
| </tr> |
| <tr> |
| <td valign="top">username</td> |
| <td valign="top">The username on the remote host to which you are connecting.</td> |
| <td valign="top" align="center">Yes</td> |
| </tr> |
| <tr> |
| <td valign="top">command</td> |
| <td valign="top">The command to run on the remote host.</td> |
| <td valian="top" align="center">Yes</td> |
| </tr> |
| <tr> |
| <td valign="top">port</td> |
| <td valign="top">The port to connect to on the remote host.</td> |
| <td valian="top" align="center">No, defaults to 22.</td> |
| </tr> |
| <tr> |
| <td valign="top">trust</td> |
| |
| <td valign="top">This trusts all unknown hosts if set to yes/true.<br> |
| <strong>Note</strong> If you set this to false (the default), the |
| host you connect to must be listed in your knownhosts file, this |
| also implies that the file exists.</td> |
| <td valian="top" align="center">No, defaults to No.</td> |
| </tr> |
| <tr> |
| <td valign="top">knownhosts</td> |
| <td valign="top">This sets the known hosts file to use to validate |
| the identity of the remote host. This must be a SSH2 format file. |
| SSH1 format is not supported.</td> |
| <td valian="top" align="center">No, defaults to |
| ${user.home}/.ssh/known_hosts.</td> |
| </tr> |
| <tr> |
| <td valign="top">failonerror</td> |
| <td valign="top">Whether to halt the build if the command does not complete successfully. |
| </td> |
| <td valign="top" align="center">No; defaults to true.</td> |
| </tr> |
| <tr> |
| <td valign="top">password</td> |
| <td valign="top">The password.</td> |
| <td valign="top" align="center">Not if you are using key based |
| authentication or the password has been given in the file or |
| todir attribute.</td> |
| </tr> |
| <tr> |
| <td valign="top">keyfile</td> |
| <td valign="top">Location of the file holding the private key.</td> |
| <td valign="top" align="center">Yes, if you are using key based |
| authentication.</td> |
| </tr> |
| <tr> |
| <td valign="top">passphrase</td> |
| <td valign="top">Passphrase for your private key.</td> |
| <td valign="top" align="center">No, defaults to an empty string.</td> |
| </tr> |
| <tr> |
| <td valign="top">output</td> |
| <td valign="top">Name of a file to which to write the output.</td> |
| <td align="center" valign="top">No</td> |
| </tr> |
| <tr> |
| <td valign="top">append</td> |
| <td valign="top">Whether output file should be appended to or overwritten. Defaults to false, meaning overwrite any existing file.</td> |
| <td align="center" valign="top">No</td> |
| </tr> |
| <tr> |
| <td valign="top">outputproperty</td> |
| <td valign="top">The name of a property in which the output of the |
| command should be stored.</td> |
| <td align="center" valign="top">No</td> |
| </tr> |
| <tr> |
| <td valign="top">timeout</td> |
| <td valign="top">Stop the command if it doesn't finish within the |
| specified time (given in milliseconds). Defaults to 0 which means "wait forever".</td> |
| <td align="center" valign="top">No</td> |
| </tr> |
| </table> |
| |
| <h3>Examples</h3> |
| <p><b>Run a command on a remote machine using password authentication</b></p> |
| <pre> |
| <sshexec host="somehost" |
| username="dude" |
| password="yo" |
| command="touch somefile"/> |
| </pre> |
| |
| <p><b>Run a command on a remote machine using key authentication</b></p> |
| <pre> |
| <sshexec host="somehost" |
| username="dude" |
| keyfile="${user.home}/.ssh/id_dsa" |
| passphrase="yo its a secret" |
| command="touch somefile"/> |
| </pre> |
| |
| <p><b>Run a command on a remote machine using key authentication with no passphrase</b></p> |
| <pre> |
| <sshexec host="somehost" |
| username="dude" |
| keyfile="${user.home}/.ssh/id_dsa" |
| command="touch somefile"/> |
| </pre> |
| |
| <p><strong>Security Note:</strong> Hard coding passwords and/or usernames |
| in sshexec task can be a serious security hole. Consider using variable |
| substituion and include the password on the command line. For example:<br> |
| <pre> |
| <sshexec host="somehost" |
| username="${username}" |
| password="${password}" |
| command="touch somefile"/> |
| </pre> |
| Invoke ant with the following command line: |
| <pre> |
| ant -Dusername=me -Dpassword=mypassword target1 target2 |
| </pre> |
| </p> |
| |
| <hr><p align="center">Copyright © 2003-2004 Apache Software Foundation. |
| All rights Reserved.</p> |
| |
| </body> |
| </html> |
| |
