chef 18.11.11 → 19.1.164

data/lib/chef/resource/ohai.rb

@@ -2,7 +2,7 @@
 # Author:: Michael Leinartas (<mleinartas@gmail.com>)
 # Author:: Tyler Cloke (<tyler@chef.io>)
 # Copyright:: Copyright 2010-2016, Michael Leinartas
-# Copyright:: Copyright (c) Chef Software, Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -26,51 +26,52 @@ class Chef
   class Resource
     class Ohai < Chef::Resource
 
-      provides :ohai
+      provides :ohai, target_mode: true
+      target_mode support: :full
 
       description "Use the **ohai** resource to reload the Ohai configuration on a node. This allows recipes that change system attributes (like a recipe that adds a user) to refer to those attributes later on during the #{ChefUtils::Dist::Infra::PRODUCT} run."
 
       examples <<~DOC
-        Reload All Ohai Plugins
+      Reload All Ohai Plugins
 
-        ```ruby
-        ohai 'reload' do
-          action :reload
-        end
-        ```
+      ```ruby
+      ohai 'reload' do
+        action :reload
+      end
+      ```
 
-        Reload A Single Ohai Plugin
+      Reload A Single Ohai Plugin
 
-        ```ruby
-        ohai 'reload' do
-          plugin 'ipaddress'
-          action :reload
-        end
-        ```
+      ```ruby
+      ohai 'reload' do
+        plugin 'ipaddress'
+        action :reload
+      end
+      ```
 
-        Reload Ohai after a new user is created
+      Reload Ohai after a new user is created
 
-        ```ruby
-        ohai 'reload_passwd' do
-          action :nothing
-          plugin 'etc'
-        end
+      ```ruby
+      ohai 'reload_passwd' do
+        action :nothing
+        plugin 'etc'
+      end
 
-        user 'daemon_user' do
-          home '/dev/null'
-          shell '/sbin/nologin'
-          system true
-          notifies :reload, 'ohai[reload_passwd]', :immediately
-        end
+      user 'daemon_user' do
+        home '/dev/null'
+        shell '/sbin/nologin'
+        system true
+        notifies :reload, 'ohai[reload_passwd]', :immediately
+      end
 
-        ruby_block 'just an example' do
-          block do
-            # These variables will now have the new values
-            puts node['etc']['passwd']['daemon_user']['uid']
-            puts node['etc']['passwd']['daemon_user']['gid']
-          end
+      ruby_block 'just an example' do
+        block do
+          # These variables will now have the new values
+          puts node['etc']['passwd']['daemon_user']['uid']
+          puts node['etc']['passwd']['daemon_user']['gid']
         end
-        ```
+      end
+      ```
       DOC
 
       property :plugin, String,
@@ -88,9 +89,8 @@ class Chef
           # This ensures that cookbook-provided Ohai plugins are available
           # when the resource reloads Ohai data
           ohai_plugin_path = Chef::Config[:ohai_segment_plugin_path]
-          if ohai_plugin_path && Dir.exist?(ohai_plugin_path) && !Dir.empty?(ohai_plugin_path)
+          if ohai_plugin_path && Dir.exist?(ohai_plugin_path) && !Dir.empty?(ohai_plugin_path) && ohai.config[:plugin_path]
             # Configure Ohai to load plugins from the cookbook segment path
-            ohai.config[:plugin_path] ||= ::Ohai.config[:plugin_path]
             ohai.config[:plugin_path] << ohai_plugin_path
             logger.trace("Added cookbook plugin path to ohai: #{ohai_plugin_path}")
           end
@@ -101,6 +101,7 @@ class Chef
           # the path are picked up by ohai.
           ohai.all_plugins new_resource.plugin
           node.automatic_attrs.merge! ohai.data
+          node.fix_automatic_attributes
           logger.info("#{new_resource} reloaded")
         end
       end

data/lib/chef/resource/ohai_hint.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -21,42 +21,43 @@ class Chef
   class Resource
     class OhaiHint < Chef::Resource
 
-      provides(:ohai_hint) { true }
+      provides(:ohai_hint, target_mode: true) { true }
+      target_mode support: :full
 
       description "Use the **ohai_hint** resource to aid in configuration detection by passing hint data to Ohai."
       introduced "14.0"
       examples <<~DOC
-        **Create a hint file**
+      **Create a hint file**
 
-        ```ruby
-        ohai_hint 'example' do
-          content a: 'test_content'
-        end
-        ```
+      ```ruby
+      ohai_hint 'example' do
+        content a: 'test_content'
+      end
+      ```
 
-        **Create a hint file with a name that does not match the resource name**
+      **Create a hint file with a name that does not match the resource name**
 
-        ```ruby
-        ohai_hint 'example' do
-          hint_name 'custom'
-        end
-        ```
+      ```ruby
+      ohai_hint 'example' do
+        hint_name 'custom'
+      end
+      ```
 
