Veritas InfoScale™ for Kubernetes Environments 8.0.220 - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (8.0.220)
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
      1.  
        Guidelines for setting the media speed for LLT interconnects
      2.  
        Guidelines for setting the maximum transmission unit (MTU) for LLT
    2.  
      Synchronizing time settings on cluster nodes
    3.  
      Securing your InfoScale deployment
    4.  
      Configuring kdump
  4. Installing Veritas InfoScale on OpenShift
    1.  
      Introduction
    2.  
      Prerequisites
    3.  
      Additional Prerequisites for Azure RedHat OpenShift (ARO)
    4.  
      Considerations for configuring cluster or adding nodes to an existing cluster
    5. Installing InfoScale on a system with Internet connectivity
      1. Installing from OperatorHub by using web console
        1.  
          Adding Nodes to an InfoScale cluster by using OLM
        2.  
          Undeploying and uninstalling InfoScale
      2. Installing from OperatorHub by using Command Line Interface (CLI)
        1.  
          Configuring cluster
        2.  
          Adding nodes to an existing cluster
        3.  
          Undeploying and uninstalling InfoScale by using CLI
      3. Installing by using YAML
        1.  
          Configuring cluster
        2.  
          Adding nodes to an existing cluster
        3.  
          Undeploying and uninstalling InfoScale
    6. Installing InfoScale in an air gapped system
      1.  
        Prerequisites to install by using YAML or OLM
      2.  
        Additional prerequisites to install by using yaml
      3.  
        Installing from OperatorHub by using web console
      4.  
        Installing from OperatorHub by using Command Line Interface (CLI)
      5.  
        Installing by using YAML
    7.  
      Removing and adding back nodes to an Azure RedHat OpenShift (ARO) cluster
  5. Installing Veritas InfoScale on Kubernetes
    1.  
      Introduction
    2. Prerequisites
      1.  
        Installing Node Feature Discovery (NFD) Operator and Cert-Manager on Kubernetes
    3. Tagging the InfoScale images on Kubernetes
      1.  
        Downloading side car images
    4.  
      Applying licenses
    5.  
      Tech Preview: Installing InfoScale on an Azure Kubernetes Service(AKS) cluster
    6.  
      Considerations for configuring cluster or adding nodes to an existing cluster
    7. Installing InfoScale on Kubernetes
      1.  
        Configuring cluster
      2.  
        Adding nodes to an existing cluster
    8.  
      Installing InfoScale by using the plugin
    9.  
      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.  
      Enabling rekey for an encrypted Volume
  7. Configuring KMS-based Encryption on a Kubernetes cluster
    1.  
      Introduction
    2.  
      Adding a custom CA certificate
    3.  
      Configuring InfoScale to enable transfer of keys
    4.  
      Enabling rekey for an encrypted Volume
  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
  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.  
        Additional requirements for replication on Cloud
      4.  
        Configuring DNS
      5.  
        Configuring Disaster Recovery Plan
  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 Veritas Oracle Data Manager (VRTSodm)
    3.  
      Enabling user access and other pod-related logs in Container environment
  13. Administering InfoScale on Containers
    1.  
      Adding Storage to an InfoScale cluster
    2.  
      Managing licenses
  14. Upgrading InfoScale
    1.  
      Prerequisities
    2.  
      On a Kubernetes cluster
    3.  
      On an OpenShift cluster
  15. Troubleshooting
    1.  
      Collecting logs by using SORT Data Collector
    2.  
      Known Issues
    3.  
      Limitations

Installing from OperatorHub by using Command Line Interface (CLI)

Complete the following steps.

Downloading YAML_8.0.220.tar.gz

  1. Download YAML_8.0.220.tar.gz from the Veritas Download Center.
  2. Unzip and untar YAML_8.0.220.tar.gz .

    After you unzip and untar YAML_8.0.220.tar.gz , a folder /YAML/OpenShift/OLM/ is created and all files required for installation are available in the folder.

    Note:

    An OpenShift cluster already has a namespace openshift-operators. You can choose to install InfoScale in openshift-operators. cert-manager (Red Hat-certified) must be already installed for a successful installation of InfoScale.

