Quickstart Guide
Installation and Deployments
Kubernetes Installation
5 min
you can use kubernetes to install belden horizon data operations (bhdo) before you begin get access to a configured kubernetes cluster get access to persistentvolumeclaim (pvc) learn more about https //kubernetes io/docs/concepts/storage/persistent volumes/ from the kubernetes documentation get administrative permissions to run the kubectl command line tool contact your account representative to get access to the service account json file depending on the specific requirements of your environment, you may need to get access to a storage class learn more about https //kubernetes io/docs/concepts/storage/storage classes/ from the kubernetes documentation for full devicehub driver support, ensure your linux host kernel is version 6 or higher to use kubernetes to install belden horizon data operations , you will need to do the following step 1 launch a belden horizon data operations kubernetes step 2 log in to belden horizon data operations step 1 launch a bhdo edge kubernetes to launch a bhdo edge kubernetes 1\ download the service account json file, which you can get from your belden account representative 2 open a command prompt terminal (ctrl+r) 3 execute the following linux command to setup credentials for a kubernetes namespace kubectl create secret namespace bhdo prod docker registry bhdo credential docker server=us docker pkg dev docker username= json key docker password="$(cat /\<file name> json)" refer to the command parameters kubectl create secret sets a secret for use with a docker registry namespace bhdo prod sets up a kubernetes namespace of bhdo prod docker registry bhdo credential sets up secret name as bhdo credential this should not be changed docker server=us docker pkg dev sets the docker registry server as us docker pkg dev this should not be changed docker username= json key sets the docker registry username to connect to the server above this should not be changed docker password="$(cat /\<file name> json)" retrieves the password within the service account file requested from step 1 note bhdo prod should be changed to an isolated namespace to suit deployment best 4\ copy or download the following belden horizon data operations deployment file \# create serviceaccount apiversion v1 kind serviceaccount metadata name bhdo docker namespace bhdo prod labels app kubernetes io/name bhdo docker app kubernetes io/instance bhdo instance \ \# create pvc kind persistentvolumeclaim apiversion v1 metadata name bhdo data namespace bhdo prod labels app kubernetes io/name bhdo docker app kubernetes io/instance bhdo instance spec accessmodes \ "readwriteonce" resources requests storage "10g" \ \# create service apiversion v1 kind service metadata name bhdo docker namespace bhdo prod labels app kubernetes io/name bhdo docker app kubernetes io/instance bhdo instance spec type clusterip ports \ port 443 targetport https protocol tcp name https selector app kubernetes io/name bhdo docker app kubernetes io/instance bhdo instance \ \# create deployment apiversion apps/v1 kind deployment metadata name bhdo docker namespace bhdo prod labels app kubernetes io/name bhdo docker app kubernetes io/instance bhdo instance spec replicas 1 selector matchlabels app kubernetes io/name bhdo docker app kubernetes io/instance bhdo instance template metadata labels app kubernetes io/name bhdo docker app kubernetes io/instance bhdo instance spec serviceaccountname bhdo docker securitycontext {} imagepullsecrets \ name bhdo credential containers \ name bhdo docker securitycontext capabilities add \ net admin image "us docker pkg dev/litmus sales enablement/bhdo/bhdo std docker\ latest" imagepullpolicy ifnotpresent ports \ name https containerport 443 protocol tcp volumemounts \ mountpath /var mountpropagation name bhdo data subpath subpathexpr resources requests cpu 1 memory 1024mi limits cpu 4 memory 4096mi volumes \ name bhdo data persistentvolumeclaim claimname bhdo data 5\ execute the following command to deploy the belden horizon data operations kubernetes cluster using the deployment file from step 4 kubectl apply f bhdo deployment yaml namespace bhdo prod refer to the command parameters f bhdo deployment yaml uses the file bhdo deployment yaml for deployment this should not be changed namespace bhdo prod sets bhdo prod to be the deployment that kubernetes will use special and additional considerations belden horizon data operations can function in both single and multi kubernetes node clusters, and can support various networking modes your kubernetes admin has the responsibility to configure proper networking adjust cpu/ram/storage for the kubernetes cluster as needed storage should be set to at least 10gb scale additional computing resources when using belden horizon data operations features that use high computing power, such as plc drivers, integrations, and flows consult https //kubernetes io/docs/home/ for best practices ensure credentials are stored properly with kubernetes management net admin permissions are required step 2 log in to belden horizon data operations see docid 3jqnxuojkyjbhtno clob for details on logging in see docid\ tdhqtwqbqzobeduatvehz for instructions on how to navigate and log in for the first time