qiot-manufacturing-factory-installer

steps to install components in Single Node Openshift:

Prerequisites

Download the Openshift client from the official download page

Download helm CLI: https://helm.sh/docs/intro/install/

• Login to your SNO with oc CLI.

oc login -u kubeadmin -p [KUBEADMIN-PASSWORD] --server=https://api.[SNO.DOMAIN].com:6443

Cleanup

helm uninstall sno-srv-install --namespace factory
helm uninstall sno-install --namespace factory
helm uninstall sno-core-install --namespace factory
helm uninstall sno-olm-install --namespace factory
oc delete secret factory-data --namespace factory
oc delete secret factory-secret --namespace factory
oc delete secret endpoint-service-edge-secret --namespace factory
oc delete secret endpoint-service-tls-secret --namespace factory
oc delete subscription amq-broker -n factory
oc delete subscription cert-manager -n openshift-operators
oc delete subscription openshift-gitops-operator -n openshift-operators
helm uninstall sno-volumes-install --namespace factory
oc delete project factory

Step 1:

• Install helm template sno-volumes-install. It contains the Helm chart for the persistent volumes piece.

This template will install the MachineConfig to mount HostPath for persistence.

helm install sno-volumes-install ./sno-volumes-install --create-namespace --namespace factory

Wait ~4 minutes until the SNO reboot caused by the MachineConfig.

Step 2:

• Install helm template sno-olm-install. It contains the helm chart for the operators piece.

This template will contain the operators of Openshift-GitOps, Cert-manager and AMQ-Broker

helm install sno-olm-install ./sno-olm-install --namespace factory

Step 3:

• Install helm template sno-core-install. It contains the helm chart for the factory core piece.

This template will contain the components required to deploy core-service and registration-service.

helm install --set coreservice.serial=<<YOUR_FACTORY_SERIAL>>,coreservice.name=<<YOUR_FACTORY_NAME>> sno-core-install ./sno-core-install --namespace factory

e.g.:

helm install --set coreservice.serial=abattaglfactorytestserial03,coreservice.name=abattaglfactorytestname03 sno-core-install ./sno-core-install --namespace factory

Run the next command to check if the delegate issuer created by the registration-service has been deployed and is valid.

oc get issuer -n factory

Step 4:

• Install helm template sno-install. It contains the helm chart for the software infrastructure piece.

This template will contain the components required to deploy MongoDB, PostgreSQL and AMQ Broker.

First things first: export a variable containing the apps domain of your SNO:

export WILDCARD=apps.$(oc get dns cluster -o jsonpath='{.spec.baseDomain}')

Verify the content of the variable WILDCARD running the command echo $WILDCARD The variable should contain a value like apps.<<YOUR_FACTORY_DOMAIN>>

helm install sno-install ./sno-install --set certificate.wildcardDomain=$WILDCARD --namespace factory

Run the next command to check if the pods are running;

oc get pods -n factory

If you can't see the broker pod "{{ .Values.amqbroker.brokerName }}" (see your values.yaml file!) run the next command as workaround to restart the AMQ-Broker operator pod:

oc delete pod -l name=amq-broker-operator -n factory

Check again if the broker is created:

oc get pods -n factory

Step 5:

• Install helm template sno-srv-install. It contains the helm chart for the workload piece.

This template will contain the components required to deploy facility-manager-service, product-line-service and production-validator-service.

helm install sno-srv-install ./sno-srv-install --set certificate.wildcardDomain=$WILDCARD --namespace factory

Considerations

We need to provide persistent storage for databases, and for this context we add the easiest solution to integrate all-in-one providing hostPath storage which requires running pods as privileged, and SElinux chcon (done with MachineConfig CR), please note this is just for testing, in production environment you will need to add external storage to the NUC, like external disks, nfs, ODF, etc.