Skip to content

USHIFT-898: Port the Getting Started procedure to use RHEL 9 and MicroShift 4.13 packages #1527

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
ggiguash wants to merge 1 commit into from
Closed

USHIFT-898: Port the Getting Started procedure to use RHEL 9 and MicroShift 4.13 packages #1527

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/config/microshift-starter.ks
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ git
jq
make
NetworkManager-ovs
python36
python3
selinux-policy-devel
%end

Expand All @@ -54,7 +54,7 @@ fi

# Configure systemd journal service to persist logs between boots and limit their size to 1G
sudo mkdir -p /etc/systemd/journald.conf.d
cat <<EOF | sudo tee /etc/systemd/journald.conf.d/microshift.conf &>/dev/null
tee /etc/systemd/journald.conf.d/microshift.conf &>/dev/null <<EOF
[Journal]
Storage=persistent
SystemMaxUse=1G
Expand Down
30 changes: 16 additions & 14 deletions docs/getting_started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ Run the following command to install the necessary components for the [libvirt](
sudo dnf install -y libvirt virt-manager virt-install virt-viewer libvirt-client qemu-kvm qemu-img
```

Download the Red Hat Enterprise Linux 8.7 DVD ISO image for the x86_64 architecture from [Red Hat Developer](https://developers.redhat.com/products/rhel/download) site and copy the file to the `/var/lib/libvirt/images` directory.
> Other architectures, versions or flavors of operating systems are not supported in this opinionated environment. For this setup, only use the RHEL 8.7 DVD image for the x86_64 architecture.
Download the Red Hat Enterprise Linux 9 DVD ISO image for the `x86_64` architecture from [Red Hat Developer](https://developers.redhat.com/products/rhel/download) site and copy the file to the `/var/lib/libvirt/images` directory.
> Other architectures, versions or flavors of operating systems are not supported in this opinionated environment.

Download the OpenShift pull secret from the https://console.redhat.com/openshift/downloads#tool-pull-secret page and save it into the `~/.pull-secret.json` file.

Expand All @@ -27,7 +27,7 @@ Run the following commands to initiate the creation process of the `microshift-s

```bash
VMNAME=microshift-starter
DVDISO=/var/lib/libvirt/images/rhel-8.7-x86_64-dvd.iso
DVDISO=/var/lib/libvirt/images/rhel-baseos-9.*-$(uname -i)-dvd.iso
KICKSTART=https://raw.githubusercontent.com/openshift/microshift/main/docs/config/microshift-starter.ks

sudo -b bash -c " \
Expand All @@ -50,29 +50,30 @@ The OS console is also accessible from the `virt-manager GUI` as a result of run

## Access MicroShift

From the OS console of the virtual machine, it is possible to log into the machine using your user credentials, `redhat:redhat`.

It is possible to use the OS console of the virtual machine to log into the system using the `redhat:redhat` user credentials.
However, it is most convenient to access the MicroShift virtual machine using SSH.

First, get the machine IP address with the following command.

```bash
sudo virsh domifaddr microshift-starter
Name MAC address Protocol Address
-------------------------------------------------------------------------------
vnet2 52:54:00:6d:08:f7 ipv4 192.168.122.2/24
```

Set the `USHIFT_IP` variable with the machine IP address value to be used in the subsequent commands.

```bash 
USHIFT_IP=192.168.122.2
```

Copy your pull secret file to the MicroShift virtual machine using `redhat:redhat` credentials.

```bash
USHIFT_IP=192.168.122.2
scp ~/.pull-secret.json redhat@${USHIFT_IP}:
```

Log into the MicroShift virtual machine.
Log into the MicroShift virtual machine using `redhat:redhat` credentials.

```bash
ssh redhat@192.168.122.2 # when prompted, password is `redhat`
ssh redhat@${USHIFT_IP}
```

The remaining commands are to be executed from within the virtual machine as the `redhat` user.
Expand All @@ -87,12 +88,13 @@ Enable the MicroShift RPM repos and install MicroShift and the `oc` and `kubectl

```bash
sudo subscription-manager repos \
--enable rhocp-4.12-for-rhel-8-x86_64-rpms \
--enable fast-datapath-for-rhel-8-x86_64-rpms
--enable rhocp-4.13-for-rhel-9-$(uname -i)-rpms \
--enable fast-datapath-for-rhel-9-$(uname -i)-rpms
sudo dnf install -y microshift openshift-clients
```

Confgure the minimum required firewall rules.

```bash
sudo firewall-cmd --permanent --zone=trusted --add-source=10.42.0.0/16
sudo firewall-cmd --permanent --zone=trusted --add-source=169.254.169.1
Expand Down