iDRAC Service Module (iSM)

This is Dell OpenManage repository for Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Servers (SLES). The repository includes iDRAC Service Module (iSM) package.

For more information about iDRAC Service Module, see Support for Dell iDRAC Service Module.

Repository setup

To configure the Linux repository for iSM, run the following commands:

• curl -O https://linux.dell.com/repo/hardware/ism/bootstrap.cgi

or


wget https://linux.dell.com/repo/hardware/ism/bootstrap.cgi

• sh bootstrap.sh

Note: Consent is required prior to installing public keys on target systems.

Install iDRAC Service Module

To install iDRAC Service Module (iSM) using the repository, run the following commands:

• For Red Hat Enterprise Linux

  yum install dcism

• For SUSE Linux Enterprise Server

  zypper install dcism

To start the iSM service, run the following command:

sudo service dcismeng start

iDRAC Service Module in container environment

iDRAC Service Module image is based on SUSE Linux Enterprise Server operating system. You can run the container image on SUSE Linux Enterprise Server and Red Hat Enterprise Linux operating system. iSM can be created and deployed in a container environment using Docker and Podman container management technologies. By default, the image is created using the podman service.
To create the iSM container image, complete the following steps:

1. To download the image creation script, run either of the following commands:

   • curl -O https://linux.dell.com/repo/hardware/ism/os_dependent/ism_docker/docker_bootstrap.sh

   • wget https://linux.dell.com/repo/hardware/ism/os_dependent/ism_docker/docker_bootstrap.sh

2. To execute the downloaded script, run either of the following commands:
   • For Podman image, run the following command:
     

     sh docker_bootstrap.sh

   • For Docker image, run the following command:
     

     sh docker_bootstrap.sh docker

3. During the execution of the above command, type Yes to import aliases when prompted.

Aliases

You can directly invoke the iDRAC Service Module (iSM) features that are supported in container environment from the host operating system using aliases.
To invoke the aliases in the host operating system root directory, complete the following steps:

1. To create the iSM container image, run either of the following commands:
   • For Podman image, run the following command:
     

     sh docker_bootstrap.sh

   • For Docker image, run the following command:
     

     sh docker_bootstrap.sh docker

2. During the execution of the above command, type Yes to import aliases when prompted.
3. Enter the following entry to .bash_profile file on the host operating system user directory:

   source /opt/dell/srvadmin/iSM/etc/dellism_aliases.sh

The following table lists the aliases and the usage:

Alias name	Usage
dell_ism_start	Run the iSM container using the supported container management technology. The default option selected in the script is Podman.
dell_ism_stop	Stop and remove the iSM container.
dell_ism_status	Check status of dcismeng.service daemon.
Invoke-FullPowerCycle	Invoke the FullPowerCycle feature.
Invoke-SupportAssistCollection	Invoke the SupportAssist Collection feature.
Invoke-iDRACHardReset	Invoke the iDRAC Hard Reset feature.
Enable-iDRACSNMPTrap	Enable or disable SNMP Traps feature.

Troubleshooting for aliases

During the invocation of the aliases, if you are running the iSM image without docker_bootstrap.sh script, update the /opt/dell/srvadmin/iSM/etc/dellism_aliases.sh script with your choice of container management platform. The alias shell script dynamically sets the platform variable as Docker or Podman.

Run iDRAC Service Module container image

• To run the iDRAC Service Module (iSM) container image, run the following command:

  docker/podman run <options> <Docker/Podman image name with version>

  Example:

  docker/podman run --rm --name=dell_ism --privileged -d -v /etc/os-release:/etc/os-release -v /etc/snmp/snmpd.conf:/etc/snmp/snmpd.conf -v /etc/hostname:/etc/hostname -v /lib/modules:/lib/modules --device=/dev/ipmi0 -v /dev/log:/dev/log --network=host dell_ism_5300

  Note: iSM service starts automatically while running the iSM container.
  

The following table lists the command-line options to run the iSM container image:



