Veritas Access 7.3 Administrator's Guide

Last Published:
Product(s): Access (7.3)
Platform: Linux
  1. Section I. Introducing Veritas Access
    1. Introducing Veritas Access
      1.  
        About Veritas Access
      2.  
        Accessing the Veritas Access CLI
      3.  
        Navigating the Veritas Access CLI
      4.  
        Getting help using the Veritas Access command-line interface
      5.  
        Displaying the command history
      6.  
        Using the more command
  2. Section II. Configuring Veritas Access
    1. Adding users or roles
      1.  
        Adding Master, System Administrator, and Storage Administrator users
      2.  
        About user roles and privileges
      3.  
        About the naming requirements for adding new users
    2. Configuring the network
      1.  
        About configuring the Veritas Access network
      2.  
        About bonding Ethernet interfaces
      3.  
        Bonding Ethernet interfaces
      4.  
        Configuring DNS settings
      5.  
        About the IP addresses for the Ethernet interfaces
      6.  
        About Ethernet interfaces
      7.  
        Displaying current Ethernet interfaces and states
      8.  
        Configuring IP addresses
      9.  
        Configuring Veritas Access to use jumbo frames
      10.  
        Configuring VLAN interfaces
      11.  
        Configuring NIC devices
      12.  
        Swapping network interfaces
      13.  
        Excluding PCI IDs from the cluster
      14.  
        About configuring routing tables
      15.  
        Configuring routing tables
      16.  
        Changing the firewall settings
    3. Configuring authentication services
      1.  
        About configuring LDAP settings
      2.  
        Configuring LDAP server settings
      3.  
        Administering the Veritas Access cluster's LDAP client
      4.  
        Configuring the NIS-related settings
      5.  
        Configuring NSS lookup order
  3. Section III. Managing Veritas Access storage
    1. Configuring storage
      1.  
        About storage provisioning and management
      2.  
        Displaying information for all disk devices associated with the nodes in a cluster
      3.  
        About configuring storage pools
      4.  
        Configuring storage pools
      5.  
        About quotas for usage
      6.  
        About quotas for CIFS home directories
      7.  
        Enabling, disabling, and displaying the status of file system quotas
      8.  
        Setting and displaying file system quotas
      9.  
        Setting user quotas for users of specified groups
      10. About Flexible Storage Sharing
        1.  
          Limitations of Flexible Storage Sharing
      11.  
        Workflow for configuring and managing storage using the Veritas Access CLI
      12.  
        Displaying WWN information
      13.  
        Initiating host discovery of LUNs
      14.  
        Importing new LUNs forcefully for new or existing pools
      15.  
        Increasing the storage capacity of a LUN
      16.  
        About configuring disks
      17.  
        Configuring disks
      18.  
        Formatting or reinitializing a disk
      19.  
        Removing a disk
    2. Configuring data integrity with I/O fencing
      1.  
        About I/O fencing
      2. Configuring disk-based I/O fencing
        1.  
          Replacing an existing coordinator disk
        2.  
          Disabling I/O fencing
        3.  
          Destroying the coordinator pool
      3.  
        Using majority-based fencing
    3. Configuring ISCSI
      1.  
        About iSCSI
      2.  
        Configuring the iSCSI initiator
      3.  
        Configuring the iSCSI initiator name
      4.  
        Configuring the iSCSI devices
      5.  
        Configuring discovery on iSCSI
      6.  
        Configuring the iSCSI targets
      7.  
        Modifying tunables for iSCSI
  4. Section IV. Managing Veritas Access file access services
    1. Configuring your NFS server
      1.  
        About using NFS server with Veritas Access
      2.  
        Using the kernel-based NFS server
      3.  
        Using the NFS-Ganesha server
      4.  
        Switching between NFS servers
      5.  
        Recommended tuning for NFS-Ganesha version 3 and version 4
      6.  
        Accessing the NFS server
      7.  
        Displaying and resetting NFS statistics
      8.  
        Configuring Veritas Access for ID mapping for NFS version 4
      9.  
        Configuring the NFS client for ID mapping for NFS version 4
      10.  
        About authenticating NFS clients
      11. Setting up Kerberos authentication for NFS clients
        1.  
          Adding and configuring Veritas Access to the Kerberos realm
    2. Using Veritas Access as a CIFS server
      1.  
        About configuring Veritas Access for CIFS
      2.  
        About configuring CIFS for standalone mode
      3.  
        Configuring CIFS server status for standalone mode
      4.  
        Changing security settings
      5.  
        Changing security settings after the CIFS server is stopped
      6. About Active Directory (AD)
        1.  
          Configuring entries for Veritas Access DNS for authenticating to Active Directory (AD)
        2.  
          Joining Veritas Access to Active Directory (AD)
        3.  
          Verifying that Veritas Access has joined Active Directory (AD) successfully
      7. About configuring CIFS for Active Directory (AD) domain mode
        1.  
          Configuring CIFS for the AD domain mode
        2.  
          Using multi-domain controller support in CIFS
        3.  
          About leaving an AD domain
        4.  
          Changing domain settings for AD domain mode
        5.  
          Removing the AD interface
      8.  
        Setting NTLM
      9. About setting trusted domains
        1.  
          Specifying trusted domains that are allowed access to the CIFS server
        2.  
          Allowing trusted domains access to CIFS when setting an IDMAP backend to rid
        3.  
          Allowing trusted domains access to CIFS when setting an IDMAP backend to ldap
        4.  
          Allowing trusted domains access to CIFS when setting an IDMAP backend to hash
        5.  
          Allowing trusted domains access to CIFS when setting an IDMAP backend to ad
        6.  
          About configuring Windows Active Directory as an IDMAP backend for CIFS
        7.  
          Configuring the Active Directory schema with CIFS-schema extensions
        8.  
          Configuring the LDAP client for authentication using the CLI
        9.  
          Configuring the CIFS server with the LDAP backend
        10.  
          Setting Active Directory trusted domains
      10.  
        About storing account information
      11.  
        Storing user and group accounts
      12.  
        Reconfiguring the CIFS service
      13.  
        About mapping user names for CIFS/NFS sharing
      14.  
        About the mapuser commands
      15.  
        Adding, removing, or displaying the mapping between CIFS and NFS users
      16.  
        Automatically mapping of UNIX users from LDAP to Windows users
      17. About managing home directories
        1.  
          Setting the home directory file systems
        2.  
          Setting up home directories
        3.  
          Displaying home directory usage information
        4.  
          Deleting home directories and disabling creation of home directories
      18. About CIFS clustering modes
        1.  
          About switching the clustering mode
      19. About migrating CIFS shares and home directories
        1.  
          Migrating CIFS shares and home directories from normal to ctdb clustering mode
        2.  
          Migrating CIFS shares and home directories from ctdb to normal clustering mode
      20.  
        Setting the CIFS aio_fork option
      21. About managing local users and groups
        1.  
          Creating a local CIFS user
        2.  
          Configuring a local group
      22.  
        Enabling CIFS data migration
    3. Configuring Veritas Access to work with Oracle Direct NFS
      1.  
        About using Veritas Access with Oracle Direct NFS
      2.  
        About the Oracle Direct NFS architecture
      3.  
        About Oracle Direct NFS node or storage connection failures
      4.  
        Configuring an Oracle Direct NFS storage pool
      5.  
        Configuring an Oracle Direct NFS file system
      6.  
        Configuring an Oracle Direct NFS share
      7.  
        Best practices for improving Oracle database performance
    4. Configuring an FTP server
      1.  
        About FTP
      2.  
        Creating the FTP home directory
      3.  
        Using the FTP server commands
      4.  
        About FTP server options
      5.  
        Customizing the FTP server options
      6.  
        Administering the FTP sessions
      7.  
        Uploading the FTP logs
      8.  
        Administering the FTP local user accounts
      9.  
        About the settings for the FTP local user accounts
      10.  
        Configuring settings for the FTP local user accounts
  5. Section V. Managing the Veritas Access Object Store server
    1. Using Veritas Access as an Object Store server
      1.  
        About the Object Store server
      2.  
        Use cases for configuring the Object Store server
      3.  
        Configuring the Object Store server
      4.  
        About buckets and objects
      5.  
        File systems used for objectstore buckets
      6.  
        Multi-protocol support for NFS with S3
  6. Section VI. Monitoring and troubleshooting
    1. Monitoring events and audit logs
      1.  
        About event notifications
      2.  
        About severity levels and filters
      3.  
        Configuring an email group
      4.  
        Configuring a syslog server
      5.  
        Displaying events on the console
      6.  
        Exporting events in syslog format to a given URL
      7.  
        About SNMP notifications
      8.  
        Configuring an SNMP management server
      9.  
        Configuring events for event reporting
  7. Section VII. Provisioning and managing Veritas Access file systems
    1. Creating and maintaining file systems
      1.  
        About creating and maintaining file systems
      2. Considerations for creating a file system
        1.  
          Best practices for creating file systems
        2.  
          About scale-out file systems
        3.  
          Characteristics of a scale-out file system
        4.  
          About striping file systems
        5.  
          About creating a tuned file system for a specific workload
        6.  
          About FastResync
        7.  
          About scale-out fsck
        8.  
          About setting retention in files
        9.  
          About managing application I/O workloads using maximum IOPS settings
      3.  
        Choosing a file system layout type
      4.  
        Determining the initial extent size for a file system
      5.  
        Creating a file system
      6.  
        Bringing the file system online or offline
      7.  
        Listing all file systems and associated information
      8. Modifying a file system
        1.  
          Adding or removing a mirror from a file system
        2.  
          Adding or removing a column from a file system
        3.  
          Increasing the size of a file system
        4.  
          Decreasing the size of a file system
      9. Managing a file system
        1.  
          Defragmenting a file system
        2.  
          Checking and repairing a file system
        3.  
          Configuring FastResync for a file system
        4.  
          Disabling the FastResync option for a file system
        5.  
          Checking and resynchronizing stale mirrors
        6.  
          Setting file system alerts
        7.  
          Displaying file system alert values
        8.  
          Removing file system alerts
      10.  
        Destroying a file system
      11.  
        Upgrading disk layout versions
  8. Section VIII. Configuring cloud storage
    1. Configuring the cloud gateway
      1.  
        About the cloud gateway
      2.  
        Configuring the cloud gateway
    2. Configuring cloud as a tier
      1.  
        Configuring the cloud as a tier feature for scale-out file systems
      2.  
        Moving files between tiers in a scale-out file system
      3. About policies for scale-out file systems
        1.  
          About pattern matching for data movement policies
        2.  
          About schedules for running policies
        3.  
          Creating and scheduling a policy for a scale-out file system
      4.  
        Obtaining statistics on data usage in the cloud tier in scale-out file systems
      5.  
        Workflow for moving on-premises storage to cloud storage for NFS shares
  9. Section IX. Provisioning and managing Veritas Access shares
    1. Creating shares for applications
      1.  
        About file sharing protocols
      2.  
        About concurrent access
      3.  
        Sharing directories using CIFS and NFS protocols
      4.  
        Sharing a file system as a CIFS home directory
      5.  
        About concurrent access with NFS and S3
    2. Creating and maintaining NFS shares
      1.  
        About NFS file sharing
      2.  
        Displaying file systems and snapshots that can be exported
      3.  
        Exporting an NFS share
      4.  
        Displaying exported directories
      5.  
        About managing NFS shares using netgroups
      6.  
        Unexporting a directory or deleting NFS options
      7.  
        Exporting an NFS share for Kerberos authentication
      8.  
        Mounting an NFS share with Kerberos security from the NFS client
      9.  
        Exporting an NFS snapshot
    3. Creating and maintaining CIFS shares
      1.  
        About managing CIFS shares
      2.  
        Exporting a directory as a CIFS share
      3.  
        Configuring a CIFS share as secondary storage for an Enterprise Vault store
      4.  
        Exporting the same file system/directory as a different CIFS share
      5.  
        About the CIFS export options
      6.  
        Setting share properties
      7.  
        Hiding system files when adding a CIFS normal share
      8.  
        Displaying CIFS share properties
      9.  
        Allowing specified users and groups access to the CIFS share
      10.  
        Denying specified users and groups access to the CIFS share
      11.  
        Exporting a CIFS snapshot
      12.  
        Deleting a CIFS share
      13.  
        Modifying a CIFS share
      14.  
        Making a CIFS share shadow copy aware
    4. Using Veritas Access with OpenStack
      1.  
        About the Veritas Access integration with OpenStack
      2. About the Veritas Access integration with OpenStack Cinder
        1.  
          About the Veritas Access integration with OpenStack Cinder architecture
        2.  
          Configuring Veritas Access with OpenStack Cinder
      3. About the Veritas Access integration with OpenStack Manila
        1.  
          OpenStack Manila use cases
        2.  
          Configuring Veritas Access with OpenStack Manila
        3.  
          Creating a new share backend on the OpenStack controller node
        4.  
          Creating an OpenStack Manila share type
        5.  
          Creating an OpenStack Manila file share
        6.  
          Creating an OpenStack Manila share snapshot
  10. Section X. Managing Veritas Access storage services
    1. Deduplicating data
      1.  
        About data deduplication
      2.  
        Best practices for using the Veritas Access deduplication feature
      3.  
        Setting up deduplication
      4.  
        Configuring deduplication
      5.  
        Manually running deduplication
      6.  
        Scheduling deduplication
      7.  
        Setting deduplication parameters
      8.  
        Removing deduplication
      9.  
        Verifying deduplication
    2. Compressing files
      1. About compressing files
        1.  
          About the compressed file format
        2.  
          About the file compression attributes
        3.  
          About the file compression block size
      2.  
        Use cases for compressing files
      3.  
        Best practices for using compression
      4. Compression tasks
        1.  
          Compressing files
        2.  
          Scheduling compression jobs
        3.  
          Listing compressed files
        4.  
          Showing the scheduled compression job
        5.  
          Uncompressing files
        6.  
          Modifying the scheduled compression
        7.  
          Removing the specified schedule
        8.  
          Stopping the schedule for a file system
        9.  
          Removing the pattern-related rule for a file system
        10.  
          Removing the modified age related rule for a file system
    3. Configuring SmartTier
      1.  
        About Veritas Access SmartTier
      2.  
        How Veritas Access uses SmartTier
      3.  
        Adding tiers to a file system
      4.  
        Adding or removing a column from a secondary tier of a file system
      5.  
        Configuring a mirror to a tier of a file system
      6.  
        Listing all of the files on the specified tier
      7.  
        Displaying a list of SmartTier file systems
      8.  
        About tiering policies
      9.  
        About configuring the policy of each tiered file system
      10.  
        Configuring the policy of each tiered file system
      11.  
        Best practices for setting relocation policies
      12.  
        Relocating a file or directory of a tiered file system
      13.  
        Displaying the tier location of a specified file
      14.  
        About configuring schedules for all tiered file systems
      15.  
        Configuring schedules for tiered file systems
      16.  
        Displaying the files that may be moved or pruned by running a policy
      17.  
        Allowing metadata information on the file system to be written on the secondary tier
      18.  
        Restricting metadata information to the primary tier only
      19.  
        Removing a tier from a file system
    4. Configuring SmartIO
      1.  
        About SmartIO for solid-state drives
      2.  
        About configuring SmartIO
      3.  
        About SmartIO read caching for applications running on Veritas Access file systems
      4.  
        Setting up SmartIO read caching for Veritas Access
      5.  
        About SmartIO writeback caching for applications running on Veritas Access file systems
      6.  
        Setting up SmartIO writeback caching for VxFS file systems
      7.  
        Tuning the writeback caching
      8.  
        Flushing dirty data from a writeback cache area
      9.  
        Setting the caching mode
      10.  
        Customizing the caching behavior
      11.  
        Viewing the caching statistics for a cache area
      12.  
        Verifying the VxFS cache area and monitoring the caching
    5. Configuring replication
      1.  
        About Veritas Access file-level replication
      2.  
        How Veritas Access replication works
      3.  
        About Veritas Access sync replication
      4.  
        How Veritas Access sync replication works
      5.  
        Starting Veritas Access replication
      6.  
        Setting up communication between the source and the destination clusters
      7.  
        Setting up the file systems to replicate
      8.  
        Setting up files to exclude from a replication unit
      9.  
        Scheduling the replication
      10.  
        Defining what to replicate
      11.  
        About the maximum number of parallel replication jobs
      12.  
        Managing a replication job
      13.  
        Replicating compressed data
      14.  
        Displaying replication job information and status
      15.  
        Synchronizing a replication job
      16.  
        Behavior of the file systems on the replication destination target
      17.  
        Accessing file systems configured as replication destinations
      18.  
        Creating a recovery point objective (RPO) report
      19. Replication job failover and failback
        1.  
          Process summary
        2.  
          Overview of the planned failover process
        3.  
          Overview of the planned failback process
        4.  
          Overview of the unplanned failover process
        5.  
          Overview of the unplanned failback process
    6. Using snapshots
      1.  
        About snapshots
      2.  
        Creating snapshots
      3.  
        Displaying snapshots
      4.  
        Managing disk space used by snapshots
      5.  
        Bringing snapshots online or taking snapshots offline
      6.  
        Restoring a snapshot
      7.  
        About snapshot schedules
      8.  
        Configuring snapshot schedules
      9.  
        Managing automated snapshots
    7. Using instant rollbacks
      1.  
        About instant rollbacks
      2.  
        Creating a space-optimized rollback
      3.  
        Creating a full-sized rollback
      4.  
        Listing Veritas Access instant rollbacks
      5.  
        Restoring a file system from an instant rollback
      6.  
        Refreshing an instant rollback from a file system
      7.  
        Bringing an instant rollback online
      8.  
        Taking an instant rollback offline
      9.  
        Destroying an instant rollback
      10.  
        Creating a shared cache object for Veritas Access instant rollbacks
      11.  
        Listing cache objects
      12.  
        Destroying a cache object of a Veritas Access instant rollback
    8. Configuring Veritas Access with the NetBackup client
      1.  
        About Veritas Access as a NetBackup client
      2.  
        Prerequisites for configuring the NetBackup client
      3.  
        About the NetBackup Snapshot Client
      4.  
        About NetBackup snapshot methods
      5.  
        About NetBackup instant recovery
      6.  
        Enabling or disabling the NetBackup SAN client
      7.  
        Workflow for configuring Veritas Access for NetBackup
      8.  
        Registering a NetBackup master server, an EMM server, or adding an optional media server
      9.  
        Displaying the excluded files from backup
      10.  
        Displaying the included and excluded files for backups
      11.  
        Adding or deleting patterns to the list of files in backups
      12.  
        Configuring or resetting the virtual IP address used by NetBackup
      13.  
        Configuring the virtual name of NetBackup
      14.  
        Displaying the status of NetBackup services
      15.  
        Configuring backup operations using NetBackup or other third-party backup applications
      16.  
        Performing a backup or restore of a Veritas Access file system over a NetBackup SAN client
      17.  
        Performing a backup or restore of a snapshot
      18.  
        Installing or uninstalling the NetBackup client
      19.  
        Configuring Veritas Access for NetBackup cloud storage
  11. Section XI. Reference
    1. Appendix A. Veritas Access documentation
      1.  
        Using the Veritas Access product documentation
      2.  
        About accessing the online man pages
    2. Appendix B. Veritas Access tuning
      1.  
        File system mount-time memory usage

