이 콘텐츠는 선택한 언어로 제공되지 않습니다.
Chapter 1. Red Hat Enterprise Linux AI 1.3 release notes
RHEL AI provides organizations with a process to develop enterprise applications on open source Large Language Models (LLMs).
1.1. About this release
Red Hat Enterprise Linux AI version 1.3 includes various features for Large Language Model (LLM) fine-tuning on the Red Hat and IBM produced Granite model. A customized model using the RHEL AI workflow consisted of the following:
- Install and launch a RHEL 9.4 instance with the InstructLab tooling.
- Host information in a Git repository and interact with a Git-based taxonomy of the knowledge you want a model to learn.
- Run the end-to-end workflow of synthetic data generation (SDG), multi-phase training, and benchmark evaluation.
- Serve and chat with the newly fine-tuned LLM.
1.2. Features and Enhancements
Red Hat Enterprise Linux AI version 1.3 includes various features for Large Language Model (LLM) fine-tuning.
1.2.1. Installing
Red Hat Enterprise Linux AI is installable as a bootable image. This image contains various tooling for interacting with RHEL AI. The image includes: Red Hat Enterprise Linux 9.4, Python version 3.11 and InstructLab tools for model fine-tuning. For more information about installing Red Hat Enterprise Linux AI, see Installation overview and the "Installation feature tracker"
1.2.1.1. Installing RHEL AI on Google Cloud Platform (GCP) (Generally Available)
On RHEL AI version 1.3 installing and deploying Red Hat Enterprise Linux AI on Google Cloud Platform (GCP) instances is now generally available. For the documentation on installing Red Hat Enterprise Linux AI on GCP, see Installing on Google Cloud Platform (GCP)
RHEL AI currently supports 8xA100 and 8xH100 accelerators on GCP instances for the full end-to-end workflow. You can also serve LLMs provided by Red Hat for inferencing on GCP instances. For more details on the RHEL AI hardware requirements for GCP, see Red Hat Enterprise Linux AI hardware requirements.
1.2.1.2. Red Hat Enterprise Linux AI images on Azure and AWS marketplace
On RHEL AI 1.3, you can download the RHEL AI image on Azure and AWS marketplace. You can access the image and deploy a RHEL AI AWS AMI or a RHEL AI Azure VHD.
1.2.2. Building your RHEL AI environment
After installing Red Hat Enterprise Linux AI, you can set up your RHEL AI environment with the InstructLab tools.
1.2.2.1. Initializing InstructLab
You can initialize and set up your RHEL AI environment by running the ilab config init command. This command creates the necessary configurations for interacting with RHEL AI and fine-tuning models. It also creates proper directories for your data files. For more information about initializing InstructLab, see the Initialize InstructLab documentation.
1.2.2.1.1. InstructLab system profiles
Red Hat Enterprise Linux AI version 1.3 replaces the former training profiles with system profiles. This process adds the proper parameters to the config.yaml for your selected system. You can select your hardware vendor and accelerators directly in the CLI. For more information on system profiles, see the Initialize InstructLab documentation.
RHEL AI version 1.3 also continues the auto-detection feature, where the CLI can detect your machines hardware and select the profile that matches your system.
1.2.2.2. Downloading Large Language Models
You can download various Large Language Models (LLMs) provided by Red Hat to your RHEL AI machine or instance. You can download these models from a Red Hat registry after creating and logging in to your Red Hat registry account. For more information about the supported RHEL AI LLMs, see the Downloading models documentation and the "Large Language Models (LLMs) technology preview status".
1.2.2.2.1. granite-8b-lab-v1 and granite-8b-starter-v1 LLMs for NVIDIA and AMD
Red Hat Enterprise Linux AI version 1.3 now supports the granite-8b-redhat-lab inference serving model and granite-8b-starter base model for systems with NVIDIA and AMD accelerators. For the full support matrix of RHEL AI LLMs, see the Downloading models documentation.
1.2.2.2.2. granite-8b-lab-v2 LLM (Technology preview)
Red Hat Enterprise Linux AI version 1.3 offers version 2 of the granite-8b-lab LLM as a technology preview. This model is supported as an inference only use case. For the full support matrix of RHEL AI LLMs, see the Downloading models documentation.
1.2.2.3. Serving and chatting with models
Red Hat Enterprise Linux AI version 1.3 allows you to run a vLLM inference server on various LLMs. The vLLM tool is a memory-efficient inference and serving engine library for LLMs that is included in the RHEL AI image. For more information about serving and chatting with models, see Serving and chatting with the models documentation.
1.2.3. Creating skills and knowledge YAML files
On Red Hat Enterprise Linux AI, you can customize your taxonomy tree using custom YAML files so a model can learn domain-specific information. You host your knowledge data in a Git repository and fine-tune a model with that data. For detailed documentation on how to create a knowledge markdown and YAML file, see Customizing your taxonomy tree.
1.2.3.1. PDF document support on Red Hat Enterprise Linux AI
Red Hat Enterprise Linux AI now supports various documentation types for SDG consumption. You can now specify PDF documents in your qna.yaml files, along with the already supported markdown format. For more information on creating custom qna.yaml files with PDF documents, see Customizing your taxonomy tree.
1.2.3.2. Creating custom skills on RHEL AI
Red Hat Enterprise Linux AI version 1.3 now supports the ability to generate a custom LLM with skills. You can now create a skill qna.yaml file and train the granite student LLM to learn the skills and knowledge. Red Hat Enterprise Linux AI version 1.3 does not currently support training skills exclusively. You can run multi-phase training for skills and knowledge on RHEL AI version 1.3. For more information about creating custom skills, see Adding skills to your taxonomy tree.
1.2.4. Generating a custom LLM using RHEL AI
You can use Red Hat Enterprise Linux AI to customize a granite starter LLM with your domain specific skills and knowledge. RHEL AI includes the LAB enhanced method of Synthetic Data Generation (SDG) and multi-phase training.
1.2.4.1. Synthetic Data Generation (SDG)
Red Hat Enterprise Linux AI includes the LAB enhanced method of synthetic data generation (SDG). You can use the qna.yaml files with your own knowledge data to create hundreds of artifical datasets in the SDG process. For more information about running the SDG process, see Generating a new dataset with Synthetic data generation (SDG).
1.2.4.2. Training a model with your data
Red Hat Enterprise Linux AI includes the LAB enhanced method of multi-phase training: A fine-tuning strategy where datasets are trained and evaluated in multiple phases to create the best possible model. For more details on multi-phase training, see Training your data on the model.
1.2.4.3. Benchmark evaluation
Red Hat Enterprise Linux AI includes the ability to run benchmark evaluations on the newly trained models. On your trained model, you can evaluate how well the model knows the knowledge or skills you added with the MMLU_BRANCH or MT_BENCH_BRANCH benchmark. For more details on benchmark evaluation, see Evaluating your new model.
1.3. Red Hat Enterprise Linux AI feature tracker
Some features in this release are currently in Technology Preview. These experimental features are not intended for production use. For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.
In the following tables, features are marked with the following statuses:
- Not Available
- Technology Preview
- General Availability
- Deprecated
- Removed
1.3.1. Installation feature tracker
| Feature | 1.1 | 1.2 | 1.3 |
|---|---|---|---|
| Installing on bare metal | Generally available | Generally available | Generally available |
| Installing on AWS | Generally available | Generally available | Generally available |
| Installing on IBM Cloud | Generally available | Generally available | Generally available |
| Installing on GCP | Not available | Technology preview | Generally available |
| Installing on Azure | Not available | Generally available | Generally available |
1.3.2. Platform support feature tracker
| Feature | 1.1 | 1.2 | 1.3 |
|---|---|---|---|
| Bare metal | Generally available | Generally available | Generally available |
| AWS | Generally available | Generally available | Generally available |
| IBM Cloud | Not available | Generally available | Generally available |
| Google Cloud Platform | Not available | Technology preview | Generally available |
| Azure | Not available | Generally available | Generally available |
| Feature | 1.1 | 1.2 | 1.3 |
|---|---|---|---|
| Bare metal | Generally available | Generally available | Generally available |
| AWS | Generally available | Generally available | Generally available |
| IBM Cloud | Generally available | Generally available | Generally available |
| Google Cloud Platform (GCP) | Not available | Technology preview | Generally available |
| Azure | Not available | Generally available | Generally available |
| Feature | 1.1 | 1.2 | 1.3 |
|---|---|---|---|
| AWS | Not available | Not available | Generally available |
| Azure | Not available | Not available | Generally available |
1.4. Large Language Models feature status
1.4.1. RHEL AI version 1.3 hardware vendor LLM support
| Feature | NVIDIA | AMD |
|---|---|---|
|
| Deprecated | Deprecated |
|
| Deprecated | Deprecated |
|
| Generally available | Technology preview |
|
| Generally available | Technology preview |
|
| Technology preview | Technology preview |
|
| Technology preview | Technology preview |
|
| Generally available | Technology preview |
|
| Generally available | Technology preview |
1.5. Known Issues
1.5.1. Incorrect auto-detection on some machines with AMD accelerators
The 1.3 version of RHEL AI sometimes auto-detects the incorrect system profile on machines with AMD accelerators.
You can select the correct system profile on AMD with the following command:
$ ilab config init --profile ~/.local/share/instructlab/internal/system_profiles/amd/mi300x/<specified-profile>
1.5.2. AMD-smi is not usable upon installation
After installing Red Hat Enterprise Linux AI using the ISO image or upgrading to a system using the bootc-amd-rhel9 container, the amd-smi tool does not work by default. To enable amd-smi, add the proper ROCm version to your user PATH variable with the following command:
$ export PATH="$PATH:/opt/rocm-6.1.2/bin"
1.5.3. Training fails with the default 4xL40s max_batch_len parameter
The default max_batch_len parameter in the 4xL40s configuration needs to be updated in order for training to run properly.
You can edit the config.yaml file with the following command:
$ ilab config edit
Edit the config.yaml file to match the following parameter:
train:
max_batch_len: 15000$ sudo rpm --restore shadow-utils
1.5.4. Incorrect auto-detection on some NVIDIA H100 or A100 systems
RHEL AI sometimes auto-detects the incorrect system profile on machines with H100 or A100 accelerators.
You can select the correct profile by re-initializing and passing the correct system profile.
$ ilab config init --profile <path-to-system-profile>
Example profile selection command
$ ilab config init --profile ~/.local/share/instructlab/internal/system_profiles/nvidia/h100/h100.yaml
1.5.5. Incorrect default gpu parameter for inference serving on Gaudi3 systems
You need to change the default gpu count in the Gaudi3 configuration in order to inference serve on your machine.
You can edit the config.yaml file with the following command:
$ ilab config edit
Edit the config.yaml so any gpu parameter is set to the value 1.
evaluate:
gpus: 1
generate:
vllm:
gpus: 1
serve:
vllm:
gpus: 11.5.6. Fabirc manager does not always starts with NVIDIA accelerators
After installing Red Hat Enterprise Linux AI on NVIDIA systems, you may see the following error when serving or training a model.
INFO 2024-11-26 22:18:04,244 instructlab.model.serve_backend:56: Using model '/var/home/cloud-user/.local/share/instructlab/phased/phase2/checkpoints/hf_format/samples_29117' with -1 gpu-lay
ers and 4096 max context size.
INFO 2024-11-26 22:18:04,244 instructlab.model.serve_backend:88: '--gpus' flag used alongside '--tensor-parallel-size' in the vllm_args section of the config file. Using value of the --gpus
File "/opt/app-root/lib64/python3.11/site-packages/vllm/entrypoints/openai/api_server.py", line 105, in build_async_engine_client
async with build_async_engine_client_from_engine_args(
File "/usr/lib64/python3.11/contextlib.py", line 210, in __aenter__
return await anext(self.gen)
^^^^^^^^^^^^^^^^^^^^^
File "/opt/app-root/lib64/python3.11/site-packages/vllm/entrypoints/openai/api_server.py", line 192, in build_async_engine_client_from_engine_args
raise RuntimeError(
RuntimeError: Engine process failed to startTo resolve this issue, you need the run the following commands:
$ sudo systemctl stop nvidia-persistenced.service $ sudo systemctl start nvidia-fabricmanager.service $ sudo systemctl start nvidia-persistenced.service
1.5.7. GUI AMD technology preview installations
Red Hat Enterprise Linux AI version 1.3 currently does not support graphical based installation with the technology previewed AMD ISOs. Ensure that the text parameter in your kickstart file is configured for non-interactive installs. You can also pass inst.text in your shell during interactive installation to avoid an install time crash.
1.5.8. SDG fails on 4xL40s
For SDG to run on 4xL40s, you need to run SDG with the --num-cpus flag and set to the value of 4.
$ ilab data generate --num-cpus 4
1.5.9. Kdump over nfs
Red Hat Enterprise Linux AI version 1.3 does not support kdump over nfs without configuration. To use this feature, run the following commands:
mkdir -p /var/lib/kdump/dracut.conf.d echo "dracutmodules=''" > /var/lib/kdump/dracut.conf.d/99-kdump.conf echo "omit_dracutmodules=''" >> /var/lib/kdump/dracut.conf.d/99-kdump.conf echo "dracut_args --confdir /var/lib/kdump/dracut.conf.d --install /usr/lib/passwd --install /usr/lib/group" >> /etc/kdump.conf systemctl restart kdump
