Adding magma orc8r onboarding guide

Signed-off-by: Gulsum Atici <gulsum.atici@canonical.com>

Hackfest_Demos/OSM-13/magma_orc_onboarding/README.md

+# Magma Orchestrator NS
+
+Descriptors that installs magma-orc8r using [Charmhub magma-orc8r bundle](https://charmhub.io/magma-orc8r?channel=beta)
+Orchestrator is a Magma service that provides a simple and consistent way to configure and monitor the wireless network securely.
+The metrics acquired through the platform allows you to see the analytics and traffic flows of the wireless users through the Magma web UI.
+For more information about Magma, see the official documentation [here](https://magmacore.org/).
+
+## Download Packages
+
+```bash
+git clone https://osm.etsi.org/gitlab/vnf-onboarding/osm-packages.git
+cd osm-packages/Hackfest_Demos/OSM-13/
+```
+
+## Create the VIM Account
+
+```bash
+# This is dummy vim account
+export VIM_ACCOUNT=k8s-vim
+osm vim-create --name $VIM_ACCOUNT \
+               --account_type dummy \
+               --user dummy \
+                --password dummy \
+                --auth_url "http://dummy" \
+                --tenant dummy
+# Check the VIM account availability
+osm vim-list
+osm vim-show $VIM_ACCOUNT
+```
+
+## Add K8s Cluster
+
+```bash
+# kubeconfig.yaml exists in the HOME directory
+export k8s_net=<K8s cluster network>  # osm-ext
+export k8s_cls_name=k8s-cluster
+osm k8scluster-add --creds ~/kubeconfig.yaml \
+                     --vim k8s-vim \
+                     --k8s-nets "{k8s_net: $k8s_net}" \
+                     --version 1.24  \
+                     $k8s_cls_name
+# Check K8s cluster availability
+osm k8scluster-list
+osm k8scluster-show $k8s_cls_name          
+```
+
+
+## Onboarding and instantiation
+
+```bash
+# Define the NS name
+export NS_NAME=<ns name>
+```
+
+```bash
+osm nfpkg-create magma_orc_cnf
+osm nspkg-create magma_orc_cnf
+osm ns-create --ns_name $NS_NAME --nsd_name magma_orc_cnf_ns --vim_account $VIM_ACCOUNT --config "{vld: [ {name: mgmtnet, vim-network-name: $k8s_net}]}"
+# Check NS status
+osm ns list
+```
+
+## Download the Admin Operator Https Certificate
+
+```bash
+juju scp --container="magma-orc8r-certifier" orc8r-certifier/0:/var/opt/magma/certs/admin_operator.pfx admin_operator.pfx
+# admin_operator.pfx file should appear in the local path
+```
+
+## Run Day2 actions
+
+### Get the Admin Operator Https Certificate credentials
+
+```bash
+OP_ID=`osm ns-action $NS_NAME --vnf_name magma_orc_cnf --kdu_name magma-orc-kdu --action_name get-pfx-package-password`
+osm ns-op-show $OP_ID
+# pfx_package pass appears in the operation output, please save it
+```
+
+### Get the Magma Orchestrator GUI credentials
+
+```bash
+OP_ID=`osm ns-action $NS_NAME --vnf_name magma_orc_cnf --kdu_name magma-orc-kdu --action_name get-master-admin-credentials`
+osm ns-op-show $OP_ID
+# admin-password and admin-username appear in the operation output, please save it
+```
+
+### Get Load Balancer Services
+
+```bash
+OP_ID=`osm ns-action $NS_NAME --vnf_name magma_orc_cnf --kdu_name magma-orc-kdu --action_name get-load-balancer-services`
+osm ns-op-show $OP_ID
+# Load Balancer service names and External IP's are visible in the action output.
+'nginx-proxy':              <nginx-proxy External IP>              ->   master.nms.osm.magma.com
+'orc8r-bootstrap-nginx':    <orc8r-bootstrap-nginx External IP>    ->   bootstrapper-controller.osm.magma.com
+'orc8r-clientcert-nginx':   <orc8r-clientcert-nginx External IP>   ->   controller.osm.magma.com
+'orc8r-nginx-proxy':        <orc8r-nginx-proxy External IP>        ->   api.osm.magma.com
+```
+
+### User a DNS server register following Domains
+
+```bash
+# Register the domains in PowerDNS server by running day2 actions:
+ZONE=osm.magma.com.
+# Sample registration for api.osm.magma.com
+DOMAIN=api.
+IP=<orc8r-nginx-proxy External IP> 
+# Test your records availability
+# DNS_IP is your DNS server ip which is available as an environment variable.
+dig @${DNS_IP} +tcp api.osm.magma.com
+```
+
+## Change the DNS Server in your machine
+
+```bash
+echo "nameserver ${DNS_IP}" | tee -a  /etc/resolv.conf
+```
+
+## Access to Magma Orchestrator GUI
+
+Open the browser and import the admin_operator.pfx using certificate import.
+
+When it asks you a password, please enter pfx_package pass.
+
+Try to reach following URL using your browser: https://master.nms.osm.magma.com.
+
+Use the admin-username and admin-password to login.
+
+