iDRAC Service Module 3.0.1 User’s Guide August 2020 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use 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. Copyright © 2017 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: Introduction................................................................................................................... 5 New in this release................................................................................................................................................................ 5 Supported features — operating systems matrix.......................................................................................................
Chapter 4: Configuring the iDRAC Service Module........................................................................... 23 Configuring The iDRAC Service Module From iDRAC Web Interface..........................................................................23 Configuring the iDRAC Service Module from RACADM................................................................................................ 24 Configuring the iDRAC Service Module from WSMAN.....................................................
1 Introduction This guide provides information and step-by-step instructions on how to install iDRAC Service Module on the supported operating systems. The Integrated Dell Remote Access Controller(iDRAC) Service Module is a lightweight optional software application that can be installed on Dell’s 12th generation of PowerEdge servers or later. The iDRAC Service Module complements iDRAC interfaces – Graphical User Interface (GUI), RACADM CLI and Web Service Management (WSMAN) with additional monitoring data.
Table 1.
Downloading iDRAC Service Module You can download the iDRAC Service Module software from dell.com/support/home . Accessing documents from the Dell EMC support site You can access the required documents in one of the following ways: • Using the following links: ○ For Dell EMC Enterprise Systems Management, Dell EMC Remote Enterprise Systems Management, and Dell EMC Virtualization Solutions documents — https://www.dell.com/esmmanuals ○ For Dell EMC OpenManage documents — https://www.dell.
• 8 The Dell Lifecycle Controller 2 Web Services Interface Guide provides information and examples for utilizing the Web services for Management (WS-Man) Management protocol.
2 Preinstallation setup Ensure that you assess the following before installing the iDRAC Service Module: • • • • • • • Dell’s 14th generation of PowerEdge or later servers. For the list of supported platforms, see Supported platforms. Minimum firmware version — For iDRAC9 – 3.00.00.00 or later. Administrator privileges. Read the installation instructions for the operating system. Read the applicable release notes files and the Systems Software Support Matrix.
Supported platforms iDRAC Service Module 3.0.1 supports Dell’s 14th generation of PowerEdge servers. Servers are classified based on the type, performance, generation, and the processor used. Table 2. Server Classification Type of Server Specifics Overall Performance Rack = R Tower = T Modular = M 1 to 5 — Low End Server 5–10 — High End Server Generation Processor 4 — 14th generation 0 — Intel processor The following is the list of supported platforms for iDRAC Service Module. Table 3.
3 Installing the iDRAC Service Module The iDRAC Service Module can be installed in any of the following operating systems.
2. The Service Module Installer is exposed to the Host OS and a job has been created in iDRAC. 3. For Microsoft Windows OS, RDP to the server or go to the physical server console. For Linux OS, SSH to the host IP or go to the physical server console. 4. Find the mounted volume in your device list labeled "SMINST" and click the appropriate script to initiate install. For Microsoft Windows OS, run the batch file “ISM-Win.bat” from the command prompt. For Linux OS, run the script “ISM-Lx.sh” from the shell. 5.
The Lifecycle Controller Log Replication window is displayed. b. Specify the location where the LC logs are to be replicated. By default, Typical (Windows Logs/System) option is selected and the LC logs are replicated in the System group of the Windows Logs folder in the Event Viewer. Click Next. NOTE: You can also create a custom group in the Application and Services Log folder by selecting the Custom option in the Lifecycle Controller Log Replication window. c.
Modifying the iDRAC Service Module components on Microsoft Windows operating systems To modify iDRAC Service Module components: 1. Browse to SYSMGMT > iSM > Windows, and then run iDRACSvcMod.msi. The iDRAC Service Module ˗ InstallShield Wizard is displayed. 2. Click Next. 3. Select Modify. 4. Enable or disable the features as required and then click Next. The Lifecycle Controller Log Replication window is displayed. 5. Specify the location where you need the LC logs to be replicated.
• Uninstalling using the add/remove feature Unattended uninstall using the product ID Type msiexec /x {6728BF98-EB2D-413D-A629-F24A3C0C9631} /qn to uninstall the iDRAC Service Module using the product ID. Uninstalling using the add/remove feature The iDRAC Service Module can be uninstalled by using the Add or Remove option from the control panel. To do so, go to Start > Control Panel > Programs and Features . NOTE: You can also uninstall by selecting Uninstall after you run the iDRACSvcMod.msi.
Table 5. Linux install dependency (continued) find findutils Shell Script commands bash ifconfig net-tools ping Iputils chkconfig RedHat Enterprise Linux • chkconfig SUSE Linux Enterprise Server • install_initd aaa_base RedHat Enterprise Linux • redhat-lsb-core SUSE Linux Enterprise Server • insserv /etc/init.d/ipmi OpenIPMI Systemctl systemd Installing The iDRAC Service Module on Linux operating system 1. The available features that can be installed are displayed on the screen.
Silent installation You can install the iDRAC Service Module silently in the background without a user console. This can be achieved by using setup.sh with parameters. The parameters that can be passed to use setup.sh are: Table 6. Silent installation Parameter Description -h Help: Displays the help -I Install: Installs and enables the selected features -x Express: Installs and enables all available features.
• • For ESXi 6.0 – ISM-Dell-Web-3.0.1-.VIB-ESX60i.zip For ESXi 6.5 – ISM-Dell-Web-3.0.1-.VIB-ESX65i.zip NOTE: The feature configuration of iDRAC Service Module is not retained as is after a forced/ungraceful reboot. A backup of the configuration files is created by the ESXi hypervisor through the script /sbin/auto-backup.sh that runs periodically for every 60 minutes. If you want to retain the configuration, manually run the backup.sh script before you reboot the system.
Using the VMware Update Manager To install the iDRAC Service Module using VMware Update Manager (VUM): 1. Install VMware vSphere 5.x or later versions (vCenter Server, vSphere Client, and VMware vSphere Update Manager) on a supported Microsoft Windows operating system. 2. On the desktop, double-click VMware vSphere Client and login to vCenter Server. 3. Right-click vSphere Client host and click New Datacenter. 4. Right-click New Datacenter and click Add Host.
for ESXi 6.5 Install-VMHostPatch -VMHost - HostPath /vmfs/volumes/ name>/ISM-Dell-Web-3.0.1-.VIB-i/ cross_oem-dell-iSMesxi_3.0.1.ESXi650-0000-metadata.zip . 10. Reboot the ESXi host. 11. Run the following command to check if the iDRAC Service Module is installed successfully on the host. esxcli software vib list|grep -i open. 12. iDRAC Service Module is displayed. NOTE: For more information on Power CLI, see the VMWare official website.
Installing the iDRAC Service Module using SSH or Local Command Shell 1. Copy the ISO file to either the Citrix XenServer host or a remote ISO library share mounted to the host. Consult Citrix XenServer documentation for further details. . 2. Install the supplemental pack: $ xe-install-supplemental-pack < iDRACServiceModule-supplemental-pack-filename>.
Simpler iDRAC Access via host OS Starting from 14G servers, users need not apend login.html to the iDRAC URL. Typing https:// : automatically redirects to the iDRAC login page.
4 Configuring the iDRAC Service Module You can configure the iDRAC Service Module using the: • • • iDRAC web interface RACADM CLI command WSMAN command Topics: • • • Configuring The iDRAC Service Module From iDRAC Web Interface Configuring the iDRAC Service Module from RACADM Configuring the iDRAC Service Module from WSMAN Configuring The iDRAC Service Module From iDRAC Web Interface To use the iDRAC Service Module from the iDRAC Web interface, go to Overview > Server > Service Module.
Configuring the iDRAC Service Module from RACADM The iDRAC Service Module can be accessed and configured through RACADM CLI commands. To know the status of the features provided by the iDRAC Service Module, use racadm get idrac.servicemodule command. This command lists the features and their status of the iDRAC Service Module: • • • • • • OSInfo LCLReplication WMI Information Auto System Recovery Action iDRAC access via Host OS iDRACHardReset To set or configure the features, use racadm set idrac.
5 iDRAC Service Module monitoring features The services provided are: • • • • • • • • • • • • OS information Lifecycle Controller Log replication into operating system Automatic system recovery Windows Management Instrumentation providers inclusive of storage data Prepare to remove NVMe SSD device Remote iDRAC hard reset iDRAC access via Host OS In-band support for iDRAC SNMP alerts Enable WSMAN remotely Auto-updation of iDRAC Service Module FullPowerCycle Support Assist on the Box Topics: • • • • • • • •
Lifecycle Controller log replication into operating system Replicates the Lifecycle Controller (LC) logs to the OS logs. All events that have the OS Log option as the target (in the Alerts page or in the equivalent RACADM or WSMAN interfaces) are replicated in the OS log using the iDRAC Service Module. This process is similar to the System Event Log (SEL) replication performed by Server Administrator.
The prerequisite to manage the hardware or the firmware is to have a dedicated connection between a device and the supported iDRAC interface. Using the iDRAC access via Host OS feature, you can connect to an iDRAC interface from an OS IP or host irrespective of the connection between a device and an iDRAC dedicated network. This feature allows you to monitor the hardware or firmware even if the iDRAC is not connected to the servers.
NOTE: User does not have to download the updates from support.dell.com. The updated iSM package is locally available in iDRAC. • • • • To install or update iSM type dcism-sync.exe in the command prompt. Complete the steps in the installation wizard. To display the help content, type––help/-h. To do silent install or update, type––silent/-s. To uninstall the current version and install the update package available in LC, type ––force/-f. NOTE: This option overwrites the previous configuration.
You can view the following items in the SupportAssist dashboard. Service Request Summary In the Service Request Summary session, you can view the details of the following requests: • • • Open Closed Submitted Support Assist Overview You can view the Service Contract details such as Contract Type and Expiration Date and the Automatic Collection settings details in this session.
• • • Manual Event-Based Schedule-Based Data to Collect SupportAssist automatically creates and send a collection to technical support when there is an event-based trigger and or on a scheduled cadence. You can collect the following type of information: • • • • System Information Storage Logs OS and Application Data Debug Logs Collection Preferences User can select or set the collection preferences using this feature.
Automatic Collection By default, the automatic collection feature is enabled. To disable this feature, use the drop-down menu: • • Enable Disable You can also specify or set the time for scheduled collection by selecting any of the following options from the Schedule automatic collections drop-down menu: • • • • Weekly Monthly Quarterly Never You can also set the automatic collection as recurring.
6 Frequently asked questions This section lists some frequently asked questions about the iDRAC Service Module. Do I need to uninstall Open Manage Server Administrator before installing or running the iDRAC Service Module? No. Before you install or run the iDRAC Service Module, ensure that you have stopped the features of Server Administrator that the iDRAC Service Module provide. NOTE: Uninstalling the Server Administrator is not required.
additional information about the supported servers. What should I do now? Before installing the iDRAC Service Module, ensure that the server or the system on which the iDRAC Service Module is to be installed is a Dell’s 12th generation PowerEdge server or later. Also make sure that you have a 64-bit system.
I used the remote iDRAC hard reset feature to reset the iDRAC. However, the IPMI drives is unresponsive and I am not able to troubleshoot. If you try to use the remote iDRAC hard reset feature on VMware ESXi 5.5 U3 or ESXi 6.0 U1, the IPMI drivers becomes unresponsive, because of this the iDRAC Service Module communication is stopped. You may have to reboot the server and load the IPMI driver again to resolve the issue.
What are the Linux-dependent packages or executables I should install while completing the Linux installation? To see the list of Linux-dependent packages, see Linux dependencies. I created a custom folder in Windows Event Viewer, but the LC logs are not replicated in my custom folder. What do I have to do now to replicate the LC logs? Ensure to close the Windows Event Viewer after creating the custom folder. Open the Windows Event Viewer again to view the replicated LC logs.
reset operation, such as racadm racresetcfg. How do I troubleshoot the issue? Ensure that the OS to iDRAC passthru channel is enabled. By default, it is disabled in factory mode. To enable the OS to IDRAC passthru channel on iDRAC, use the following command, racadm set idrac.os-bmc.adminstate 1. I am seeing the past Life Cycle Logs (LCL) alerts targeted for SNMP traps replicated in Operating System logs.
7 Linux installer packages The installer packages for the supported Linux OS are provided here: Table 10. Linux installer packages Supported Linux Operating System Installer Packages Red Hat Enterprise Linux 6 SYSMGMT\iSM\linux\RHEL6\x86_64\dcism-3.0.1.el6.x86_64.rpm Red Hat Enterprise Linux 7 SYSMGMT\iSM\linux\RHEL7\x86_64\dcism-3.0.1.el7.x86_64.rpm SUSE Linux Enterprise Server 12 SYSMGMT\iSM\linux\SLES12\x86_64\dcism-3.0.1.sles12.x86_64.