Install an Apache Solr search engine to OpenShift

[computate]

As a team, install an Apache Solr search engine to OpenShift.

Install an Apache Solr Container Image Stream

• Login to your OpenShift environment here: https://api.rh-us-east-1.openshift.com
• Open the project named: southerncoalition
• Click the [ Add to Project ] button in the top right.
• Click "Deploy Image"
• Select "Image Name" and enter: quay.io/computate/computate-solr
• For other values, you can leave them as the default, then click [ Create ]
• Click [ Close ]

Install an Apache Solr Persistent Volume Claim

• Open the persistent volume claims of the OpenShift project by clicking [ Storage ]
• Click "Create Storage"
• For the config map "Storage Class", enter: gp2-encrypted
• For the config map "Name" enter: computate-solr
• For the config map "Size" in GiB, enter: 2
• For other values, you can leave them as the default, then click [ Create ]
• Click [ Create ]

Verify the Apache Solr Service

• Open the services of the OpenShift project by clicking [ Applications ] -> [ Services ]
• Notice that an apache-solr service already exists. Click on the "apache-solr" service.
• Notice that it has a service with an assigned cluster IP address that proxies TCP traffic on port 8983 to a target port of 8983 on the pod. 8983 is the default port of Apache Solr.
• You might notice a related pod that is not receiving traffic and is in a state of "Crash Loop Back-off". That is because the computate-solr application is not completely configured yet.

Configure the Apache Solr Deployment Config

• Open the deployment configs of the OpenShift project by clicking [ Applications ] -> [ Deployments ]
• Notice that an apache-solr deployment config already exists. Click on the "apache-solr" deployment config, then click on the "Configuration" tab.

Configure Apache Solr Recreate deployments

• On the apache-solr deployment config, click [ Actions ] -> Edit
• Change the Strategy Type to: Recreate
• to keep some existing rolling strategy parameters, click [ Yes ]
• Click [ Save ]

Configure an Apache Solr Resource Limit

• On the apache-solr deployment config, click [ Actions ] -> Edit Resource Limits
• For the "Memory" in MiB, enter: 2000
• For other values, you can leave them as the default, then click [ Save ]

Configure Apache Solr Data Volume Mount

• On the apache-solr deployment config, click [ Actions ] -> Add Storage
• Select the existing "computate-solr" persistent volume claim storage
• For the "Mount Path", enter: /opt/solr/data
• For the "Volume Name", enter: volume-computate-solr-data
• For other values, you can leave them as the default, then click [ Add ]

Configure Apache Solr Config Volume Mount

• On the apache-solr deployment config, click the "Environment" tab
• Configure a new environment variable with the "Name" of: ZK_HOSTNAME
• And the "Value" of: computate-zookeeper.southerncoalition.svc
• Click [ Save ]

At this point, you should find the computate-solr running with the pod no longer in an error state.