Merge pull request #30070 from cachedout/issue_27835

Add documentation on debugging salt-ssh
This commit is contained in:
Nicole Thomas 2015-12-29 16:00:06 -07:00
commit 404414bf57

View file

@ -200,3 +200,16 @@ Boolean-style options should be specified in their YAML representation.
be ``wipe_ssh`` and thus this is what should be configured in the
``Saltfile``. Using the names of flags for this option, being ``wipe:
true`` or ``w: true``, will not work.
Debugging salt-ssh
==================
One common approach for debugging ``salt-ssh`` is to simply use the tarball that salt
ships to the remote machine and call ``salt-call`` directly.
To determine the location of ``salt-call``, simply run ``salt-ssh`` with the ``-ldebug``
flag and look for a line containing the string, ``SALT_ARGV``. This contains the ``salt-call``
command that ``salt-ssh`` attempted to execute.
It is recommended that one modify this command a bit by removing the ``-l quiet``,
``--metadata`` and ``--output json`` to get a better idea of what's going on on the target system.