Chapter 1. Installing OpenShift Lightspeed
Enable OpenShift Lightspeed in your cluster by installing the OpenShift Lightspeed Operator and configuring the Service to interact with a large language model (LLM) provider.
1.1. Large language model (LLM) overview Copy linkLink copied to clipboard!
Learn how the OpenShift Lightspeed Service uses large language models (LLMs) to generate intelligent, context-aware answers to your questions about OpenShift Container Platform.
You can configure Red Hat Enterprise Linux AI or Red Hat OpenShift AI as the LLM provider for the OpenShift Lightspeed Service. Either LLM provider can use a server or inference service that processes inference queries.
Alternatively, you can connect the OpenShift Lightspeed Service to a publicly available LLM provider, such as IBM watsonx, OpenAI, or Microsoft Azure OpenAI.
Installing the OpenShift Lightspeed Operator does not install an LLM provider. You must have an LLM provider available for use before you install the OpenShift Lightspeed Operator.
1.1.1. Red Hat Enterprise Linux AI with OpenShift Lightspeed Copy linkLink copied to clipboard!
You can use Red Hat Enterprise Linux AI to host an LLM.
For more information, see Generating a custom LLM by using RHEL AI.
1.1.2. Red Hat OpenShift AI with OpenShift Lightspeed Copy linkLink copied to clipboard!
You can use Red Hat OpenShift AI to host an LLM.
For more information, see About model serving.
1.1.3. IBM watsonx with OpenShift Lightspeed Copy linkLink copied to clipboard!
To configure IBM watsonx as the LLM provider, you need an IBM Cloud project with access to IBM watsonx. You also need your IBM watsonx API key.
For more information, see the official IBM watsonx product documentation.
1.1.4. OpenAI with OpenShift Lightspeed Copy linkLink copied to clipboard!
To configure OpenAI as the LLM provider with OpenShift Lightspeed, you need either the OpenAI API key or the OpenAI project name during the configuration process.
The OpenAI Service has a feature for projects and service accounts. You can use a service account in a dedicated project so that you can precisely track OpenShift Lightspeed usage.
For more information, see the official OpenAI product documentation.
1.1.5. Microsoft Azure OpenAI with OpenShift Lightspeed Copy linkLink copied to clipboard!
To configure Microsoft Azure OpenAI as the LLM provider, you need a Microsoft Azure OpenAI Service instance. You must have at least one model deployment in Microsoft Azure OpenAI Studio for that instance.
For more information, see the official Microsoft Azure OpenAI product documentation.
1.2. About subscription requirements Copy linkLink copied to clipboard!
Review the supported OpenShift Container Platform product subscriptions and account requirements necessary to activate and use the OpenShift Lightspeed Service in your environment.
Red Hat OpenShift Lightspeed requires a valid and active subscription to one of the listed products.
- Red Hat OpenShift Kubernetes Engine
- Red Hat OpenShift Virtualization Engine
- OpenShift Container Platform
- Red Hat OpenShift Platform Plus
1.3. About adding Operators to a cluster Copy linkLink copied to clipboard!
Use the software catalog or OperatorHub to install Operators on your OpenShift Container Platform cluster. These tools use the Operator Lifecycle Manager (OLM) to manage your software.
1.3.1. Installing the OpenShift Lightspeed Operator from the OperatorHub Copy linkLink copied to clipboard!
Install the OpenShift Lightspeed Operator so that you can configure the OpenShift Lightspeed Service.
Prerequisites
- You have deployed OpenShift Container Platform 4.16 to 4.19.
-
You have logged in to the OpenShift Container Platform web console as a user with the
cluster-adminrole. - You have successfully configured your large language model (LLM) provider so that OpenShift Lightspeed can communicate with it.
Procedure
-
In the OpenShift Container Platform web console, navigate to the Operators
OperatorHub page. - Search for OpenShift Lightspeed.
- Locate the OpenShift Lightspeed Operator, and click to select it.
- When the prompt that discusses the community operator displays, click Continue.
- Click Install.
- Use the default installation settings presented, and click Install to continue.
-
Click Operators
Installed Operators to verify the OpenShift Lightspeed Operator installation. Succeededdisplays in the Status column.
1.3.2. Installing the OpenShift Lightspeed Operator from the software catalog Copy linkLink copied to clipboard!
Install the OpenShift Lightspeed Operator so that you can configure the OpenShift Lightspeed Service.
Prerequisites
- You have deployed OpenShift Container Platform 4.20 or later.
-
You have logged in to the OpenShift Container Platform web console as a user with the
cluster-adminrole. - You have successfully configured your large language model (LLM) provider so that OpenShift Lightspeed can communicate with it.
Procedure
-
In the OpenShift Container Platform web console, navigate to the Ecosystem
Software Catalog page. - Click the Project drop-down list, and enable the toggle switch to show default projects.
-
Enter
openshift-marketplacein the search field. -
Click to select
openshift-marketplace. - Search for OpenShift Lightspeed.
- Locate the OpenShift Lightspeed Operator, and click to select it.
- When the prompt that discusses the OpenShift Lightspeed Operator displays, click Install.
- Use the default installation settings presented, and click Install to continue.
-
Click Ecosystem
Installed Operators to verify the OpenShift Lightspeed Operator installation. Succeededdisplays in the Status column.