Important Update: Cohesity Products Documentation

All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.

InfoScale™ for Kubernetes 9.1.0 - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (9.1)
Platform: Linux
  1. Overview
    1.  
      Introduction
    2.  
      Features of InfoScale in Containerized environment
    3.  
      CSI Introduction
    4.  
      I/O fencing
    5.  
      Disaster Recovery
    6.  
      Licensing
    7.  
      Encryption
  2. System requirements
    1.  
      Introduction
    2.  
      Supported platforms
    3.  
      Disk space requirements
    4.  
      Hardware requirements
    5.  
      Number of nodes supported
    6.  
      DR support
  3. Preparing to install InfoScale on Containers
    1.  
      Setting up the private network
    2.  
      Guidelines for setting the media speed for LLT interconnects
    3.  
      Guidelines for setting the maximum transmission unit (MTU) for LLT
    4.  
      Synchronizing time settings on cluster nodes
    5.  
      Securing your InfoScale deployment
    6.  
      Configuring kdump
  4. Installing Arctera InfoScale on OpenShift
    1.  
      Introduction
    2. Prerequisites
      1.  
        Enabling kubelet inhibitor with systemd
      2.  
        Preflight checks before the product deployment
    3.  
      Considerations for configuring cluster or adding nodes to an existing cluster
    4.  
      Creating multiple InfoScale clusters
    5.  
      InfoScale for Kubernetes with Red Hat OpenShift virtualization platform
    6. Installing InfoScale on a system with Internet connectivity
      1.  
        Using IncludeDevices for selective storage management
      2.  
        Installing from OperatorHub by using web console
      3.  
        Installing from OperatorHub by using Command Line Interface (CLI)
      4.  
        Installing by using YAML
    7.  
      Using InfoScale storage with OpenShift virtualization
    8. InfoScale for Kubernetes support for Two-Node Arbiter (TNA) clusters
      1.  
        Prerequisites and compatibility requirements
      2.  
        Configuration
      3.  
        Installation
  5. Installing Arctera InfoScale on Kubernetes
    1.  
      Introduction
    2.  
      Prerequisites
    3.  
      Installing Node Feature Discovery (NFD) Operator and Cert-Manager on Kubernetes
    4.  
      Downloading Installer
    5. Tagging the InfoScale images on Kubernetes
      1.  
        Downloading side car images
    6.  
      Applying licenses
    7.  
      Considerations for configuring cluster or adding nodes to an existing cluster
    8.  
      Creating multiple InfoScale clusters
    9. Installing InfoScale on Kubernetes
      1.  
        Configuring cluster
    10.  
      Undeploying and uninstalling InfoScale
  6. Configuring KMS-based encryption on an OpenShift cluster
    1.  
      Introduction
    2.  
      Adding a custom CA certificate
    3.  
      Configuring InfoScale to enable transfer of keys
    4.  
      Renewing with an external CA certificate
  7. Configuring KMS-based encryption on an Kubernetes cluster
    1.  
      Introduction
    2.  
      Adding a custom CA certificate
    3.  
      Configuring InfoScale to enable transfer of keys
    4.  
      Renewing with an external CA certificate
  8. InfoScale CSI deployment in Container environment
    1.  
      CSI plugin deployment
    2.  
      Raw block volume support
    3.  
      Static provisioning
    4. Dynamic provisioning
      1.  
        Reclaiming provisioned storage
    5.  
      Resizing Persistent Volumes (CSI volume expansion)
    6. Snapshot provisioning (Creating volume snapshots)
      1.  
        Dynamic provisioning of a snapshot
      2.  
        Static provisioning of an existing snapshot
      3.  
        Using a snapshot
      4.  
        Restoring a snapshot to new PVC
      5.  
        Deleting a volume snapshot
      6.  
        Creating snapshot of a raw block volume
    7. Managing InfoScale volume snapshots with Velero
      1.  
        Setting up Velero with InfoScale CSI
      2.  
        Taking the Velero backup
      3.  
        Creating a schedule for a backup
      4.  
        Restoring from the Velero backup
    8. Volume cloning
      1.  
        Creating volume clones
      2.  
        Deleting a volume clone
    9.  
      Using InfoScale with non-root containers
    10.  
      Using InfoScale in SELinux environments
    11.  
      CSI Drivers
    12.  
      Creating CSI Objects for OpenShift
    13.  
      Creating ephemeral volumes
    14.  
      Creating node affine volumes
  9. Installing and configuring InfoScale DR Manager on OpenShift
    1.  
      Introduction
    2.  
      Prerequisites
    3.  
      Creating Persistent Volume for metadata backup
    4.  
      External dependencies
    5. Installing InfoScale DR Manager by using OLM
      1.  
        Installing InfoScale DR Manager by using web console
      2.  
        Configuring InfoScale DR Manager by using web console
      3.  
        Installing from OperatorHub by using Command Line Interface (CLI)
    6. Installing InfoScale DR Manager by using YAML
      1.  
        Configuring Global Cluster Membership (GCM)
      2.  
        Configuring Data Replication
      3.  
        Configuring DNS
      4.  
        Configuring Disaster Recovery Plan
    7. Tech Preview: Disaster recovery in OpenShift virtualization environment
      1.  
        Capturing and replicating VM resources
      2.  
        Graceful workload shutdown
      3. Prerequisites and compatibility requirements
        1.  
          Required operators on the DR site
      4.  
        Deployment behavior
      5.  
        Migration and failback considerations
  10. Installing and configuring InfoScale DR Manager on Kubernetes
    1.  
      Introduction
    2.  
      Prerequisites
    3.  
      Creating Persistent Volume for metadata backup
    4.  
      External dependencies
    5. Installing InfoScale DR Manager
      1.  
        Configuring Global Cluster Membership (GCM)
      2.  
        Configuring Data Replication
      3.  
        Additional requirements for replication on Cloud
      4.  
        Configuring DNS
      5.  
        Configuring Disaster Recovery Plan
  11. Disaster Recovery scenarios
    1.  
      Migration
    2.  
      Takeover
  12. Configuring InfoScale
    1.  
      Logging mechanism
    2.  
      Configuring Arctera Oracle Data Manager (VRTSodm)
    3.  
      Enabling user access and other pod-related logs in Container environment
  13. Administering InfoScale on Containers
    1.  
      Adding nodes to an existing cluster
    2.  
      Removing nodes from an existing cluster
    3.  
      Adding storage to an InfoScale cluster
    4.  
      Managing licenses
    5.  
      Monitoring InfoScale
    6.  
      Configuring Alerts for monitoring InfoScale
    7.  
      Draining InfoScale nodes
    8.  
      Using InfoScale toolset
    9.  
      Changing the peerinact value in a cluster
    10.  
      PV rebuild
  14. Troubleshooting
    1.  
      Adding a sort data collector utility
    2.  
      Collecting logs by using SORT Data Collector
    3.  
      Approving certificate signing requests (csr) for OpenShift
    4.  
      Cert Renewal related
    5.  
      PVC deletions after PV rebuilds
    6.  
      Troubleshooting when adding storage to InfoScale cluster
    7.  
      Known Issues
    8.  
      Limitations

