Getting started with Open Data for Industries

When you review the requirements for the Cloud Pak for Data platform, remember that more requirements might apply depending on the services you plan to install.

These resources are the minimum resources that are needed to install Open Data for Industries on top of the Cloud Pak for Data platform.

If you plan to install other services in your environment, review the requirements for services in Hardware requirements and Storage requirements to ensure that you identify common hardware and storage requirements.

vCPU, memory, and storage

Calculate the amount of vCPU, memory, and storage that you need based on the requirements for:

• The Cloud Pak for Data platform
• The shared cluster components.
• The services that you plan to install.

You can use the minimum requirements that are listed for the Cloud Pak for Data platform to run Open Data for Industries. However, if the service requires more vCPU, memory, or storage than the Cloud Pak for Data platform, add the difference between the requirements to the sizing of your cluster.

Work with IBM Sales to get a more accurate sizing based on your expected workload.

Hardware architecture

Ensure that the hardware architecture is supported by:

• Open Data for Industries.
• Any other services that you plan to install.
• The persistent storage that you plan to use.
• The deployment environment that you plan to use.

Consider whether you have an existing cluster environment that you want to use.

You can skip this step if you have an existing Cloud Pak for Data deployment.

• Open Data for Industries.
• Any other services that you plan to install.
• The deployment environment that you plan to use.

IBM Cloud Pak for Data images are accessible from the IBM Entitled Registry. In most situations, it is strongly recommended that you mirror the necessary software images from the IBM Entitled Registry to a private container registry.

See Mirroring images to your private container registry.

• In an express installation, the IBM Cloud Pak® foundational services operators and the Cloud Pak for Data operators are in the same project.
• In a specialized installation, the IBM Cloud Pak foundational services operators and the Cloud Pak for Data operators are installed in separate projects. With separate projects, you can specify different security settings for the IBM Cloud Pak foundational services and for the Cloud Pak for Data operators.

For more information, see Creating projects (namespaces).

You already have an OpenShift 4.6 or 4.8 cluster

Go to the next step.

You have an older version of OpenShift

Upgrade your cluster.

You don't have an OpenShift cluster

Deploy OpenShift on your chosen environment:

• For an on-premises deployment, follow the Red Hat OpenShift Container Platform documentation to install OpenShift 4.6 or OpenShift 4.8.
• For a cloud deployment, install and manage Red Hat OpenShift Container Platform on your chosen cloud provider. For details, see Installing Red Hat OpenShift Container Platform.

If the shared persistent storage you selected is not set up on your cluster, follow the guidance in Setting up shared persistent storage to install and configure the storage.

• You have the necessary projects on your cluster.
• You need to create operator groups for the projects.

If you have your API key, go to the next step.

If you don't have your API key, follow the guidance in Obtaining your IBM entitlement API key.

To pull images from the IBM Entitled Registry

Complete the appropriate steps for your environment in Configuring your cluster to pull Cloud Pak for Data images.

To mirror images to a private container registry

1. Review the guidance in Mirroring images to your private container registry to ensure you have a private container registry that meets the minimum requirements.
   Important: To download the Open Data for Industries CASE package, run the command:

     cloudctl case save \
   --repo ${CASE_REPO_PATH} \
   --case ibm-osdu \
   --version 3.0.0 \
   --outputdir ${OFFLINEDIR}

2. Complete the appropriate steps for your environment in Configuring your cluster to pull Cloud Pak for Data images.

cloudctl case launch \
  --case ${OFFLINEDIR}/ibm-osdu-3.0.0.tgz \
  --inventory osduOperatorSetup \
  --namespace openshift-marketplace \
  --action install-catalog \
    --args "--inputDir ${OFFLINEDIR} --recursive"

oc get catalogsource -n openshift-marketplace ibm-osdu-operator-catalog \
-o jsonpath='{.status.connectionState.lastObservedState} {"n\"}'

Ensure that the Operator Lifecycle Manager (OLM) can use the Cloud Pak for Data operators to install the software.

An operator subscription tells the cluster where to install an operator and gives information about the operator to Operator Lifecycle Manager (OLM).

Follow the guidance in Creating operator subscriptions. For the Open Data for Industries operator subscription commands, see "Installing Open Data for Industries" topic.

Follow the guidance in Installing the scheduling service.

Ensure that you complete the installation tasks in order.

* The Cloud Pak for Data platform supports auditing system access through security information and event management (SIEM) software. If you want to audit system access, determine which events create audit records based on the services that are installed in your environment.

Follow the guidance in Set up regular backups.

From the Cloud Pak for Data web client, you can do several tasks. Namely, monitor the services that are running on the platform, understand how you are using cluster resources, and be aware of issues as they arise.

Follow the guidance in Monitoring the platform.

Repeat this process routinely to ensure you are aware of the status of your deployment.

Adjust the capacity and resiliency of your deployment based on your workload.

Before you scale up a service, ensure that your cluster can support the additional workload. If necessary, contact your IBM Support representative.

Repeat this process as needed.

Follow the guidance in Accessing and querying logs in Open Data for Industries.