lustre/conf/resource/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, check pointpoint and filesystem
  99     # against source (i.e. device)
 100     local dev=$(findmnt -t lustre -ln -o SOURCE -T $(realpath "$OCF_RESKEY_mountpoint"))
 101     [ "$dev" == "$OCF_RESKEY_target" ]
 102 }
 103
 104 lustre_monitor () {
 105     if ! lustre_is_mounted; then
 106         ocf_log err "$OCF_RESKEY_target is not mounted"
 107         return $OCF_NOT_RUNNING
 108     fi
 109
 110     # TODO: Add better status monitoring
 111     return $OCF_SUCCESS
 112 }
 113
 114 #####################################################################
 115 # ACTIONS
 116 #
 117
 118 lustre_mount () {
 119     if ! lustre_is_mounted; then
 120         ocf_log info "Starting to mount $OCF_RESKEY_target"
 121
 122         if mount -t lustre $OCF_RESKEY_target $OCF_RESKEY_mountpoint ; then
 123             ocf_log info "$OCF_RESKEY_target mounted successfully"
 124             return $OCF_SUCCESS
 125         fi
 126         ocf_log err "$OCF_RESKEY_volume mount failed"
 127         return $OCF_ERR_GENERIC
 128     fi
 129 }
 130
 131 lustre_umount () {
 132     if lustre_is_mounted; then
 133         ocf_log info "Starting to unmount $OCF_RESKEY_target"
 134
 135         if umount $OCF_RESKEY_mountpoint; then
 136             ocf_log info "$OCF_RESKEY_target unmounted successfully"
 137             return $OCF_SUCCESS
 138         fi
 139         ocf_log err "$OCF_RESKEY_target unmount failed"
 140         return $OCF_ERR_GENERIC
 141     fi
 142 }
 143
 144 all_start () {
 145     lustre_mount
 146     mnt_success=$?
 147     if [ "$mnt_success" != "$OCF_SUCCESS" ]; then
 148         ocf_log err "$OCF_RESKEY_target can not be mounted with this error: $mnt_success"
 149         return $OCF_ERR_GENERIC
 150     fi
 151     return $OCF_SUCCESS
 152 }
 153
 154 all_stop () {
 155     lustre_umount
 156     mnt_success=$?
 157     if [ "$mnt_success" != "$OCF_SUCCESS" ]; then
 158         ocf_log err "$OCF_RESKEY_target can not be unmounted with this error: $mnt_success"
 159         return $OCF_ERR_GENERIC
 160     fi
 161     return $OCF_SUCCESS
 162 }
 163
 164 validate () {
 165     if [ ! -d "$OCF_RESKEY_mountpoint" ]; then
 166         ocf_log err "$OCF_RESKEY_mountpoint can not be found"
 167         return $OCF_ERR_INSTALLED
 168     fi
 169     if ! modinfo -n lustre >/dev/null 2>&1; then
 170         ocf_log err "lustre module not available"
 171         return $OCF_ERR_INSTALLED
 172     fi
 173     return $OCF_SUCCESS
 174 }
 175
 176 case $1 in
 177     meta-data)          meta_data;;
 178     start)              all_start;;
 179     stop)               all_stop;;
 180     status|monitor)     lustre_monitor;;
 181     validate-all)       validate;;
 182     usage)              usage
 183         exit $OCF_SUCCESS
 184         ;;
 185     *)                  exit $OCF_ERR_UNIMPLEMENTED;;
 186 esac