edits

paigecalvert · paigecalvert · commit a064b326ee1a · 2024-10-09T13:31:14.000-06:00
diff --git a/docs/enterprise/installing-existing-cluster-automation.mdx b/docs/enterprise/installing-existing-cluster-automation.mdx
@@ -45,19 +45,19 @@ For a tutorial that demonstrates how to install a sample application using the K
 
 ## Limitation
 
-Replicated Embedded Cluster does not support headless installations with the KOTS CLI. 
+[Replicated Embedded Cluster](/vendor/embedded-overview) does not support automated, or _headless_, installations with the KOTS CLI. 
 
-## Prerequisite
+## Prerequisites
 
-Create a ConfigValues file to define the configuration settings for the application. For air gap environments, ensure that you can access the ConfigValues file that you create from your installation environment.
+* Create a ConfigValues YAML file to define the configuration settings for the application. For air gap environments, ensure that you can access the ConfigValues file that you create from your installation environment. 
 
-**Example:**
+    A ConfigValues file includes the names of the configuration fields for the application along with a user-supplied `value` for each field. The ConfigValues file is specific to the application. For more information, see [Sharing a ConfigValues File](/vendor/releases-configvalues).
 
-<ConfigValuesExample/>
+    **Example:**
 
-As shown in the example above, the ConfigValues file includes the names of the configuration fields for the application along with a user-supplied `value` for each field.
+    <ConfigValuesExample/>   
 
-The ConfigValues file is specific to the application. For more information, see [Sharing a ConfigValues File](/vendor/releases-configvalues).
+* (Air Gap Only) For air gap installations, ensure that the **Airgap Download Enabled** option is enabled for the license that will be used to install.
    
 ## Install
 
@@ -116,7 +116,7 @@ To install with kURL on a VM or bare metal server:
 
 ### Air Gap Existing Cluster 
 
-Air gap installations in existing clusters require the application `.airgap` bundle and the KOTS Admin Console `kotsadm.tar.gz` air gap bundle. Additionally, images for the application and the KOTS Admin Console must be pushed to a local private registry. For more information about downloading the necessary air gap bundles, see [Downloading Air Gap Bundles](/vendor/releases-download-airgap-bundles).
+Air gap installations in existing clusters require the application `.airgap` bundle and the KOTS Admin Console `kotsadm.tar.gz` air gap bundle. Additionally, images for the application and the KOTS Admin Console must be pushed to a local private registry.
 
 To install in an air gap existing cluster:
 
