Troubleshooting

Chef Workstation Logs

Chef Workstation logs are stored in ~/.chef-workstation/logs.

Uninstall instructions

Follow the steps provided under Uninstalling.

Trusted Certs

We recommend developing the habit of restarting Chef Workstation Powershell after adding certificates to the trusted_certs directory on Windows machines. Sometimes certificate-related commands such as knife ssl check don’t return the expected results after adding a certificate with knife ssh fetch. If this happens:

Exit the Chef Workstation Powershell.
Select the Chef Workstation Powershell icon to restart.
Retry the command.

Common Error Codes

CHEFINT001

CHEFINT001

An remote error has occurred:

  Your SSH Agent has no keys added, and you have not specified a password or a key file.

This error now appears as CHEFTRN007. If you’re running an older version of chef-run it will appear as CHEFINT001 with the message above. Follow the steps detailed under CHEFTRN007 below to resolve.

CHEFTRN007

No authentication methods available

This error occurs when there are no available ssh authentication methods to provide to the server. chef-run requires a password, a key file, or a .ssh/config host entry containing a KeyFile. Information about each option is below.

resolve via chef-run flags

Use --password to provide the password required to authenticate to the host:

chef-run --password $PASSWORD myhost.example.com --password

Alternatively, explicitly provide an identity file using ‘–identity-file’:

chef-run --identity-file /path/to/your/ssh/key

resolve by adding key(s) to ssh-agent

## ensure ssh-agent is running. This may report it is already started:
$ ssh-agent

## Add your key file(s):
$ ssh-add
Identity added: /home/timmy/.ssh/id_rsa (/home/timmy/.ssh/id_rsa)

resolve by adding a host entry to ~/.ssh/config

Add an entry for this host to your .ssh/config:

host example.com
  IdentityFile /path/to/valid/key