The only real pain point I've had with hdf5 is with writing or reading separate files in parallel. I can understand problems writing to the same file in parallel, but it was a bit of a shock to realize writing two separate files in parallel isn't supported.