Skip to content

SingleStore.md

Latest commit

 

History

History
105 lines (63 loc) · 8.31 KB

SingleStore.md

File metadata and controls

105 lines (63 loc) · 8.31 KB

SAS Viya Support for SingleStore

The SAS Viya platform provides an optional integration with SingleStore. SingleStore is a cloud-native database that is designed for data-intensive applications. A distributed, relational SQL database management system that features ANSI SQL support, SingleStore is known for speed in data ingest, transaction processing, and query processing.

Requirements for SAS SpeedyStore

If your SAS software order includes SAS SpeedyStore, additional requirements apply to your deployment. The SAS Viya Platform Operations Guide provides detailed information about requirements for a SingleStore-enabled deployment of the SAS Viya platform.

Deploying SAS SpeedyStore Using SAS Viya 4 Deployment

You can deploy SAS SpeedyStore into a Kubernetes cluster in the following environments:

  • Azure Kubernetes Service (AKS) in Microsoft Azure
  • Elastic Kubernetes Service (EKS) in Amazon Web Services (AWS)
  • Open Source Kubernetes on your own machines

Cluster Provisioning for SAS SpeedyStore

Azure Kubernetes Service (AKS) Cluster in Microsoft Azure

The SAS Viya 4 IaC for Microsoft Azure GitHub project can automatically provision the required infrastructure components that support SAS SpeedyStore deployments. Refer to the SingleStore sample input file for Terraform configuration values that create an AKS cluster that is suitable for deploying the SAS Viya platform and SingleStore.

EKS Cluster in AWS

The SAS Viya 4 IaC for AWS GitHub project can automatically provision the required infrastructure components that support SAS SpeedyStore deployments. Refer to the SingleStore sample input file for Terraform configuration values that create an EKS cluster that is suitable for deploying the SAS Viya platform and SingleStore.

Open Source Kubernetes Cluster

The SAS Viya 4 Infrastructure as Code (IaC) for Open Source Kubernetes GitHub project can automatically provision the required infrastructure components that support SAS SpeedyStore deployments. Refer to the SingleStore sample input file for Terraform configuration values that create an Open Source Kubernetes cluster that is suitable for deploying the SAS Viya platform and SingleStore.

Customizing SingleStore Deployment Overlays

Choose the appropriate section below based on the cadence version of the SAS Viya platform and SingleStore that you are deploying.

SAS SpeedyStore orders at stable:2023.10 and later

Refer to the viya4-deployment Getting Started and SAS Viya Platform Customizations documentation if you need information about how to make changes to your deployment by adding custom overlays into subdirectories under the site-config directory.

After running viya4-deployment with the setting DEPLOY=false in your ansible-vars.yaml file, locate the sas-bases directory, which is a peer to the site-config directory underneath your SAS Viya platform deployment's <base_dir>.

Complete each step under the "SingleStore Cluster Definition" heading in the "SAS SingleStore Cluster Operator" README file in order to configure your SAS SpeedyStore deployment, noting the following exceptions. The README file is located at $deploy/sas-bases/examples/sas-singlestore/README.md (for Markdown format) or at $deploy/sas-bases/docs/sas_singlestore_cluster_operator.htm (for HTML format).

  • Complete steps 1 and 2 in the "SAS SingleStore Cluster Operator" README file.

  • After you complete step 2, complete these additional steps 2a, 2b, 2c, and 2d:

    2a. Create the $deploy/site-config/sas-singlestore/component subdirectory.

    2b. Copy the $deploy/sas-bases/components/sas-singlestore/ subdirectory into the $deploy/site-config/sas-singlestore/component/ subdirectory.

    2c. Create the $deploy/site-config/sas-singlestore/examples subdirectory.

    2d. Move the sas-singlestore-secret.yaml file and the kustomization.yaml file located in the $deploy/site-config/sas-singlestore subdirectory to the $deploy/site-config/sas-singlestore/examples subdirectory.

  • Complete steps 3 and 4 in the "SAS SingleStore Cluster Operator" README file.

  • Skip step 5 in the "SAS SingleStore Cluster Operator" README file. The viya4-deployment playbook will automatically add the SingleStore component and the overlays to the base kustomization.yaml file in the final step.

  • In step 6 of the "SAS SingleStore Cluster Operator" README file, if you do NOT want to override the cluster OS configuration, continue to the next step. If you do want to override the cluster OS configuration, copy the $deploy/sas-bases/examples/sas-singlestore-osconfig/sas-singlestore-osconfig.yaml file to the $deploy/site-config/sas-singlestore subdirectory. Refer to the "SAS SingleStore Cluster OS Configuration" README file for additional guidance. The "SAS SingleStore Cluster OS Configuration" README file is located at $deploy/sas-bases/examples/sas-singlestore-osconfig/README.md (for Markdown format) or at $deploy/sas-bases/docs/sas_singlestore_cluster_os_configuration.htm (for HTML format).

    The contents of your $deploy/site-config/sas-singlestore subdirectory should now look like this:

.
├── component/sas-singlestore
│   ├── kustomization.yaml
│   ├── kustomizeconfig.yaml
│   ├── sas-singlestore-cluster.yaml
│   ├── secret.yaml
│   └── transformers.yaml
├── examples
│   ├── kustomization.yaml
│   └── sas-singlestore-secret.yaml
├── README.md
├── sas-singlestore-cluster-config.yaml
└── sas-singlestore-osconfig.yaml           (present only if you did NOT skip step 6 above)

  • Set DEPLOY=true in your ansible-vars.yaml file.

  • Run viya4-deployment with the "viya, install" tags to deploy SAS SpeedyStore into your cluster.

SAS SpeedyStore orders at LTS:2023.03 and earlier

Refer to the viya4-deployment Getting Started and SAS Viya Platform Customizations documentation if you need information about how to make changes to your deployment by adding custom overlays into subdirectories under the /site-config directory.

After running viya4-deployment with the setting DEPLOY=false in your ansible-vars.yaml file, locate the sas-bases directory, which is a peer to the site-config directory underneath your SAS Viya platform deployment's <base_dir>.

Complete each step under the "SingleStore Cluster Definition" heading in the "SAS SingleStore Cluster Operator" README file in order to configure your SAS SpeedyStore deployment, noting the following exceptions. The README file is located at $deploy/sas-bases/examples/sas-singlestore/README.md (for Markdown format) or at $deploy/sas-bases/docs/sas_singlestore_cluster_operator.htm (for HTML format).

  • Complete steps 1 and 2 in the sas-bases/examples/sas-singlestore/README.md file.

  • Complete Step 2a below:

    2a. Copy $deploy/sas-bases/components/sas-singlestore into the $deploy/site-config/sas-singlestore/components directory.

  • Complete steps 3 and 4 in the "SAS SingleStore Cluster Operator" README file.

  • Skip step 5 in the "SAS SingleStore Cluster Operator" README file. The viya4-deployment playbook will automatically add the SingleStore component and the overlays to the base kustomization.yaml file that you have copied to the site-config directory in the final step.

  • Complete the remaining steps from the "SAS SingleStore Cluster Operator" README file. Then set DEPLOY=true in your ansible-vars.yaml file.

  • Run viya4-deployment with the "viya, install" tags to deploy SAS SpeedyStore into your cluster.