iDRAC Service Module (iSM)

This is Dell EMC OpenManage repository for Redhat Enterprise Linux support. The repository includes iDRAC Service Module(iSM).

Information on iDRAC Service Module is located at the following link:

• Support for Dell EMC iDRAC Service Module

Repository setup

To configure the repository, use 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


• bash bootstrap.cgi

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

Install iDRAC Service Module

To install iSM using the repository, use the following command:

• For Red Hat Enterprise Linux Servers

  #yum install dcism

• For SUSE Linux Enterprise Servers

  #zypper install dcism

• Start iDRAC Service Module Service

  $sudo service dcismeng start

Containerising iDRAC Service Module

iDRAC Service Module image is based on SUSE Linux Enterprise Server operating system.
The created image can be run on SUSE Linux Enterprise Server and Red Hat Enterprise Linux operating system.
Users can choose between Docker and Podman container technologies for building the image.
By default, Podman service is chosen for the creation of the image.
To create the iDRAC Service Module image, use the following command:

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


• For podman image, run the following command:
  bash docker_bootstrap.sh
• For docker image, run the following command:
  bash docker_bootstrap.sh docker



Steps to run the iDRAC Service Module Image

Use the following command to run the iSM image:
• docker/podman run <options> <docker image name with version>
  Example: docker/podman run --rm --name=dell_ism --privileged -d -v /etc/os-release:/etc/os-release -v /etc/hostname:/etc/hostname -v /lib/modules:/lib/modules --device=/dev/ipmi0 -v /dev/log:/dev/log --network=host dell_ism_4300
  
  Key options used in the above command:
  
  • --rm:   Delete container after stopping the container. This option helps to relaunch the container easily.
  
  
  • -d or --detach:   Run container in background and print container ID.
  
  
  • -v /etc/hostname:/etc/hostname:   Populate Host operating system hostname on the container.
  
  
  • -v /lib/modules:/lib/modules:   Load lib/modules for iSM features iDRAC Hard Reset and Full power cycle.
  
  
  • -v /dev/log:/dev/log:   Log iSM messages to the host operating system log.
  
  
  • -v /etc/os-release:/etc/os-release:   Pass operating system information.
  
  
  • --network=host:   Pass host network devices to container.
  
  
  • --privileged:   Give root privileges to the container.
  
  
  • --device =/dev/ipmi0:   Mount the ipmi device.
  
  
• To stop the running container, use the following command:
  docker/podman stop <name of the container>
  Example:docker/podman stop dell_ism
  
  
• To delete the iSM image, use the following command:
  docker/podman rmi <name of the image>
  Example:docker/podman rmi dell_ism_4300
  
  

To start iSM inside the container

Users have to exec inside the container to start iSM using systemctl.

• docker/podman exec -it <name of the iSM container> bash
  Example:docker exec -it dell_ism bash
  
  
• Start iSM using systemctl command:
  systemctl start dcismeng.service

Note: To stop/restart iSM, use the usual systemctl commands, for example: systemctl stop dcismeng.service

To export the image to other target box

For Red Hat Enterprise Linux operating system and SUSE Linux Enterprise Server operating system only.
Prerequisites:
• Configure the operating system repository.
• Install wget, and docker or podman service.


To run the image on Red Hat Enterprise Linux operating system, use the following commands:
On the SUSE Linux Enterprise Server box where the image is created, complete the following tasks:

• Save the iDRAC Service Module image as a .tar:
  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>


• Copy the image to the Red Hat Enterprise Linux server:
  copy command <name of the tar file> <Red Hat Enterprise Linux server IP>
  Example: scp dell_ism_<version >.tar to target operating system

On the target Red Hat Enterprise Linux box where the image will be run:

• Load the iDRAC Service Module image:
  docker/podman load -i <name of the tar file>
  Example: docker load -i dell_ism_<version >.tar
Now, use the run command mentioned in the steps to run the iDRAC Service Module image section.

Note: Image build/export fails on a server with Antivirus installed. This issue is not specific iSM container rather a generic issue reported for all images. Should you encounter this issue, please refer to the following link for more details: https://access.redhat.com/solutions/5979431

List of supported features

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

OS Information (OS Info + Network Info)

LC Replication log

Watchdog

iDRAC Hard reset

Full Power Cycle

SupportAssist

Other supporting documents and links

In addition to this guide, you can access the following guides available at dell.com
• Dell EMC iDRAC Service Module Release Notes
• Dell EMC iDRAC Service Module User's Guide
• Dell EMC iDRAC Service Module Security Configuration Guide

Support

For more support on the repository, see the linux-poweredge mailing list.




Copyright 2022 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	-