Dell PowerStore Service Scripts Guide

These service scripts enable you to view and customize the parameters of various NAS server components. The default values of the NAS server parameters satisfy most use cases, but this script enables you to adjust the parameters based on your business need.

Although both svc_nas_tools and svc_nas_global_tools scripts use the same arguments and options, their application is different:

• Use the svc_nas_tools script to review and customize parameters for a specific NAS server.
• Use the svc_nas_global_tools script to review and customize parameters for all NAS servers in the cluster.

Run without args to see the NAS internal usage.

Usage

Format

svc_nas_tools [-h] [--server value] [--args="<value>"]

svc_nas_global_tools [-h] [--args="<value>"]

Optional arguments

Options

Use the --args argument to specify the following additional options:

[-h | -help | --help | <no option>]

Display help and exit. Use this option with svc_nas_tools to view the top-level options for a command. To view the options and parameters for a top-level option, use the -help option after the top-level option. For example, the output of svc_nas_tools --server nas 1 -args="-stats -help" provides detailed information about the -setspn option.

-cava

Display the status of antivirus service of the NAS server, including the connection state to Celerra AntiVirus Agent (CAVA) servers, the number of files checked and their progress.

Usage:

svc_nas_tools <NAS_server_name> --args="-cava
      [ -stats
      | -set accesstime={ now | none | [[[[yy]mm]dd]hh]mm[.ss] }]
      | -fsscan [ <fs_mountpath> { -list | -create | -delete } ]]"

-stats

Display statistics counters of the antivirus service.

-set accesstime={ now | none | [[[[yy]mm]dd]hh]mm[.ss] }]

Enable scan-on-first-read and change the access time setting, where:

• Specify now to Enable the scan-on-first-read feature and set the reference time to now.
• Specify none to disable the scan-on-first-read feature.
• Specify [[[[yy]mm]dd]hh]mm[.ss] to enable the scan-on-first-read feature and set the reference time according the specified value.

-fsscan [ <fs_mountpath> { -list | -create | -delete }

Start, stop, or view the status of a full file system scan, where:

• <fs_mountpath> option enables you to specify the location of the file system to be scanned.
• The -list option displays the scan status for the specified file system.
• The -create option initializes a full scan on the file system <fs_name> and the offline options allow the file system scan on all offline files. By default, offline file systems are not included.
• The -delete option stops the scan.

NOTE:If no file system is specified, this option displays the file system scan status for all file systems.

-dbms

Manage NAS server databases.

Usage:

svc_nas_tools <NAS_server_name> --args="-dbms
    -list [<db_name>]
    | -compact [<db_name>]
    | -stats [-reset]
    | -backup -target <path_name>
    | -restore -source <path_name> [-silent]}"

-list [<dbName>]

Display NAS server databases.

-compact [<dbName>]

Compact NAS server databases.

-stats [-reset]

Display statistics about NAS server databases.

-backup -target <pathname>

Perform an online backup of the NAS server database environment.

-restore -source <pathname> [-silent]

Restore the NAS server database environment from backup files.

-dns

Display current DNS settings of the NAS server.

Usage:

svc_nas_tools <NAS_server_name> --args="-dns
    [-dump
    | -lookup{
        -host <host_name>
        | -addr <ipv4_or_ipv6_address>}]"

-dump

Display the current DNS cache content.

-lookup {-host <host_name> | -addr <ipv4_or_ipv6_address>}

Provides lookup information about the specified resource.

-ds

Display the Windows Directory Service information.

Usage:

svc_nas_tools <NAS_server_name> --args="-ds
    [-dump]"

-dump

Display the Windows Directory Service cache.

-kerberos

Display the current Kerberos settings of the NAS server.

Usage:

svc_nas_tools <NAS_server_name> --args="-kerberos
    | -listrealms
    | -listspn
    | -keytab [-v]
    | -conf
    | -log [-all]"

NOTE:This option does not apply to the svc_nas_global_tools script.

-listrealms

List the Kerberos realms that are configured on the NAS server.

-listspn

List the Kerberos service principles defined in Active Directory (AD) and keytab (joined CIFS server).

-keytab

Dump the Kerberos key table of the NAS server.

-conf

