Creating and Managing Customers
This topic describes how to create and manage customers in the Replicated vendor portal. For more information about customer licenses, see About Customers.
Create a Customer
This procedure describes how to create a new customer in the vendor portal. You can edit customer details at any time in the vendor portal by going to the Customer details for a customer. For more information, see Customer Details Page in About Customers.
To create a customer:
In the vendor portal, click Customers > Create customer.
The Create a new customer page opens:
For Customer name, enter a name for the customer.
For Customer email, enter the email address for the customer. The customer email address is required for Helm installations. This email address is never used send emails to customers.
For Assigned channel, assign the customer to one of your channels. You can select any channel that has at least one release. The channel a customer is assigned to determines the application releases that they can install. For more information, see Channel Assignment in About Customers.note
You can change the channel a customer is assigned at any time. For installations with Replicated KOTS, when you change the customer's channel, the customer can synchronize their license in the Replicated admin console to fetch the latest release on the new channel and then upgrade. The admin console always fetches the latest release on the new channel, regardless of the presence of any releases on the channel that are marked as required.
For Expiration policy, by default, Customer's license does not expire is enabled. To set an expiration date for the license, enable Customer's license has an expiration date and specify an expiration date in the When does this customer expire? calendar.
For Customer type, set the customer type. Customer type is used only for reporting purposes. Customer access to your application is not affected by the type you assign to them. By default, Trial is selected. For more information, see About Customer License Types.
(KOTS Only) In the License options pane, configure any of the built-in KOTS entitlements that you support in your application. For more information, see Built-in License Fields.
The available license options are:
Name Description KOTS Install Enabled Enables customers to install with Replicated KOTS. Airgap Download Enabled Enables new installations with this license to install from an air gap package or from an online installation. Gitops Enabled Enables existing cluster and embedded cluster installations to transition to a GitOps workflow for deployment. Identity Service Enabled Enables customers to integrate with third-party identity service providers to provision RBAC for authenticating to the admin console. Support Bundle Upload Enabled Enables installations to upload support bundles directly from the admin console. Allow Snapshot Enables customers to create snapshots for backup and restore. Vendors must also add a Backup custom resource. See Velero Backup Custom Resource.
(Optional) For Custom fields, configure any custom fields that are available for your Replicated application. For more information about how to create custom fields for your application, see Managing Custom License Fields.
Click Save Changes.
Edit a Customer
You can edit the built-in and custom license fields for a customer at any time.
Replicated recommends that you test any licenses changes in a development environment. If needed, install the application using a developer license matching the current customer's entitlements before editing the developer license. Then validate the updated license.
For online environments, changing license entitlements can trigger changes to the customer's installed application instance during runtime. Replicated recommends that you verify the logic your application uses to query and enforce the target entitlement before making any changes.
To edit license fields:
In the vendor portal, click Customers.
Select the target customer and click the Customer details tab.
On the Customer details page, edit the desired fields and click Save.
Test the changes by installing or updating in a development environment. Do one of the following, depending on the installation method for your application:
- For applications installed with Helm that use the Replicated SDK, you can add logic to your application to enforce entitlements before installation or during runtime using the Replicated SDK API license endpoints. See Checking Entitlements for Helm Installations (Beta).
- For applications installed with Replicated KOTS, update the license in the admin console. See Update Online Licenses and Update Air Gap Licenses in Updating Licenses.
Archive a Customer
When you archive a customer in the vendor portal, the customer is hidden from search by default and becomes read-only. Archival does not affect the utility of license files downloaded before the customer was archived.
To expire a license, set an expiration date and policy in the Expiration policy field before you archive the customer.
To archive a customer:
In the vendor portal, click Customers. Select the target customer then click the Customer details tab.
Click Archive Customer. In the confirmation dialog, click Archive Customer again.
You can unarchive by clicking Unarchive Customer in the customer's Customer details page.
Export Customer and Instance Data
You can download customer and instance data from the Download CSV dropdown on the Customers page:
Customer data includes details about your customers, such as the customer's channel assignment, license entitlements, expiration date, last active timestamp, and more.
Instance data includes details about the instances assoicated with each customer, such as the Kubernetes distribution and cloud provider of the cluster where the instance is running, the most recent application instance status, if the instance is active or inactive, and more.
You can also export customer instance data as JSON using the Vendor API v3
customer_instances endpoint. For more information, see Get customer instance report in CSV or JSON format in the Vendor API v3 documentation.
For more information about the data fields in the CSV downloads, see Data Dictionary in Export Customers and Instance Data.
Filter and Search Customers
The Customers page provides a search box and filters that help you find customers:
You can filter customers based on whether they are active, by license type, and by channel name. You can filter using more than one criteria, such as Active, Paid, and Stable. However, you can select only one license type and one channel at a time.
If you want to filter information using multiple license types or channels, you can download a CSV file instead. For more information, see Export Customer and Instance Data above.