Accessing the Service Mesh Manager binaries

To evaluate Service Mesh Manager we recommend using the free tier option.

If you don’t already have a Cisco Customer Identity (CCI) account, you’ll also have to complete a brief sign-up procedure.

To access the CLI binaries, you can either download it from the Service Mesh Manager download page or from registry.eticloud.io using ORAS.

Download the CLI

Visit the Calisti download center.
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.
Once you have logged in, navigate to the Calisti download center again.
Read and accept the End-User License Agreement (EULA).
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.
Extract the archive. The archive contains two binaries, smm for Service Mesh Manager, and supertubes for Streaming Data Manager.
Navigate to the directory where you have extracted the CLI.

Download the CLI using ORAS

To install the Service Mesh Manager CLI using ORAS, complete the following steps.

Install OCI Registry As Storage (ORAS). For details, see the ORAS installation guide for your operating system. For example, on macOS you can run brew install oras
Log in to registry.eticloud.io using ORAS. You can find your credentials and the activation command on the Service Mesh Manager download page. (If you haven’t registered yet, sign up on the Service Mesh Manager page).

Run the following command to log in, then enter your username and password.
```
oras login registry.eticloud.io
```

Download the Service Mesh Manager CLI by running:

oras pull registry.eticloud.io/smm/smm-cli:v1.11.0

To manage Apache Kafka installations using Streaming Data Manager, download the Streaming Data Manager command-line tool (called supertubes-cli) as well.
```
oras pull registry.eticloud.io/sdm/supertubes-cli:v1.11.0
```
Extract the archive for your operating system.
Navigate to the directory where you have extracted the CLI.

Activate the CLI

Due to legal requirements the docker images for Service Mesh Manager are stored in a docker registry requiring authentication. Service Mesh Manager has built-in support for transparently performing this authentication. For this feature to work you must “activate” the CLI on every workstation that will be used to install, upgrade, or change the Service Mesh Manager deployment. For using the dashboard or any other CLI command this activation step can be skipped.

You can find your credentials and the activation command on the Service Mesh Manager download page.

Open a terminal and login to the image registries of Service Mesh Manager by running:

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

Where the <your-password> and <your-username> parts contain the access credentials to the registries.

After the activation, you can install Service Mesh Manager on a single cluster or multiple clusters, or manage an existing installation.

Upgrading an already activated 1.8.x SMM

In case your local 1.8.x CLI is already activated using the ECR repositories (the old activate command is still available as activate-ecr command), feel free to continue using the existing ECR repositories, they will remain supported.

If you’d like to start using the new repositories, execute the activate command as shown above. That updates the local environment to rely on the new repositories. When you use the install or operator reconcile command for the next time, the Kubernetes cluster will be automatically updated to use the new access credentials.