blob: 9885cbe3d6d7ede6cf60e791867c7573ae0f3363 (
plain)
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
|
<!--
~ Copyright (c) 2023-2024 Arista Networks, Inc.
~ Use of this source code is governed by the Apache License 2.0
~ that can be found in the LICENSE file.
-->
# ANTA Requirements
## Python version
Python 3 (`>=3.8`) is required:
```bash
python --version
Python 3.9.9
```
## Install ANTA package
This installation will deploy tests collection, scripts and all their Python requirements.
The ANTA package and the cli require some packages that are not part of the Python standard library. They are indicated in the [pyproject.toml](https://github.com/arista-netdevops-community/anta/blob/main/pyproject.toml) file, under dependencies.
### Install from Pypi server
```bash
pip install anta
```
### Install ANTA from github
```bash
pip install git+https://github.com/arista-netdevops-community/anta.git
# You can even specify the branch, tag or commit:
pip install git+https://github.com/arista-netdevops-community/anta.git@<cool-feature-branch>
pip install git+https://github.com/arista-netdevops-community/anta.git@<cool-tag>
pip install git+https://github.com/arista-netdevops-community/anta.git@<more-or-less-cool-hash>
```
### Check installation
After installing ANTA, verify the installation with the following commands:
```bash
# Check ANTA has been installed in your python path
pip list | grep anta
# Check scripts are in your $PATH
# Path may differ but it means CLI is in your path
which anta
/home/tom/.pyenv/shims/anta
```
!!! warning
Before running the `anta --version` command, please be aware that some users have reported issues related to the `urllib3` package. If you encounter an error at this step, please refer to our [FAQ](faq.md) page for guidance on resolving it.
```bash
# Check ANTA version
anta --version
anta, version v0.13.0
```
## EOS Requirements
To get ANTA working, the targetted Arista EOS devices must have the following configuration (assuming you connect to the device using Management interface in MGMT VRF):
```eos
configure
!
vrf instance MGMT
!
interface Management1
description oob_management
vrf MGMT
ip address 10.73.1.105/24
!
end
```
Enable eAPI on the MGMT vrf:
```eos
configure
!
management api http-commands
protocol https port 443
no shutdown
vrf MGMT
no shutdown
!
end
```
Now the swicth accepts on port 443 in the MGMT VRF HTTPS requests containing a list of CLI commands.
Run these EOS commands to verify:
```eos
show management http-server
show management api http-commands
```
|
