summaryrefslogtreecommitdiff
path: root/lib/chef/formatters
diff options
context:
space:
mode:
Diffstat (limited to 'lib/chef/formatters')
-rw-r--r--lib/chef/formatters/error_inspectors/api_error_formatting.rb20
-rw-r--r--lib/chef/formatters/error_inspectors/cookbook_resolve_error_inspector.rb2
-rw-r--r--lib/chef/formatters/error_inspectors/registration_error_inspector.rb4
-rw-r--r--lib/chef/formatters/error_inspectors/run_list_expansion_error_inspector.rb4
4 files changed, 15 insertions, 15 deletions
diff --git a/lib/chef/formatters/error_inspectors/api_error_formatting.rb b/lib/chef/formatters/error_inspectors/api_error_formatting.rb
index f306a5a5f1..954eebafdb 100644
--- a/lib/chef/formatters/error_inspectors/api_error_formatting.rb
+++ b/lib/chef/formatters/error_inspectors/api_error_formatting.rb
@@ -28,7 +28,7 @@ class Chef
def describe_network_errors(error_description)
error_description.section("Networking Error:", <<~E)
#{exception.message}
-
+
Your chef_server_url may be misconfigured, or the network could be down.
E
error_description.section("Relevant Config Settings:", <<~E)
@@ -40,25 +40,25 @@ E
error_description.section("Authentication Error:", <<~E)
Received an EOF on transport socket. This almost always indicates a network
error external to chef-client. Some causes include:
-
+
- Blocking ICMP Dest Unreachable (breaking Path MTU Discovery)
- IPsec or VPN tunnelling / TCP Encapsulation MTU issues
- Jumbo frames configured only on one side (breaking Path MTU)
- Jumbo frames configured on a LAN that does not support them
- Proxies or Load Balancers breaking large POSTs
- Broken TCP offload in network drivers/hardware
-
+
Try sending large pings to the destination:
-
+
windows: ping server.example.com -f -l 9999
unix: ping server.example.com -s 9999
-
+
Try sending large POSTs to the destination (any HTTP code returned is success):
-
+
e.g.: curl http://server.example.com/`printf '%*s' 9999 '' | tr ' ' 'a'`
-
+
Try disabling TCP Offload Engines (TOE) in your ethernet drivers.
-
+
windows:
Disable-NetAdapterChecksumOffload * -TcpIPv4 -UdpIPv4 -IpIPv4 -NoRestart
Disable-NetAdapterLso * -IPv4 -NoRestart
@@ -66,7 +66,7 @@ E
Restart-NetAdapter *
unix(bash):
for i in rx tx sg tso ufo gso gro lro rxvlan txvlan rxhash; do /sbin/ethtool -K eth0 $i off; done
-
+
In some cases the underlying virtualization layer (Xen, VMware, KVM, Hyper-V, etc) may have
broken virtual networking code.
E
@@ -89,7 +89,7 @@ E
chef_server_url "#{server_url}"
node_name "#{username}"
client_key "#{api_key}"
-
+
If these settings are correct, your client_key may be invalid, or
you may have a chef user with the same client name as this node.
E
diff --git a/lib/chef/formatters/error_inspectors/cookbook_resolve_error_inspector.rb b/lib/chef/formatters/error_inspectors/cookbook_resolve_error_inspector.rb
index a45d5ea45f..a046f1a277 100644
--- a/lib/chef/formatters/error_inspectors/cookbook_resolve_error_inspector.rb
+++ b/lib/chef/formatters/error_inspectors/cookbook_resolve_error_inspector.rb
@@ -59,7 +59,7 @@ class Chef
error_description.section("Authorization Error", <<~E)
This client is not authorized to read some of the information required to
access its cookbooks (HTTP 403).
-
+
To access its cookbooks, a client needs to be able to read its environment and
all of the cookbooks in its expanded run list.
E
diff --git a/lib/chef/formatters/error_inspectors/registration_error_inspector.rb b/lib/chef/formatters/error_inspectors/registration_error_inspector.rb
index cfc536192c..b912800bc5 100644
--- a/lib/chef/formatters/error_inspectors/registration_error_inspector.rb
+++ b/lib/chef/formatters/error_inspectors/registration_error_inspector.rb
@@ -32,7 +32,7 @@ class Chef
E
error_description.section("Relevant Config Settings:", <<~E)
chef_server_url "#{server_url}"
-
+
If your chef_server_url is correct, your network could be down.
E
when Chef::Exceptions::PrivateKeyMissing
@@ -74,7 +74,7 @@ E
chef_server_url "#{server_url}"
validation_client_name "#{username}"
validation_key "#{api_key}"
-
+
If these settings are correct, your validation_key may be invalid.
E
end
diff --git a/lib/chef/formatters/error_inspectors/run_list_expansion_error_inspector.rb b/lib/chef/formatters/error_inspectors/run_list_expansion_error_inspector.rb
index 93e29e4017..9d46465947 100644
--- a/lib/chef/formatters/error_inspectors/run_list_expansion_error_inspector.rb
+++ b/lib/chef/formatters/error_inspectors/run_list_expansion_error_inspector.rb
@@ -38,7 +38,7 @@ class Chef
when Errno::ECONNREFUSED, Timeout::Error, Errno::ETIMEDOUT, SocketError
error_description.section("Networking Error:", <<~E)
#{exception.message}
-
+
Your chef_server_url may be misconfigured, or the network could be down.
E
when Net::HTTPServerException, Net::HTTPFatalError
@@ -85,7 +85,7 @@ E
chef_server_url "#{server_url}"
node_name "#{username}"
client_key "#{api_key}"
-
+
If these settings are correct, your client_key may be invalid.
E
when Net::HTTPForbidden