1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
Install Troubleshooting
=======================
Before posting an issue, please review our list of [common issues](https://github.com/Azure/azure-cli/issues?q=label%3AFAQ+is%3Aclosed).
These are issues we have closed because we cannot address them within the CLI due to platform or language limitations.
lsb_release does not return the correct base distribution version
-----------------------------------------------------------------
Some Ubuntu- or Debian-derived distributions such as Linux Mint may not return the correct version name from `lsb_release`. This value is used in the install process to determine the package to install. If you know the code name of the Ubuntu or Debian version your distribution is derived from, you can set the `AZ_REPO` value manually when [adding the repository](https://learn.microsoft.com/cli/azure/install-azure-cli-linux?pivots=apt#lsb_release-doesnt-return-the-correct-base-distribution-version). Otherwise, look up information for your distribution on how to determine the base distribution code name and set `AZ_REPO` to the correct value.
No package for your Debian-based distribution
---------------------------------------------
Sometimes it may be a while after a distribution is released before there's an Azure CLI package available for it. The Azure CLI is designed to be resilient with regards to future versions of dependencies and rely on as few of them as possible. If there's no package available for your base distribution, try a package for an earlier distribution.
To do this, set the value of `AZ_REPO` manually when [adding the repository](https://learn.microsoft.com/cli/azure/install-azure-cli-linux?pivots=apt#no-package-for-your-distribution). For Ubuntu distributions use the `bionic` repository, and for Debian distributions
use `stretch`. Distributions released before Ubuntu Trusty and Debian Wheezy are not supported.
Install on RHEL 7.6 or other YUM-managed systems without Python 3
-----------------------------------------------------------------
If you can, please upgrade your system to a version with official support for `python3` package. Otherwise, you need to first install a `python3` package, either [build from source](https://github.com/linux-on-ibm-z/docs/wiki/Building-Python-3.6.x) or install through some [additional repo](https://developers.redhat.com/blog/install-python3-rhel). Then you can download the package and install it without dependency.
```bash
$ sudo yum install yum-utils
$ sudo yumdownloader azure-cli
$ sudo rpm -ivh --nodeps azure-cli-*.rpm
```
Install on SLES 12 or other other zypper-managed systems without Python 3.6
---------------------------------------------------------------------------
On SLES 12, the default `python3` package is 3.4 and not supported by Azure CLI. You can first build a higher version `python3` from source. Then you can download the Azure CLI package and install it without dependency.
```bash
$ sudo zypper install -y gcc gcc-c++ make ncurses patch wget tar zlib-devel zlib
# Download Python source code
$ PYTHON_VERSION="3.6.9"
$ PYTHON_SRC_DIR=$(mktemp -d)
$ wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
# Build Python
$ $PYTHON_SRC_DIR/*/configure --with-ssl
$ make
$ sudo make install
# Download azure-cli package
$ AZ_VERSION=$(zypper --no-refresh info azure-cli |grep Version | awk -F': ' '{print $2}' | awk '{$1=$1;print}')
$ wget https://packages.microsoft.com/yumrepos/azure-cli/azure-cli-$AZ_VERSION.x86_64.rpm
# Install without dependency
$ sudo rpm -ivh --nodeps azure-cli-$AZ_VERSION.x86_64.rpm
```
Completion is not working
-------------------------
#### MacOS
The Homebrew formula of Azure CLI installs a completion file named `az` in the Homebrew-managed completions directory (default location is `/usr/local/etc/bash_completion.d/`). To enable completion, please follow Homebrew's instructions [here](https://docs.brew.sh/Shell-Completion).
Upgrade from 0.1.0b10 causes 'KeyError: Azure' error
----------------------------------------------------
On Python 2, it's recommended to upgrade with the `--ignore-installed` flag:
`pip install --upgrade --ignore-installed azure-cli`.
Alternatively, use the interactive install script.
See [#1540](https://github.com/Azure/azure-cli/issues/1540#issue-195125878)
Error: 'Could not find a version that satisfies the requirement azure-cli'
--------------------------------------------------------------------------
The error message from pip usually means a very old version of pip is installed.
Run `pip --version` to confirm. [Latest pip version](https://pip.pypa.io/en/stable/news/)
Upgrade `pip` with ``$ pip install --upgrade pip`` or install with the ``--pre`` flag.
See [#1308](https://github.com/Azure/azure-cli/issues/1308#issuecomment-260413613)
'X509' object has no attribute '_x509'
--------------------------------------
If you run into an ``AttributeError: 'X509' object has no attribute '_x509'`` error, downgrade your version of the requests library from 2.12.1 to 2.11.1.
See [#1360](https://github.com/Azure/azure-cli/issues/1360)
Windows - 'FileNotFoundError' error on install
----------------------------------------------
Verify that the file path quoted in the error has more than 260 characters.
If so, the installation files exceed the 260 character limit for file paths on Windows.
This can be resolved by installing the CLI in a higher directory to prevent reaching the Windows max filepath length.
See [#1221](https://github.com/Azure/azure-cli/issues/1221#issuecomment-258290204)
Ubuntu 12.04 LTS - Known warning
--------------------------------
You may see the following warning message during install and execution of `az`.
```
/usr/local/az/envs/default/local/lib/python2.7/site-packages/pip/pep425tags.py:30: RuntimeWarning: invalid Python installation: unable to open /usr/az/envs/default/lib/python2.7/config/Makefile (No such file or directory)
warnings.warn("{0}".format(e), RuntimeWarning)
```
See [#348](https://github.com/Azure/azure-cli/issues/348)
See also [pypa/pip#1074](https://github.com/pypa/pip/issues/1074)
Errors with curl redirection
----------------------------
If you get an error with the curl command regarding the `-L` parameter or an error saying `Object Moved`, try using the full url instead of the aka.ms url:
```shell
# If you see this:
$ curl -L https://aka.ms/InstallAzureCli | bash
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 175 100 175 0 0 562 0 --:--:-- --:--:-- --:--:-- 560
bash: line 1: syntax error near unexpected token `<'
'ash: line 1: `<html><head><title>Object moved</title></head><body>
# Try this instead:
$ curl https://azurecliprod.blob.core.windows.net/install | bash
```
Errors on install with cffi or cryptography
-------------------------------------------
If you get errors on installation on **OS X**, upgrade pip by typing:
```shell
pip install --upgrade --force-reinstall pip
```
If you get errors on installation on **Fedora or CentOS** such as `No module named '_cffi_backend'`,
install `python3-cffi` by typing:
```shell
sudo yum install -y python3-cffi
```
If your system does not provide the `python3-cffi` RPM package, you can install the `cffi` package with `pip`:
```shell
sudo pip3 install cffi --target /usr/lib64/az/lib/python3.6/site-packages/
```
If you get errors on installation on **Debian or Ubuntu** such as the examples below,
install libssl-dev and libffi-dev by typing:
```shell
sudo apt-get update && sudo apt-get install -y libssl-dev libffi-dev
```
Also install Python Dev for your version of Python.
Python 2:
```shell
sudo apt-get install -y python-dev
```
Python 3:
```shell
sudo apt-get install -y python3-dev
```
Ubuntu 15 may require `build-essential` also:
```shell
sudo apt-get install -y build-essential
```
**Example Errors**
```shell
Downloading cffi-1.5.2.tar.gz (388kB)
100% |################################| 389kB 3.9MB/s
Complete output from command python setup.py egg_info:
No working compiler found, or bogus compiler options
passed to the compiler from Python's distutils module.
See the error messages above.
(If they are about -mno-fused-madd and you are on OS/X 10.8,
see http://stackoverflow.com/questions/22313407/ .)
----------------------------------------
Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-build-77i2fido/cffi/
```
```shell
#include <openssl/e_os2.h>
^
compilation terminated.
error: command 'x86_64-linux-gnu-gcc' failed with exit status 1
Failed building wheel for cryptography
```
See Stack Overflow question - [Failed to install Python Cryptography package with PIP and setup.py](http://stackoverflow.com/questions/22073516/failed-to-install-python-cryptography-package-with-pip-and-setup-py)
|