CLI option	Description
--rm	To remove the iSM container
-d or --detach	To run the iSM container in the background and print container ID
-v /etc/hostname:/etc/hostname	To bind mount a hostname file for OS Information feature
-v /lib/modules:/lib/modules	To bind mount a modules directory. Load lib/modules for iDRAC Hard Reset and Full Power Cycle features
-v /dev/log:/dev/log	To bind mount a log file for iSM system logs
-v /etc/os-release:/etc/os-release	To bind mount a os-release file for OS Information feature
-v /etc/snmp/snmpd.conf:/etc/snmp/snmpd.conf	To bind mount a snmpd.conf file for SNMP Traps and SNMP Get features
--network=host	To connect the container to the host network
--privileged	To give extended privileges to the container
--device =/dev/ipmi0	To add a host ipmi device to the container



• To stop the iSM container, run the following command:

  docker/podman stop <name of the container>

  Example:

  docker/podman stop dell_ism

• To delete the iSM container image, run the following command:

  docker/podman rmi <name of the image>

  Example:

  docker/podman rmi dell_ism_5300

Export iDRAC Service Module container image to target box

The following are the prerequisites to export the iDRAC Service Module (iSM) container image to the target box on RHEL and SLES operating systems:

• Configure the operating system repository
• Install Docker or Podman service

To run the created iSM container image on the other target operating systems, complete the following steps:

1. To save the iSM container image as a .tar file on the system where the image is created, run the following command:
   

   docker/podman save -o <path to the tar file> <ID/name of the image>

   Example:

   docker/podman save -o dell_ism_<version >.tar <Image ID/Name>

2. To copy the iSM container image to the target operating system, run the following command:

   copy command <name of the tar file> <Target OS IP>

   Example:

   scp dell_ism_<version >.tar to target operating system

3. To load the iSM container image on the target operating system, run the following command:

   docker/podman load -i <name of the tar file>

   Example:

   docker load -i dell_ism_<version >.tar

For more information about running the iSM container image, see Run the iDRAC Service Module container image.

Note: Image build or export operation fails when antivirus application is installed on the server. The issue is observed on all container images. For more information about resolving the issue, see https://access.redhat.com/solutions/5979431.

List of supported features

The following features are supported on the iDRAC Service Module 5.3.0.0 container image:

• OS Information (OS Info + Network Info)
• Replicate Lifecycle Log in OS Log
• Auto System Recovery
• iDRAC Hard Reset
• FullPowerCycle
• SupportAssist
• SNMP Alerts via Host OS
• SNMP Get via Host OS
• SNMP OMSA Alerts via Host OS

The following are the prerequisites for the SNMP features:

1. Install the net-snmp package on the host operating system.
2. Remove the iSMSnmpUser user from the iDRAC settings Users page, if present.
3. Configure the /etc/snmp/snmpd.conf file with the following required details for the SNMP Traps and SNMP Walk features:
   1. To provide read-only access to the systemview view, add the following entry to the file:
      

      access notConfigGroup "" any noauth exact systemview none none

   2. To provide read-only access publicly, add the following entry to the file:
      

      rocommunity public

   3. To run the SNMP Agent as Master Agent, add the following entry to the file:
      

      agentx master

   4. If the SNMP Agent is configured to listen on localhost IP address, remove the following entry from the file to provide access from remote servers:
      

      agentAddress  udp:<Localhost IP Address>:<Port Number>

   5. To provide firewall access for SNMP port for the remote servers, execute the following command on the host operating system:
      

      firewall-cmd --add-port=161/udp

Note: iDRAC Service Module supports the iDRAC SNMP OID 1.3. 6.1. 4.1.674.10892.5 for the SNMP Get operations.

Resources

For more information about the iDRAC Service Module, see the following documents available at https://www.dell.com/idracmanuals.

• Dell iDRAC Service Module Release Notes
• Dell iDRAC Service Module User's Guide
• Dell iDRAC Service Module Security Configuration Guide
• Dell iDRAC Service Module DUP supported platforms

Support

For more support on the repository, see the Linux-PowerEdge mailing list.

Copyright 2023 Dell, Inc.

File list

	Name	Last modified	Size	Description
	Parent Directory		-
	iSM/4100/	20-July-2021 17:03	-
	iSM/4200/	25-Jan-2022 17:03	-
	iSM/4300/	05-July-2022 17:03	-
	iSM/5100/	29-Jan-2023 17:03	-
	iSM/5200/	14-Jan-2023 17:03	-
	iSM/5300/	29-Nov-2023 17:03	-