_errands.html.md.erb

Errands are scripts that run at designated points during an installation.  

To configure which post-deploy and pre-delete errands run for 
Tanzu Kubernetes Grid Integrated Edition:

1. Make a selection in the dropdown next to each errand.  
<% if current_page.data.iaas == "vSphere-NSX-T" %>
    <p class="note"><strong>Note</strong>: We recommend that you use the 
    default settings for all errands except for the <strong>NSX validation</strong> 
    and <strong>Run smoke tests</strong> errands.
    </p> 
<% else %>
    <p class="note"><strong>Note</strong>: We recommend that you use the 
    	default settings for all errands except for the **Run smoke tests** errand.
    </p> 
<% end %>
<% if current_page.data.iaas == "vSphere-NSX-T" %>
1. (Optional) Set the **NSX validation** errand to **On**.  

    This errand verifies the NSX objects.
<% end %>
1. (Optional) Set the **Run smoke tests** errand to **On**.  

    The Smoke Test errand smoke tests the TKGI upgrade by creating and deleting a test Kubernetes cluster. 
    If test cluster creation or deletion fails, the errand fails, and the installation of the 
    TKGI tile halts.  
    
<% if current_page.data.iaas == "vSphere-NSX-T" %>
    The errand uses the TKGI CLI to create the test cluster configured using either 
    the configuration settings on the TKGI tile - the default, or a network profile.  

1. (Optional) To configure the Smoke Test errand to use a network profile instead of the default configuration settings on the TKGI tile:  

    * Create a network profile with your preferred smoke test settings.  
    * Configure **Errand Settings** > **Smoke tests - Network Profile Name** with the network profile name.  
    
    <img src="images/nsxt/upgrade-smoke-test-network-profile-config.png" alt="Smoke Test cluster network profile assignment in the Smoke tests - Network Profile Name field.">
<% else %>
    The errand uses the TKGI CLI to create the test cluster configured using 
    the configuration settings on the TKGI tile.  
<% end %>

1. (Optional) To ensure that all of your cluster VMs are patched, 
    configure the **Upgrade all clusters errand** errand to **On**.  
<br>
    Updating the Tanzu Kubernetes Grid Integrated Edition tile with a new 
	Linux stemcell and the **Upgrade all clusters errand** enabled 
	triggers the rolling of every Linux VM in each Kubernetes cluster. 
	Similarly, updating the Tanzu Kubernetes Grid Integrated Edition tile with a new Windows stemcell triggers 
	the rolling of every Windows VM in your Kubernetes clusters.  
    <p class="note"><strong>Note:</strong> <%= vars.recommended_by %> recommends that you 
    review the Broadcom Support metadata and confirm stemcell version compatibility before using 
    the Broadcom Support APIs to update the stemcells in your automated pipeline. 
    See <a href="https://knowledge.broadcom.com/external/article?articleNumber=371876">Retrieve Product Version Compatibilities from the Tanzu API</a> in the Broadcom Support KB.
    </p>