Configuring discovery on iSCSI

The iSCSI initiator contains a list of iSCSI target discovery addresses.

To display the iSCSI discovery addresses

  • To display the iSCSI discovery addresses, enter the following:
    Storage> iscsi discovery list

    For example:

    Storage> iscsi discovery list
Discovery Address
-----------------
192.168.2.14:3260
192.168.2.15:3260

To add a discovery address to the iSCSI initiator

  1. To add a discovery address to the iSCSI initiator, enter the following:
    Storage> iscsi discovery add discovery-address

    where:

    discovery-address

    The target address at which an initiator can request a list of targets using a SendTargets text request as specified in iSCSI protocol of RFC3720.

    You can specify either an IPv4 address or an IPv6 address. Optionally, you can specify a port with the IP address. For example:

    192.168.0.4
192.168.0.4:3260
2001:c90::211:9ff:feb8:a9e9
[2001:c90::211:9ff:feb8:a9e9]:3260

    If no port is specified, the default port 3260 is used. Verify that your firewall allows you to access the target location through the port. For example: 

    # telnet discovery-address 3260

    For example:

    Storage> iscsi discovery add 192.168.2.15:3260
Discovery CHAP credentials for ACCESS_1:
Outgoing CHAP Username : root
Outgoing CHAP Password : ********
Incoming CHAP Username :
Authentication succeeded.

