diff --git a/cmd/packer-sdc/internal/renderdocs/docs-partials/packer-plugin-sdk/communicator/SSH-not-required.mdx b/cmd/packer-sdc/internal/renderdocs/docs-partials/packer-plugin-sdk/communicator/SSH-not-required.mdx index b1a8652f62..f690f8db68 100644 --- a/cmd/packer-sdc/internal/renderdocs/docs-partials/packer-plugin-sdk/communicator/SSH-not-required.mdx +++ b/cmd/packer-sdc/internal/renderdocs/docs-partials/packer-plugin-sdk/communicator/SSH-not-required.mdx @@ -74,6 +74,12 @@ - `ssh_file_transfer_method` (string) - `scp` or `sftp` - How to transfer files, Secure copy (default) or SSH File Transfer Protocol. + + NOTE: for guests using Windows with Win32-OpenSSH v9.1.0.0p1-Beta, scp + (the default protocol for copying data) returns an error since the MOTW + cannot be set, and the command ends-up with a non-zero error code, making + transfers fail in this case. This can be solved by overriding the protocol + with SFTP instead. - `ssh_proxy_host` (string) - A SOCKS proxy host to use for SSH connection diff --git a/communicator/config.go b/communicator/config.go index e75820503a..51feb9c0e4 100644 --- a/communicator/config.go +++ b/communicator/config.go @@ -165,6 +165,12 @@ type SSH struct { SSHBastionCertificateFile string `mapstructure:"ssh_bastion_certificate_file"` // `scp` or `sftp` - How to transfer files, Secure copy (default) or SSH // File Transfer Protocol. + // + // NOTE: for guests using Windows with Win32-OpenSSH v9.1.0.0p1-Beta, scp + // (the default protocol for copying data) returns an error since the MOTW + // cannot be set, and the command ends-up with a non-zero error code, making + // transfers fail in this case. This can be solved by overriding the protocol + // with SFTP instead. SSHFileTransferMethod string `mapstructure:"ssh_file_transfer_method"` // A SOCKS proxy host to use for SSH connection SSHProxyHost string `mapstructure:"ssh_proxy_host"`