Optionally, you can configure a new user - infoscale-admin, associated with a Role-based Access Control ( RBAC) clusterrole defined in infoscale-admin-role.yaml, to deploy InfoScale and its dependent components. infoscale-admin as a user when configured has clusterwide access to only those resources needed to deploy InfoScale and its dependent components such as SRO/NFD/Cert Manager in the desired namespaces.

To provide a secure and isolated environment for InfoScale deployment and associated resources, the namespace associated with these resources must be protected from access of all other users (except super user of the cluster), with appropriate RBAC implemented.

Run the following commands on the bastion node to create a new user - infoscale-admin and a new project and assign role or clusterrole to infoscale-admin. You must be logged in as a super user.

Configuring a new user

  1. oc new-project <New Project name>

    A new project is created for InfoScale deployment.

  2. oc adm policy add-role-to-user admin infoscale-admin

    Following output indicates that administrator privileges are assigned to the new user - infoscale-admin within the new project.

    clusterrole.rbac.authorization.k8s.io/admin added: "infoscale-admin"
  3. oc apply -f /YAML/OpenShift/OLM/infoscale-admin-role.yaml

    Following output indicates that a clusterrole is created.

    clusterrole.rbac.authorization.k8s.io/infoscale-admin-role created
  4. oc adm policy add-cluster-role-to-user infoscale-admin-role infoscale-admin

    Following output indicates that a clusterrole created is associated with infoscale-admin.

    clusterrole.rbac.authorization.k8s.io/infoscale-admin-role added:
              "infoscale-admin"
    

After creating this user, you can login as infoscale-admin to perform all operations involved in installing InfoScale, configuring cluster, and adding nodes.

