You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/vendor/customer-reporting.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -57,7 +57,7 @@ From the **Download portal** section, you can:
57
57
* Manage the password for the Download Portal
58
58
* Access the unique Download Portal URL for the customer
59
59
60
-
You can use the Download Portal to give your customers access to the files they need to install your application, such as their license file or air gap bundles. For more information, see [Downloading Assets from the Download Portal](releases-share-download-portal).
60
+
You can use the Download Portal to give your customers access to the files they need to install your application, such as their license file or air gap bundles. For more information, see [Accessing a Customer's Download Portal](releases-share-download-portal).
Copy file name to clipboardExpand all lines: docs/vendor/embedded-overview.mdx
-2
Original file line number
Diff line number
Diff line change
@@ -111,8 +111,6 @@ Embedded Cluster has the following limitations:
111
111
112
112
***Automatic updates not supported**: Configuring automatic updates from the Admin Console so that new versions are automatically deployed is not supported for Embedded Cluster installations. For more information, see [Configuring Automatic Updates](/enterprise/updating-apps).
113
113
114
-
***Embedded Cluster installation assets not available through the Download Portal**: The assets required to install with Embedded Cluster cannot be shared with users through the Download Portal. Users can follow the Embedded Cluster installation instructions to download and extract the installation assets. For more information, see [Online Installation with Embedded Cluster](/enterprise/installing-embedded).
115
-
116
114
***`minKotsVersion` and `targetKotsVersion` not supported**: The [`minKotsVersion`](/reference/custom-resource-application#minkotsversion-beta) and [`targetKotsVersion`](/reference/custom-resource-application#targetkotsversion) fields in the KOTS Application custom resource are not supported for Embedded Cluster installations. This is because each version of Embedded Cluster includes a particular version of KOTS. Setting `targetKotsVersion` or `minKotsVersion` to a version of KOTS that does not coincide with the version that is included in the specified version of Embedded Cluster will cause Embedded Cluster installations to fail with an error message like: `Error: This version of App Name requires a different version of KOTS from what you currently have installed`. To avoid installation failures, do not use targetKotsVersion or minKotsVersion in releases that support installation with Embedded Cluster.
117
115
118
116
***Support bundles over 100MB in the Admin Console**: Support bundles are stored in rqlite. Bundles over 100MB could cause rqlite to crash, causing errors in the installation. You can still generate a support bundle from the command line. For more information, see [Generating Support Bundles for Embedded Cluster](/vendor/support-bundle-embedded).
import DownloadPortal from "../partials/kots/_download-portal-about.mdx"
1
+
# Accessing a Customer's Download Portal
2
2
3
-
# Downloading Assets from the Download Portal
4
-
5
-
This topic describes how to download customer license files, air gap bundles, and other assets from the Replicated Download Portal.
3
+
This topic describes how to access installation instructions and download installation assets (such as customer license files and air gap bundles) from the Replicated Download Portal.
6
4
7
5
For information about downloading air gap bundles and licenses with the Vendor API v3, see the following pages in the Vendor API v3 documentation:
8
6
*[Download a customer license file as YAML](https://replicated-vendor-api.readme.io/reference/downloadlicense)
@@ -11,37 +9,39 @@ For information about downloading air gap bundles and licenses with the Vendor A
11
9
12
10
## Overview
13
11
14
-
<DownloadPortal/>
15
-
16
-
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.
12
+
The Replicated Download Portal can be used to share license files, air gap bundles, and other assets with customers. From the Download Portal, customers can also view instructions for how to install a release with Replicated Embedded Cluster or the Helm CLI.
17
13
18
-
The following is an example of the Download Portal for an air gap customer installing in their own existing cluster:
14
+
A unique Download Portal link is available for each customer. The Download Portal uses information from the customer's license to make the relevant assets and installation instructions available.
19
15
20
-

16
+
## Limitation
21
17
22
-
[View a larger version of this image](/images/download-portal-existing-cluster.png)
18
+
Sessions in the Download Portal are valid for 72 hours. After the session expires, your customer must log in again. The Download Portal session length is not configurable.
23
19
24
-
## Limitations
20
+
## Access the Download Portal
25
21
26
-
* Installation assets for [Replicated Embedded Cluster](/vendor/embedded-overview) are not available for download in the Download Portal.
22
+
To access the Download Portal for a customer:
27
23
28
-
* Sessions in the Download Portal are valid for 72 hours. After the session expires, your customer must log in again. The Download Portal session length is not configurable.
24
+
1. In the [Vendor Portal](https://vendor.replicated.com), on the **Customers** page, click on the name of the customer.
29
25
30
-
## Download Assets from the Download Portal
26
+
1. On the **Manage customer** tab, under **Install types**, enable the installation types that are supported for the customer. This determines the installation instructions and assets that are available for the customer in the Download Portal. For more information about install types, see [Managing Install Types for a License](/vendor/licenses-install-types).
31
27
32
-
To log in to the Download Portal and download assets:
1. In the [Vendor Portal](https://vendor.replicated.com), on the **Customers** page, click on the name of the customer.
30
+
[View a larger version of this image](/images/license-install-types.png)
35
31
36
-
1. (Optional) On the **Manage customer** tab, enable the **Airgap Download Enabled** option. This makes air gap bundles available in the Download Portal.
32
+
1. (Optional) Under **Advanced install options**, enable the air gap installation options that are supported for the customer:
33
+
* Enable **Helm CLI Air Gap Instructions (Helm CLI only)** to display Helm air gap installation instructions in the Download Portal for the customer.
34
+
* Enable **Air Gap Installation Option (Replicated Installers only)** to allow the customer to install from an air gap bundle using one of the Replicated installers (KOTS, kURL, Embedded Cluster).
[View a larger version of this image](/images/download-portal-link.png)
47
47
@@ -55,7 +55,7 @@ To log in to the Download Portal and download assets:
55
55
56
56
After the password is saved, it cannot be retrieved again. If you lose the password, you can generate a new one.
57
57
58
-
1. Click **Save** to set the password.
58
+
1. Click **Save** to set the password.
59
59
60
60
1. Click **Visit download portal** to log in to the Download Portal
61
61
and preview your customer's experience.
@@ -64,22 +64,12 @@ and preview your customer's experience.
64
64
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).
65
65
:::
66
66
67
-
1. In the Download Portal, on the left side of the screen, select one of the following:
68
-
***Bring my own Kubernetes**: View the downloadable assets for existing cluster installations with KOTS.
69
-
***Embedded Kubernetes**: View the downloadable assets for Replicated kURL installations.
70
-
71
-
:::note
72
-
Installation assets for [Replicated Embedded Cluster](/vendor/embedded-overview) are not available for download in the Download Portal.
73
-
:::
74
-
75
-
The following is an example of the Download Portal for an air gap customer:
76
-
77
-

67
+
1. In the Download Portal, on the left side of the screen, select the installation type. The options displayed vary depending on the **Install types** and **Advanced install options** that you enabled in the customer's license.
78
68
79
-
[View a larger version of this image](/images/download-portal-existing-cluster.png)
69
+
The following is an example of the Download Portal with options for Helm and Embedded Cluster installations:
80
70
81
-
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.
0 commit comments