contrib/scripts/pacemaker/Lustre

   1 #!/bin/sh
   2 #
   3 # License:      GNU General Public License (GPL)v2
   4 # Description:  Manages Lustre server on a shared storage
   5 # Written by:   Gabriele Paciucci, Nathaniel Clark
   6 # Release Date: 28 February 2017
   7 # Release Version: 1.0.0
   8 # Copyright (c) 2017, Intel Corporation
   9 #
  10 # This program is free software; you can redistribute it and/or modify
  11 # it under the terms and conditions of the GNU General Public License,
  12 # version 2, as published by the Free Software Foundation.
  13 #
  14 # This program is distributed in the hope it will be useful, but
  15 # WITHOUT ANY WARRANTY; without even the implied warranty of
  16 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17 # General Public License for more details.
  18 #
  19 #
  20 # usage: ./Lustre {start|stop|status|monitor|validate-all|meta-data}
  21 #
  22 #               OCF parameters are as follows:
  23 #               OCF_RESKEY_target - the device or ZFS volume to mount/umount
  24 #               OCF_RESKEY_mountpoint - the mountpoint to use
  25 #######################################################################
  26 # Initialization:
  27
  28 : ${OCF_FUNCTIONS_DIR=${OCF_ROOT}/lib/heartbeat}
  29 . ${OCF_FUNCTIONS_DIR}/ocf-shellfuncs
  30
  31
  32 # Variables used by multiple methods
  33
  34
  35 #######################################################################
  36
  37 # USAGE
  38
  39 usage() {
  40     usage: $0 {start|stop|status|monitor|validate-all|meta-data}
  41 }
  42
  43 # META-DATA
  44
  45 meta_data() {
  46     cat <<END
  47 <?xml version="1.0"?>
  48 <!DOCTYPE resource-agent SYSTEM "ra-api-1.dtd">
  49 <resource-agent name="Lustre">
  50 <version>1.0.0</version>
  51 <longdesc lang="en">
  52 This script manages Lustre Targets (MGT, MDT, OST).
  53 The script is able to mount/umount Lustre Targets.
  54
  55 The standard monitor operation of depth 0 (also known as probe)
  56 checks if the filesystem is mounted and lustre is healthy
  57 </longdesc>
  58 <shortdesc lang="en">Lustre management</shortdesc>
  59
  60 <parameters>
  61
  62 <parameter name="target" unique="1" required="1">
  63 <longdesc lang="en">
  64 The name of the target created during the Lustre format
  65 (e.g. /dev/sda, ZPOOL/MGS, /dev/mapper/mpatha)
  66 </longdesc>
  67 <shortdesc lang="en">Lustre target name</shortdesc>
  68 <content type="string" default="" />
  69 </parameter>
  70
  71 <parameter name="mountpoint" unique="1" required="1">
  72 <longdesc lang="en">
  73 The mount point where the Lustre target will be mounted.
  74 </longdesc>
  75 <shortdesc lang="en">Mount point for Lustre</shortdesc>
  76 <content type="string" default="" />
  77 </parameter>
  78
  79 </parameters>
  80
  81 <actions>
  82 <action name="start"   timeout="300s" />
  83 <action name="stop"    timeout="300s" />
  84 <action name="monitor" depth="0"  timeout="300s" interval="20s" />
  85 <action name="validate-all"  timeout="30s" />
  86 <action name="meta-data"  timeout="5s" />
  87 </actions>
  88 </resource-agent>
  89 END
  90     exit $OCF_SUCCESS
  91 }
  92
  93 #####################################################################
  94 # STATUS
  95 #
  96
  97 lustre_is_mounted () {
  98     # Verify if this is consistent
  99     grep -q $(realpath "$OCF_RESKEY_mountpoint") /proc/mounts
 100 }
 101
 102 lustre_monitor () {
 103     if ! lustre_is_mounted; then
 104         ocf_log err "$OCF_RESKEY_target is not mounted"
 105         return $OCF_NOT_RUNNING
 106     fi
 107
 108     # TODO: Add better status monitoring
 109     return $OCF_SUCCESS
 110 }
 111
 112 #####################################################################
 113 # ACTIONS
 114 #
 115
 116 lustre_mount () {
 117     if ! lustre_is_mounted; then
 118         ocf_log info "Starting to mount $OCF_RESKEY_target"
 119
 120         if mount -t lustre $OCF_RESKEY_target $OCF_RESKEY_mountpoint ; then
 121             ocf_log info "$OCF_RESKEY_target mounted successfully"
 122             return $OCF_SUCCESS
 123         fi
 124         ocf_log err "$OCF_RESKEY_volume mount failed"
 125         return $OCF_ERR_GENERIC
 126     fi
 127 }
 128
 129 lustre_umount () {
 130     if lustre_is_mounted; then
 131         ocf_log info "Starting to unmount $OCF_RESKEY_target"
 132
 133         if umount $OCF_RESKEY_mountpoint; then
 134             ocf_log info "$OCF_RESKEY_target unmounted successfully"
 135             return $OCF_SUCCESS
 136         fi
 137         ocf_log err "$OCF_RESKEY_target unmount failed"
 138         return $OCF_ERR_GENERIC
 139     fi
 140 }
 141
 142 all_start () {
 143     lustre_mount
 144     mnt_success=$?
 145     if [ "$mnt_success" != "$OCF_SUCCESS" ]; then
 146         ocf_log err "$OCF_RESKEY_target can not be mounted with this error: $mnt_success"
 147         return $OCF_ERR_GENERIC
 148     fi
 149     return $OCF_SUCCESS
 150 }
 151
 152 all_stop () {
 153     lustre_umount
 154     mnt_success=$?
 155     if [ "$mnt_success" != "$OCF_SUCCESS" ]; then
 156         ocf_log err "$OCF_RESKEY_target can not be unmounted with this error: $mnt_success"
 157         return $OCF_ERR_GENERIC
 158     fi
 159     return $OCF_SUCCESS
 160 }
 161
 162 validate () {
 163     if [ ! -d "$OCF_RESKEY_mountpoint" ]; then
 164         ocf_log err "$OCF_RESKEY_mountpoint can not be found"
 165         return $OCF_ERR_INSTALLED
 166     fi
 167     if ! modinfo -n lustre >/dev/null 2>&1; then
 168         ocf_log err "lustre module not available"
 169         return $OCF_ERR_INSTALLED
 170     fi
 171     return $OCF_SUCCESS
 172 }
 173
 174 case $1 in
 175     meta-data)          meta_data;;
 176     start)              all_start;;
 177     stop)               all_stop;;
 178     status|monitor)     lustre_monitor;;
 179     validate-all)       validate;;
 180     usage)              usage
 181         exit $OCF_SUCCESS
 182         ;;
 183     *)                  exit $OCF_ERR_UNIMPLEMENTED;;
 184 esac