Dell VNXe2 VNXe Series Service Commands

Dell VNXe2 Manual

Dell VNXe2 manual content summary:

  • Dell VNXe2 | VNXe Series Service Commands - Page 1
    VNXe3200 Service Commands Technical Notes 302-000-197 Rev 03 February 2015 May 2014
  • Dell VNXe2 | VNXe Series Service Commands - Page 2
    owners. For the most up-to-date regulatory document for your product line, go to the technical documentation and advisories section on the EMC online support website. Part Number: 302-000-197 VNXe Service Commands 2
  • Dell VNXe2 | VNXe Series Service Commands - Page 3
    Solution overview ...8 Key results / recommendations...8 Introduction ...9 Purpose ...9 Scope ...9 Usage ...9 Audience ...10 Terminology ...10 Serviceability Command Categories 12 Serviceability Commands ...18 ACL Database Dump (svc_acldb_dump 18 Description...18 Use Cases ...18 Example Usage...18
  • Dell VNXe2 | VNXe Series Service Commands - Page 4
    Configuration (svc_change_hw_config 27 Description...27 Use Cases ...27 Related Commands ...28 CIFS Support (svc_cifssupport) ...29 Description...29 Use Cases ...29 Related Commands ...30 Upload 40 Description...40 Use Cases ...40 Example Usage...40 Related Commands ...41 VNXe Service Commands 4
  • Dell VNXe2 | VNXe Series Service Commands - Page 5
    Inject Troubleshooting Software Tool (svc_inject 42 Description...42 Use Cases ...42 Example Usage...43 Related Commands ...43 Base Management Collect Performance Information (svc_perfcheck 53 Description...53 Use Cases ...53 Example Usage...53 Related Commands ...54 VNXe Service Commands 5
  • Dell VNXe2 | VNXe Series Service Commands - Page 6
    Related Commands ...56 Reinitialize VNXe to Factory Settings (svc_reinit 57 Description...57 Use Cases ...57 Related Commands ...57 Service Mode Information (svc_rescue_state 58 Description...58 Use Cases ...58 Related Commands ...59 Management Stack Controls (svc_restart_service 60 Description
  • Dell VNXe2 | VNXe Series Service Commands - Page 7
    Use Cases ...69 Example Usage:...69 Related Commands ...69 Redirect Output (svc_tcpdump)...70 Description...70 Use Cases ...70 Example Usage:...71 Related Commands ...71 VNXe Service Commands 7
  • Dell VNXe2 | VNXe Series Service Commands - Page 8
    by the user. You can solve common system problems within the Unisphere Service Page. However, a problem may occur that is not diagnosable or solvable by the options found on the Service Page. Solution overview A set of problem diagnostic, system configuration, and system recovery commands are
  • Dell VNXe2 | VNXe Series Service Commands - Page 9
    , when combined with the proper methodology, can troubleshoot VNXe system problems. The Service Commands listed are available on VNXe systems running or software. Operations-Supports commands for advanced troubleshooting. These tools are for use by authorized Support Representatives only. Recovery-
  • Dell VNXe2 | VNXe Series Service Commands - Page 10
    only run in standard operational mode. Service Mode-Some commands only run in maintenance and troubleshooting mode. Both-Some commands run in either mode. VNXe storage system administrators, EMC, EMC partner, field service personnel and support personnel. The Service Commands run on the VNXe Linux
  • Dell VNXe2 | VNXe Series Service Commands - Page 11
    -based, distributed support solution for command, control, and visibility into a system by an authorized remote support representative. Standard troubleshooting. In this mode, a limited interface through Unisphere or a Command Line Interface (CLI) enables problem resolution. An SP in Service
  • Dell VNXe2 | VNXe Series Service Commands - Page 12
    Serviceability Command Categories Commands may be categorized by: Function-Step of the troubleshooting process the command is best used Use-No special knowledge is needed to run or understand the results. Technical Service-Advanced training is required to run the command or understand the results.
  • Dell VNXe2 | VNXe Series Service Commands - Page 13
    Shell (svc_service_shell) Recovery Run FSCK on Storage (svc_storage_integritycheck) Run FSCK on Storage (svc_storage_integritycheck) Service Mode Information (svc_rescue_state) System Operations Purge Logs (svc_purge_logs) Boot Control (svc_boot_control) Cache (svc_cache) Help (svc_help) VNXe
  • Dell VNXe2 | VNXe Series Service Commands - Page 14
    Name Inject Troubleshooting Software Tool (svc_inject) Mount Storage (svc_mount) Synchronize Time (svc_ntp) Enable Secure Shell (svc_ssh) Table 3. Service Commands by ) Configure Backup and Recovery (svc_cbr) CIFS Support (svc_cifssupport) Upload SSL Certificates (svc_custom_cert) ESRS
  • Dell VNXe2 | VNXe Series Service Commands - Page 15
    OE (svc_reimage) Data Collection (svc_dc) System Diagnostics (svc_diag) Help (svc_help) Inject Troubleshooting Software Tool (svc_inject) Service Shell (svc_service_shell) Shutdown (svc_shutdown) Service Mode Only Redirect Output (svc_tcpdump) Operating System Information (svc_oscheck) Purge
  • Dell VNXe2 | VNXe Series Service Commands - Page 16
    Reinitialize VNXe to Factory Settings (svc_reinit) Service Mode Information (svc_rescue_state) Mount Storage (svc_mount) Table 4. Service Commands by Usage Usage Name General Use Apply Custom Log-on Banners (svc_banner) Antivirus Configuration (svc_cava) Upload SSL Certificates (
  • Dell VNXe2 | VNXe Series Service Commands - Page 17
    (svc_initial_config) Inject Troubleshooting Software Tool (svc_inject) Mount Storage (svc_mount) Create Management Interface (svc_network) Restore VNXe OE (svc_reimage) Reinitialize VNXe to Factory Settings (svc_reinit) Management Stack Controls (svc_restart_service) Service Shell (svc_service_shell
  • Dell VNXe2 | VNXe Series Service Commands - Page 18
    provides appropriate usage examples and use cases. Note that many Service Commands support a help option. Run this option with either the "--help Function: Diagnostic Mode: Normal Usage: Technical Service Description Use this command to troubleshoot ACL database issues in an online file system.
  • Dell VNXe2 | VNXe Series Service Commands - Page 19
    Usage: General Use Description This command captures the current system configuration and returns the location of the capture file. Use Cases Related Commands None. VNXe Service Commands 19
  • Dell VNXe2 | VNXe Series Service Commands - Page 20
    banner may be configured to display when authenticating through Unisphere as the Service user. The login banner may be one of three different types: serial number o Unisphere IP Address Custom-Contains any message, including support for localized banners o If the custom banner file is named "
  • Dell VNXe2 | VNXe Series Service Commands - Page 21
    , Belarusian and Chinese, 1. Create files with localized content named: a. en_US.txt b. be_BY.txt c. zh_CN.txt 2. To apply these files, run the following command as the Service user: To revert to the default style banner, run the following command as the
  • Dell VNXe2 | VNXe Series Service Commands - Page 22
    Operations Mode: Both Usage: Technical Service Description This command sets, clears, or lists boot control block tallies and breakpoints before the VNXe specific software is loaded. It enables you to boot directly into the Linux operating environment for troubleshooting. If you use the "net
  • Dell VNXe2 | VNXe Series Service Commands - Page 23
    Cache (svc_cache) Use this command to find and clear dirty cache. Function: System Operations Mode: Both Usage: Technical Service Description See Knowledgebase article emc263713 for the full Clear Cache Lost / Dirty description. Do not attempt to Clear Cache Dirty or Lost with these commands
  • Dell VNXe2 | VNXe Series Service Commands - Page 24
    uses third-party antivirus software to identify and eliminate known viruses before they infect files on the storage system. Use Cases -start Example Usage VNXe Service Commands 24
  • Dell VNXe2 | VNXe Series Service Commands - Page 25
    Related Commands None. VNXe Service Commands 25
  • Dell VNXe2 | VNXe Series Service Commands - Page 26
    Backup and Recovery (svc_cbr) This command gathers metadata information to restore the system if needed. Function: Recovery Mode: Normal Usage: Technical Service Description The command also automatically runs daily with the "-b" option and can run at any time. The "-r" option must only be used
  • Dell VNXe2 | VNXe Series Service Commands - Page 27
    : Configuration Mode: Normal Usage: General Use Description Refer to the system documentation for a complete description of upgrades and uses for this command. Use Cases VNXe Service Commands 27
  • Dell VNXe2 | VNXe Series Service Commands - Page 28
    Related Commands None. VNXe Service Commands 28
  • Dell VNXe2 | VNXe Series Service Commands - Page 29
    CIFS Support (svc_cifssupport) This command troubleshoots CIFS-related issues. Function: Configuration Mode: Normal Usage: General Use Description This command also provides information about , access logs, and so on. Note: This command must run on a primary SP. Use Cases VNXe Service Commands 29
  • Dell VNXe2 | VNXe Series Service Commands - Page 30
    Related Commands None. VNXe Service Commands 30
  • Dell VNXe2 | VNXe Series Service Commands - Page 31
    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 and < files that contain the private key and certificate respectively. The private key must have a strength of at least
  • Dell VNXe2 | VNXe Series Service Commands - Page 32
    technical analysis. Function: Diagnostic Mode: Both Usage: General Use Description This command also collects system information to triage and resolve customer problems. The data collected includes system configurations, logs, run-time data, and so on. Running this command without any options runs
  • Dell VNXe2 | VNXe Series Service Commands - Page 33
    Example Usage VNXe Service Commands 33
  • Dell VNXe2 | VNXe Series Service Commands - Page 34
    Related Commands None. VNXe Service Commands 34
  • Dell VNXe2 | VNXe Series Service Commands - Page 35
    the system to show the status of hardware and software. Executing the command without arguments will result in the basic running diagnostic. Use Cases VNXe Service Commands 35
  • Dell VNXe2 | VNXe Series Service Commands - Page 36
    Example Usage Related Commands Service mode Information (svc_rescue_state) VNXe Service Commands 36
  • Dell VNXe2 | VNXe Series Service Commands - Page 37
    's EMC Secure Remote Server (ESRS) configuration. Function: Configuration Mode: Both Usage: Technical Service Description This command enables and disables EMC Secure Remote Support (ESRS) from the command line in Service Mode. Run this command on the primary storage processor (SP). All changes made
  • Dell VNXe2 | VNXe Series Service Commands - Page 38
    . Function: Systems Operation Mode: Both Usage: General Use Description Use this command lists the Service Commands available to the Service user on the VNXe system. Use the Inject Troubleshoots Software Tool command to add more commands. In the use case below, the list includes the additional
  • Dell VNXe2 | VNXe Series Service Commands - Page 39
    Related Commands Inject Troubleshooting Software Tool (svc_inject) VNXe Service Commands 39
  • Dell VNXe2 | VNXe Series Service Commands - Page 40
    Initial This command sets up initial system configuration. Configuration (svc_initial_config) Function: Configuration Mode: Normal Usage: Technical Service Description This command configures a management IP address when the Connection Utility (CU) is not available on the network. If an
  • Dell VNXe2 | VNXe Series Service Commands - Page 41
    Related Commands None. VNXe Service Commands 41
  • Dell VNXe2 | VNXe Series Service Commands - Page 42
    Systems Operations Mode: Both Usage: Technical Service Description This command injects additional troubleshooting tools on a VNXe system. The -based injection) The key-based option allows you to provide authorized support representatives with a unique string to enable root access. Upload discrete,
  • Dell VNXe2 | VNXe Series Service Commands - Page 43
    Example Usage Related Commands None. VNXe Service Commands 43
  • Dell VNXe2 | VNXe Series Service Commands - Page 44
    a BMC cold reset. This cold reset power cycles only the BMC and troubleshoots BMC issues such as console inaccessibility. This command can also retrieve the abovementioned information from the peer BMC. It is the service command for dealing with EMC VNXe NFS locks. Use Cases Related Commands None
  • Dell VNXe2 | VNXe Series Service Commands - Page 45
    View Locks (svc_lockd) This command views information of NFS locks. Function: Diagnostic Mode: Normal Usage: General Use Description This command allows the Service user to view information about NFS locks currently held for provisioned VNXe storage. It only runs in Normal Mode when the system
  • Dell VNXe2 | VNXe Series Service Commands - Page 46
    as read-only unless specified with the "-w" qualifier: The SSD and at The backend mirror at The cores partition at Only run this command in Service Mode. If a kernel level failure occurs while trying to run this command, the kernel could panic and cause a reboot. Use Cases Related Commands Boot
  • Dell VNXe2 | VNXe Series Service Commands - Page 47
    netmask, and gateway address for a particular system interface. Function: Diagnostic Mode: Normal (if no management IP is active) or Service (Revision 2.2.x and higher: Both) Usage: Technical Service Description This command can be run in Normal Mode if no management IP is currently active on the SP
  • Dell VNXe2 | VNXe Series Service Commands - Page 48
    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 VNXe2 | VNXe Series Service Commands - Page 49
    Example Usage VNXe Service Commands 49
  • Dell VNXe2 | VNXe Series Service Commands - Page 50
    [output continues] Related Commands Collect Performance Information (svc_perfcheck) Data Collection (svc_dc) VNXe Service Commands 50
  • Dell VNXe2 | VNXe Series Service Commands - Page 51
    command synchronizes the system time with an NTP server. Function: System Operations Mode: Normal Usage: General Use Description This command allows the Service user to synchronize the VNXe's time with an NTP server. This tool can list information about the configured NTP servers and their status
  • Dell VNXe2 | VNXe Series Service Commands - Page 52
    Information (svc_oscheck) This command collects OS-related information and logs it to the user-specified file. Function: Recovery Mode: Service Usage: Technical Service Description These logs are for performance analysis and to triage system issues. The collected logs can be redirected to a desired
  • Dell VNXe2 | VNXe Series Service Commands - Page 53
    backend setup and performance metrics, and extracts information that may be useful for performance troubleshooting. Similar content is available in Data Collects bundles - see svc_dc. Performance statistics if run on the secondary SP. Use Cases [] Example Usage VNXe Service Commands 53
  • Dell VNXe2 | VNXe Series Service Commands - Page 54
    " " Related Commands Data Collection (svc_dc) Operating System Information (svc_networkcheck) Network Configuration Information (svc_networkcheck) Output Storage Information (svc_storagecheck) Redirect Output (svc_tcpdump) VNXe Service Commands 54
  • Dell VNXe2 | VNXe Series Service Commands - Page 55
    clears up space on the root file system or purges the logging database if specified limits are exceeded. Function: Recovery Mode: Service Usage: Technical Service Description This command clears up space on the root file system or purges the logging database if specified limits are exceeded. It
  • Dell VNXe2 | VNXe Series Service Commands - Page 56
    Restore VNXe OE (svc_reimage) This command is used per-SP operation to overwrite the SP's system partition. Function: Recovery Mode: Service Usage: Technical Service Description This command overwrites the SP's system partition with a known, good image stored on the backend system device while
  • Dell VNXe2 | VNXe Series Service Commands - Page 57
    command only when all installed SPs are in Service Mode. WARNING: This command is a last-resort troubleshooting solution. Try an SP reimage (svc_reimage) to correct the problem before using this command. Obtain a Data Collection and consult with the support provider before making the decision to run
  • Dell VNXe2 | VNXe Series Service Commands - Page 58
    whether an SP is able to meet baseline functionality and boot normally, or whether it should go into Service Mode for repair. Function: Recovery Mode: Service Usage: Technical Service Description This command is used in a variety of SP or system shutdown procedures, or during triage to determine
  • Dell VNXe2 | VNXe Series Service Commands - Page 59
    Related Commands System Diagnostics (svc_diag) VNXe Service Commands 59
  • Dell VNXe2 | VNXe Series Service Commands - Page 60
    management software. Function: System Operations Mode: Normal Usage: Technical Service Description This command replaces , and has extended features. You can run these extended commands to initialize the system software for troubleshooting purposes by exiting the process and then restarting it
  • Dell VNXe2 | VNXe Series Service Commands - Page 61
    this command shows the default is in use, set a new password. The mode switch returns a "yes" or "no." The option of this command sets the service password back to the default value. For a password to be compliant with VNXe security policies and to be accepted as valid, it must adhere to
  • Dell VNXe2 | VNXe Series Service Commands - Page 62
    Example Usage Related Commands None. VNXe Service Commands 62
  • Dell VNXe2 | VNXe Series Service Commands - Page 63
    system. (svc_service_shell) Function: Recovery Mode: Both Usage: Technical Service Description This command allows an authorized support entity to gain super user access to the VNXe's operating system in both Normal and Service modes. The support entity must enable this tool for use first. Once
  • Dell VNXe2 | VNXe Series Service Commands - Page 64
    a warm reboot of the SP. The SP then automatically runs through its boot processes and - assuming it is in a healthy state and no fault requiring Service Mode exists - come back online. The halt operation is similar to the reboot in that it performs the same graceful shutdown of the system software
  • Dell VNXe2 | VNXe Series Service Commands - Page 65
    Related Commands Service Mode Information (svc_rescue_state) VNXe Service Commands 65
  • Dell VNXe2 | VNXe Series Service Commands - Page 66
    over the system's Management interface. If SSH connectivity is disabled, or it did not turn on when requested from within Unisphere, a Service user may manually enable SSH while logged into Linux through a serial connection to the SP with this command. This command may also disable SSH connections
  • Dell VNXe2 | VNXe Series Service Commands - Page 67
    command runs File System Check (FSCK) on storage file systems and returns them to a mountable state. Function: Recovery Mode: Normal Usage: Technical Service Description This command automatically unmounts file systems that are in use, runs FSCK on them, and then remounts the file systems when it
  • Dell VNXe2 | VNXe Series Service Commands - Page 68
    all available checks. View the output log at the location specified above using the Linux utility. Use Cases Related Commands Collect Performance Information (svc_perfcheck) VNXe Service Commands 68
  • Dell VNXe2 | VNXe Series Service Commands - Page 69
    display information about disk mappings for user LUNs, file systems, and VDMs. It also includes intermediate mappings. Use Cases Example Usage: Related Commands None. VNXe Service Commands 69
  • Dell VNXe2 | VNXe Series Service Commands - Page 70
    attempts to run tcpdump network diagnostics on a given system interface in a safe, controlled manner. Function: Diagnostic Mode: Both 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 VNXe2 | VNXe Series Service Commands - Page 71
    Example Usage: Related Commands None. VNXe Service Commands 71
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71

VNXe3200 Service Commands
Technical Notes
302-000-197
Rev 03
February 2015