Skip to main content
Version: 3.9
Features and pricing

How to install Scalar products through AWS Marketplace

Scalar products (ScalarDB, ScalarDL, and their tools) are available in the AWS Marketplace as container images. This guide explains how to install Scalar products through the AWS Marketplace.

note
  • Some Scalar products are available under commercial licenses, and the AWS Marketplace provides those products as pay-as-you-go (PAYG) pricing. When you use pay-as-you-go pricing, AWS will charge you the Scalar product license fee based on your usage.
  • Previously, a bring-your-own-license (BYOL) option was offered in the AWS Marketplace. However, that option has been deprecated and removed, so it is no longer supported in the AWS Marketplace.
  • A BYOL option is provided in the following public container repositories outside of the AWS Marketplace. If you don't have a license key, please contact us.

Subscribe to Scalar products from AWS Marketplace​

  1. Select your Scalar product to see the links to the AWS Marketplace.

    Select your edition of ScalarDB Enterprise.

    PAYGBYOL (Deprecated)
    ScalarDB ClusterScalarDB Cluster

  2. Select Continue to Subscribe.

  3. Sign in to AWS Marketplace using your IAM user. If you have already signed in, this step will be skipped automatically.

  4. Read the Terms and Conditions and select Accept Terms. It takes some time. When it's done, you can see the current date in the Effective date column. Also, you can see our products on the Manage subscriptions page of AWS Console.

[Pay-As-You-Go] Deploy containers on EKS (Amazon Elastic Kubernetes Service) from AWS Marketplace using Scalar Helm Charts​

By subscribing to Scalar products in the AWS Marketplace, you can pull the container images of Scalar products from the private container registry (ECR) of the AWS Marketplace. This section explains how to deploy Scalar products with pay-as-you-go pricing in your EKS cluster from the private container registry.

  1. Create an OIDC provider.

    You must create an identity and access management (IAM) OpenID Connect (OIDC) provider to run the AWS Marketplace Metering Service from ScalarDL pods.

    eksctl utils associate-iam-oidc-provider --region <REGION> --cluster <EKS_CLUSTER_NAME> --approve

    For details, see Creating an IAM OIDC provider for your cluster.

  2. Create a service account.

    To allow your pods to run the AWS Marketplace Metering Service, you can use IAM roles for service accounts.

    eksctl create iamserviceaccount \
        --name <SERVICE_ACCOUNT_NAME> \
        --namespace <NAMESPACE> \
        --region <REGION> \
        --cluster <EKS_CLUSTER_NAME> \
        --attach-policy-arn arn:aws:iam::aws:policy/AWSMarketplaceMeteringFullAccess \
        --approve \
        --override-existing-serviceaccounts

  3. Update the custom values file of the Helm Chart for the Scalar product that you want to install. You need to specify the private container registry (ECR) of the AWS Marketplace as the value for [].image.repository in the custom values file. You also need to specify the service account name that you created in the previous step as the value for [].serviceAccount.serviceAccountName and set [].serviceAccount.automountServiceAccountToken to true. See the following examples based on the product you're using.

    Select your edition of ScalarDB Enterprise.

    In the scalardb-cluster-standard-custom-values.yaml file:

    scalardbCluster:
      image:
        repository: "709825985650.dkr.ecr.us-east-1.amazonaws.com/scalar/scalardb-cluster-node-aws-payg-standard"
      serviceAccount:
        serviceAccountName: "<SERVICE_ACCOUNT_NAME>"
        automountServiceAccountToken: true
    note

    For more details on the configurations, see Configure a custom values file for ScalarDB Cluster.

  4. Deploy Scalar products by using Helm Charts in conjunction with the above custom values files. See the following examples based on the product you're using.

    Select your edition of ScalarDB Enterprise.

    helm install scalardb-cluster-standard scalar-labs/scalardb-cluster -f scalardb-cluster-standard-custom-values.yaml

[Deprecated] [BYOL] Deploy containers on EKS (Amazon Elastic Kubernetes Service) from AWS Marketplace using Scalar Helm Charts​

By subscribing to Scalar products in the AWS Marketplace, you can pull the container images of Scalar products from the private container registry (ECR) of the AWS Marketplace. This section explains how to deploy Scalar products with the BYOL option in your EKS cluster from the private container registry.

  1. Update the custom values file of the Helm Chart for the Scalar product that you want to install. You need to specify the private container registry (ECR) of AWS Marketplace as the value of [].image.repository in the custom values file. See the following examples based on the product you're using.

    scalardbCluster:
      image:
        repository: "709825985650.dkr.ecr.us-east-1.amazonaws.com/scalar/scalardb-cluster-node-aws-byol"
    note

    For more details on the configurations, see Configure a custom values file for ScalarDB Cluster.

  2. Deploy the Scalar products using the Helm Chart with the above custom values files. See the following examples based on the product you're using. See the following examples based on the product you're using.

    helm install scalardb-cluster scalar-labs/scalardb-cluster -f scalardb-cluster-custom-values.yaml

[Deprecated] [BYOL] Deploy containers on Kubernetes other than EKS from AWS Marketplace using Scalar Helm Charts​

  1. Install the aws command according to the AWS Official Document (Installing or updating the latest version of the AWS CLI).

  2. Configure the AWS CLI with your credentials according to the AWS Official Document (Configuration basics).

  3. Create a reg-ecr-mp-secrets secret resource for pulling the container images from the ECR of AWS Marketplace.

    kubectl create secret docker-registry reg-ecr-mp-secrets \
      --docker-server=709825985650.dkr.ecr.us-east-1.amazonaws.com \
      --docker-username=AWS \
      --docker-password=$(aws ecr get-login-password --region us-east-1)

  4. Update the custom values file of the Helm Chart for the Scalar product that you want to install. You need to specify the private container registry (ECR) of AWS Marketplace as the value of [].image.repository in the custom values file. Also, you need to specify the reg-ecr-mp-secrets as the value of [].imagePullSecrets. See the following examples based on the product you're using.

    scalardbCluster:
      image:
        repository: "709825985650.dkr.ecr.us-east-1.amazonaws.com/scalar/scalardb-cluster-node-aws-byol"
      imagePullSecrets:
        - name: "reg-ecr-mp-secrets"
    note

    For more details on the configurations, see Configure a custom values file for ScalarDB Cluster.

  5. Deploy the Scalar products using the Helm Chart with the above custom values files.

    • Examples Please refer to the [Deprecated] [BYOL] Deploy containers on EKS (Amazon Elastic Kubernetes Service) from AWS Marketplace using Scalar Helm Charts section of this document.