Install SDM from the command line

This guide shows you how to install Streaming Data Manager using from the command line.

• For other installation methods, see Installation.
• To quickly test Calisti, see Getting started with the Free Tier.

Prerequisites

Before deploying Streaming Data Manager on your cluster, complete the prerequisites.

Preparation

To access and install Calisti, complete the following steps.

1. You’ll need a Cisco Customer account to download Calisti. If you don’t already have one here’s how to sign up:

   1. Visit the Cisco Account registration page and complete the registration form.
   2. Look out for an email from no-reply@mail-id.cisco.com titled Activate Account and click on the Activate Account button to activate your account.

2. Download the Calisti command-line tools.

   1. Visit the Calisti download center.
   2. If you’re redirected to the home page, check the upper right-hand corner to see if you’re signed in. If you see a login button go ahead and login using your Cisco Customer account credentials. If, instead, you see “welcome, ” then you are already logged in.
   3. Once you have logged in, navigate to the Calisti download center again.
   4. Read and accept the End-User License Agreement (EULA).
   5. Download the Service Mesh Manager command-line tool (CLI) suitable for your system. The CLI supports macOS and Linux (x86_64). On Windows, install the Windows Subsystem for Linux (WSL) and use the Linux binary.
   6. Extract the archive. The archive contains two binaries, smm for Service Mesh Manager, and supertubes for Streaming Data Manager.
   7. Navigate to the directory where you have extracted the CLI.

   Note: For information on how to download the CLI using ORAS, see Download the CLI using ORAS.

3. The Calisti download page shows your credentials that you can use to access the Service Mesh Manager and Streaming Data Manager docker images.

   Open a terminal and login to the image registries of Calisti by running the following command. The <your-password> and <your-username> parts contain the access credentials to the registries.

   SMM_REGISTRY_PASSWORD=<your-password> ./smm activate \
     --host=registry.eticloud.io \
     --prefix=smm \
     --user='<your-username>'
   

Install Streaming Data Manager

1. Run the following command. This will install the main Service Mesh Manager and Streaming Data Manager components.

   • On Kubernetes:

     smm install -a --install-sdm
     

   • On OpenShift (for details, see OpenShift integration):

     smm install -a --install-sdm --platform=openshift
     

   Note: If you are installing Service Mesh Manager on a managed Kubernetes solution of a public cloud provider (for example, Amazon EKS, AKS, or GKE) or kOps, the cluster name auto-discovered by Service Mesh Manager is incompatible with Kubernetes resource naming restrictions and Istio’s method of identifying clusters in a multicluster mesh.

   In earlier Service Mesh Manager versions, you had to manually use the --cluster-name parameter to set a cluster name that complies with the RFC 1123 DNS subdomain/label format (alphanumeric string without “_” or “.” characters). Starting with Service Mesh Manager version 1.11, non-compliant names are automatically converted using the following rules:

   • Replace ‘_’ characters with ‘-’
   • Replace ‘.’ characters with ‘-’
   • Replace ‘:’ characters with ‘-’
   • Truncate the name to 63 characters

   Calisti supports KUBECONFIG contexts having the following authentication methods:

   • certfile and keyfile
   • certdata and keydata
   • bearer token
   • exec/auth provider

   Username-password pairs are not supported.

   If you are installing Streaming Data Manager in a test environment, you can install it without requiring authentication by running:

   smm install --install-sdm --anonymous-auth -a
   

   If you experience errors during the installation, try running the installation in verbose mode: smm install -v

   Note: the smm install -a --install-sdm command assumes that there is a default storage class available on the cluster, to provision the needed volumes. If your Kubernetes environment doesn’t have a default storage class, then the CRs deployed by Streaming Data Manager must be adjusted in order to work in your environment. In that case, request a demo and describe your use case so we can guide you through the configuration details as part of the demo.

2. Wait until the installation is completed. This can take a few minutes.

3. Deploy a broker that can receive messages from your producers. If you have installed the demo application you can skip this step, because the demo application automatically creates brokers for you. For details on deploying brokers, see Create Kafka cluster.

4. Run the following command to open the dashboard. If you don’t already have Istio or Kafka workload and traffic, the dashboard will be empty.

   smm dashboard
   

   

Next steps

• If you already have Kafka brokers outside Calisti, you can migrate them into Calisti.
• If you want to install a simple demo application that generates Kafka traffic, see Recommendations demo application.