Discovered Targets
------------------
iqn.2001-04.com.example:storage.disk2.sys3.xyz
iqn.2001-04.com.example:storage.disk3.sys3.xyz
iqn.2001-04.com.example:storage.disk4.sys3.xyz
iqn.2001-04.com.example:storage.disk5.sys3.xyz

Logging into target iqn.2001-04.com.example:storage.disk2.sys3.xyz
Logging into target iqn.2001-04.com.example:storage.disk3.sys3.xyz
Logging into target iqn.2001-04.com.example:storage.disk4.sys3.xyz
Logging into target iqn.2001-04.com.example:storage.disk5.sys3.xyz
  2. To verify the addition of the discovery address, display the discovery addresses.
    Storage> iscsi discovery list

    For example: 

    Storage> iscsi discovery list
Discovery Address
-----------------
192.168.2.14:3260
192.168.2.15:3260

To delete an iSCSI discovery address

  1. To delete the targets discovered using this discovery address, enter the following:
    Storage> iscsi discovery del discovery-address

    where:

    discovery-address

    The target address at which an initiator can request a list of targets using a SendTargets text request as specified in iSCSI protocol of RFC3720.

    You can specify either an IPv4 address or an IPv6 address. Optionally, you can specify a port with the IP address. For example:

    192.168.0.4
