Adding upstream version 0.13.0.upstream/0.13.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 105 insertions, 0 deletions

diff --git a/docs/requirements-and-installation.md b/docs/requirements-and-installation.md
new file mode 100644
index 0000000..9885cbe
--- /dev/null
+++ b/docs/requirements-and-installation.md
@@ -0,0 +1,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
+```