diff --git a/docs/partials/install/_automation-intro-embedded.mdx b/docs/partials/install/_automation-intro-embedded.mdx
@@ -1 +1 @@
-You can use Replicated kURL to provision a cluster and install an application on a VM or bare metal server. When you use the KOTS CLI to install an application in a kURL cluster, you first run the kURL installation script to provision the cluster and automatically install KOTS in the cluster. Then, you can run the `kots install` command to install the application.
+When you use the KOTS CLI to install an application in a kURL cluster, you first run the kURL installation script to provision the cluster and automatically install KOTS in the cluster. Then, you can run the `kots install` command to install the application.
diff --git a/docs/partials/install/_placeholder-airgap-bundle.mdx b/docs/partials/install/_placeholder-airgap-bundle.mdx
@@ -1 +1 @@
-* `PATH_TO_AIRGAP_BUNDLE` with the path to the application `.airgap` bundle. For information about downloading the `.airgap` bundle, see [Build and Download the Application Bundle](/vendor/releases-download-airgap-bundles#air-gap-bundle) in _Downloading Air Gap Bundles_.
+* `PATH_TO_AIRGAP_BUNDLE` with the path to the `.airgap` bundle for the application release. For information about building and downloading air gap bundles with the Vendor API v3, see [Trigger airgap build for a channel's release](https://replicated-vendor-api.readme.io/reference/channelreleaseairgapbuild) and [Get airgap bundle download URL for the active release on the channel](https://replicated-vendor-api.readme.io/reference/channelreleaseairgapbundleurl) in the Vendor API v3 documentation.
diff --git a/docs/partials/install/_placeholders-global.mdx b/docs/partials/install/_placeholders-global.mdx
@@ -2,6 +2,6 @@
 
 * `PASSWORD` with a shared password for accessing the Admin Console.
 
-* `PATH_TO_LICENSE` with the path to your license file.
+* `PATH_TO_LICENSE` with the path to your license file. See [Downloading Customer Licenses](/vendor/licenses-download). For information about how to download licenses with the Vendor API v3, see [Download a customer license file as YAML](https://replicated-vendor-api.readme.io/reference/downloadlicense) in the Vendor API v3 documentation.
 
-* `PATH_TO_CONFIGVALUES` with the path to the ConfigValues file.
+* `PATH_TO_CONFIGVALUES` with the path to the ConfigValues file. See [Generating a ConfigValues File](/vendor/releases-configvalues).
diff --git a/docs/vendor/releases-share-download-portal.md b/docs/vendor/releases-share-download-portal.md
@@ -2,42 +2,53 @@ import DownloadPortal from "../partials/kots/_download-portal-about.mdx"
 
 # Downloading Release Assets from the Download Portal
 
-This topic describes how to share customer license files, air gap bundles, and other assets with customers through the Replicated download portal.
+This topic describes how to download customer license files, air gap bundles, and other assets from the Replicated Download Portal.
+
+For information about downloading release assets with the Vendor API v3, see the following pages in the Vendor API v3 documentation:
+* [Download a customer license file as YAML](https://replicated-vendor-api.readme.io/reference/downloadlicense)
+* [Trigger airgap build for a channel's release](https://replicated-vendor-api.readme.io/reference/channelreleaseairgapbuild)
+* [Get airgap bundle download URL for the active release on the channel](https://replicated-vendor-api.readme.io/reference/channelreleaseairgapbundleurl)
 
 ## Overview
 
 <DownloadPortal/>
 
-The most common use case for the download portal is for customers installing into air gap environments who must download both their license file as well as multiple air gap bundles. In this case, the download portal makes it easy for customers to find and download the correct KOTS admin console or kURL air gap bundle based on the selected application version to ensure compatibility.
+The most common use case for the Download Portal is for customers installing into air gap environments who need to download both their license file as well as multiple air gap bundles.
 
-The following is an example of the download portal for an air gap customer installing in their own existing cluster:
+The following is an example of the Download Portal for an air gap customer installing in their own existing cluster:
 
-![download portal for existing cluster air gap installs](/images/download-portal-existing-cluster.png)
+![Download Portal for existing cluster air gap installs](/images/download-portal-existing-cluster.png)
 
 [View a larger version of this image](/images/download-portal-existing-cluster.png)
 
-The following is an example of the download portal for an air gap customer installing in an embedded cluster with kURL:
+## Limitation
 
-![download portal for kURL air gap installs](/images/download-portal-kurl.png)
+Release assets for [Replicated Embedded Cluster](/vendor/embedded-overview) are not available for download in the Download Portal.
 
-[View a larger version of this image](/images/download-portal-kurl.png)
+## Download Assets from the Download Portal
 
-### Limitation
+To log in to the Download Portal and download release assets:
 
-Air gap bundles for the Replicated Embedded Cluster installer are not available in the Download Portal.
+1. In the [Vendor Portal](https://vendor.replicated.com), on the **Customers** page, click on the name of the customer.
 
-## Get the Customer-Specific Download Portal URL and Password
+1. (Optional) On the **Manage customer** tab, enable the **Airgap Download Enabled** option. This makes air gap bundles available in the Download Portal.
 
-To share installation files with a customer, you can send the customer their unique link and password for the download portal.
+   ![airgap download enabled license option](/images/airgap-download-enabled.png)
 
-To get the URL and generate a password for the download portal:
+   [View a larger version of this image](/images/airgap-download-enabled.png)
 
-1. In the [Vendor Portal](https://vendor.replicated.com), on the **Customers** page, click on the name of the customer.
+1. On the **Reporting** tab, in the **Download portal** section, click **Manage customer password**.
 
-1. (Optional) On the **Manage customer** page, enable the **Airgap Download Enabled** option. This makes air gap bundles available in the Download Portal.
+   ![download portal section](/images/download-portal-link.png)
+
+   [View a larger version of this image](/images/download-portal-link.png)
 
 1. In the pop-up window, enter a password or click **Generate**.
 
+   ![download portal password pop-up](/images/download-portal-password-popup.png)
+
+   [View a larger version of this image](/images/download-portal-password-popup.png)
+
 1. Click **Copy** to copy the password to your clipboard.
 
    After the password is saved, it cannot be retrieved again. If you lose the password, you can generate a new one.
@@ -47,29 +58,26 @@ To get the URL and generate a password for the download portal:
 1. Click **Visit download portal** to log in to the Download Portal
 and preview your customer's experience.
 
-    The following is an example of the download portal for an air gap customer:
-
-    ![download portal for existing cluster air gap installs](/images/download-portal-existing-cluster.png)
-
-    [View a larger version of this image](/images/download-portal-existing-cluster.png)
-
    :::note
    By default, the Download Portal uses the domain `get.replicated.com`. You can optionally use a custom domain for the Download Portal. For more information, see [Using Custom Domains](/vendor/custom-domains-using).
    :::
 
-1. Send the URL and password for the Download Portal to your customer.
+1. In the Download Portal, on the left side of the screen, select one of the following:
+     * **Bring my own cluster**: View the downloadable assets for existing cluster installations with KOTS.
+     * **Embedded cluster**:  View the downloadable assets for Replicated kURL installations.
 
-## Download Assets from the Download Portal {#download-portal}
+     :::note
+     Release assets for [Replicated Embedded Cluster](/vendor/embedded-overview) are not available for download in the Download Portal.
+     :::
 
-Users can download release assets, including air gap bundles and their licenses, from the Download Portal.
+     The following is an example of the Download Portal for an air gap customer:
 
-To download release assets from the Download Portal:
+     ![download portal for existing cluster air gap installs](/images/download-portal-existing-cluster.png)
 
+     [View a larger version of this image](/images/download-portal-existing-cluster.png)
 
-1. On the left side of the screen, select one of the following:
-     * **Bring my own cluster**: View the air gap bundles for existing cluster installations with KOTS.
-     * **Embedded cluster**: View the air gap bundles for kURL installations.
+1. Under **Select application version**, use the dropdown to select the target application release version. The Download Portal automatically makes the correct air gap bundles available for download based on the selected application version.
 
-1. Under **Select application version**, use the dropdown to select the target application release version. The download portal automatically makes the correct air gap bundles available for download based on the selected application version.
+1. Click the download button to download each asset.   
 
-1. Click the download button to download each asset.
+1. To share installation files with a customer, send the customer their unique link and password for the Download Portal.
diff --git a/sidebars.js b/sidebars.js
@@ -249,7 +249,6 @@ const sidebars = {
                   'vendor/admin-console-customize-config-screen',
                   'vendor/config-screen-map-inputs',
                   'vendor/config-screen-conditional',
-                  'vendor/releases-configvalues',
                   {
                     type: 'category',
                     label: 'Tutorial: Set Helm Chart Values with KOTS',
@@ -353,7 +352,7 @@ const sidebars = {
               },
               {
                 type: 'category',
-                label: 'Installing in Existing Clusters',
+                label: 'Installing in Existing Clusters with KOTS',
                 items: [
                   'enterprise/installing-existing-cluster',
                   'enterprise/installing-existing-cluster-airgapped',
@@ -368,7 +367,15 @@ const sidebars = {
                   'enterprise/cluster-management-add-nodes',
                 ],
               },
-              'enterprise/installing-existing-cluster-automation',
+              {
+                type: 'category',
+                label: 'Installing with the KOTS CLI',
+                items: [
+                  'enterprise/installing-existing-cluster-automation',
+                  'vendor/releases-configvalues',
+                ],
+              },
+              
               'enterprise/installing-stateful-component-requirements',
             ],
           },
diff --git a/static/images/download-portal-link.png b/static/images/download-portal-link.png
diff --git a/static/images/download-portal-password-popup.png b/static/images/download-portal-password-popup.png

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		-You can use Replicated kURL to provision a cluster and install an application on a VM or bare metal server. When you use the KOTS CLI to install an application in a kURL cluster, you first run the kURL installation script to provision the cluster and automatically install KOTS in the cluster. Then, you can run the `kots install` command to install the application.
	`1`	+When you use the KOTS CLI to install an application in a kURL cluster, you first run the kURL installation script to provision the cluster and automatically install KOTS in the cluster. Then, you can run the `kots install` command to install the application.
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		-* `PATH_TO_AIRGAP_BUNDLE` with the path to the application `.airgap` bundle. For information about downloading the `.airgap` bundle, see [Build and Download the Application Bundle](/vendor/releases-download-airgap-bundles#air-gap-bundle) in _Downloading Air Gap Bundles_.
	`1`	+* `PATH_TO_AIRGAP_BUNDLE` with the path to the `.airgap` bundle for the application release. For information about building and downloading air gap bundles with the Vendor API v3, see [Trigger airgap build for a channel's release](https://replicated-vendor-api.readme.io/reference/channelreleaseairgapbuild) and [Get airgap bundle download URL for the active release on the channel](https://replicated-vendor-api.readme.io/reference/channelreleaseairgapbundleurl) in the Vendor API v3 documentation.