-        **Create a hint file that is not loaded at compile time**
+      **Create a hint file that is not loaded at compile time**
 
-        ```ruby
-        ohai_hint 'example' do
-          compile_time false
-        end
-        ```
+      ```ruby
+      ohai_hint 'example' do
+        compile_time false
+      end
+      ```
 
-        **Delete a hint file**
+      **Delete a hint file**
 
-        ```ruby
-        ohai_hint 'example' do
-          action :delete
-        end
-        ```
+      ```ruby
+      ohai_hint 'example' do
+        action :delete
+      end
+      ```
       DOC
 
       property :hint_name, String,

data/lib/chef/resource/openbsd_package.rb

@@ -2,7 +2,7 @@
 # Authors:: AJ Christensen (<aj@chef.io>)
 #           Richard Manyanza (<liseki@nyikacraftsmen.com>)
 #           Scott Bonds (<scott@ggr.com>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # Copyright:: Copyright 2014-2016, Richard Manyanza, Scott Bonds
 # License:: Apache License, Version 2.0
 #
@@ -25,8 +25,9 @@ require_relative "../provider/package/openbsd"
 class Chef
   class Resource
     class OpenbsdPackage < Chef::Resource::Package
-      provides :openbsd_package
-      provides :package, os: "openbsd"
+      provides :openbsd_package, target_mode: true
+      provides :package, os: "openbsd", target_mode: true
+      target_mode support: :full
 
       description "Use the **openbsd_package** resource to manage packages for the OpenBSD platform."
       introduced "12.1"

data/lib/chef/resource/openssl_dhparam.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

data/lib/chef/resource/openssl_ec_private_key.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # Author:: Julien Huon
 # License:: Apache License, Version 2.0
 #
@@ -60,7 +60,7 @@ class Chef
         description: "The desired curve of the generated key (if key_type is equal to 'ec'). Run openssl ecparam -list_curves to see available options.",
         default: "prime256v1"
 
-      property :key_pass, String, sensitive: true,
+      property :key_pass, String,
         description: "The desired passphrase for the key."
 
       property :key_cipher, String,

data/lib/chef/resource/openssl_ec_public_key.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # Author:: Julien Huon
 # License:: Apache License, Version 2.0
 #
@@ -56,10 +56,10 @@ class Chef
       property :private_key_path, String,
         description: "The path to the private key file."
 
-      property :private_key_content, String, sensitive: true,
+      property :private_key_content, String,
         description: "The content of the private key including new lines. This property is used in place of private_key_path in instances where you want to avoid having to first write the private key to disk"
 
-      property :private_key_pass, String, sensitive: true,
+      property :private_key_pass, String,
         description: "The passphrase of the provided private key."
 
       property :owner, [String, Integer],

data/lib/chef/resource/openssl_rsa_private_key.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -59,7 +59,7 @@ class Chef
         description: "The desired bit length of the generated key.",
         default: 2048
 
-      property :key_pass, String, sensitive: true,
+      property :key_pass, String,
         description: "The desired passphrase for the key."
 
       property :key_cipher, String,

data/lib/chef/resource/openssl_rsa_public_key.rb

@@ -1,5 +1,5 @@
 #
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -57,10 +57,10 @@ class Chef
       property :private_key_path, String,
         description: "The path to the private key file."
 
-      property :private_key_content, String, sensitive: true,
+      property :private_key_content, String,
         description: "The content of the private key, including new lines. This property is used in place of private_key_path in instances where you want to avoid having to first write the private key to disk."
 
-      property :private_key_pass, String, sensitive: true,
+      property :private_key_pass, String,
         description: "The passphrase of the provided private key."
 
       property :owner, [String, Integer],

data/lib/chef/resource/openssl_x509_certificate.rb

@@ -1,7 +1,7 @@
 #
 # License:: Apache License, Version 2.0
 # Author:: Julien Huon
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -115,7 +115,7 @@ class Chef
       property :key_file, String,
         description: "The path to a certificate key file on the filesystem. If the key_file property is specified, the resource will attempt to source a key from this location. If no key file is found, the resource will generate a new key file at this location. If the key_file property is not specified, the resource will generate a key file in the same directory as the generated certificate, with the same name as the generated certificate."
 
-      property :key_pass, String, sensitive: true,
+      property :key_pass, String,
         description: "The passphrase for an existing key's passphrase."
 
       property :key_type, String,
@@ -212,13 +212,17 @@ class Chef
         end
 
         def subject
