X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Finstallation-guide.rst;h=9b63c7c63778cb33ef8122ee531655fc85b92be7;hb=refs%2Fchanges%2F40%2F9340%2F1;hp=289a7cd499b92b2ad396f4dc456229d08f26b602;hpb=f5627e99aaba6380ecd57e497efc8fbafa1f2d86;p=pti%2Fo2.git diff --git a/docs/installation-guide.rst b/docs/installation-guide.rst index 289a7cd..9b63c7c 100644 --- a/docs/installation-guide.rst +++ b/docs/installation-guide.rst @@ -13,7 +13,7 @@ Installation Guide Abstract -------- -This document describes how to install O-RAN O2 service over O-RAN INF platform. +This document describes how to install INF O2 service over O-RAN INF platform. The audience of this document is assumed to have basic knowledge in kubernetes cli, helm chart cli. @@ -24,8 +24,8 @@ Preface Before starting the installation and deployment of O-RAN O2 service, you should have already deployed O-RAN INF platform, and you need to download the helm charts or build from source as described in developer-guide. -ORAN O2 Service in E Release -============================ +INF O2 Service in E Release +=========================== 1. Provision remote cli for kubernetes over INF platform -------------------------------------------------------- @@ -111,8 +111,8 @@ The following instruction should be done outside of INF platform controller host 2. Deploy INF O2 service ------------------------ -2.1 Retrieve Helm chart for deploying of O2 service -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +2.1 Retrieve Helm chart for deploying of INF O2 service +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. code:: shell @@ -135,6 +135,52 @@ The following instruction should be done outside of INF platform controller host export OS_USERNAME= export OS_PASSWORD= + # If the external OAM IP same as OS_AUTH_URL's IP address, you can use the below command to set the environment + # export API_HOST_EXTERNAL_FLOATING=$(echo ${OS_AUTH_URL} | sed -e s,`echo ${OS_AUTH_URL} | grep :// | sed -e's,^\(.*//\).*,\1,g'`,,g | cut -d/ -f1 | sed -e 's,:.*,,g') + export API_HOST_EXTERNAL_FLOATING= + + # please specify the smo service account yaml file + export SMO_SERVICEACCOUNT= + # service account and binding for smo yaml file + + cat <smo-serviceaccount.yaml + apiVersion: rbac.authorization.k8s.io/v1 + kind: Role + metadata: + namespace: default + name: pod-reader + rules: + - apiGroups: [""] # "" indicates the core API group + resources: ["pods"] + verbs: ["get", "watch", "list"] + --- + apiVersion: v1 + kind: ServiceAccount + metadata: + name: ${SMO_SERVICEACCOUNT} + namespace: default + --- + apiVersion: rbac.authorization.k8s.io/v1 + kind: RoleBinding + metadata: + name: read-pods + namespace: default + roleRef: + apiGroup: rbac.authorization.k8s.io + kind: Role + name: pod-reader + subjects: + - kind: ServiceAccount + name: ${SMO_SERVICEACCOUNT} + namespace: default + + EOF + + kubectl apply -f smo-serviceaccount.yaml + + #export the smo account token data + export SMO_TOKEN_DATA=$(kubectl -n default describe secret $(kubectl -n default get secret | grep ${SMO_SERVICEACCOUNT} | awk '{print $1}') | grep "token:" | awk '{print $2}') + cat <o2service-override.yaml o2ims: imagePullSecrets: admin-orano2-registry-secret @@ -149,6 +195,8 @@ The following instruction should be done outside of INF platform controller host OS_USERNAME: "${OS_USERNAME}" OS_PASSWORD: "${OS_PASSWORD}" K8S_KUBECONFIG: "/opt/k8s_kube.conf" + API_HOST_EXTERNAL_FLOATING: "${API_HOST_EXTERNAL_FLOATING}" + EOF @@ -159,8 +207,8 @@ The following instruction should be done outside of INF platform controller host helm install o2service o2/charts/ -f o2service-override.yaml helm list |grep o2service - kubectl -n ${NAMESPACE} get pods |grep o2service - kubectl -n ${NAMESPACE} get services |grep o2service + kubectl -n ${NAMESPACE} get pods |grep o2api + kubectl -n ${NAMESPACE} get services |grep o2api 2.4 Verify INF O2 service @@ -181,7 +229,8 @@ The following instruction should be done outside of INF platform controller host --------------------------------- - assumed you have setup SMO O2 endpoint for registration -- INF O2 service will post the O-Cloud registration data to that SMO O2 endpoint +- INF O2 service will post the INF platform registration data to that SMO O2 endpoint + .. code:: shell