Installing Operators

  1. Run the following command on the bastion node.

    Note:

    Ignore this step if you want to install in openshift-operators.

    oc create namespace infoscale-vtas

    Review output similar to the following to verify whether the namespace is created successfully.

    namespace/infoscale-vtas created
  2. Run the following command on the bastion node to create subscription.

    Note:

    If you want to install InfoScale in openshift-operators, edit /YAML/OpenShift/OLM/infoscale-sub.yaml. Change namespace from infoscale-vtas to openshift-operators

    oc create -f /YAML/OpenShift/OLM/infoscale-sub.yaml

    Following output indicates a successful command run.

    subscription.operators.coreos.com/infoscale-sds-operator created
  3. Run the following command on the bastion node to deploy InfoScale licensing operator subscription.

    oc create -f licensing-sub.yaml

    Following output indicates a successful command run.

    subscription.operators.coreos.com
      /infoscale-licensing-operator-sub created
  4. Run the following command on the bastion node to create an operator group.

    Note:

    Ignore this step if you want to install in openshift-operators.

    oc create -f /YAML/OpenShift/OLM/infoscale-og.yaml

    Following output indicates a successful command run.

    operatorgroup.operators.coreos.com/infoscale-opgroup created
  5. Run the following command on the bastion node.

    oc get sub,og -n infoscale-vtas

    Following output indicates a successful command run.

    NAME                                                                 
    subscription.operators.coreos.com/infoscale-licensing-operator-sub   
    subscription.operators.coreos.com/infoscale-sds-operator-sub         
    
    
    PACKAGE                        SOURCE                CHANNEL
    infoscale-licensing-operator   certified-operators   stable
    infoscale-sds-operator         certified-operators   stable
    
    NAME                                                       AGE
    operatorgroup.operators.coreos.com/infoscale-sds-opgroup   82s
    
  6. Run the following command on the bastion node.

    oc get ip -A

    Use installation-name from the output similar to the following output.

    NAMESPACE      NAME          CSV                     APPROVAL APPROVED
    infoscale-vtas install-59vpz nfd.4.10.0-202206010607 Manual   false
    infoscale-vtas install-wspfv infoscale-sds-operator. Manual   false
                                 v8.0.220 
    
  7. Run the following command on the bastion node.

    Note:

    Do not include the angle brackets (< >) in the command.

    oc patch installplan <installation-name> --namespace infoscale-vtas --type merge --patch '{"spec":{"approved":true}}'

    Following output indicates a successful command run.

    installplan.operators.coreos.com/<installation-name> patched
  8. Run the following command on the bastion node.

    oc get ip -A

    Review output similar to the following . Check if APPROVED is true.

    NAMESPACE        NAME            
    infoscale-vtas   <installation-name> 
    CSV                                         APPROVAL   APPROVED
    openshift-special-resource-operator.4.9.0   Manual     true
    -202111041612
  9. Run the following command on the bastion node to check the status of csv.

    oc get csv

    Components which are getting installed or are pending are listed, as under.

    NAME                                   InfoScale Licensing Operator                  
    infoscale-sds-operator.v8.0.220        InfoScale™ SDS Operator                       
    nfd.4.10.0-202206010607                Node Feature Discovery Operator              
    openshift-cert-manager.v1.7.1          cert-manager Operator for 
                                           Red Hat OpenShift                                                             
    
    
    VERSION               REPLACES PHASE
    8.0.220                        Installing
    8.0.220                        Installing
    4.10.0-202206010607            Installing
    1.7.1-1                        Succeeded
    
  10. Run the following command on the bastion node again till all operators are installed successfully.

    oc get csv

    Review output as under.

    NAME                                    DISPLAY                                       
    infoscale-licensing-operator.v8.0.220   InfoScale Licensing Operator                  
    infoscale-sds-operator.v8.0.220         InfoScale™ SDS Operator                       
    nfd.4.10.0-202206010607                 Node Feature Discovery Operator               
    openshift-cert-manager.v1.7.1           cert-manager Operator for 
                                            Red Hat OpenShift   
                                                        
    
    
    VERSION               REPLACES      PHASE
    8.0.220                             Succeeded
    8.0.220                             Succeeded
    4.10.0-202206010607                 Succeeded
    1.7.1-1                             Succeeded
    
  11. Access your web console. Follow steps 10 to 15 in Installing from OperatorHub by using web console to install NodeFeatureDiscovery.
  12. Run the following command to check the status of all operator pods in infoscale-vtas.

    Note:

    If you have installed in openshift-operators, run oc get pods -n openshift-operators.

    oc get pods -n infoscale-vtas

    NAME                                   READY STATUS    RESTARTS   AGE
    cert-manager-64c9cb7499-ppgbk          1/1   Running   0          165m
    cert-manager-cainjector-5596f8f575
                                    -2f246 1/1   Running   0          165m
    cert-manager-webhook-7485d9dd59-864l4  1/1   Running   0          165m
    infoscale-sds-operator-6dd8d77bf8-qwg2p 1/1  Running   0          165m
    nfd-controller-manager-5fc85ff79-gx4qb 2/2   Running   0          165m
    nfd-master-6zs5p                       1/1   Running   0          55m
    nfd-master-ktc7s                       1/1   Running   0          55m
    nfd-master-n2dh9                       1/1   Running   0          55m
    nfd-worker-795vs                       1/1   Running   0          55m
    nfd-worker-8n2m9                       1/1   Running   0          55m
    nfd-worker-9j845                       1/1   Running   0          55m
    nfd-worker-vwkwq                       1/1   Running   0          55m
    special-resource-controller-manager-
    dc5d6b768-2sk4k                        2/2   Running   0          165m
    

Applying Licenses

  1. Edit /YAML/OpenShift/license_cr.yaml for the license edition. Optionally, you can change the license name. The default license edition is Developer. You can change the licenseEdition. If you want to configure Disaster Recovery (DR), you must have Enterprise as the license edition.

    See Licensing.

    apiVersion: vlic.veritas.com/v1
    kind: License
    metadata:
      name: license-dev
    spec:
      # valid licenseEdition values are Developer, 
                 Storage or Enterprise
      licenseEdition: "Developer"
      licenseServer: <Optional - IP address of
                      the VIOM server on your system>
    
  2. Run oc create -f /YAML/OpenShift/license_cr.yaml on the bastion node.
  3. Run oc get licenses on the bastion node to verify whether licenses have been successfully applied.

    An output similar to the following indicates that license_cr.yaml is successfully applied.

    NAME          NAMESPACE   LICENSE-EDITION   AGE
    license                   DEVELOPER         27s