1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/microshift-install-rpms.adoc
2025-03-18 15:17:35 +00:00

91 lines
3.2 KiB
Plaintext

// Module included in the following assemblies:
//
// microshift/microshift-install-rpm.adoc
:_mod-docs-content-type: PROCEDURE
[id="installing-microshift-from-rpm-package_{context}"]
= Installing {microshift-short} from an RPM package
Use the following procedure to install {microshift-short} from an RPM package.
.Prerequisites
* The system requirements for installing {microshift-short} have been met.
* You completed the steps of preparing to install {microshift-short} from an RPM package.
.Procedure
. For all lifecycles, enable the repository for your release by running the following command:
+
[source,terminal,subs="attributes+"]
----
$ sudo subscription-manager repos \
--enable rhocp-{ocp-version}-for-rhel-{op-system-version-major}-$(uname -m)-rpms \
--enable fast-datapath-for-rhel-{op-system-version-major}-$(uname -m)-rpms
----
. For extended support (EUS) releases, also enable the EUS repositories by running the following command:
+
[source,terminal,subs="attributes+"]
----
$ sudo subscription-manager repos \
--enable rhel-{op-system-version-major}-for-$(uname -m)-appstream-eus-rpms \
--enable rhel-{op-system-version-major}-for-$(uname -m)-baseos-eus-rpms
----
. Avoid unintended future updates into an unsupported configuration by locking your operating system version with the following command:
+
[source,terminal,subs="attributes+"]
----
$ sudo subscription-manager release --set={op-system-version}
----
. Install {microshift-short} by running the following command:
+
[source,terminal]
----
$ sudo dnf install -y microshift
----
. Download your installation pull secret from the https://console.redhat.com/openshift/install/pull-secret[Red Hat Hybrid Cloud Console] to a temporary folder, for example, `$HOME/openshift-pull-secret`. This pull secret allows you to authenticate with the container registries that serve the container images used by {product-title}.
. To copy the pull secret to the `/etc/crio` folder of your {op-system-base} machine, run the following command:
+
[source,terminal]
----
$ sudo cp $HOME/openshift-pull-secret /etc/crio/openshift-pull-secret
----
. Make the root user the owner of the `/etc/crio/openshift-pull-secret` file by running the following command:
+
[source,terminal]
----
$ sudo chown root:root /etc/crio/openshift-pull-secret
----
. Make the `/etc/crio/openshift-pull-secret` file readable and writeable by the root user only by running the following command:
+
[source,terminal]
----
$ sudo chmod 600 /etc/crio/openshift-pull-secret
----
. If your {op-system-base} machine has a firewall enabled, you must configure a few mandatory firewall rules. For `firewalld`, run the following commands:
+
[source,terminal]
----
$ sudo firewall-cmd --permanent --zone=trusted --add-source=10.42.0.0/16
----
+
[source,terminal]
----
$ sudo firewall-cmd --permanent --zone=trusted --add-source=169.254.169.1
----
+
[source,terminal]
----
$ sudo firewall-cmd --reload
----
. If the Volume Group (VG) that you have prepared for {microshift-short} used the default name `rhel`, no further configuration is necessary. If you have used a different name, or if you want to change more configuration settings, see the "Using the {microshift-short} configuration file" section.