Users Guide
Table Of Contents
- SupportAssist Enterprise Version 1.2 User's Guide
- Overview
- Getting started with SupportAssist Enterprise
- Setting up SupportAssist Enterprise for the local system
- Setting up SupportAssist Enterprise for remote devices
- Evaluating SupportAssist Enterprise
- Downloading the SupportAssist Enterprise installation package
- Installing, Upgrading, or Migrating to SupportAssist Enterprise
- Minimum requirements for installing and using SupportAssist Enterprise
- Installing SupportAssist Enterprise
- Upgrading SupportAssist Enterprise
- Migrating to SupportAssist Enterprise
- Using SupportAssist Enterprise without registration
- Registering SupportAssist Enterprise
- Setting up an SELinux enabled system to receive alerts
- Opening the SupportAssist Enterprise user interface
- Logging in to SupportAssist Enterprise
- Logging out of SupportAssist Enterprise
- Adding devices
- Methods of adding devices
- Device types and applicable devices
- Adding a single device
- Adding a server or hypervisor
- Adding an iDRAC
- Adding a chassis
- Adding a Networking device
- Adding a PowerVault MD Series storage array
- Adding an EqualLogic PS Series storage solution
- Adding a Compellent SC Series storage solution
- Adding a Fluid File System NAS device
- Adding a software
- Adding a solution
- Adding a device by duplication
- Importing multiple devices
- Exporting details of devices that were not imported
- Revalidating a device
- Managing device discovery rules
- Viewing cases and devices
- Using Extensions
- Types of extensions
- Support for setting up adapter or Remote Collector
- Getting started with adding devices managed by systems management consoles
- Adapters
- Setting up OpenManage Essentials adapter
- Setting up the Microsoft System Center Operations Manager adapter
- Management Packs for inventorying devices managed by Operations Manager
- Setting up OpenManage Enterprise adapter
- Viewing adapter overview pane
- Viewing devices inventoried by the adapter
- Synchronizing adapter
- Editing adapter
- Deleting adapter
- Approximate time required to assign Credential Profile
- Remote Collectors
- Device grouping
- Managing device credentials
- Maintaining SupportAssist Enterprise capability
- Enabling or disabling monitoring of a device
- Performing deep discovery
- Installing or upgrading OMSA by using SupportAssist Enterprise
- Configuring SNMP settings by using SupportAssist Enterprise
- Viewing and updating the contact information
- Updating dispatch details
- Adding dispatch notes to default group
- Configuring proxy server settings
- Connectivity test
- Testing the case creation capability
- Clearing the System Event Log
- Automatic update
- Deleting a device
- Configuring email notifications
- Configuring collection settings
- Prerequisites for collecting system information
- Enabling or disabling the automatic collection of system information on case creation
- Enabling or disabling the periodic collection of system information from all devices
- Enabling or disabling the collection of identity information
- Enabling or disabling the collection of software information and the system log
- Enabling or disabling the automatic upload of collections
- Viewing collections
- Using SupportAssist Enterprise to collect and send system information
- Understanding maintenance mode
- SupportAssist Enterprise user groups
- Manually configuring SNMP settings
- Manually configuring the alert destination of a server
- Manually configuring the alert destination of a server by using the script file on server running Windows
- Manually configuring the alert destination of a server running Windows
- Manually configuring the alert destination of a server by using the script file on a server running Linux
- Manually configuring the alert destination of a server running Linux
- Manually configuring the alert destination of iDRAC by using the web interface
- Manually configuring the alert destination of a chassis by using the web interface
- Manually configuring the alert destination of a networking device
- Manually configuring the alert destination of a server
- Managing SupportAssist Enterprise alerts in TechDirect
- Other useful information
- Monitoring servers for hardware issues
- Support for automatically installing or upgrading OMSA
- Support for automatically configuring SNMP settings
- Deep discovery
- Device correlation
- Association view
- Detection of hardware issues in attached storage devices
- Support for Dell OEM servers
- Installing Net-SNMP on a server running Linux
- Configuring sudo access for SupportAssist Enterprise on a server running Linux
- Ensuring successful communication between the SupportAssist Enterprise application and the SupportAssist server
- Accessing the SupportAssist Enterprise application logs
- Event storm handling
- Accessing the context-sensitive help
- Viewing SupportAssist Enterprise product information
- Uninstalling SupportAssist Enterprise
- Identifying the generation of a Dell PowerEdge server
- Troubleshooting
- Installing SupportAssist Enterprise
- SupportAssist Enterprise registration
- Opening the SupportAssist Enterprise user interface
- Logging in to SupportAssist Enterprise
- Unable to add device
- Unable to add adapter
- Unable to add Remote Collector
- Disconnected
- Importing multiple devices
- OMSA not installed
- SNMP not configured
- New version of OMSA available
- Unable to configure SNMP
- Unable to verify SNMP configuration
- Unable to install OMSA
- Unable to verify OMSA version
- OMSA not supported
- Unable to reach device
- Unable to gather system information
- Insufficient storage space to gather system information
- Unable to export collection
- Unable to send system information
- Authentication failed
- Clearing System Event Log failed
- Maintenance mode
- Auto update
- Unable to edit device credentials
- Automatic case creation
- Scheduled tasks
- SupportAssist Enterprise services
- Tool tips
- Other services
- Security
- SupportAssist Enterprise user interface
- Error code appendix
- Related documents and resources
● Automatically create a support case if there is a problem with a device in your environment.
● Upload the collected system information to Dell.
To ensure that the SupportAssist Enterprise application is able to successfully communicate with the SupportAssist server:
● The server where the SupportAssist Enterprise application is installed must be able to connect to the following destinations:
○ https://apidp.dell.com and https://api.dell.com — end point for the SupportAssist server. On the server where
SupportAssist Enterprise is installed, verify if you can access the following locations using the web browser: https://
apidp.dell.com and https://api.dell.com.
○ https://is.us.dell.com/FUS/api/2.0/uploadfile — the file upload server where the collected system information is
uploaded.
○ https://is.us.dell.com/FUSCHUNK/api/1.0/file/uploadChunk — the file upload server where the collection files
greater than 10 MB in size are uploaded.
○ https://downloads.dell.com/ — for downloading Dell OpenManage Server Administrator (OMSA) and also for
getting new SupportAssist Enterprise release information, policy files, and product support files. On the server where
SupportAssist Enterprise is installed, verify if you can access the following location using the web browser: https://
downloads.dell.com/
○ On the server where SupportAssist Enterprise is installed, verify if port 443 is open for is.us.dell.com,
downloads.dell.com, apidp.dell.com, and api.dell.com. You can use a telnet client to test the connection. For
example, use the following command: o downloads.dell.com 443
● On the server where SupportAssist Enterprise is installed, verify if the network settings are correct.
● If the server where SupportAssist Enterprise is installed connects the Internet through a proxy server, configure the proxy
settings in SupportAssist Enterprise. See Configuring proxy server settings.
If the communication problem persists, contact your network administrator for further assistance.
Accessing the SupportAssist Enterprise application
logs
About this task
SupportAssist Enterprise saves system events and log messages in the following locations:
● On Windows:
○ Windows Event Log
○ The installation logs folder (<Drive where SupportAssist Enterprise is installed>:\Program
Files\Dell\SupportAssist\logs)
● On Linux:
○ var logs
○ The installation logs folder (/opt/dell/supportassist/logs)
A new log file is created daily at 11:59 p.m. based on the time zone configured on the system, and the log is stored in the
logs folder. The log file contains log information for the current day. At the end of each day, the log file is renamed as
application.log <date format in yyyymmdd>. If the log file is older than two days, the log file is zipped automatically. This
enables you to identify the exact log file stored for a given date when alerts occur. For example, log files similar to the following
can be seen:
● application.log
● application.log. 20171101
● application.log. 20171102 .zip
● application.log. 20171103 .zip
The log files are purged from storage after 30 days.
The log file contains log messages that correspond to the following values (or higher) in the log4j.xml file: FATAL,
ERROR, WARN, INFO, and DEBUG, with special values of OFF and ALL. The log4j.xml file is available at <Drive where
SupportAssist Enterprise is installed>:\Program Files\Dell\SupportAssist\config (on Windows)
and /opt/dell/supportassist/config (on Linux). A value of ERROR in the log4j.xml file results in log messages of
FATAL, and ERROR, since FATAL is a higher level than ERROR.
160
Other useful information