(PE-39411) Add descriptive error during infrastructure upgrade when rbac token is invalid

Author: jhbuchanan45

tasks/puppet_infra_upgrade.rb

@@ -73,7 +73,14 @@ def wait_until_connected(nodes:, token_file:, timeout: 120)
       loop do
         response = https.request(request)
         unless response.is_a? Net::HTTPSuccess
-          raise "Unexpected result from orchestrator: #{response.class}\n#{response}"
+          case (response)
+          when Net::HTTPUnauthorized
+            raise "401 Unauthorized: Check your API token at #{token_file} has not been revoked. " +
+                  "An alternate token file can be specified using the token_file param. \n" +
+                  "See https://www.puppet.com/docs/pe/latest/rbac_token_auth_intro for more details"
+          else
+            raise "Unexpected result from orchestrator: #{response.class}\n#{response}"
+          end
         end
         inventory = JSON.parse(response.body)
         break if inventory['items'].all? { |item| item['connected'] }