MzBench Diameter Worker

This is diameter worker for MzBench

For now it is suitable for simple request/answer scenarios. It supports both, TCP and SCTP transports.

Configuration

MzBench

Erlang release in MzBench doesn't include diameter application. You have to add it.

Edit node/rebar.config, find relx configuration part add ,{diameter, load} after inets:

{relx, [
    {release, {mzbench, "0.5.5"},
        [mzbench, dummy_worker, mz_histogram, mz_counter,
        crypto, public_key, asn1, ssl, inets]},

will be:

{relx, [
    {release, {mzbench, "0.5.5"},
        [mzbench, dummy_worker, mz_histogram, mz_counter,
        crypto, public_key, asn1, ssl, inets, {diameter, load}]},

Reinstall node code:

cd node
make clean
make local_tgz
make install

Dictionaries

You need diameter dictionaries for your diameter applications in OTP Diameter Dictionary Format.

Place them in dia subdirectory.

Worker

Worker accepts the following parameters:

• dictionary, diameter dictionary module name
• module, callback module, defaults to diameter_worker_cb, see OTP Diameter for details. It implements diameter_app behavior
• origin_host, defaults to inet:gethostname()
• origin_realm, defaults to "mzbench-client.com"
• product_name, defaults to "MzBench"
• auth_application_id, comma separated list of integers, defaults to empty string
• acct_application_id, comma separated list of integers, defaults to empty string
• service_name, distinct one diameter service from another, must be unique per client, defaults to diameter_worker
• address, server address, defaults to "127.0.0.1"
• port, server port, defaults to 3868
• avp_dictionaries, comma separated list of additional diameter module dictionaries, defaults to empty string
• transport, "tcp" or "sctp", defaults to "tcp"

Message Representation

Messages are represented as Erlang maps. You can use JSON format in resource files alternatively.

Lists of messages are represented as lists of maps:

[#{message_name => string(), message => map()}]

Usage

connect(address = "127.0.0.1", port=3868, auth_application_id = "4",
            dictionary="diameter_3gpp_ro", avp_dictionaries="diameter_ericsson")
call(MessageName, MessageBody),
call(MessageList)
disconnect()

Look in Examples subdicrectory for further inspiration.