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.

Nenzyz / mzbench_diameter_worker