Dell Unity 650F Unity™ Family Service Commands Technical N
Dell Unity 650F Manual
View all Dell Unity 650F manuals
Add to My Manuals
Save this manual to your list of manuals |
Dell Unity 650F manual content summary:
- Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 1
Dell Unity™ Family Service Commands Technical Notes Version 5.x Rev. 09 April 2022 • Additional resources...2 • Executive summary...2 • Introduction...2 • Serviceability commands...4 • Appendix A...107 • Appendix B...125 Part Number: 302-002-574 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 2
feature documentation or release notes, go to Unity Technical Documentation at: dell.com/unitydocs. Troubleshooting For information about products, software updates, licensing, and service, go to Support (registration required) at: dell.com/ support. After logging in, locate the appropriate product - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 3
SSH) that, when combined with the proper method, can troubleshoot Unity system problems. The Service Commands listed are available on Unity systems running OE version 4.2. Authorized technical support personnel may have installed additional service commands (not found in this document) on the system - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 4
the system is in Normal Mode. Service Mode The Unity system's reduced operational mode is for maintenance and troubleshooting. In this mode, a limited interface through Unisphere or a Command Line Interface (CLI) enables problem resolution. An SP in Service Mode does not process data requests - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 5
/ success cp /mnt/NASServer00/AclDedupDB ./acl1/ success Command done with success Related commands None. Array configuration (svc_arrayconfig) This service script captures a snapshot of the configurations on the storage system. Function: Diagnostic Mode: Normal Usage: General Use Description This - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 6
● hardware-Physical inventory data ● storage-Storage related data ● network-Network related data ● host-Host related data ● service-Remote support related data ● application-Application related data ● protection-Protection related data [-v | --version] Display the script version number. Related - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 7
● Simple-Displays a message containing: ○ Unity system type ○ system hostname ○ system software ● Custom-Contains any message, including support for localized banners ○ If the custom only be set in Service Mode. As the Service user, create plain-text files in /home/service whose names follow the - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 8
System Operations Mode: Both Usage: Technical Service Description This command sets, clears, or lists boot control block tallies and breakpoints before the Unity specific software is loaded. It enables you to boot directly into the Linux operating environment for troubleshooting. If you use the net - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 9
script finds and clears a dirty cache. Function: System Operations Mode: Both Usage: Technical Service Description See Knowledgebase article 500194 (https://www.dell.com/support/kbdoc/en-sg/500914) for the full Clear Cache Lost / Dirty description. Do not attempt to Clear Cache Dirty or Lost - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 10
flag. Related commands None. Antivirus configuration (svc_cava) This service script sets up and manages the Common Internet File System read. The access time is compared with a time reference stored in the CAVA service. If the file's access time is earlier than the reference time, the file is - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 11
server, including the connection state to CAVA servers, the number of files checked and their progress. -stats Display statistics counters for 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: ● now - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 12
ADMIN: 6: Command succeeded: viruschk Related commands CIFS support (svc_cifssupport) Dynamic Access Control (svc_dac) Event Publishing diagnostics The [-r | --restore] option must only be used by authorized service personnel. NOTE: The -b option for this command is run in Normal Mode. The -r option - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 13
output for this command relates to eSLICs, this command is effective on any type of SLIC. Unity systems do not use eSLICs. NOTE: Only trained service personnel should use the [-c | --change_chassis] and [-u | --upgrade] qualifiers for this command. Use cases Usage: svc_change_hw_config [-h | --help - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 14
system memory. [-b | --begin] [-c | --commit] [-a | --abort] Begin an upgrade; valid in Normal Mode. Commit an upgrade; valid in Service Mode. Abort an upgrade; valid in Service Mode. NOTE: An upgrade involves running this script twice. 1. Run this script using the [-b | --begin] option to start - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 15
FC interrupt coalesce mode setting. The FC interrupt coalesce setting features Zero Interrupt Operation (ZIO), which monitors whether the system driver is servicing the response queue. If the sysem driver has made progress before the interrupt delay time expires, the firmware restarts the interrupt - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 16
None. Check hardware configuration (svc_check_hw_config) This service script displays hardware configuration information for the for the system are displayed. This can be used if the unit is in Service Mode because of an invalid DIMM configuration. Use cases Usage: [-h | --help] | [-d - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 17
help and exit. Check the DIMM configuration. Run speclcli -getall. Related commands None. CIFS support (svc_cifssupport) This service script provides information for troubleshooting CIFS-related issues. Function: Configuration Mode: Normal Usage: General Use Description This command displays - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 18
-accessright -acl -audit Display help and exit. Use this option with svc_cifssupport to view the top-level options for the 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_cifssupport -setspn -help - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 19
about the test that is executed by the command. Display or build a Windows user credential. Use this command to troubleshoot user access control issues. Usage: svc_cifssupport { | ALL} -cred {-user -domain | -sid | -uname } [-build - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 20
-homedir -Join -logontrace -lsarpc Usage: svc_cifssupport { | ALL} -gpo [-info] [-update] Enable or disable the SMB home directories. Once the feature is enabled, a homedir file containing the name of the SMB users and their related home dirctory must be uploaded to the NAS server - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 21
a domain user name and password pair. Use this command to troubleshoot connection issues or test DC connections. This command only applies to verifies that a CIFS server can access and use the domain controller services. Applies to compname only. Usage: svc_cifssupport { | ALL} - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 22
-setspn 22 | -domain | -sid | -uid | -gid ] | -create {-name -domain | -sid } | -update {-name -domain | -sid } | -delete {-name -domain | -sid } | -export [-file ] | - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 23
and AD. Troubleshoot issues with the Microsoft Windows Branch caching mechanism. BranchCache V1 and BranchCache V2 are supported. Usage: svc_cifssupport output of -info. -info Show detailed information for the hash generation service. -fsusage Display the SMB hash file disk usage for - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 24
||| SERVER_119[DOMAINB] on if=4_FCNCH0972C3275 ||| CurrentDC 0x00110c8688=FRA165202 ||| Proto=NT1, Arch=Win2K, OS 6.1 Build 7601, RemBufsz=0xffff, LocBufsz=0xffff, popupMsg=1 ||| 0 FNN in FNNlist NbUsr=1 NbCnx=2 ||| Uid=0x3f NTcred(0x0005e9b468 RC=4 NTLMSSP Capa=0x2001) 'DOMAINB\eric1' || Cnxp( - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 25
Configure ConnectEMC (svc_connectemc) This service script allows the user to enable the connection. The command runs on either SP when both SPs are in Normal Mode and is supported on both physical and virtual deployments, excluding UnityVSA Community Edition. Use cases Usage: svc_connectemc [-h | - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 26
ConnectEMC to send a message to support: svc_connectemc -t INFO [spa]: Test . Function: Recovery Mode: Normal Usage: Technical Service Description This service script is used to copy user data from Unity 480(F), 680(F), 880(F) models: 99_0_0, 99_0_1, 99_0_2, and 99_0_3 ● All other Unity models: 0_0_0 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 27
: Configuration Mode: Normal Usage: General Use Description This command installs custom SSL certificates for use by the GUI web server in both Normal and Service Mode. It looks for .pk and .crt files that contain the private key and certificate respectively - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 28
> is the file path of the directory containing the certificate files. Related commands None. Dynamic Access Control (svc_dac) This service script provides Dynamic Access Control configuration and diagnostic options. Function: Configuration, Diagnostic Mode: Normal Usage: General Use Description - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 29
Perform an action on , where is one of: ● SVDM_A ● SVDM_B ● ALL [-e | --enable] [-d | --disable] [-s | --state] --cap-stagingenable --cap-stagingdisable [-v | --verbosity] Enable DAC on . Only valid if is ALL. Disable DAC on . Only valid if < - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 30
--id Configuration,CN=Configuration, DC=test,DC=prv". Show details of the policy with the specified policy id in the policy manager associated with , where is of the form S-1-17-n-n-n-n. [-p | --preload] Load the policy with the specified distinguished name into - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 31
(no logging unless there is a problem): svc_dac SVDM_A --verbosity default Dump all svc_dac NASServer00 --info dacjb3 NOTE: In Unity, by default the compname is same as Documents Rule,CN=Central Access Rules,CN=Claims Configuration,CN=Services,CN=Configuration,DC=eft2k12r2,DC=fra,DC=location,DC=room - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 32
CN=Finance Policy,CN=Central Access Policies,CN=Claims Configuration,CN=Services,CN=Configuration,DC=eft2k12r2,DC=fra,DC=location,DC=room,DC DN=CN=Finance Documents Rule,CN=Central Access Rules,CN=Claims Configuration,CN=Services,CN=Configuration,DC=eft2k12r2,DC=fra,DC=location,DC=room,DC=com pany, - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 33
DN=CN=Finance Documents Rule,CN=Central Access Rules,CN=Claims Configuration,CN=Services,CN=Configuration,DC=eft2k12r2,DC=fra,DC=location,DC=room,DC=com "CN=Finance Policy,CN=Central Access Policies,CN=Claims Configuration,CN=Services,CN=Configuration,DC=eft2k12r2,DC=fra,DC=location,DC=room,DC=compa - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 34
Documents Rule DN=CN=Finance Documents Rule,CN=Central Access Rules,CN=Claims Configuration,CN=Services,CN=Configuration,DC=eft2k12r2,DC=fra,DC=location,DC=room,DC=com pany,DC= Antivirus configuration (svc_cava) CIFS support (svc_cifssupport) Event Publishing diagnostics (svc_event_publishing) 34 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 35
NAS settings (svc_nas) NAS server backup and restore statistics (svc_pax) Dump VHDX metadata (svc_vhdx) Data protection operations (svc_dataprotection) This service script allows the user to set the replication synchronization rate and clean up any replication session that the UEMCLI cannot delete - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 36
● syncrate= {high|med|low}-Specify the synchronization rate between the replication source and destination for synchronous replication sessions. The rate can be set at the consistency group level as well as the member level. Default is medium. ○ high-Complete the operation as quickly as possible. ○ - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 37
81604378625_FCNCH097039364_0000.ckpt000_64519397754605549.1_433 root line:1572 INFO ========3. Check on the private volume left for the replication======== root line:1579 WARNING Private vu left 81604378625_433-RepV2Priv-0 root line:1579 WARNING Private vu left 81604378625_433-RepV2Priv-1 root line: - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 38
Related commands None. Data collection (svc_dc) This service script generates a Data Collection (DC) bundle for collects system information to triage and resolve customer problems. The data collected includes system configurations, logs, Collect support materials before starting the upgrade. 38 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 39
Use cases Usage: svc_dc [-h | --help | -?] | [-v | --version] | [-l | --lifetime] | [-csp | --current-sp] | [-n | --name-prefix] | [-p | --priority] [HIGH | NORMAL] | [-lp | --list-profile] | [-s | --status] | [-pbc | --profile-based-collection] | -- - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 40
]: invoked from 26555 26554 26555 -bash [DC spb]: Arguments: [DC spb]: DCPID 26612 [DC spb]: Spawned group 26687 [DC spb]: Destination folder is: /EMC/backend/service/data_collection [DC spb]: SP status: spb -- Normal Mode Peer -- Normal Mode 40 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 41
as shown in the previous example. svc_dc -uc C4Core_dump_FCNCH123456789_2021-04-26_01_51_16 Related commands None. System diagnostics (svc_diag) This service script gathers information about the system to diagnose and triage issues. Function: Diagnostic Mode: Both Usage: General Use Description - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 42
runs a quick test across the system to show the status of hardware and software. [-l | --list] Display all valid states. [-t | --service-tree] Runs the service tree command. [-b | --boot-blocking] Shows detail about boot-blocking causes. [ -u | --update-sp-state] Update storage processor states - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 43
to view and manage information generated by the Electronic Licensing Management System (ELMS) feature. Function: Configuration Mode: Normal Usage: Technical Service Description This command enables or disables the automatic weekly ELMS usage information transfer. The command also allows the user to - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 44
service and network or cleaning up the configuration. NOTE: This command must be run on the primary SP when system is in normal mode. Commands for integrated ESRS only are not supported -establish the connection between the gateway and the Unity system. Example usage Check ESRS VE status: - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 45
(also known as the Common Event Publishing Agent) for a specified NAS server. Function: Diagnostic Mode: Normal Usage: Technical Service Description Use this service command to diagnose of the Common Event Publishing Agent (CEPA) on a NAS server. The command displays the current settings, including - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 46
succeeded: cepp info Related commands Antivirus configuration (svc_cava) CIFS support (svc_cifssupport) Dynamic Access Control (svc_dac) View locks (svc_lockd UDP port numbers. Function: Configuration Mode: Normal Usage: Technical Service Description When a NIS server sends a response to the array - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 47
clear] | [-s | --show]} Options: protocol Specify the protocol to use. Only UDP is supported, specified with the -udp option. [-h | --help] Display help and exit. [-a | list the Service Commands available to the Service user on the Unity system. Use the Inject Troubleshoots Software Tool - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 48
Options: no option Display list of service commands and exit. Example usage Display list of service commands: svc_help The following Unity serviceability commands are available to the service user: svc_acldb_dump svc_arrayconfig svc_banner svc_boot_control svc_cache svc_cava svc_cbr - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 49
(https://www.dell.com/support). Each Unity serviceability command supports a "--help" option which displays a description for the script use and usage syntax. For general Linux or Bash help, run the "linux_help" command. Related commands Inject troubleshooting software tool (svc_inject) Modify - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 50
on a node (such as a directory or file), the contents may not be the same on the source and target. These differences should be resolved manually after import completion. You must confirm this action using either the interactive prompt, or by specifying the --yes option. -d | --drop-failed-nodes - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 51
==== dir4 dir2 dir1 dir3 dir5 Clear the errors for inodes 9444 and 9449 on NAS server "NAS_server1". Any inconsistencies must be resolved manually after the import has completed. svc_imt "NAS_server1" --clear-failed-nodes 11 --node 9444 --node 9449 id fs_name == ======= 11 fs2 11 fs2 inode - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 52
system import session 13 on NAS server "NAS_server1". Any inconsistencies must be resolved manually after the import has completed. svc_imt "NAS_server1" --drop-failed-nodes 13 -- This service script sets up initial system configuration. Function: Configuration Mode: Normal Usage: Technical Service - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 53
gateway>" auto disable Specify the IPv6 address, prefix length, and default gateway manually. The items in the string must appear in the given order and be =NewSystem Related commands None. Inject troubleshooting software tool (svc_inject) This service script installs an encrypted, validated - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 54
troubleshooting tools on a Unity system. The Unity system support representatives with a unique string to enable root access. Upload discrete, securely signed files to the Unity SP directly using file-based injection. Inject software tools in Normal Mode. Tools injected while an SP is in Service - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 55
hotfix_tracker123_artf456": svc_inject -h -e hotfix_tracker123_artf456 List all injected service tools and hotfixes: svc_inject -l -a Related cold reset. This cold reset power cycles only the BMC and troubleshoots BMC issues such as console inaccessibility. This command can also retrieve the - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 56
script restores the correct KMIP server configuration and, if necessary, the Unity certificates so that the array can return to Normal Mode. Function: Recovery Mode: Service Usage: Technical Service Description If there is a problem with or unexpected change to the KMIP configuration or status, the - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 57
server. The default value is 5696. number> NOTE: If there is a firewall between the KMIP server and the Unity array, this port must be open. [-u | --uploadcert] Upload the certificates for the KMIP server. [-h | to connect to the KMIP server and enters Service Mode. Related commands None. 57 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 58
NFSv4, and NLM for NFSv3 clients. Function: Diagnostic Mode: Normal Usage: General Use Description This command allows the Service user to view information about locks currently held for provisioned Unity storage. It can be used for range locks, which control access to specific parts of a file, open - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 59
SVDM_A stat reset Related commands Antivirus configuration (svc_cava) CIFS support (svc_cifssupport) Dynamic Access Control (svc_dac) Event Publishing Dump VHDX metadata (svc_vhdx) Mapped RAID (svc_mapped_raid) This service script is used to configure mapped RAID parameters. Function: - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 60
qualifier: ● The SSD at /mnt/ssdroot ● The backend mirror at /mnt/backend ● The cores partition at /mnt/cores Only run this command in Service Mode. If a kernel-level failure occurs while trying to run this command, the kernel can panic and cause a reboot. Use cases Usage: svc_mount [-h | --help - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 61
Create management interface (svc_network) Advanced NAS settings (svc_nas) This service script allows NAS server advanced management, including NAS server parameters, databases maintenance, and network troubleshooting. Function: Configuration, Diagnostic Mode: Normal Usage: General Use Description - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 62
| -ds | -dump | -kerberos | -listrealms | -listspn | -keytab [-v] | -conf | -log [-all] | -ldap | -refresh | -lookup {-user | -group | -uid | -gid | -hostbyname | -netgroup } | -nis [-lookup {-user {-name | -uid } | - - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 63
-log [-all] List the Kerberos realms that are configured on the NAS server. List the Kerberos service principles defined in Active Directory (AD) and keytab (joined CIFS server). Dump the Kerberos key table Provides lookup information about the specified resource for troubleshooting purposes. 63 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 64
member }} Provides lookup information about the specified resource for troubleshooting purposes. -info Display all NAS parameter facilities. -facility {< to the NFS proxy server. The -NFSRoot option supports these values: [minSecurity=] [host=< - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 65
. -silent Do not request user confirmation before restarting the NAS server. -panic Panic the NAS server. -threads Display running and blocked threads. -list {service= | pool=} Query and list running and blocked threads for the system, or for a specific - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 66
VDM_CHECKER DBMS VDMINDICATION VDM_REFRESH_CONF0 SSL ReplicationV2 REPV2RECOVERY REPV2ASYNCTHR REPV2CMDTIMER -stats Dump the statistics table of running/blocked threads. Example usage Display the description of the parameter cifs.windowsTimeUpdate for the specified NAS server: svc_nas mynas - - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 67
NAS server threads on the system. svc_nas ALL -threads SVDM_A : commands processed: 1 command(s) succeeded output is complete 1619797344: KERNEL: 6: SERVICE NAME POOL NAME THREADS TIME TO PANIC OPTIONS CRITICALS 1619797344: KERNEL: 6: STATMON StatmonExec 4 1800 1 0 1619797344: KERNEL: 6: THREAD NAME - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 68
Command succeeded Related commands Antivirus configuration (svc_cava) CIFS support (svc_cifssupport) Dynamic Access Control (svc_dac) Event Publishing Dump VHDX metadata (svc_vhdx) Create management interface (svc_network) This service script sets the IP address, netmask, and gateway address - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 69
-o | --down -i -a -n -g -m | --mtu -s | --adv_speed {10 | 100 | 1000 | auto} -x | --adv_duplex {full | half | auto} Options: [-h | --help] Display help and exit. [-d | --debug] Enable extra debugging - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 70
Mode: Both Usage: General Use Description This command collects network information about one or all SPs. It allows the Service user to run common network troubleshooting utilities. These utilities include netstat, tracert, ping, and ethtool. It provides information relating to the management IP - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 71
[-p | --ping] { | } Ping the specified or IPv4 target from the default port. --mtu -I --mark Ping with the specified MTU value. Specify the ping source IP or interface name. Specify the NAS connection mark used to find the source IP. [-p6 | - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 72
-e all spa][Thu May 19 22:50:38 UTC 2011] Beginning Run Settings for eth2: Supported ports: [ TP ] Supported link modes: 10baseT/Half 10baseT/Full 100baseT/Half 100baseT/Full 1000baseT/Full Supports auto-negotiation: Yes Advertised link modes: 10baseT/Half 10baseT/Full Change the IPv4 ARP caching - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 73
Bond options for FSN and LACP connections (svc_network_bond) This service script allows you to view and modify the options of for link aggregation (LACP) and fail-safe network (FSN) ports on the Unity system. Function: Configuration, Diagnostic Mode: Normal Usage: General Use Description This - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 74
the NFS client IP addresses for further investigation, including the ability to parse by NFSv3 and NFSv4. Function: Diagnostic Mode: Normal Usage: Technical Service Description List all NFS client IP addresses. NOTE: This command must be run on the primary SP. Use cases Usage: svc_nfssupport - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 75
v4 Clients: |--- 10.228.84.79 |--- 10.229.171.175 |--- 10.229.168.142 |--- 10.229.168.155 Related commands None. Synchronize time (svc_ntp) This service script synchronizes the system time with an NTP server. Function: System Operations Mode: Normal Usage: General Use 75 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 76
only runs in Normal Mode. Only use this command on the primary SP with a management IP configured. NOTE: This utility is for trained service personnel only. This action can cause the SP or SPs to reboot and cause a Data Unavailable scenario. Use cases Usage: svc_ntp [-h | --help] | [-i | --info - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 77
script displays or resets the counters for NDMP and PAX backup statistics. Function: Diagnostic Mode: Normal Usage: General Use Description This service script displays the advanced statistics of NDMP and PAX backup sessions in progress in the NAS servers. The statistics counters can also be - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 78
Display in progress NDMP/PAX backups statistics counters. -reset -verbose Reset NDMP/PAX backups statistics counters. Display in progress NDMP/PAX backups advanced statistics counters. Example usage Reset the advanced PAX statistics on SPA: svc_pax SVDM_A -stats -reset SVDM_A : commands processed - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 79
1488797790: ADMIN: 6: Command succeeded: printstats pax full Value Definition NASS STATS Thread responsible for traversing the file system and providing metadata for each directory and/or file. Total file processed Total number of files and/or directories for which metadata was processed. Total NASS - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 80
(svc_perfcheck) This service script outputs performance metrics. Function: Diagnostic Mode: Normal Usage: General Use Description This command outputs front-end and backend setup and performance metrics, and extracts information that can be useful for performance troubleshooting. Similar content - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 81
-f Specify the filename for the output. -d Specify the length of the interval in seconds. -o "" Specify the RBA type in the form of "-t -t ". If not specified, the default is "-t tcd -t fbe_lun -t spc". Valid RBA types are: off, tcd, - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 82
clears up space on the root file system or purges the logging database if specific limits are exceeded. Function: Recovery Mode: Service Usage: Technical Service Description This command attempts to find large files on the file system and generates a report to analyze the findings. This command - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 83
factory-delivered state, deleting all user data and persistent configurations. Function: Recovery Mode: Service Usage: Technical Service Description This command reinitializes a Unity system to factory settings. The Unity system's OE is overwritten with the Dell EMC Software image contained in the - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 84
: ● List-this option details why the current SP has booted into Service Mode. ● Set-this option manually forces the SP to boot into Service Mode the next time it is rebooted. ● Clear-this option resets all the boot control counters and instructs the SP to attempt to boot into Normal Mode on the next - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 85
script restarts system management software. Function: System Operations Mode: Normal Usage: Technical Service Description This command allows the Service user to initialize the system software for troubleshooting by exiting the MGMT process and then restarting it on the local or peer SP. The - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 86
it on the peer SP. Report MGMT running status. Related commands None. Map a Linux block device to a VMware hard disk (svc_scsi_id) This service script maps a Linux block device to the associated VMware hard disk in UnityVSA. Function: Diagnostic Mode: Both Usage: General Use Description This - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 87
password. The -isdefault mode switch returns a "yes" or "no." The reset option of this command sets the service password back to the default value. For a password to be compliant with Unity security policies and to be accepted as valid, it must adhere to the following guidelines: ● 8-40 characters - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 88
Service Description This command allows an authorized support entity to gain super user access to the Unity's operating system in both Normal and Service modes. The support within the service shell. This command rapidly increases the size of the svc_service_shell log file and can cause problems. 88 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 89
performs a safe reboot or shutdown of an SP, and shutdown of the system. Function: System Operations Mode: Both Usage: General Use Description This service tool performs a safe reboot or power down (halt) of a Unity SP, and shutdown of the system. SP reboot and shutdown can be performed in both - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 90
system-halt WARNING: This action shuts down the system and you have to manually power up afterwards Enter "yes" if want to proceed with this action now in progress Related commands Service Mode information (svc_rescue_state) Enable Secure Shell (svc_ssh) This service script turns the Secure Shell - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 91
, or it did not turn on when requested from within Unisphere, a Service user can manually enable SSH while logged into Linux through a serial connection to the SP with this command. This command can also disable SSH connections to the Unity system. If a user connects to the SP through SSH and SSH - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 92
automatically INFO: restart to finish applying. Monitor status with 'svc_stig -s'. If status INFO: does not change to expected value within 30 minutes, contact service INFO: provider. INFO Enter "yes" if want to proceed with this action: Display the STIG mode status for all STIGs: svc_stig -s STIG - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 93
storage, or lower layers in the configuration stack. Only run this command in Normal Mode on the Primary SP. Output is logged to the /home/service/ svc_storagecheck.log file. The output of this command is lengthy if you run all available checks. View the output log using the Linux less utility - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 94
Options: [-h | --help] [-d | --dedupe] Display help and exit. List the file systems that are performing file deduplication. NOTE: Unity systems do not support deduplication, therefore this option returns no data. [-b | --backend] List information about the backend disks configured into the system - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 95
collect trace information from the Tie-breaker Node (TBN) VM on UnityVSA High-availability. Function: Diagnostic Mode: Normal Usage: Technical Services Description This service script collects trace information for the TBN VM that can be used while diagnosing issues. Use cases Usage: svc_tbn_dc - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 96
] Default gateway. [-d | --dhcp4] Enable DHCP client (only support IPv4). [-o | --offline] Sets management interface down. Example usage To configure default gateway default 10.0.0.2 - eth2 DEBUG: Start ssh service Active: active (running) since Fri 2018-10-19 07:38:51 UTC; 6min - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 97
) Configure Tie-breaker Node network (svc_tbn_network) Shutdown Tie-breaker Node VM (svc_tbn_shutdown) Shutdown Tie-breaker Node VM (svc_tbn_shutdown) This service script provides shutdown facilities for the Tie-breaker Node (TBN) VM on UnityVSA High-availability. Function: Diagnostic Mode: Normal - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 98
tries to run tcpdump network diagnostics on a specified system interface in a safe, controlled manner. Function: Diagnostic Mode: Normal Usage: Technical Service Description This command allows you to run a Linux tcpdump on a system interface for diagnostic purposes. The output is saved in rotating - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 99
. By default, the output files are named dump.out[0-4]. The prefix unity-tcpdump- is added to output file names. [-p | --path] [path for the output file storage. By default, the output files are stored in /home/service [-W | --rotations] [number] Number of files for output use. The default value - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 100
processor. It is used to monitor the storage environment and to troubleshoot performance issues. Use this feature to correlate CIFS and NFS statistics can also use this command to control and manage the crawler service. This service crawls user-specified file system paths and creates inode to file - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 101
}] Toggle display of summary. [-noresolve] Do not attempt name resolution. [-fileresolver] Control and manage the crawler service. [-service] -start [-maxlimit ] -stop Start the service with an optional limit, in M. The limit specifies the number of inode to filepath entries that are - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 102
readBytes, writeBytes, avgTime. UDoctor utility (svc_udoctor) This service script allows you to enable or disable jobs within UDoctor scheduler framework. This script exists so that users do not have to manually edit configuration files to customize their automated jobs. This script can also - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 103
| [-s | --statistics] | [-n | --noaudit] Options: [-h | --help] [-j | --jobs] Display help and exit. Perform the specified job action. [-e | --enable] Enable the specified job. [-d | --disable] Disable the specified job. [-l | --list] Display all jobs in the UDoctor - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 104
VHDX files. Function: Diagnostic Mode: Normal Usage: Technical Service Description If a Windows client has an issue with a given SVHDX file, this command can be used to display categorized SVHDX metadata for troubleshooting. Field support personnel can dump the metadata using svc_vhdx for further - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 105
commands Antivirus configuration (svc_cava) CIFS support (svc_cifssupport) Dynamic Access Control (svc_dac failed Display help and exit. Display the status of the clustuer. Display the failed services. Example usage Check the status of the cluster: svc_view_services -c Last updated: Sun Oct - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 106
commands None. Virtual platform host check (svc_vp_hostcheck) This service script reports potential problems on the hypervisor that hosts UnityVSA. Function: Diagnostic Mode: Normal Usage: General Use Description This script is only supported on Virtual Platforms, and checks for potential host - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 107
● CPU over-subscription ● Memory over-subscription ● Disk latency ● Host network latency When using the svc_vp_hostcheck service command, the time frame and thresholds can be changed using the options documented below. Use cases Usage: svc_ vp_hostcheck -h | -s [] | -e [] | -t - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 108
● current-Value currently used by the system. ● configured-Value applied after restarting the NAS server (for local parameters) or SP (for global parameters). Some parameters are applied without restarting the NAS server or the SP. Parameters that control global resources are defined globally (for - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 109
that CIFS network backup applications can back up and restore them to and from a Unity file system. ○ Bit 3 set (0001000 or +8) - If bit 3 is set point to. ○ Bit 4 set (0010000 or +16) - Any file or directory on a Unity system can have as many as three names in the file system: a UNIX name, a long - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 110
Table 2. NAS server parameters (continued) Facility Parameter name Values cifs acl.restrictedTak 0 or 1 eOwnership Default: 0 cifs admin.shareC_N 0 or 1 otCreated Default: 0 cifs admin.shareC_R 0 or 1 O Default: 0 cifs allowSnapSureVs 0 or 1 s Default: 1 cifs cifsclient.timeout - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 111
: 127 cifs maxVCThreads 1-0xffffffff Default: 3 cifs nthreads 32-2048 Defaults: Unity 300: 384 Unity 350, 400, and 500: 512 Description Scope Controls whether to disable checking this parameter is memory dependent. Ensure that the system memory can support your configuration. Global 111 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 112
in Network Appliance mode). ● 1 = Ignore the DOS read-only attribute and allow the deletion of files and directories. NAS server Unity does not support CIFS extended attributes and the system rejects any request to set the extended attributes of a file. Some applications, however, rely on this - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 113
this parameter to 1 are disconnected by the server upon processing the next request. ● 0 = SMB1 clients have access to the SMB servers. ● 1 = SMB clients supporting only the SMB1 protocol (XP, Windows 2003 and earlier OS) cannot access to the SMB servers when the SMB MAX protocol is configured to - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 114
Table 2. NAS server parameters (continued) Facility Parameter name Values cvfs virtualDirName Text string Default: ckpt Description ● 1 = Timestamps are updated on CIFS close (this is how Windows behaves). CVFS version 2 allows users to traverse mounted checkpoint from a hidden virtual - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 115
. Global Specifies the port number which file import sessions use to connect to the source VNX HTTP DHSM service. This value needs to be the same as the port number used by the HTTP service on the source side. This parameter needs to be set correctly when the source VDM to be - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 116
Table 2. NAS server parameters (continued) Facility Parameter name Values Description Scope To reduce the maximum count below the current count of entries, use the server_ldap -clear command or restart the NAS server. ldap cacheMaxHosts 10-1000000 Specifies the maximum number of cached hosts - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 117
Table 2. NAS server parameters (continued) Facility Parameter name Values NDMP bufsz 64-1168 Default: 256 NDMP CDBFsinfoBufSiz 16-2048 eInKB Default: 1024 NDMP concurrentDataS 1-20 treams Default: 20 NDMP NDMP NDMP NDMP NDMP convDialect Text string Default: 8859-1 dialect envTakeLast - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 118
to the device. NAS server Determines whether SnapSure is used for backup if the NDMP environment variable SNAPSURE is not set or not supported by the DMA software. The NDMP environment variable, if set, overrides this parameter. ● 0 = Do not use SnapSure for backup. ● 1 = Use SnapSure for backup - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 119
NAS server parameters (continued) Facility Parameter name Values Unity 300: 384 Unity 350, 400, and 500: 512 Unity 450, 550, 600, and 650: 1024 nfs from the reuse of relinquished ports. ● 0 = Do not support DNFS. ● 1 = Support Oracle 11g DNFS clients that use NFSv3. NAS server Specifies the - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 120
, respectively, where domain_name is defined in the parameter nfsv4.domain. NAS server To translate the UID or GID into this format, a Unix Directory Service must be configured and a reverse lookup of the UID or GID must be successful. If these conditions are not met, the system handles the - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 121
Table 2. NAS server parameters (continued) Facility Parameter name Values Description For example: "hosts: dns passwd: files nis group:nis" Scope Unspecified databases use default rules according to the NAS server setup. pax checkUtf8Filena 0 or 1 Specify whether to check if file names are - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 122
to the user. This means the "space available" displays factors in the space that are preallotted to quota trees, users, and groups. rquota is not supported for tree quotas. ● 2 = The df command will only report the space available to the file system or the tree. This means only the space in - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 123
, but only those owned by root. 0 through 3 assume their binary values. Refer to the multiprotocol resources for Unity systems on dell.com/support for more information about this parameter. shadow shadow ssl followdotdot 0 or 1 Default: 0 offlinebitfilter 0 or 1 Default: 1 protocol 2, 3, or - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 124
+ 0x10 + 0x20 Controls notifications to users (through Windows pop-up messages) and the admin (through System Management events) when the CAVA service deletes, modifies, or renames a file because of a virus infection. ● 0 = Send Virus Checker file deletion and rename event notifications to System - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 125
the maximum is reached. The SMB/CIFS thread is blocked until the low water mark is reached again. NOTE: Restart the virus checker service for changes to take effect. Appendix B Available file statistics for svc_topstats The following is a list of the available statistics paths and field names - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 126
name = nfs.nassvr.*.client.*.readCalls description = Number of read calls this client has executed type = Counter member_stats = member_elements = member_of = nfs.nassvr.*.client name = nfs.nassvr.*.client.*.writeCalls description = Number of write calls this client has executed type - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 127
name = nfs.nassvr.*.user.*.writeCalls description = Number of write calls this client has executed type = Counter member_stats = member_elements = member_of = nfs.nassvr.*.user name = nfs.nassvr.*.user.*.suspectCalls description = Number of suspicious NFS calls type = Counter - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 128
name = nfs.nassvr.*.group.*.suspectCalls description = Number of suspicious NFS calls type = Counter member_stats = member_elements = member_of = nfs.nassvr.*.group name = nfs.nassvr.*.group.*.totalBytes description = Number of bytes read and written type = Counter member_stats = - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 129
name = nfs.nassvr.*.export.*.totalBytes description = Number of bytes read and written type = Counter member_stats = member_elements = member_of = nfs.nassvr.*.export name = nfs.nassvr.*.export.*.readBytes description = Number of bytes read by the NFS client type = Counter - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 130
name = cifs.nassvr.*.client description = Per CIFS client statistics type = Correlated Set member_stats = cifs.nassvr.*.client.*.totalCalls,cifs.nassvr.*.client.*.readCalls,cifs.nassvr.*.client.* .writeCalls,cifs.nassvr.*.client.*.suspectCalls,cifs.nassvr.*.client.*.totalBytes,cifs.na ssvr - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 131
Calls,cifs.nassvr.*.user.*.suspectCalls,cifs.nassvr.*.user.*.totalBytes,cifs.nassvr.*.use r.*.readBytes,cifs.nassvr.*.user.*.writeBytes,cifs.nassvr.*.user.*.avgTime member_elements = member_of = cifs.nassvr name = cifs.nassvr.*.user.*.totalCalls description = Number of CIFS calls requested - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 132
description = Number of CIFS calls requested type = Counter member_stats = member_elements = member_of = cifs.nassvr.*.server name = cifs.nassvr.*.server.*.readCalls description = Number of CIFS read calls requested type = Counter member_stats = member_elements = member_of = cifs. - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 133
type = Counter member_stats = member_elements = member_of = fs.qtree name = fs.qtree.*.writeCalls description = Number of write requests by the Quota Tree type = Counter member_stats = member_elements = member_of = fs.qtree name = fs.qtree.*.totalBytes description = Number of - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 134
name = fs.filesystem.*.file.*.avgTime description = Average microseconds per read and write to access the file type = member_stats = member_elements = member_of = fs.filesystem.*.file name = fs.filesystem.*.file.*.avgReadTime description = Average microseconds per read to access the - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 135
name = fs.qtreeFile.*.file.*.avgWriteTime description = Average microseconds per write to access the file type = member_stats = member_elements = member_of = fs.qtreeFile.*.file 135 - Dell Unity 650F | Unity™ Family Service Commands Technical N - Page 136
of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2016 - 2022 Dell Inc. or its subsidiaries. All rights reserved. Dell
Part Number: 302-002-574
Dell Unity
™
Family Service Commands
Technical Notes
Version 5.x
Rev. 09
April 2022
•
Additional resources
................................................................................................................................................................................................
2
•
Executive summary
..................................................................................................................................................................................................
2
•
Introduction
................................................................................................................................................................................................................
2
•
Serviceability commands
........................................................................................................................................................................................
4
•
Appendix A
.............................................................................................................................................................................................................
107
•
Appendix B
.............................................................................................................................................................................................................
125