Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Installing optional RPM packages

Red Hat build of MicroShift 4.19

Installing optional RPM packages

Red Hat OpenShift Documentation Team

Abstract

This document provides information about installing optional RPM packages with MicroShift to provide additional cluster and application services.

Chapter 1. Installing optional RPM packages
Copy link

You can install optional RPM packages with MicroShift to provide additional cluster and application services.

1.1. Installing optional packages
Copy link

When you install MicroShift, optional RPM packages can be added. Examples of optional RPMs include those designed to expand your network, add and manage operators, and manage applications. Use the following procedures to add the packages that you need.

You can use a lightweight version of OpenShift GitOps with MicroShift to help manage your applications by installing the microshift-gitops RPM package. The microshift-gitops RPM package includes the necessary manifests to run core Argo CD.

Important

The Argo CD CLI is not available on MicroShift. This process installs basic GitOps functions.

Prerequisites

  • You installed MicroShift version 4.14 or later.
  • You configured 250MB RAM of additional storage.

Procedure

  1. Enable the GitOps repository with the subscription manager by running the following command: 

    $ sudo subscription-manager repos --enable=gitops-1.16-for-rhel-9-$(uname -m)-rpms
    Copy to Clipboard Toggle word wrap

  2. Install the MicroShift GitOps package by running the following command: 

    $ sudo dnf install -y microshift-gitops
    Copy to Clipboard Toggle word wrap

  3. To deploy Argo CD pods, restart MicroShift by running the following command: 

    $ sudo systemctl restart microshift
    Copy to Clipboard Toggle word wrap

Verification

  • You can verify that your pods are running properly by entering the following command: 

    $ oc get pods -n openshift-gitops
    Copy to Clipboard Toggle word wrap

    Example output

    NAME                                  READY   STATUS    RESTARTS   AGE
argocd-application-controller-0       1/1     Running   0          4m11s
argocd-redis-56844446bc-dzmhf         1/1     Running   0          4m12s
argocd-repo-server-57b4f896cf-7qk8l   1/1     Running   0          4m12s
    Copy to Clipboard Toggle word wrap

1.1.2. Installing the multiple networks plugin
Copy link

You can install the MicroShift Multus Container Network Interface (CNI) plugin alongside a new MicroShift installation. If you want to attach additional networks to a pod for high-performance network configurations, install the microshift-multus RPM package.

Important

The MicroShift Multus CNI plugin manifests are included in the MicroShift binary. To enable multiple networks, you can either set the value in the MicroShift config.yaml file to Enabled, or use the configuration snippet in the microshift-multus RPM. Uninstalling the MicroShift Multus CNI is not supported in either case.

Procedure

  • Install the Multus RPM package by running the following command: 

    $ sudo dnf install microshift-multus
    Copy to Clipboard Toggle word wrap
    Tip

    If you create your custom resources (CRs) while you are completing your installation of MicroShift, you can avoid restarting the service to apply them.

Next steps

  1. Continue with your new MicroShift installation, including any add-ons.
  2. Create the custom resources (CRs) needed for your MicroShift Multus CNI plugin.
  3. Configure other networking CNIs as needed.
  4. After you have finished installing all of the RPMs that you want to include, start the MicroShift service. The MicroShift Multus CNI plugin is automatically deployed.

When you install MicroShift, the Operator Lifecycle Manager (OLM) package is not installed by default. You can install the OLM on your MicroShift instance using an RPM package.

Procedure

  1. Install the OLM package by running the following command: 

    $ sudo dnf install microshift-olm
    Copy to Clipboard Toggle word wrap

  2. To apply the manifest from the package to an active cluster, run the following command: 

    $ sudo systemctl restart microshift
    Copy to Clipboard Toggle word wrap

You can install MicroShift Observability at any time, including during the initial MicroShift installation.

Procedure

  1. Install the microshift-observability RPM by entering the following command: 

    $ sudo dnf install microshift-observability
    Copy to Clipboard Toggle word wrap

  2. Enable the microshift-observability system service by entering the following command: 

    $ sudo systemctl enable microshift-observability
    Copy to Clipboard Toggle word wrap

  3. Start the microshift-observability system service by entering the following command: 

    $ sudo systemctl start microshift-observability
    Copy to Clipboard Toggle word wrap

  4. Restart MicroShift after the initial installation. 

    $ sudo systemctl restart microshift-observability
    Copy to Clipboard Toggle word wrap

The installation is successful if there is no output after you start the microshift-observability RPM.

1.1.5. Installing the Red Hat OpenShift AI RPM
Copy link

To use AI models in MicroShift deployments, use this procedure to install the Red Hat OpenShift AI (Red Hat OpenShift AI Self-Managed) RPM with a new MicroShift installation. You can also install the RPM on an existing MicroShift instance if you restart the system.

Important

Red Hat OpenShift AI is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features Support Scope.

Prerequisites

  • The system requirements for installing MicroShift have been met.
  • You have root user access to your machine.
  • The OpenShift CLI (oc) is installed.
  • You configured your LVM VG with the capacity needed for the PVs of your workload.
  • You have the RAM and disk space required for your AI model.
  • You configured the required accelerators, hardware, operating system, and MicroShift to provide the resources your model needs.
  • Your AI model is ready to use.
Note

The microshift-ai-model-serving RPM contains manifests that deploy kserve, with the raw deployment mode enabled, and ServingRuntimes objects in the redhat-ods-applications namespace.

Procedure

  1. Install the MicroShift AI-model-serving RPM package by running the following command: 

    $ sudo dnf install microshift-ai-model-serving
    Copy to Clipboard Toggle word wrap

  2. As a root user, restart the MicroShift service by entering the following command: 

    $ sudo systemctl restart microshift
    Copy to Clipboard Toggle word wrap

  3. Optional: Install the release information package by running the following command: 

    $ sudo dnf install microshift-ai-model-serving-release-info
    1
    Copy to Clipboard Toggle word wrap
    1
    The release information package contains a JSON file with image references useful for offline procedures or deploying copy of a ServingRuntime to your namespace during a bootc image build.

Verification

  • Verify that the kserve pod is running in the redhat-ods-applications namespace by entering the following command: 

    $ oc get pods -n redhat-ods-applications
    Copy to Clipboard Toggle word wrap

    Example output

    NAME                                        READY   STATUS    RESTARTS   AGE
kserve-controller-manager-7fc9fc688-kttmm   1/1     Running   0          1h
    Copy to Clipboard Toggle word wrap

Next steps

  • Create a namespace for your AI model.
  • Package your model into an OCI image.
  • Configure a model-serving runtime.
  • Verify that your model is ready for inferencing.
  • Make requests against the model server.

Legal Notice
Copy link

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat