45Drives Server CLI Tools

Supported OS

• CentOS 7.X
• Ubuntu 20.04.1 (45drives-tools version >= 1.8.3)

Contents

• Drive Aliasing
  • dmap: (opt/tools/dmap)

    Automatically configures device aliases for 45Drives Storinator products.
    Options:
    -h, --help show this help message and exit
    -m, --no-udev Creates map but doesnt trigger udev rules
    -s SZ, --size=SZ Specify chassis size
    -q, --quiet Quiet Mode
    -r, --reset-map Resets the drive map
    

  • profile.d/tools.sh: (/etc/profile.d/tools.sh)

    A script that automatically runs at login. Sets enviroment varibles required for device aliasing.
    

• Drive Display
  • lsdev: (opt/tools/lsdev)

    Lists a variety of block device information. Options:
    -h, --help show this help message and exit
    -j, --json Output in JSON format
    -n, --no-color, --no-colour Replace colour coding with asterisks
    -d, --device Output device name "/dev/sd<x>/"
    -H, --health Output SMARTCTL health (slow)
    -m, --model Output model names
    -t, --type Output drive types (HDD/SSD)
    -s, --serial Output serial numbers
    -T, --temp Output temperature (deg-C) (slow)
    -f, --firmware Output firmware version
    -o, --ceph-osd Output OSD name - Ceph only
    

• ZFS Drive Tools
  • zcreate: (/opt/tools/zcreate)

    Automatically creates zpools based on system hardware. Also takes input for fine tuned options. Use '-h' flag for more options
    

• Ceph Drive Tools
  • findosd: (/opt/tools/findosd)

    Takes osd id as input and outputs device alias. If osd is located on another host output is that hostname.
    

  • generate-osd-vars.sh: (opt/tools/generate-osd-vars.sh)

    Outputs list of devive names and device alias to stdout. Used by ceph-ansible playbook to autogenerate devices varibles
    

  • wipedev (/opt/tools/wipedev)

    Wipes the partition table of all drives in system. (excluding server's OS drives).
    

Installation

CentOS 7

Add the 45drives-centos.repo

cd /etc/yum.repos.d
curl -LO http://images.45drives.com/repo/centos/45drives-centos.repo yum clean all

45drives-centos.repo

[45drives_stable]
baseurl = http://images.45drives.com/repo/centos/el$releasever/stable
enabled = 1
gpgcheck = 1
repo_gpgcheck = 1
gpgkey = http://images.45drives.com/repo/keys/rpmpubkey.asc
name = 45Drives Stable Packages
priority = 1
[45drives_testing]
baseurl = http://images.45drives.com/repo/centos/el$releasever/testing
enabled = 0
gpgcheck = 1
repo_gpgcheck = 1
gpgkey = http://images.45drives.com/repo/keys/rpmpubkey.asc
name = 45Drives Testing Packages
priority = 1

Enable the 45drives_testing repo (optional)

The latest versions of our packages are available in our 45drives_testing repo.
By default, the 45drives_testing packages are not enabled.

You can enable them by editing /etc/yum.repos.d/45drives-centos.repo with a text editor (nano, vim, etc ).
Simply change enabled = 0 to enabled = 1.

Install Package

With the 45drives Repo enabled, you can now install using yum from your terminal.

yum install 45drives-tools

Ubuntu 20

Import 45drives repo GPG

wget -qO - http://images.45drives.com/repo/keys/aptpubkey.asc | apt-key add -

Add the 45drives.list

cd /etc/apt/sources.list.d
sudo curl -LO http://images.45drives.com/repo/debian/45drives.list
sudo apt update

45drives.list

deb http://images.45drives.com/repo/debian focal main
#deb http://images.45drives.com/repo/debian focal-testing main

Enable the 45drives_testing packages (optional)

The latest versions of our packages are available in our 45drives_testing repo.
By default, the 45drives_testing packages are not enabled.

You can enable them by editing /etc/apt/sources.list.d/45drives.list with a text editor (nano, vim, etc ).
You can uncomment (delete the # character) the second line.

Install Package

sudo apt install 45drives-tools