open-service-mesh-binary.md

title	description	services	ms.topic	ms.date	ms.author	zone_pivot_groups
Download the OSM client Library	Download and configure the Open Service Mesh (OSM) client library	container-service	article	8/26/2021	pgibson	client-operating-system

Download and configure the Open Service Mesh (OSM) client library

This article will discuss how to download the OSM client library to be used to operate and configure the OSM add-on for AKS, and how to configure the binary for your environment.

::: zone pivot="client-operating-system-linux"

[!INCLUDE Linux - download and install client binary]

::: zone-end

::: zone pivot="client-operating-system-macos"

[!INCLUDE macOS - download and install client binary]

::: zone-end

::: zone pivot="client-operating-system-windows"

[!INCLUDE Windows - download and install client binary]

::: zone-end

Warning

Do not attempt to install OSM from the binary using osm install. This will result in a installation of OSM that is not integrated as an add-on for AKS.

Configure OSM CLI variables with an OSM_CONFIG file

Users can override the default OSM CLI configuration to enhance the add-on experience. This can be done by creating a config file, similar to kubeconfig. The config file can be either created at $HOME/.osm/config.yaml, or at a different path that is exported using the OSM_CONFIG environment variable.

The file must contain the following YAML formatted content:

install:
  kind: managed
  distribution: AKS
  namespace: kube-system

If the file is not created at $HOME/.osm/config.yaml, remember to set the OSM_CONFIG environment variable to point to the path where the config file is created.

After setting OSM_CONFIG, the output of the osm env command should be the following:

$ osm env
---
install:
  kind: managed
  distribution: AKS
  namespace: kube-system