Dump the Kerberos configuration file for this NAS server.

-log [-all]

Extract Kerberos logs from the NAS server recent log.

NOTE:The -all option scans the full server log.

-ldap

Display current LDAP settings of the NAS server.

Usage:

svc_nas_tools <NAS_server_name> --args="-ldap
   | -refresh
   | -lookup {
        -user <username>
        | -group <groupname>
        | -uid <uid>
        | -gid <gid>
        | -hostbyname <hostname>
        | -netgroup <groupname>}"

-refresh

If LDAP is configured with no static IP, refresh the IPs of the LDAP servers of the domain from DNS.

-lookup {-user <username> | -group <groupname> | -uid <uid> | -gid <gid> | -hostbyname <hostname> | -netgroup <groupname>}

Provides lookup information about the specified resource for troubleshooting purposes.

-lockd

Manage file locks on the NAS servers.

Usage:

svc_nas_tools <NAS_server_name> --args="-lockd
    | -list
    | -info -fldp <address>
    | -remove -fldp <address> -credp <address>
    | -stat [-reset]"

-list

Display the locked files on the NAS server with their count of locks; The files are ordered per file-system. Each file is identified by its inode number, and also by a fldp=<address> token for use with the -info option.

-info -fldp <address>

Show detailed information about the specific file; For each file lock, this command also displays the credp=<address> token. You can use this token with the -remove option.

-remove -fldp <address> -credp <address>

On the file identified by the fldp value, use this command to remove any range lock that matches the given lock credential.

-stat [-reset]

Show (and optionally reset) the statistics about file locks. The statistics counters are global to the SDNAS feature, and may be related to other NAS servers in the same node.

-nis

Display current NIS settings of the NAS server.

Usage:

svc_nas_tools <NAS_server_name> --args="-nis
    [-lookup{
        -user {-name <user_name> | -uid <unix_user_id>}
        | -group {-name <group_name> | -gid <group_unix_id>}
        | -host {-name <host_name> | -addr <host_ip_address>}
        | -netgroup {-name <group_name> | -member <host_name>}]"

-lookup {-user {-name <user_name> | -uid <unix_user_id>} | -group {-name <group_name> | -gid <group_unix_id>} | -host {-name <host_name> | -addr <host_ip_address>} | -netgroup {-name <group_name> | -member <host_name>}}

Provides lookup information about the specified resource for troubleshooting purposes.

-param

Display or modify NAS server parameter facilities.

Usage:

svc_nas_tools <NAS_server_name> --args="-param
    { -info
    | -facility {<facility> | -all} -list
    | -facility {<facility> | -all} -info {<param_name> [-verbose] | -all}
    | -facility <facility> -modify <param_name> -value <new_value>}"

-info

Display all NAS parameter facilities.

-facility {<facility> | -all } -list

Display all NAS parameter values of the specified facility for the specified NAS server.

-facility {<facility> | -all } -info { <paramname> [-verbose]} | -all

Display the details of the specified NAS parameter of the specified facility for the specified NAS server.

-facility <facility> -modify <paramname> -value <newvalue>

Modify the value of the specified NAS parameter of the specified facility for the specified NAS server.

-restart

Restart the specified NAS server. The output from the -info or -modify command informs the user if this is required for the specified parameter.

NOTE:This option does not apply to the svc_nas_global_tools script.

Usage:

svc_nas_tools <NAS_server_name> --args="-restart
    [-silent]"

-silent

Do not request user confirmation before restarting the NAS server.

-vhdx -file

Display the VHDX metadata (Hyper-V virtual disk files).

NOTE:This option does not apply to the svc_nas_global_tools script.

Usage:

svc_nas_tools <NAS_server_name> --args="-vhdx -file <vhdx file>
         [-verbose]"

-verbose

Display the VHDX metadata, including SCSI PRs.

Example

Use the following command to view the ACL for the smbshare share on the nas1 NAS server:

svc_nas_tools --server NasServer4461 --args="-param -facility ldap -list"


NasServer4461:
param_name              facility   default    current  configured

SecurityLayer           ldap            2          2
cacheMaxGroups          ldap        10000      10000
cacheMaxHosts           ldap        10000      10000