[gpfsug-discuss] gpfsug-discuss Digest, Vol 79, Issue 21: mmaddcallback documentation issue

Tue Aug 7 12:35:17 BST 2018

Hi Kevin,

I'm running policy migrations on Spectrum Scale 4.2.3, but I use mmapplypolicy to kick off the policy runs, not mmstartpolicy. Docs here (which I admit are not for your version of Spectrum Scale) state that mmstartpolicy is for internal GPFS use only: https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/General+Parallel+File+System+(GPFS)/page/Using+Policies 

So if the above link is correct, I'd recommend switching to using mmapplypolicy, which handily comes with a man page, whereas mmstartpolicy doesn't and might have you fumbling around in the dark.

As for the issue you're experiencing with adding a callback, it looks like the mmaddcallback command is catching the --single-instance flag as an argument for it, not as a parameter for the mmstartpolicy command. After looking at the documentation you've referenced, I suspect that there's a typo/omission in the command and it should have a trailing double quote (") on the end of the parms argument list, i.e.:

mmaddcallback MIGRATION --command /usr/lpp/mmfs/bin/mmstartpolicy --event lowDiskSpace --parms "%eventName %fsName --single-instance"

I'm not sure how we go about asking IBM to correct their documentation, but expect someone in the user group will have some idea.

Regards,

Pete Chase
peter.chase at metoffice.gov.uk

-----Original Message-----
From: gpfsug-discuss-bounces at spectrumscale.org <gpfsug-discuss-bounces at spectrumscale.org> On Behalf Of gpfsug-discuss-request at spectrumscale.org
Sent: 06 August 2018 23:47
To: gpfsug-discuss at spectrumscale.org
Subject: gpfsug-discuss Digest, Vol 79, Issue 21

Send gpfsug-discuss mailing list submissions to
	gpfsug-discuss at spectrumscale.org

To subscribe or unsubscribe via the World Wide Web, visit
	http://gpfsug.org/mailman/listinfo/gpfsug-discuss
or, via email, send a message with subject or body 'help' to
	gpfsug-discuss-request at spectrumscale.org

You can reach the person managing the list at
	gpfsug-discuss-owner at spectrumscale.org

When replying, please edit your Subject line so it is more specific than "Re: Contents of gpfsug-discuss digest..."

Today's Topics:

   1. mmaddcallback documentation issue (Buterbaugh, Kevin L)
   2. Re: mmaddcallback documentation issue (Eric Sperley)

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

Message: 1
Date: Mon, 6 Aug 2018 21:42:54 +0000
From: "Buterbaugh, Kevin L" <Kevin.Buterbaugh at Vanderbilt.Edu>
To: gpfsug main discussion list <gpfsug-discuss at spectrumscale.org>
Subject: [gpfsug-discuss] mmaddcallback documentation issue
Message-ID: <735F4275-191A-4363-B98C-1EA289292037 at vanderbilt.edu>
Content-Type: text/plain; charset="utf-8"

Hi All,

So I?m _still_ reading about and testing various policies for file placement and migration on our test cluster (which is now running GPFS 5).

On page 392 of the GPFS 5.0.0 Administration Guide it says:

To add a callback, run this command. The following command is on one line:

mmaddcallback MIGRATION --command /usr/lpp/mmfs/bin/mmstartpolicy --event lowDiskSpace --parms "%eventName %fsName --single-instance

The --single-instance flag is required to avoid running multiple migrations on the file system at the same time.

However, trying to issue that command gives:

mmaddcallback: Incorrect option: --single-instance

And the man page for mmaddcallback doesn?t mention it or anything similar to it.  Now my test cluster is running GPFS 5.0.1.1, so is this something that was added in GPFS 5.0.0 and then subsequently removed?

I can?t find the GPFS 5.0.1 Administration Guide with a Google search.

Thanks?

Kevin

?
Kevin Buterbaugh - Senior System Administrator Vanderbilt University - Advanced Computing Center for Research and Education Kevin.Buterbaugh at vanderbilt.edu<mailto:Kevin.Buterbaugh at vanderbilt.edu> - (615)875-9633

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://gpfsug.org/pipermail/gpfsug-discuss/attachments/20180806/d4348ee3/attachment-0001.html>

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

Message: 2
Date: Mon, 6 Aug 2018 15:46:39 -0700
From: "Eric Sperley" <esperle at us.ibm.com>
To: gpfsug main discussion list <gpfsug-discuss at spectrumscale.org>
Subject: Re: [gpfsug-discuss] mmaddcallback documentation issue
Message-ID:
	<OF2E0E1104.A39AA4C3-ON002582E1.007D02C1-882582E1.007D1EE0 at notes.na.collabserv.com>

Content-Type: text/plain; charset="utf-8"

See if this helps
https://www.ibm.com/support/knowledgecenter/en/STXKQY_5.0.1/com.ibm.spectrum.scale.v5r01.doc/bl1adm_mmaddcallback.htm

Best Regards, Eric

                                               Eric Sperley, PhD                 

                                               SDI Architect                     

     To improve is to change; to be perfect is IBM Systems                       
     to change often - - Winston Churchill                                       

                                               esperle at us.ibm.com                

                                               +15033088721                      

From:	"Buterbaugh, Kevin L" <Kevin.Buterbaugh at Vanderbilt.Edu>
To:	gpfsug main discussion list <gpfsug-discuss at spectrumscale.org>
Date:	08/06/2018 02:44 PM
Subject:	[gpfsug-discuss] mmaddcallback documentation issue
Sent by:	gpfsug-discuss-bounces at spectrumscale.org