There is a basic guide in ACS project which is responsible for generating http://docs.tigase.org/tigase-acs/snapshot/Tigase_ACS_Guide/html/

%wojtek ,

I've compiled what I can of cluster documentation from various old and odd sources to make it more readable. Only thing I think might be missing is the ability to change ports, can that just be done using --s2s-ports= ?

s2s is for the federated server-to-server connections, cl-comp is responsible for cluster connections, thus you can use:

--cl-comp-ports=5277,5278

which actually translates to:

cl-comp/connections/ports[i]=5277, 5278

In addition each port has separate network configuration, which may or may not require configuration (defaults are good enough, i.e.:

cl-comp/connections/5277/type[S]=accept
cl-comp/connections/5277/socket[S]=plain
cl-comp/connections/5277/ifc[s]=*
cl-comp/connections/5277/remote-host[S]=localhost
cl-comp/connections/5277/connections/tls/required[B]=false
cl-comp/connections/5278/type[S]=accept
cl-comp/connections/5278/socket[S]=plain
cl-comp/connections/5278/ifc[s]=*
cl-comp/connections/5278/remote-host[S]=localhost
cl-comp/connections/5278/connections/tls/required[B]=false

Thanks for the details, those are now uploaded.