dracadm

A tool to run racadm on a Mac or non x86 based (e.g. ARM) Linux machine via docker

Version

Current version: 0.0.7

Prerequisites

Required packages/applications:

• Docker

To be able to call this script like normal racadm, symlink the script to racadm in your path, e.g.:

ls -s /home/user/bin/dracadm.sh /usr/local/bin/racadm

Introduction

This script provides a way to run racadm from the command line on non x86 hardware and/or non Linux based OS by using a docker container (e.g. MacOS on Apple Silicon)

If the docker container isn't present it will create it. As pare of this process, the script creates the Dockerfile and the compose file in a work directory, and then runs a docker compose.

The docker compose fetches the appropriate packages from the Dell repository and installs them. The required packages have systemd commands in the post install, so will not normally install in a docker container. To get around this, the packages are unpacked with dpkg, the postinstall script is removed, and then the package is configured.

There are probably far better ways to do this, but here is an example of the created docker files:

docker-compose.yml:

version: "3"

services:
  dracadm:
    build:
      context: .
      dockerfile: Dockerfile
    image: dracadm
    container_name: dracadm
    entrypoint: /bin/bash
    working_dir: /root
    platform: linux/amd64

Dockerfile:

FROM ubuntu:22.04
RUN apt-get update && apt-get install -y libssl-dev ca-certificates wget libargtable2-0 pciutils && cd /tmp && wget https://linux.dell.com/repo/community/openmanage/11000/jammy/pool/main/s/srvadmin-hapi/srvadmin-hapi_11.0.0.0_amd64.deb && wget https://linux.dell.com/repo/community/openmanage/11000/jammy/pool/main/s/srvadmin-idracadm8/srvadmin-idracadm7_11.0.0.0_all.deb && wget https://linux.dell.com/repo/community/openmanage/11000/jammy/pool/main/s/srvadmin-idracadm8/srvadmin-idracadm8_11.0.0.0_amd64.deb && dpkg --unpack srvadmin-hapi_11.0.0.0_amd64.deb && rm /var/lib/dpkg/info/srvadmin-hapi.postinst && dpkg --configure -a && dpkg --unpack srvadmin-idracadm7_11.0.0.0_all.deb && rm /var/lib/dpkg/info/srvadmin-idracadm7.postinst && dpkg --configure -a && dpkg --unpack srvadmin-idracadm8_11.0.0.0_amd64.deb && rm /var/lib/dpkg/info/srvadmin-idracadm8.postinst && dpkg --configure -a && chmod +x /opt/dell/srvadmin/sbin/racadm-wrapper-idrac7 && ln -sf /opt/dell/srvadmin/sbin/racadm-wrapper-idrac7 /usr/bin/racadm && rm /tmp/*.deb

Usage

The script passes commandline argument to racadm in the docker container, therefore the same commandline arguments that are used with racadm can be used with the script.

Exceptions to this are:

• The --version switch returns the version of the local script
• The --help swich is converted to nothing to return help as racadm does not have a help switch

To get help on how to use the racadm command use the --help switch:

> ./dracadm.sh --help

===============================================================================
RACADM version 11.0.0.0
Copyright (c) 2003-2022 Dell, Inc.
All Rights Reserved
===============================================================================

RACADM usage syntax:

 racadm <subcommand> <options>

Examples:

 racadm getsysinfo
 racadm getsysinfo -d
 racadm getniccfg
 racadm setniccfg -d
 racadm setniccfg -s 192.168.0.120 255.255.255.0 192.168.0.1
 racadm getconfig -g cfgLanNetworking

Display a list of available subcommands for the RAC:

 racadm help

Display more detailed help for a specific subcommand:

 racadm help <subcommand>

-------------------------------------------------------------------------------

Remote RACADM usage syntax:

 racadm -r <RAC IP address> -u <username> -p <password> <subcommand> <options>
 racadm -r <RAC IP address> -i <subcommand> <options>

 The "-i" option allows the username and password to be entered interactively.

Examples:

 racadm -r 192.168.0.120 -u racuser1 -p aygqt12a getsysinfo
 racadm -r 192.168.0.120 -u racuser2 -p gsdf12o1 getractime
 racadm -r 192.168.0.120 -u racuser5 -p dsajkhds help getsysinfo

Display a list of available subcommands for the remote RAC:

 racadm -r <RAC IP address> -u <username> -p <password> help

Display more detailed help for a specific subcommand:

 racadm -r <RAC IP address> -u <username> -p <password> help <subcommand>

-------------------------------------------------------------------------------