View Source Partisan Cheatsheet

The following cheatsheet assumes you have two nodes running: foo@127.0.0.1 (foo) and bar@127.0.0.1 (bar).

connecting-to-other-peers

Connecting to other peers

manually-joining-using-erlang-s-console

Manually joining using Erlang's console

Obtain bar's node specification

(bar@127.0.0.1)1> NodeSpec = partisan:node_spec().

Join foo to bar

(foo@127.0.0.1)1> NodeSpec = ... % paste NodeSpec obtained at 'bar@127.0.0.1'
(foo@127.0.0.1)2> partisan_peer_service:join(NodeSpec).

checking-cluster-membership-view

Checking cluster membership view

Obtain members

(bar@127.0.0.1)1> partisan_peer_service:members().

Returns [node_spec()] and should contain both node specifications.

Obtain nodes

(bar@127.0.0.1)1> partisan:nodes().

Returns [node()] and should contain both nodes.

sending-messages

Sending messages

obtain-bar-s-shell-pid

Obtain bar's shell pid

(bar@127.0.0.1)2> partisan:self().
% <<"partisan:pid:plum_db1@127.0.0.1:0.813.0">>

Returns [partisan_remote_ref:t()]

send-message-from-foo

Send message from foo

(foo@127.0.0.1)3> Ref = <<"partisan:pid:plum_db1@127.0.0.1:0.813.0">>.
(foo@127.0.0.1)4> partisan:forward_message(Ref, hello).
(bar@127.0.0.1)3> flush().
% Shell got hello
% ok