+          if new_resource.common_name.nil? && new_resource.subject_alt_name.empty?
+            Chef.deprecated(:common_name_and_subject_alt_name_empty, "According to RFC5280 subsection 4.1.2.6, certificates must have one of a common_name or a subject_alt_name entry. Neither common_name nor subject_alt_name specified, one is required.")
+          end
+
           OpenSSL::X509::Name.new.tap do |csr_subject|
             csr_subject.add_entry("C", new_resource.country) unless new_resource.country.nil?
             csr_subject.add_entry("ST", new_resource.state) unless new_resource.state.nil?
             csr_subject.add_entry("L", new_resource.city) unless new_resource.city.nil?
             csr_subject.add_entry("O", new_resource.org) unless new_resource.org.nil?
             csr_subject.add_entry("OU", new_resource.org_unit) unless new_resource.org_unit.nil?
-            csr_subject.add_entry("CN", new_resource.common_name)
+            csr_subject.add_entry("CN", new_resource.common_name) unless new_resource.common_name.nil?
             csr_subject.add_entry("emailAddress", new_resource.email) unless new_resource.email.nil?
           end
         end

data/lib/chef/resource/openssl_x509_crl.rb

@@ -1,7 +1,7 @@
 #
 # License:: Apache License, Version 2.0
 # Author:: Julien Huon
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -29,24 +29,24 @@ class Chef
       description "Use the **openssl_x509_crl** resource to generate PEM-formatted x509 certificate revocation list (CRL) files."
       introduced "14.4"
       examples <<~DOC
-        **Create a certificate revocation file**
+      **Create a certificate revocation file**
 
-        ```ruby
-        openssl_x509_crl '/etc/ssl_test/my_ca.crl' do
-          ca_cert_file '/etc/ssl_test/my_ca.crt'
-          ca_key_file '/etc/ssl_test/my_ca.key'
-        end
-        ```
+      ```ruby
+      openssl_x509_crl '/etc/ssl_test/my_ca.crl' do
+        ca_cert_file '/etc/ssl_test/my_ca.crt'
+        ca_key_file '/etc/ssl_test/my_ca.key'
+      end
+      ```
 
-        **Create a certificate revocation file for a particular serial**
+      **Create a certificate revocation file for a particular serial**
 
-        ```ruby
-        openssl_x509_crl '/etc/ssl_test/my_ca.crl' do
-          ca_cert_file '/etc/ssl_test/my_ca.crt'
-          ca_key_file '/etc/ssl_test/my_ca.key'
-          serial_to_revoke C7BCB6602A2E4251EF4E2827A228CB52BC0CEA2F
-        end
-        ```
+      ```ruby
+      openssl_x509_crl '/etc/ssl_test/my_ca.crl' do
+        ca_cert_file '/etc/ssl_test/my_ca.crt'
+        ca_key_file '/etc/ssl_test/my_ca.key'
+        serial_to_revoke C7BCB6602A2E4251EF4E2827A228CB52BC0CEA2F
+      end
+      ```
       DOC
 
       property :path, String,

data/lib/chef/resource/openssl_x509_request.rb

@@ -1,7 +1,7 @@
 #
 # License:: Apache License, Version 2.0
 # Author:: Julien Huon
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -66,7 +66,7 @@ class Chef
       DOC
 
       property :path, String, name_property: true,
-        description: "An optional property for specifying the path to write the file to if it differs from the resource block's name."
+               description: "An optional property for specifying the path to write the file to if it differs from the resource block's name."
 
       property :owner, [String, Integer],
         description: "The owner applied to all files created by the resource."
@@ -102,7 +102,7 @@ class Chef
       property :key_file, String,
         description: "The path to a certificate key file on the filesystem. If the `key_file` property is specified, the resource will attempt to source a key from this location. If no key file is found, the resource will generate a new key file at this location. If the `key_file` property is not specified, the resource will generate a key file in the same directory as the generated certificate, with the same name as the generated certificate."
 
-      property :key_pass, String, sensitive: true,
+      property :key_pass, String,
         description: "The passphrase for an existing key's passphrase."
 
       property :key_type, String,

data/lib/chef/resource/package.rb

@@ -1,7 +1,7 @@
 #
 # Author:: Adam Jacob (<adam@chef.io>)
 # Author:: Tyler Cloke (<tyler@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +22,8 @@ require_relative "../resource"
 class Chef
   class Resource
     class Package < Chef::Resource
-      provides :package
+      provides :package, target_mode: true
+      target_mode support: :full
 
       description "Use the **package** resource to manage packages. When the package is" \
                   " installed from a local file (such as with RubyGems, dpkg, or RPM" \
@@ -61,7 +62,7 @@ class Chef
         desired_state: false
 
       property :environment, Hash,
-        introduced: "18.8",
+        introduced: "19.0",
         description: "A Hash of environment variables in the form of {'ENV_VARIABLE' => 'VALUE'} to be set before running the command.",
         desired_state: false
 

data/lib/chef/resource/pacman_package.rb

@@ -22,7 +22,8 @@ class Chef
   class Resource
     class PacmanPackage < Chef::Resource::Package
 
