This is a cache of https://docs.okd.io/4.19/virt/fusion_access_SAN/install-configure-fusion-access-san.html. It is a snapshot of the page at 2025-08-09T21:54:40.110+0000.
Install and configure IBM Fusion Access for SAN - Virtualization with IBM Fusion Access for SAN | Virtualization | OKD 4.19
  1. Documentation
×

Installing and configuring {IBMFusionFirst}

To use Red Hat OKD Virtualization with IBM Fusion Access for SAN, you must first install the Fusion Access for SAN Operator.

Then you must create a Kubernetes pull secret and create the FusionAccess custom resource (CR).

Finally, follow the Red Hat OKD web console wizard to configure the storage cluster, local disk, and file systems.

Installing the Fusion Access for SAN Operator

Install the Fusion Access for SAN Operator from the OperatorHub in the OKD web console.

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

  • You have a working container registry enabled.

Procedure

  1. In the OKD web console, navigate to Operators → OperatorHub.

  2. In the Filter by keyword field, type Fusion Access for SAN.

  3. Select the Fusion Access for SAN tile and click Install.

  4. On the Install Operator page, keep the default selections for Update Channel, Version, and Installation mode.

  5. Verify that Operator recommended Namespace is selected for Installed Namespace.

    This installs the Operator in the ibm-fusion-access namespace. If this namespace does not yet exist, it is automatically created.

    If you install the Fusion Access for SAN Operator in a namespace other than ibm-fusion-access, Fusion Access for SAN does not work.

  6. Verify that the Automatic default is selected for Update Approval.

    This enables automatic updates when a new z-stream release is available.

  7. Click Install.

    This installs the Operator.

Verification

  1. Navigate to Operators → Installed Operators.

  2. Verify that the Fusion Access for SAN Operator is displayed.

Creating a Kubernetes pull secret

After installing the Fusion Access for SAN Operator, you must create a Kubernetes secret object to hold the IBM entitlement key for pulling the required container images from the IBM container registry.

Prerequisites

  • You installed the oc CLI.

  • You have access to the cluster as a user with the cluster-admin role.

  • You installed the Fusion Access for SAN Operator and created the ibm-fusion-access namespace in the process.

Procedure

  1. Log in to the IBM Container software library with your Fusion Access for SAN IBMid and password.

  2. In the IBM Container software library, get the entitlement key:

    1. If you do not have an entitlement key yet, click Get entitlement key or Add new key, and then click Copy.

    2. If you already have an entitlement key, click Copy.

  3. Save the entitlement key in a safe place.

  4. Create the secret object by running the oc create command:

    $ oc create secret -n ibm-fusion-access generic fusion-pullsecret \
--from-literal=ibm-entitlement-key=<ibm-entitlement-key> (1)
    1 This is the entitlement key you copied in step 2 from the IBM Container software library.
Verification

  1. In the OKD web console, navigate to Workloads → secrets.

  2. Find the fusion-pullsecret in the list.

Creating the FusionAccess CR

After installing the Fusion Access for SAN Operator and creating a Kubernetes pull secret, you must create the FusionAccess custome resource (CR).

Creating the FusionAccess CR triggers the installation of the correct version of IBM Storage Scale and detects worker nodes with shared LUNs.

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

  • You installed the Fusion Access for SAN Operator.

  • You created a Kubernetes pull secret.

Procedure

  1. In the OKD web console, navigate to Operators → Installed Operators.

  2. Click on the Fusion Access for SAN Operator you installed.

  3. In the Fusion Access for SAN page, select the Fusion Access tab.

  4. Click Create FusionAccess.

  5. On the Create FusionAccess page, enter the object Name.

  6. Optional: You can choose to add Labels if they are relevant.

  7. Select the IBM Storage Scale Version from the drop-down list.

    This version is the same version that was used to install the Fusion Access for SAN Operator.

  8. Click Create.

Verification

  • In the Fusion Access for SAN Operator page, in the Fusion Access tab, verify that the created FusionAccess CR appears with the status Ready.

Creating a storage cluster with Fusion Access for SAN

Once you have installed the Fusion Access for SAN Operator, you can create a storage cluster with shared storage nodes.

The wizard for creating the storage cluster in the OKD web console provides easy-to-follow steps and lists the relevant worker nodes with shared disks.

Prerequisites

  • You have bare-metal worker nodes with visible and attached shared LUNs.

    A shared LUN is a shared disk that is accessed by all workers simultaneously.

  • You installed the Fusion Access for SAN Operator.

  • You created the FusionAccess custom resource (CR) in the ibm-fusion-access namespace.

Procedure

  1. In the OKD web console, navigate to Storage → Fusion Access for SAN.

  2. Click Create storage cluster.

  3. Select the worker nodes that have shared LUNs.

    You can only select worker nodes with a minimum of 20 GB of RAM from the list.

  4. Click Create storage cluster.

    The page reloads, opening the Fusion Access for SAN page for the new storage cluster.

Creating a file system with Fusion Access for SAN

You need to create a file system to represent your required storage.

The file system is based on the storage available in the worker nodes you selected when creating the storage cluster.

Prerequisites

  • You created a Fusion Access for SAN storage cluster.

Procedure

  1. In the OKD web console, navigate to Storage → Fusion Access for SAN.

  2. In the File systems tab, click Create file system.

  3. Enter a Name for the new file system.

  4. Select the LUNs that you want to use as the storage volumes for your file system.

  5. Click Create file system.

    The Fusion Access for SAN page reloads, and the new file system appears in the File systems tab.

Next steps

Repeat this procedure for each file system that you want to create.

Verification

  1. Watch the Status of the file system in the File systems tab until it is marked as Healthy.

    This may take several minutes.

  2. Click on the StorageClass for the file system.

  3. In the YAML tab, verify the following:

    1. The value in the name field is the name of the file system you created.

    2. The value in the provisioner field is spectrumscale.csi.ibm.com.

    3. The value in the volBackendFs field matches the name of the file system you created.

      kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: filesystem1
  uid: eb410309-a043-a89b-9bb05483872a
  resourceVersion: '87746'
  creationTimestamp: '2025-05-14T12:30:08Z'
  managedFields:
provisioner: spectrumscale.csi.ibm.com
parameters:
  volBackendFs: filesystem1
reclaimPolicy: Delete
allowVolumeExpansion: true
volumeBindingMode: Immediate

Next steps

Once you create a storage cluster with file systems, you can create a virtual machine (VM) on the storage cluster.

Create a VM from an instance type or template and select one of the file systems you created as the storage type.