192.168.0.4:3260
2001:c90::211:9ff:feb8:a9e9
[2001:c90::211:9ff:feb8:a9e9]:3260

    If no port is specified, the default port 3260 is used. Verify that your firewall allows you to access the target location through the port. For example: 

    # telnet discovery-address 3260

    For example:

    Storage> iscsi discovery del 192.168.2.15:3260
  2. To verify the deletion of the discovery address, display the discovery addresses.
    Storage> iscsi discovery list
Discovery Address
-----------------
192.168.2.14:3260

To rediscover an iSCSI discovery address

  • To rediscover an iSCSI discovery address, enter the following:
    Storage> iscsi discovery rediscover discovery-address

    where:

    discovery-address

    The target address at which an initiator can request a list of targets using a SendTargets text request as specified in iSCSI protocol of RFC3720.

    You can specify either an IPv4 address or an IPv6 address. Optionally, you can specify a port with the IP address. For example:

    192.168.0.4
192.168.0.4:3260
2001:c90::211:9ff:feb8:a9e9
[2001:c90::211:9ff:feb8:a9e9]:3260

    If no port is specified, the default port 3260 is used. Verify that your firewall allows you to access the target location through the port. For example: 

    # telnet discovery-address 3260

    For example:

    Storage> iscsi discovery rediscover 192.168.2.15:3260
