Note: The default ITS GitLab runner is a shared resource and is subject to slowdowns during heavy usage.
You can run your own GitLab runner that is dedicated just to your group if you need to avoid processing delays.

README.md 2.38 KB
Newer Older
Adam Robinson's avatar
Adam Robinson committed
1
pure_storage_vmware_best_practices
Adam Robinson's avatar
Adam Robinson committed
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
=========

This role configures an ESXi host for the best practices when using Pure storage.  The settings are
from the [Best practices guide](https://support.purestorage.com/Solutions/VMware_Platform_Guide/001VMwareBestPractices/dddVMware_ESXi_Host_Configuration) and
[VAAI Guide](https://support.purestorage.com/Solutions/VMware_Platform_Guide/001VMwareBestPractices/Web_Guide%3A_VMware_Storage_APIs_for_Array_Integration_with_the_Pure_Storage%C2%AE_FlashArray).
Additional info is also available in [VMware KB 2146167](https://kb.vmware.com/s/article/2146167).

Requirements
------------

pyvmomi is required. This role assumes your inventory file contains each ESXi host you are managing.

Role Variables
--------------

Adam Robinson's avatar
Adam Robinson committed
17
18
19
20
21
22
23
24
25
26
27
28
29
30
### Defaults

- `Third_Party_Array_Not_Support_ATS_HB` - If a third party array also used in the environment
  has issues using ATS heartbeats, it is ok to disable this functionality. The default value is `false`.

- `Third_Party_Array_Not_Support_Max_HW_Transfer_Size` - If a third party array also used in the environment
  has issues increasing the maximum size of VAAI XCOPY operations, it is ok to leave MaxHWTransferSize
  at the default. The default value is `false`.

- `MaxHWTransferSize` - By default this is set to `4096`, but for best performance on Pure storage it should
  be set to `16384`.  It will automatically be calculated based on the value of
  `Third_Party_Array_Not_Support_Max_HW_Transfer_Size`.  You might want to override it if you have another
  array in the environment that supports operations larger than the default but smaller than Pure's recomendation.

Adam Robinson's avatar
Adam Robinson committed
31
32
33
34
35
- `DisableSmartd` - There appears to be an issue where
  [vSphere tries to read SMART data from Pure volumes](https://www.jacobhopkinson.com/2019/08/09/vmware-and-scsi-why-do-my-pure-storage-datastores-report-scsi-0x85-errors-every-30-minutes/)
  , but those obviously don't support SMART.  If you don't have any local storage, it should be safe
  to disable SMART. Defaults to `false`.

Adam Robinson's avatar
Adam Robinson committed
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
### Required

- `vcenter_hostname` - The hostname or address of the vCenter server.

- `inventory_hostname` - The hostname or address of the ESXi server.

Dependencies
------------

None

Example Playbook
----------------

TODO

License
-------

BSD

Author Information
------------------

An optional section for the role authors to include contact information, or a website (HTML is not allowed).