# Start Orchestrator
###### tags: `Tesis` `Python`
[TOC]
---


## Quick Start
### Step 1: Provision the AGW VM
```
HOST [magma]$ echo "* 192.168.0.0/16" | sudo tee -a /etc/vbox/networks.conf
HOST [magma]$ echo "* 3001::/64" | sudo tee -a /etc/vbox/networks.conf
HOST [magma]$ cd lte/gateway
HOST [magma/lte/gateway]$ vagrant up magma
```
### Step 2: Build Orchastrator
```
HOST [magma]$ cd orc8r/cloud/docker
HOST [magma/orc8r/cloud/docker]$ ./build.py --all
```

### Step 3: start Orchastrator
this command is to run the docker and docker-compose programe, make sure you have installed docker and docker-compose, run this command to check docker:
```
docker version
```

```
docker compose version
```

```
docker-compose version
```

```
HOST [magma/orc8r/cloud/docker]$ ./run.py
```

```
HOST [magma/orc8r/cloud/docker]$ ./run.py --metrics
```

if have permision isue try to run in root by use `su` command.
---
### Step 4: Check certs and import to browser
```
ls ../../../.cache/test_certs
```

```
HOST [magma/orc8r/cloud/docker] sudo chown ${USER}:${USER} ../../../.cache/test_certs/admin_operator.key.pem
HOST [magma/orc8r/cloud/docker] sudo chown ${USER}:${USER} ../../../.cache/test_certs/admin_operator.pfx
```

then:
If you're using GNOME desktop environment, you can use nautilus command:
```
HOST [magma/orc8r/cloud/docker]$ nautilus ../../../.cache/test_certs
```

If you're using macOS, you can use open command:
```
HOST [magma/orc8r/cloud/docker]$ open ../../../.cache/test_certs
```
If you use Firefox, you'll have to import this .pfx file into your browser's installed client certificates. See [here](https://support.globalsign.com/customer/en/portal/articles/1211486-install-client-digital-certificate---firefox-for-windows) for instructions.

After starting the Orchestrator with HOST `[magma/orc8r/cloud/docker]$ ./run.py` and importing `admin_operator.pfx`, you should be able to visit the Swagger UI at https://localhost:9443/swagger/v1/ui.

### Reference
* https://magma.github.io/magma/docs/basics/quick_start_guide
* https://magmacore.org/blog/magma-installation-on-ubuntu-20-04/