Deploying Code Insights Explain


You must install BMC AMI Platform before deploying the Code Insights Explain service. To know about installing BMC AMI Platform, see Installing.

Success

Best practice
We recommend the following models.

Language

Recommended model

Limitations

Cobol

Granite-3.1-8B-Instruct 

None

PLI

Granite-3.1-8B-Instruct 

None

Assembler

Granite-3.1-8B-Instruct 

Macros are not supported.

JCL

Granite-3.1-8B-Instruct 

Conditions (If-Else) are sometimes not detected correctly or give incorrect explanations. We plan to provide better results in future maintenance.

Warning
Important

We support the following inference engines for BYOLLM:

  • OpenAI
  • vLLM
  • Triton

To deploy Code Insights Explain on Kubernetes

  1. Log in to the primary manager node of Kubernetes and access /<extracted_dir>/BMC-AMI-PLATFORM-2.0.00.
  2. Verify that the scripts/code-explain.sh file is present.
  3. Run the code-explain.sh file and provide the following input:

Field

Description

ces_scheme

Protocol of the CES instance

ces_host

Host name or IP address of the CES instance

ces_port

Port of the CES instance

ces_username

The CES instance user name, if required.

ces_password

The CES instance password, encoded in base64 format, if required.

Warning
Important

Adding CES details is optional.

To verify the deployment

  1. Verify that the service and pod are running successfully under the namespaces by using the following commands:

     kubectl get po --namespace bmcami-prod-amiai-services
     

    1760614541694-782.png

     kubectl get svc --namespace bmcami-prod-amiai-services
     

    1760614637831-986.png

    To use Code Insights Explain, you must provision the service and download the connection details from Platform Manager > BMC AMI AI Manager> AI services settings > Integrations settings page. 

    To learn how to provision and integrate, see Integrations Settings.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Platform 2.0