activemq-artemis/examples/soak/normal
Clebert Suconic b3af4bb777 ARTEMIS-178 Refactor examples to use CLI
This is changing the examples to run the real servers.
The maven plugin should be an automation of the CLI
Where we run real servers instead of any embedded framework

Going forward we will need to remove the common examples.
Failover examples will be able to use Process Builders
2015-07-29 16:00:41 -05:00
..
server0 ARTEMIS-178 Refactor examples to use CLI 2015-07-29 16:00:41 -05:00
src/main ARTEMIS-178 Refactor examples to use CLI 2015-07-29 16:00:41 -05:00
README ARTEMIS-178 Refactor examples to use CLI 2015-07-29 16:00:41 -05:00
pom.xml ARTEMIS-178 Refactor examples to use CLI 2015-07-29 16:00:41 -05:00
soak.properties ACTIVEMQ6-43(reopened) : Replace License Headers on codebase 2015-01-05 13:14:25 -05:00

README

****************************************************
* Soak Test For Manual Reconnection of JMS Clients *
****************************************************

Running the Soak Tests
=======================

Run The Server Standalone
==========================

Use the Profile server
   mvn -Pserver verify

That will create a server under ./target/server0


You can define the property server.dir under the same Profile to create other servers. or you could do it manually if desired using the regular ./artemis create

   $ mvn -Dserver.dir=server1 -Pserver verify

server1 should contain a copy of configuration equivalent to that found under the server0 director with different
settings.

To run a server with the same configuration but on a different host.  Check out this source on the host machine and
change:
* activemq.remoting.netty.host property in broker.xml
* bindAddress and rmiBindAddress properties in activemq-beans.xml

  $ mvn verify -P server


To run the server just start it manually

Configure Server Dump
=====================

The server can "dump" info at regular interval. In broker.xml, set

   <server-dump-interval>10000</server-dump-interval>

to have infos every 10s:

**** Server Dump ****
date:            Mon Aug 17 18:19:07 CEST 2009
free memory:      500,79 MiB
max memory:       1,95 GiB
total memory:     507,13 MiB
available memory: 99,68%
total paging memory:   0,00 B
# of thread:     19
# of conns:      0
********************

Run The Clients
===============

The clients can be run separate from the server using:

  $ mvn verify -Premote

Parameters are specified in soak.properties.

The duration of the tests is configured by duration-in-minutes (defaults to 2 minutes, set to
-1 to run the test indefinitely).

To configure the soak properties different to the defaults for the clients, use the system property
To specify the JNDI server to connect to, use the system property jndi.address

  $ mvn verify -Premote -Dsoak.props=<path to properties> -Pjndi.address=jnp:remote.host:1099

Every 1000th message, the clients will display their recent activity:

INFO: received 10000 messages in 5,71s (total: 55s)

At the end of the run, the sender and receiver will sum up their activity:

INFO: Received 223364 messages in 2,01 minutes

Kill The Server And Check Manual Reconnection
==============================================

You can kill the server (ctl+c or kill -9), the clients are configured to reconnect
indefinitely to the same single server (even in case of clean shutdown)
Once the server restarts, all the clients will resume their activities after reconnecting
to the server.