Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section

Getting Started

Column
width30%

Connect to Administration Web console available on http://<mayanas1-ip>:2020 and login as admin and click Getting Started

Click Next to proceed with Choose Storage Nodethe wizard configuration. To exit from Wizard click Cancel and again Cancel for the prompt.

To skip a step click Cancel and OK for the prompt


Column
width70%

Image Added



Section

Step1 →

Choose Storage Node

Configure Cloud Profile

Column
width30%
  • Select 2-Node HA
  • Select Storage Pool Type
    Volume Group provides robust block storage
    Choose ZFS Pool for advanced file system with compression, snapshot,  and replication
    1. Label: Give a name for this cloud profile. Ex: gcpaccount
    2. Description: Give a short description on this account
    3. Select Cloud Provider Storage Type
      AWS
      Azure
      Google Storage
    • Account or Access Key: Copy and paste the Access Key avaiable from Cloud Console settings
    • Secret: Copy and paste the key from Cloud provider console

    Click Next to proceed with High Availability


    Column
    width70%

    Image RemovedImage Added



    Section


    Column
    width30%

    Provide configuration details for High Availability

    • Active/Passive is selected
    • Primary: hostname  filled automatically
    • Secondary: Enter hostname that should match uname -n output
    • Resource ID: Enter any number 1 to 255
    • Virtual IP address: Enter any Enter  valid IPV4 VIP address that is outside this subnet IP addressapplicable for your cloud environment
      GCP: IPv4 address from  secondary address range assigned as IPaliases
      AWS: Available Private IP address within the subnet
      Azure: Any valid IPv4 address that is outside the subnet range of the instance
    • Heartbeat Link1: (Left) Select the interface to use and enter IP address of the secondary node
    • Heartbeat Link1:(Right)  Select the interface to use and enter IP address of the primary node
      Provide Heartbeat Link2 if more interfaces available

    Click Next to proceed to the next step.


    Column
    width70%


    ...

    Section


    Column
    width30%

    Please wait while High Availability configuration is being applied to both the MayaScale MayaNAS instances.  This typically takes around 30 seconds to finish.

    Click Next to proceed to the next step.


    Column
    width70%



    Section

    Step 2 → Configure

    Primary mirror NVMe Target

    Cloud Disk

    Column
    width30%

    Provide details for Primary NVMe Target

    • Node Name: Click and then add .nvme1 suffix
    • Portal Tag: Click and accept default value 1
    • Interfaces: Select the interface where the backend NVMe mirroring traffic will occur
    • IP Address: This field will be filled automatically once interface is selected
    • Port Number: Click and accept default value 4422. This way it is different from the default NVMe TCP port 4420 that will be used for the NVMe clients
    • Authorized access only: Leave this checkbox unchecked
    • Disks: Click to select all the available NVMe

    the Cloud Disk

    • Existing Bucket: If empty buckets created from the Cloud Console use existing one
      Otherwise select New Bucket
    • New Bucket: Enter new bucket name here. If using exsting bucket it will be automatically filled for you
    • Disk Name: Internal disk name for the cloud bucket name. If needed you may pick a different name or leave it as bucket name.
    • Loop Device: Indicate whether you want the cloud disk to appear as loop device to Linux
      For Bcache this option will be selected
    • Cache File: For HA operation no cache file be used. For single node it can be selected
    • Disk Size: Though cloud storage has no limit you can simply specify reasonable size here.
    • Block Size: Use the maximum block size 1MB to reduce cloud storage access costs.
    • ClusterID: This field will be automatically filled in HA mode.

    Click Next to proceed to the next step.


    Column
    width70%

    Image RemovedImage Added



    Section

    Step 3 → Configure

    Secondary mirror NVMe Target

    ZPOOL

    Column
    width30%

    Provide details for Secondary NVMe Target

    Node Name:

    ZFS storage pool

    • Zpool cache Type:
      ZIL - Recommended for heavy write workloads
      Bcache - Better for bursty and low latency workloads
    • Click and then add .nvme1 suffix
    • Portal Tag: Click and accept default value 1
    • Interfaces: Select the interface where the backend NVMe mirroring traffic will occur
    • IP Address: This field will be filled automatically once interface is selected
    • Port Number: Click and accept default value 4422. This way it is different from the default NVMe TCP port 4420 that will be used for the NVMe clients
    • Authorized access only: Leave this checkbox unchecked
    • Disks: Click to select all the available NVMe

    Click Next to proceed to the next stepadd VDEV disks to storage pool.


    Column
    width70%

    Image RemovedImage Added



    Section

    Select mirror disk for storage Pool

    Column
    width30%

    Select NVMe disks to pair and click Mirror to establish mirroringZIL disk if that option was selected earlier.

    Next select the Cloud disks as VDEV disks to pool

    Click Next to proceed to the next step.


    Column
    width70%


    Image RemovedImage AddedImage Added

    Image Removed



    Section

    Step 4 → Configure Storage Pool

    Column
    width30%

    Provide Storage Pool details

    • Label: Name for the storage pool
    • Description: Optionally enter some description for this pool

    Rest of the fields will be automatically filled. Click Next to proceed to the next step.


    Image Removed
    Column
    width70%

    Image Added


    Section

    Step 5 → Configure Volume

    Column
    width30%

    Select Storage Pool where new volumes will be provisioned

    • Click the checkbox under Name columne of the storage pool
    • Volume Type:
      Click on Block for block volumes sharing over iSCSI or NVME/TCP protocol
      Click File System for file system sharing using NFS or SMB protocol

    Click Next to proceed to the next step.


    Column
    width70%

    Image RemovedImage Added



    Section

    Create Volume

    Column
    width30%

    Provide new volume details

    • Label: Enter volume name the checkbox under Name columne of the storage poolfile sysntem dataset name
    • Description: Optionally enter some description for this volume
    • ZVOL ZFS Options: Select appropriate options for the new volume
      LZ4 Compression: Select if compression is preferred
      Sparse: Select if thin provisioning volume is preferred
      Sync: Select option for data consistency
      always → writes will be acknowledged only after committed to stable storage
      standard → writes will be committed only if the client requested
      never → all writes are fully async
    • Volume Size: Enter desired volume size. For Sparse volume this can exceed available storage pool size
    • Sequence VolumeSequence of File System: Select if more than one volumes in sequence to be created.
      For example for default 3 it will create 3 new volumes nvlun1, nvlun1, nvlun2 file systems client1,client2,client3 if label is nvlun client

    Click Next to proceed to the next step.


    Column
    width70%

    Image RemovedImage Added




    Section

    Step 6 → Configure Volume Mapping

    Column
    width30%

    Provide details on how the new volumes will be shared

    • Volume: Select the volume to be mapped
    • Controller:
      Choose iscsi or nvme-tcp for block volume
      Choose NFS or SMB for file system

    Click Next to proceed to the next step.


    Column
    width70%

    Image ModifiedImage Added



    Section


    Column
    width30%

    Provide details on how the new volumes file system will be shared

    • New NVMe Target: Share Label: Dataset
    • Record size: This should match NFS record size
    • Allowed Clients: Wild card * allows for all clients.
      List of hostnames comma separated or IP addresses or subnets can be entered
    • name Click on this radio button to create new NVMe target for the first mapping to make use of Virtual IP address
      otherwise the mapping will be a local resource only and will not be controlled by HA faiilover scripts
      Add custom name after nqn.2022-20.com.zettalane:
    • Available: Select the VIP address
    • IP Address: VIP address will appear
    • Portal Tag: unique number for this cluster wide target. Default choice is cluster id value
    • CID: Controller ID for NVMe target
    • Authorized access only: Do not click on this to allow all access.
    • Export Options:

    Click Next to proceed to the next step.


    Column
    width70%

    Image RemovedImage Added

    Image Removed




    Section

    Confirm Volume Mappings

    Column
    width30%

    Review the mapping details provided by you

    If there are more mappings to be specified for other volumes click on checkbox to Configure more mapping and the next step will present you with option to provide more mappings.

    Click Next to proceed to the next step.


    Column
    width70%

    Image RemovedImage Added




    Section


    Column
    width30%

    Final review of mapping details on how the new volumes

    Click Finish to finish Getting Started Wizard.


    Image Removed
    Column
    width70%

    Image Added


    Section


    Column
    width30%

    Click on Add or remove Mappings to make sure the new volumes are activated and ready for access from clients. 

    Occasionally the mappings may not be active due to delay in activation of the Virtual IP address in Azure environment. In that case you may manually activate by selecting the volume and clicking Bind



    Column
    width70%

    Image RemovedImage Added