Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
105 changes: 105 additions & 0 deletions content/storage/ibm-fusion-access-san/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
---
title: IBM Fusion Access SAN
linktitle: IBM Fusion Access SAN
description: IBM Fusion Access SAN
tags: ['storage','v4.20']
icon: ibm/logo
---
# IBM Fusion Access SAN

Official documentation:

* <https://www.ibm.com/docs/en/fusion-software/2.12.0?topic=san-deploying-fusion-access>

Tested with:

|Component|Version|
|---|---|
|OpenShift|v4.20.4|
|OpenShift Virt|v4.20.x|
|IBM Fussion Access for SAN|2.12.0|

# Prerequisites

## Create an IBMid

<https://www.ibm.com/account/reg/us-en/signup?formid=urx-19776>

## Request a 60day IBM Storage Fusion trail version

<https://www.ibm.com/docs/en/storage-fusion/storage/2.6.0?topic=overview-storage-fusion-trial-version>

## Create an Entitlement key

<https://myibm.ibm.com/products-services/containerlibrary>

## Create an OpenShift cluster

* With at least 3 worker nodes each with ~32 GB memory
* All nodes need a shared disk. Via iSCSI, FC and KVM
* OpenShift internal registry is running with storage

!!! warning

OpenShift internal registry is mandatory because IBM Fusion Access for SAN builds via <TBD> a container image with the kernel module.

It means you need highly available storage for the internal registry to start highly available storage.

## Install Operator

<https://www.ibm.com/docs/en/fusion-software/2.12.0?topic=san-installing-fusion-access-operator>

## Create a Kubernetes pull secret

with the entitlement key from above:

```shell
oc create secret -n ibm-fusion-access generic fusion-pullsecret \
--from-literal=ibm-entitlement-key=<ibm-entitlement-key>
```

## At this point, there is a demo video available

<https://www.youtube.com/watch?v=ayXgD4e61K4>

<iframe width="560" height="315" src="https://www.youtube.com/embed/ayXgD4e61K4?si=27io6kIPJ3obqi2Z" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>

## Creating the FusionAccess CR

<https://www.ibm.com/docs/en/fusion-software/2.12.0?topic=san-creating-fusionaccess-cr>

## Creating a storage cluster

<https://www.ibm.com/docs/en/fusion-software/2.12.0?topic=san-creating-storage-cluster>

## Creating a filesystem

<https://www.ibm.com/docs/en/fusion-software/2.12.0?topic=san-creating-filesystem>

# Notes for various lab environments

Add a shared disk to all worker nodes

## Plain KVM envrioment

I deployed via <https://github.com/RedHat-EMEA-SSA-Team/hetzner-ocp4>. Now let's add a shared lvm disk becaus all is running on one node.

```shell
lvcreate -L1T -n fusion vg0
```

```shell
virsh attach-disk /dev/mapper/vg0-fusion sdb --type raw --targetbus scsi --cache none --persistent --live --wwn 5000c500155a3456

[root@pluto ~]# virsh attach-disk demo-compute-0 /dev/mapper/vg0-fusion sdb --targetbus scsi --cache none --persi
stent --live --wwn 5000c500155a3456
Disk attached successfully

[root@pluto ~]# virsh attach-disk demo-compute-1 /dev/mapper/vg0-fusion sdb --targetbus scsi --cache none --persi
stent --live --wwn 5000c500155a3456
Disk attached successfully
```

## iSCSI & RHCOS

This is ugly as hel, but works for quick testing.
25 changes: 25 additions & 0 deletions content/storage/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: Storage
linktitle: Storage
description: Storage
tags: ['storage',]
icon: fontawesome/solid/database
---
# Storage

## Content

{% set current_page_title = page.title %}
{% for n in navigation if n.title == current_page_title %}
{% for c in n.children if c.title != current_page_title %}
{% if c.abs_url is string %}

- [{{ c.title }}]({{c.canonical_url}})

{% else %}

- **[{{ c.title }}]({{ c.children[0].canonical_url }})**

{% endif %}
{% endfor %}
{% endfor %}
4 changes: 4 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -193,6 +193,10 @@ nav:
- control-plane/index.md
- Restoring etcd quorum: control-plane/lost-quorum/index.md

- Storage:
- storage/index.md
- IBM Fussion Access SAN: storage/ibm-fusion-access-san/index.md

- Troubleshooting: troubleshooting/index.md

- Client: client/index.md
Expand Down
1 change: 1 addition & 0 deletions new-page-template.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ title: New Page
linktitle: New Page
description: Some information
tags: ['tagA','tagB','v4.17']
icon: redhat/Technology_icon-Red_Hat-OpenShift_Virtualization-Standard-RGB
---
# Some information

Expand Down
7 changes: 7 additions & 0 deletions overrides/.icons/ibm/logo.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.