Deleted targets
-----------------
iqn.2001-04.com.example:storage.disk5.sys3.xyz

New targets
-----------------
iqn.2001-04.com.example:storage.disk6.sys3.new.xyz

Logging into target iqn.2001-04.com.example:storage.disk6.sys3.new.xyz

To rediscover changes in targets or LUNs at a discovery address

  • To rediscover changes in targets or LUNs at a discovery address, enter the following:
    Storage> iscsi discovery rediscover_new discovery-address

    where:

    discovery-address

    The target address at which an initiator can request a list of targets using a SendTargets text request as specified in iSCSI protocol of RFC3720.

    You can specify either an IPv4 address or an IPv6 address. Optionally, you can specify a port with the IP address. For example:

    192.168.0.4
192.168.0.4:3260
2001:c90::211:9ff:feb8:a9e9
[2001:c90::211:9ff:feb8:a9e9]:3260

    If no port is specified, the default port 3260 is used. Verify that your firewall allows you to access the target location through the port. For example: 

    # telnet discovery-address 3260

    New LUNs or targets discovered at discovery-address will be automatically added and logged into. This command does not discover any targets that have been deleted at discovery-address.

    For example: 

    Storage> iscsi discovery rediscover_new 192.168.2.15:3260
14% [|] Checking for new targets

New targets
-----------------
iqn.2001-04.com.example:storage.disk7.sys3.new.xyz

100% [#] Updating disk list