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.

For information about creating a customer with the replicated CLI, see customer create.

For information about creating and managing customers with the Vendor API v3, see the customers section in the Vendor API v3 documentation.

To create a customer:

1. In the vendor portal, click Customers > Create customer.

   The Create a new customer page opens:

   

2. For Customer name, enter a name for the customer.

3. 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.

4. 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.

5. For Custom ID, you can enter a custom ID for the customer. Setting a custom ID allows you to easily tie this Replicated customer record to your own internal customer data systems during data exports. We suggest setting an alphanumeric value such as your Salesforce ID, Hubspot ID, etc for that customer. Replicated does not require the custom ID to be unique. The custom ID is for vendor data reconciliation purposes, and is not used by Replicated for any functionality purposes.

6. 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.

7. 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.

8. (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	important KOTS GitOps is a legacy feature and is not recommended for use. For modern enterprise customers that prefer software deployment processes that use CI/CD pipelines, Replicated recommends the Helm CLI installation method, which is more commonly used in these types of enterprise environments. Enables customers with a KOTS-managed installation to transition from click-to-deploy to a GitOps workflow for deployment. See Pushing Updates to a GitOps Workflow.
   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.

9. (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.

10. Click Save Changes.

Edit a Customer

You can edit the built-in and custom license fields for a customer at any time by going to the Manage customer for a customer. For more information, see Manage Customer Page in About Customers.

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.

important

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:

1. In the vendor portal, click Customers.

2. Select the target customer and click the Manage customer tab.

3. On the Manage customer page, edit the desired fields and click Save.

   

4. 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:

1. In the vendor portal, click Customers. Select the target customer then click the Manage customer tab.

2. Click Archive Customer. In the confirmation dialog, click Archive Customer again.

You can unarchive by clicking Unarchive Customer in the customer's Manage customer page.

Export Customer and Instance Data

You can download customer and instance data from the Download CSV dropdown on the Customers page:

View a larger version of this image

The Download CSV dropdown has the following options:

• Customers: Includes details about your customers, such as the customer's channel assignment, license entitlements, expiration date, last active timestamp, and more.

• (Recommended) Customers + Instances: 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. The Customers + Instances data is a super set of the customer data, and is the recommended download for most use cases.

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:

View a larger version of this image

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 there is adoption rate data available for the channel that you are filtering by, you can also filter by current version, previous version, and older versions.

You can also filter customers by custom ID or email address. To filter customers by custom ID or email, use the search box and prepend your search term with "customId:" (ex: customId:1234) or "email:" (ex: email:[email protected]).

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.