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.
Download the CLI
- Visit the Service Mesh Manager 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 Service Mesh Manager 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,
smmfor Service Mesh Manager, and
supertubesfor 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>'
<your-username> parts contain the access credentials to the registries.
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
operator reconcile command for the next time, the Kubernetes cluster will be automatically updated to use the new access credentials.