Accessing the Service Mesh Manager binaries

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

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

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

  1. Visit the Service Mesh Manager 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 Service Mesh Manager 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.
  7. 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.

  1. 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

  2. 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
    
  3. Download the Service Mesh Manager CLI by running:

    oras pull registry.eticloud.io/smm/smm-cli:v1.10.0
    
  4. Extract the archive for your operating system.

  5. 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” 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 SMM version

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.