-      provides :pacman_package
+      provides :pacman_package, target_mode: true
+      target_mode support: :full
 
       allowed_actions :install, :upgrade, :remove, :purge
 

data/lib/chef/resource/paludis_package.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Vasiliy Tolstov (<v.tolstov@selfip.ru>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -23,7 +23,8 @@ class Chef
   class Resource
     class PaludisPackage < Chef::Resource::Package
 
-      provides :paludis_package
+      provides :paludis_package, target_mode: true
+      target_mode support: :full
 
       description "Use the **paludis_package** resource to manage packages for the Paludis platform."
       introduced "12.1"

data/lib/chef/resource/perl.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Adam Jacob (<adam@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +22,8 @@ class Chef
   class Resource
     class Perl < Chef::Resource::Script
 
-      provides :perl
+      provides :perl, target_mode: true
+      target_mode support: :full
 
       def initialize(name, run_context = nil)
         super

data/lib/chef/resource/plist.rb

@@ -1,6 +1,6 @@
 #
 # Copyright:: Copyright 2017-2020, Microsoft Corporation
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -59,9 +59,9 @@ class Chef
       DEFAULTS_EXECUTABLE = "/usr/bin/defaults".freeze
       PLUTIL_EXECUTABLE = "/usr/bin/plutil".freeze
       PLUTIL_FORMAT_MAP = { "us-ascii" => "xml1",
-                            "text/xml" => "xml1",
-                            "utf-8" => "xml1",
-                            "binary" => "binary1" }.freeze
+                             "text/xml" => "xml1",
+                             "utf-8" => "xml1",
+                             "binary" => "binary1" }.freeze
 
       load_current_value do |new_resource|
         current_value_does_not_exist! unless ::File.exist? new_resource.path

data/lib/chef/resource/portage_package.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Adam Jacob (<adam@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -22,7 +22,8 @@ class Chef
   class Resource
     class PortagePackage < Chef::Resource::Package
 
-      provides :portage_package
+      provides :portage_package, target_mode: true
+      target_mode support: :full
 
       description "Use the **portage_package** resource to manage packages for the Gentoo platform."
 

data/lib/chef/resource/powershell_package.rb

@@ -1,5 +1,5 @@
 # Author:: Dheeraj Dubey(dheeraj.dubey@msystechnologies.com)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

data/lib/chef/resource/powershell_package_source.rb

@@ -143,7 +143,7 @@ class Chef
         introduced: "17.6",
         description: "A username that, as part of a credential object, is used to register a repository or other package source with."
 
-      property :password, String, sensitive: true,
+      property :password, String,
         introduced: "17.6",
         description: "A password that, as part of a credential object, is used to register a repository or other package source with."
 
@@ -239,17 +239,17 @@ class Chef
 
         def get_package_source_details
           powershell_exec! <<~EOH
-            $package_details = Get-PackageSource -Name '#{new_resource.source_name}' -ErrorAction SilentlyContinue
-            if ($package_details.ProviderName -match "PowerShellGet"){
-              return "PSRepository"
-            }
-            elseif ($package_details.ProviderName ) {
-              return "PackageSource"
-            }
-            elseif ($null -eq $package_details)
-            {
-              return "Unregistered"
-            }
+              $package_details = Get-PackageSource -Name '#{new_resource.source_name}' -ErrorAction SilentlyContinue
+              if ($package_details.ProviderName -match "PowerShellGet"){
+                return "PSRepository"
+              }
+              elseif ($package_details.ProviderName ) {
+                return "PackageSource"
+              }
+              elseif ($null -eq $package_details)
+              {
+                return "Unregistered"
+              }
           EOH
         end
 

data/lib/chef/resource/powershell_script.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Adam Edwards (<adamed@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

data/lib/chef/resource/python.rb

@@ -1,5 +1,5 @@
 # Author:: Adam Jacob (<adam@chef.io>)
-# Copyright:: Copyright (c) Chef Software Inc.
+# Copyright:: Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -21,7 +21,8 @@ class Chef
   class Resource
     class Python < Chef::Resource::Script
 
-      provides :python
+      provides :python, target_mode: true
+      target_mode support: :full
 
       def initialize(name, run_context = nil)
         super

data/lib/chef/resource/reboot.rb

@@ -1,6 +1,6 @@
 #
 # Author:: Chris Doherty <cdoherty@chef.io>)
-# Copyright:: Copyright 2014-2019, Chef, Inc.
+# Copyright (c) 2009-2026 Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -23,7 +23,8 @@ class Chef
   class Resource
     class Reboot < Chef::Resource
 
-      provides :reboot
+      provides :reboot, target_mode: true
+      target_mode support: :full
 
       description "Use the **reboot** resource to reboot a node, a necessary step with some" \
                   " installations on certain platforms. This resource is supported for use on" \