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.1
8 # Copyright (c) 2017, Intel Corporation
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.
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.
20 # usage: ./Lustre {start|stop|status|monitor|validate-all|meta-data}
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 # OCF_RESKEY_mountoptions - any mount options to use
26 #######################################################################
29 : ${OCF_FUNCTIONS_DIR=${OCF_ROOT}/lib/heartbeat}
30 . ${OCF_FUNCTIONS_DIR}/ocf-shellfuncs
33 # Variables used by multiple methods
36 #######################################################################
41 echo "usage: $0 {start|stop|status|monitor|validate-all|meta-data}"
49 <!DOCTYPE resource-agent SYSTEM "ra-api-1.dtd">
50 <resource-agent name="Lustre">
51 <version>1.0.1</version>
53 This script manages Lustre Targets (MGT, MDT, OST).
54 The script is able to mount/umount Lustre Targets.
56 The standard monitor operation of depth 0 (also known as probe)
57 checks if the filesystem is mounted and lustre is healthy
59 <shortdesc lang="en">Lustre management</shortdesc>
63 <parameter name="target" unique="1" required="1">
65 The name of the target created during the Lustre format
66 (e.g. /dev/sda, ZPOOL/MGS, /dev/mapper/mpatha)
68 <shortdesc lang="en">Lustre target name</shortdesc>
69 <content type="string" default="" />
72 <parameter name="mountpoint" unique="1" required="1">
74 The mount point where the Lustre target will be mounted.
76 <shortdesc lang="en">Mount point for Lustre</shortdesc>
77 <content type="string" default="" />
80 <parameter name="mountoptions" unique="1" required="0">
82 Any additional mount options for the Lustre target. (eg: "-o skpath=/path/to/keys")
84 <shortdesc lang="en">Mount options for Lustre target</shortdesc>
85 <content type="string" default="" />
91 <action name="start" timeout="300s" />
92 <action name="stop" timeout="300s" />
93 <action name="monitor" depth="0" timeout="300s" interval="20s" />
94 <action name="validate-all" timeout="30s" />
95 <action name="meta-data" timeout="5s" />
102 #####################################################################
106 lustre_is_mounted () {
107 # Verify if this is consistent, check pointpoint and filesystem
108 # against source (i.e. device)
109 local dev=$(findmnt -t lustre -ln -o SOURCE -T $(realpath "$OCF_RESKEY_mountpoint"))
110 local target=$(realpath "$OCF_RESKEY_target" 2> /dev/null)
112 [ -n "$dev" ] && [ "$dev" == "$OCF_RESKEY_target" -o "$dev" == "$target" ]
116 if ! lustre_is_mounted; then
117 ocf_log err "$OCF_RESKEY_target is not mounted"
118 return $OCF_NOT_RUNNING
121 # TODO: Add better status monitoring
125 #####################################################################
130 if ! lustre_is_mounted; then
131 ocf_log info "Starting to mount $OCF_RESKEY_target"
133 output=$(mount -t lustre $OCF_RESKEY_mountoptions $OCF_RESKEY_target $OCF_RESKEY_mountpoint 2>&1)
135 if [ $rc -eq 0 ]; then
136 ocf_log info "$OCF_RESKEY_target mounted successfully"
137 [ -n "$output" ] && ocf_log info "$output"
140 ocf_log err "$OCF_RESKEY_target mount failed, rc=$rc"
141 ocf_log err "$output"
142 return $OCF_ERR_GENERIC
148 if lustre_is_mounted; then
149 ocf_log info "Starting to unmount $OCF_RESKEY_target"
151 output=$(umount $OCF_RESKEY_mountpoint 2>&1)
153 if [ $rc -eq 0 ]; then
154 ocf_log info "$OCF_RESKEY_target unmounted successfully"
155 [ -n "$output" ] && ocf_log info "$output"
158 ocf_log err "$OCF_RESKEY_target unmount failed, rc=$rc"
159 ocf_log err "$output"
160 return $OCF_ERR_GENERIC
168 if [ "$mnt_success" != "$OCF_SUCCESS" ]; then
169 ocf_log err "$OCF_RESKEY_target can not be mounted with this error: $mnt_success"
170 return $OCF_ERR_GENERIC
178 if [ "$mnt_success" != "$OCF_SUCCESS" ]; then
179 ocf_log err "$OCF_RESKEY_target can not be unmounted with this error: $mnt_success"
180 return $OCF_ERR_GENERIC
186 if [ ! -d "$(realpath $OCF_RESKEY_mountpoint)" ]; then
187 ocf_log err "$OCF_RESKEY_mountpoint can not be found"
188 return $OCF_ERR_INSTALLED
190 if ! modinfo -n lustre >/dev/null 2>&1; then
191 ocf_log err "lustre module not available"
192 return $OCF_ERR_INSTALLED
198 meta-data) meta_data;;
201 status|monitor) lustre_monitor;;
202 validate-all) validate;;
206 *) exit $OCF_ERR_UNIMPLEMENTED;;