[ClusterLabs] How to set up fencing/stonith

[Casey & Gina]

In the meantime, I thought I'd try running the fence_vmware_soap command, but it doesn't seem to be working, despite me using the same credentials that worked with the external/vcenter plugin.  Is there a way to get more debugging information about why it says unable to connect/login?  The error is thrown immediately:

# fence_vmware_soap --ip <vSphere IP> --username <my_user> --password '<my_password>' --ssl --action list
Unable to connect/login to fencing device

> Okay, I see that I can get a list of stonith options with `stonith describe fence_vmware_soap`.  However, this isn't terribly detailed.  Is there a command to get more detailed information, like a man page would?  I did look at `man stonithd` but that doesn't clarify things further either.  I apologize if there's documentation somewhere that I could be reading instead of posting questions here...anyways here are my immediate questions after looking at the above:
> 
> 1.  I see that it says "action" is required, but is missing in the example `pcs stonith create ...` command.  Is this something variable provided by pacemaker rather than part of the configure command?
> 
> 2.  How should pcmk_host_list contents be formatted?  A comma-separated list like "hostname1,hostname2,hostname3"?  Based on the example value provided for pcmk_host_map, I guess it may be semicolons instead of commas?  I did find a little more detail in `man stonithd`, but it still doesn't specify how this parameter's value should be formatted.
> 
> 3.  I see that "port" is required and am still unsure of what this should be set to.  Describe says "Physical plug number on device, UUID or identification of machine".  When you say "the above command presumes one fence device per node", is this a requirement for the fence_vmware_soap device, or is there a different syntax available?  I don't understand the "one device per node" versus "one device for the cluster" concept very well.  Is a single device for the cluster worse idea for some reason?  For a 3-node cluster with one device per node, do I need to create 3 different stonith devices, with port=<hostname> for each different host in the cluster, but all of the nodes in the pcmk_host_list parameter?
> 
> Thank you for any insights,
> -- 
> Casey
> _______________________________________________
> Users mailing list: Users at clusterlabs.org
> https://lists.clusterlabs.org/mailman/listinfo/users
> 
> Project Home: http://www.clusterlabs.org
> Getting started: http://www.clusterlabs.org/doc/Cluster_from_Scratch.pdf
> Bugs: http://bugs.clusterlabs.org