Deploy BMC HelixGPT on-premises

Starting from BMC Helix Service Management 23.3.04, you can install BMC HelixGPT in your on-premises environment.

To install BMC HelixGPT, you must install BMC Helix Service Management in your on-premises environment by using either the CORE or FULL deployment mode:

CORE mode: Installs only the platform and BMC HelixGPT components.
The CORE deployment mode feature is under controlled availability to select customers. We recommend that you contact BMC Helix Support to review and adjust the sizing according to your specific environment.
FULL mode: Installs BMC HelixGPT along with Service Management applications.

Installation options

The following table lists the installation options for BMC HelixGPT based on products and associated applications:

Product	Install only BMC HelixGPT with BMC Helix Service Management platform	Install BMC HelixGPT with Service Management applications	Install BMC HelixGPT with BMC Helix AIOps
BMC Helix Service Management	✅️	✅️	❌️
BMC Helix IT Operations Management	✅️	❌️	✅️
BMC Helix ServiceOps (BMC Helix IT Operations Management and BMC Helix Service Management user)	✅️	✅️	✅️

Scenarios

Service Management user wants only BMC HelixGPT:

You plan to use BMC HelixGPT Agent Studio to enhance IT operations with generative AI capabilities in your organization.
A system administrator in your organization deploys BMC Helix Service Management in CORE mode along with BMC HelixGPT. This ensures only the platform and BMC HelixGPT components are installed, reducing CPU and memory overhead.

Service Management user wants BMC HelixGPT with Service Management applications:

You want to enable BMC HelixGPT for BMC Helix Business Workflows across all lines of business.
In this case, the system administrator selects BMC Helix Service Management FULL mode, which installs BMC Helix Service Management, BMC HelixGPT, and BMC Helix Business Workflows. After installation, the administrator configures and enables BMC HelixGPT for all business units.

IT Operations Management user wants BMC HelixGPT with AIOps:

You want to use BMC HelixGPT with BMC Helix AIOps capabilities to improve operational intelligence and predictive analytics. A system administrator first installs BMC Helix IT Operations Management alongside AIOps components and then installs BMC HelixGPT with the BMC Helix Service Management platform, enabling advanced AI-driven insights for IT operations.

Workflow to install BMC HelixGPT

The following table lists the tasks to install BMC HelixGPT:

Task	Description	Reference
1	*Install BMC Helix IT Operations Management or* BMC Helix Platform Common services**
	(For BMC Helix Service Management users) Deploy BMC Helix Platform Common services and set up the installation environment. (For BMC Helix IT Operations Management and BMC Helix Service Operations users) Install BMC Helix IT Operations Management.	Installing BMC Helix Platform Common services 25.4.00 Deploy BMC Helix IT Operations Management in BMC Helix IT Operations Management deployment documentation.
2	Install BMC HelixGPT
	Install BMC HelixGPT by installing the BMC Helix Service Management in your environment.	Performing the BMC Helix Service Management installation
3	Configure BMC HelixGPT
	Configure BMC Helix GPT for BMC Helix Service Management.	Configuring Ask HelixGPT for BMC Helix ITSM and Configuring Agentic chat for BMC Helix ITSM in BMC Helix ITSM: Service Desk documentation.
	Configure BMC HelixGPT for BMC Helix Business Workflows.	Configuring BMC HelixGPT for BMC Helix Business Workflows in BMC Helix Business Workflows documentation
	Configure BMC HelixGPT for BMC Helix Digital Workplace.	Configuring BMC HelixGPT to offer options for unanswered questions and Configuring BMC HelixGPT in the end-user console and studio pages in BMC Helix Digital Workplace documentation.
	Configure BMC HelixGPT for BMC Helix AIOps.	Configuring settings to use the AI-powered capabilities in BMC Helix AIOps on premises in BMC Helix AIOps documentation.

Troubleshooting BMC HelixGPT installation issues

Refer to the troubleshooting information if you encounter any of the following issues while installing BMC HelixGPT.

Issue symptoms

BMC Helix Service Management upgrade fails at the HelixGPT Apps stage when and the pods attempt to fetch files from huggingface.co.

Issue scope

This issue occurs when the environment lacks internet access.

Resolution

Log in to BMC Deployment Engine.
Run the following command:
kubectl get deployment -n <BMC Helix Innovation Suite> |grep -i gpt
Sample command output:
helix-gpt-assistant 1/1 1 1 45d
helix-gpt-data-connection 1/1 1 1 45d
To edit the helix-gpt-assistant deployment, run the following command:
kubectl edit deployment helix-gpt-assistant -n <BMC Helix Innovation Suite namespace>
In the helix-gpt-assistant deployment, add the following environment variable:
- name: ONLY_USE_LOCAL_HF_CACHE
value: 'true'
To edit the helix-gpt-data-connection deployment, run the following command:
kubectl edit deployment helix-gpt-data-connection -n <BMC Helix Innovation Suite namespace>
In the helix-gpt-data-connection deployment, add the following environment variable:
- name: ONLY_USE_LOCAL_HF_CACHE
value: 'true'