Resizing Persistent Volumes (CSI volume expansion)

Using the persistent volume expansion feature, you can easily expand the storage capacity of a persistent volume by just updating the Persistent Volume Claim storage specification. However, to use this feature, you must set the allowVolumeExpansion attribute to true in their StorageClass object. Only the PVCs created by using such Storage Class allow volume expansion. When the storage attribute of such a PVC object is updated, Container Orchestrator interprets it as a change request and triggers automatic volume resizing.

The following sample Storage Class yaml shows the allowVolumeExpansion attribute definition.

---
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: csi-infoscale-sc
  annotations:
    storageclass.kubernetes.io/is-default-class: "false"
provisioner: org.veritas.infoscale
reclaimPolicy: Delete
allowVolumeExpansion: true
parameters:
  fstype: vxfs
  layout: "mirror"

While performing the volume expansion operation, you must note the following:

  • Ensure that the PVC is in use by some application pod while performing resize operation. InfoScale supports dynamic volume expansion in 'Online' mode.

  • Do not perform the volume expansion operation from InfoScale SDS pods. In such case, OpenShift is not aware of these changes and updated volume size is not reflected in the PV and PVC objects.

  • InfoScale does not support the shrinking of persistent volume as OpenShift does not support it.

  • If this PVC is a part of any Disaster Recovery (DR) configuration, DR controller automatically detects this change and underlying Arctera Volume is expanded on the secondary cluster also. If PVC is resized on a primary cluster and if PVC with an identical name is available on secondary cluster, you must manually update the PVC size on the secondary cluster. Volume is resized automatically on the secondary cluster.

  • When a volume is used in any InfoScale configuration, make sure that you use only InfoScale commands to resize it. Do not use any other methods - like OS-specific commands - to resize such volumes. Doing so may disrupt the functioning of your InfoScale configuration.

After the volume is provisioned, create the container application pod, run the application, and access the volume. If the volume is full and must be resized, use one of the following ways:

  • Edit the Persistent Volume Claim

  • Use the oc patch pvc command

Note:

Resize operation on volume is not supported when it is provisioned in ReadOnlyMany mode.

Resizing a Persistent Volume by editing the Persistent Volume Claim

  1. Find the Persistent Volume Claim to resize. 
    oc get pvc

    Output similar to this is displayed: 

    NAME              STATUS  VOLUME   CAPACITY 
csi-infoscale-pvc Bound   pvc-<id> 5Gi
    ACCESS MODES STORAGECLASS     AGE
RWX          csi-infoscale-sc 32m
  2. To resize the storage capacity, edit the PVC.
    oc edit pvc csi-infoscale-pvc
  3. From your text editor, change the storage capacity to the required larger value. For example, from 5Gi to 10Gi .
  4. Check the status of the Persistent Volume Claim and Persistent Volume to verify if the size is updated. 
    oc get pvc

    Output similar to this is displayed: 

    NAME               STATUS VOLUME
csi-infoscale-pvc  Bound  pvc-<id>
    CAPACITY ACCESS MODES STORAGECLASS     AGE  
10Gi     RWX          csi-infoscale-sc 32m

Resizing a Persistent Volume using the 'patch pvc' command

  1. Find the Persistent Volume Claim to resize. 
    oc get pvc

    Output similar to this is displayed: 

    NAME              STATUS VOLUME   CAPACITY
csi-infoscale-pvc Bound  pvc-<id> 5Gi
    ACCESS MODES STORAGECLASS     AGE
RWX          csi-infoscale-sc 32m
  2. To resize the storage capacity to the required larger value, for example, from 5Gi to 10Gi, run the following command. 
     oc patch pvc csi-infoscale-pvc --patch 
'{"spec": {"resources": {"requests": {"storage": "10Gi"}}}}'
  3. Check the status of the Persistent Volume Claim and Persistent Volume to verify if the size is updated. 
     oc get pvc

    Output similar to this is displayed: 

    NAME                 STATUS   VOLUME
csi-infoscale-pvc    Bound    pvc-<id>
    CAPACITY   ACCESS MODES STORAGECLASS     AGE
10Gi       RWX          csi-infoscale-sc 32m