Reference Guide
Table Of Contents
- Dell EMC PowerStore Service Scripts Guide
- Contents
- Additional Resources
- Introduction
- Service Commands
- Shut down and reboot an appliance (svc_appliance)
- Provision an appliance (svc_appliance_provisioning)
- Capture array configuration data (svc_arrayconfig)
- Make space on the root partition (svc_cleanup)
- Clear firmware update (svc_clear_fw_update_alert)
- Shut down a SAN cluster (svc_cluster)
- Diagnose a create cluster failure (svc_cluster_diag)
- Cluster management (svc_cluster_management)
- Configure new SLICs (svc_commit_slic)
- Check status of or restart container (svc_container_mgmt)
- Support materials (svc_dc)
- Generate a support materials bundle (svc_dc run)
- Delete a support materials bundle (svc_dc delete)
- List support materials (svc_dc list)
- List all support material profiles (svc_dc list_profiles)
- List all system dump files (svc_dc list_dumps)
- Download an existing support materials bundle (svc_dc download)
- Upload a support materials bundle (svc_dc upload)
- System diagnostics (svc_diag)
- Check datapath stats (svc_dp_oos_check)
- Collect flash and NVMe statistics (svc_drive_stats)
- Factory reset (svc_factory_reset)
- Perform a health check on the appliance (svc_health_check)
- Help (svc_help)
- Hypervisor diagnostics (svc_hypervisor)
- Inject troubleshooting software tool (svc_inject)
- Install service tools (svc_inject run)
- Delete an injected service tool (svc_inject delete)
- Display information about a specific package (svc_inject info)
- Generate a root or recovery package key (svc_inject generate-key)
- Deactivate service escalation (svc_inject deactivate)
- View service escalation status (svc_inject status)
- Review system journal logs (svc_journalctl)
- Install the PowerStore system (svc_manufacturing)
- Retrieve information as a root user (svc_mgmt_operations)
- Migrate a cluster or DVS to another vCenter (svc_migrate_to_vcenter)
- Run service scripts using SSH tunneling (svc_nas)
- Download the ACL database of a file system (svc_nas nas_svc_acldb_dump)
- Manage Dynamic Access Control (svc_nas nas_svc_dac)
- Generate an SDNAS archive file (svc_nas nas_svc_dc)
- Manage NAS servers (svc_nas nas_svc_nas)
- Show statistics for NDMP and PAX backup sessions (svc_nas_nas_svc_paxstats)
- Run a Linux tcpdump (svc_nas nas_svc_tcpdump)
- Back up NAS server configuration (svc_nas_cbr)
- CIFS Support (svc_nas_cifssupport)
- Enable HA monitoring (svc_nas_enable_ha_monitoring)
- Advanced NAS settings (svc_nas_tools and svc_nas_global_tools)
- Upgrade or roll back a NAS node (svc_nas_ndu)
- Repair NAS NDU (svc_nas_ndu_repair)
- Reboot, shut down, and turn on a node (svc_node)
- Check and fix the NTP status (svc_ntp_ctl)
- Disable password reset (svc_password_mgmt)
- Troubleshoot and repair (svc_remote_support)
- List the remote configuration (svc_remote_support list)
- Modify the remote support configuration (svc_remote_support_modify)
- Modify contact information (svc_remote_support modify_contact)
- Reinitialize the remote support configuration (svc_remote_support reinitialize)
- Restart SupportAssist (svc_remote_support restart)
- Check the connectivity status (svc_remote_support connectivity)
- Manage the remote syslog (svc_remote_syslog)
- Remove appliance (svc_remove_appliance)
- Repair software (svc_repair)
- Replace the DPE (svc_replace_dpe)
- Service mode operation (svc_rescue_state)
- Enable, disable, or display security protocols (svc_security_protocol)
- Grant service user access (svc_service_config)
- Gain root privileges (svc_service_shell)
- Software recovery (svc_software_recovery)
- Connect to the peer node service container (svc_ssh_peer)
- View capacity metrics (svc_volume_space_metrics)
- System Journal Fields
Introduction
PowerStore includes service scripts that enable you to diagnose issues, solve common problems, perform certain operational
tasks, and recover your system from an error state. These scripts provide in-depth level of information and a lower level of
system control than is available through other interfaces such as PowerStore Manager, CLI, and REST API. This document
describes these service scripts and how you can use them.
NOTE: The service scripts that are described in this document are a subset of the operating environment software tools
for servicing your system. You can use the CLI or REST API for scriptable system configuration for additional capability. For
more information about these interfaces, see the PowerStore CLI Guide and PowerStore REST API Developers Guide.
This chapter contains the following topics:
Topics:
• Audience
• Running the service scripts
Audience
Although no special knowledge is needed to run most of the service commands or understand the results, the service commands
are designed with storage system administrators, field service personnel, and support personnel in mind. The service commands
run on the PowerStore appliance's Linux-based operating environment. Ensure that you are familiar with the Linux shell,
associated commands, PowerStore's installed hardware, and the PowerStore operating environment.
Certain commands may require more training or require you to obtain root privileges. If the command description specifies more
training or greater privileges, do not run the commands without an approval from your authorized service representative.
Running the service scripts
Prerequisites
● Obtain the password for the Service account.
● In PowerStore Manager, under Settings, enable SSH.
● Download and install an SSH client, such as PuTTY, to a computer that has network access to the cluster. You use the SSH
client to run the scripts.
About this task
To run the service scripts:
Steps
1. Launch an SSH client, and connect to the cluster using the management IP address.
For example, in PuTTY, enter the management IP for the destination.
2. Enter the username and password for the service account to log in to the system.
Once logged in, you should be connected directly to the serviceability docker container.
3. Type the name of the script to run.
For example, to see the list of scripts, type the following: svc_help
Each script includes a --help option. Type a space and --help after the name of a script for usage information as seen in
the following example:
svc_diag --help
1
6 Introduction