README

README
=====

The perf test class is perf.Test, use run.sh to run it. 



Setup
-----

- Apache httpd should be installed in a local file system, e.g. /tmp, instead of an NFS mount
  --> This way it is much faster

  In httpd.conf, comment the CustomLog directive, or else access_log gets really big !

- Use the httpd.conf below:
# MOD_CLUSTER_ADDS
# Adjust to your hostname and subnet.

ServerLimit 20
ThreadsPerChild 50
StartServers 10
MaxClients 500

<IfModule manager_module>
  Listen 8000
  ManagerBalancerName mycluster
  Maxcontext 10
  Maxnode 40
  Maxhost 40
  ReduceDisplay off
  <VirtualHost *:8000>
    <Location />
     Order deny,allow
     Allow from all
    </Location>

    KeepAliveTimeout 20
    MaxKeepAliveRequests 0
    ServerAdvertise off
    AdvertiseFrequency 30
    #AdvertiseSecurityKey secret
    #AdvertiseGroup @ADVIP@:23364
    EnableMCPMReceive

    <Location /mod_cluster_manager>
       SetHandler mod_cluster-manager
       Order deny,allow
       Allow from all
    </Location>

  </VirtualHost>
</IfModule>



- Use the run-master.sh script below to start a JBoss 7 domain controller:
  ./run-master.sh

- Use the run-slave.sh script to start N slave host controllers:
  ./run-slave.sh 2 // name ('2') needs to be unique for every slave


- Modify domain.xml:

  * Parameterize instance-id in jboss:domain:web:1.1:
    <subsystem xmlns="urn:jboss:domain:web:1.1" default-virtual-server="default-host"
               instance-id="${jboss.node.name:undefined}" native="true">
         <connector name="ajp" protocol="AJP/1.3" scheme="http" socket-binding="ajp" max-connections="400"/>
  
 
  * modcluster:
    <subsystem xmlns="urn:jboss:domain:modcluster:1.1">
        <mod-cluster-config proxy-list="172.17.32.254:8000" advertise="false">
            <simple-load-provider factor="1"/>
        </mod-cluster-config>
    </subsystem>


  Make sure to adjust proxy-list.

  * Change the AJP connector:
    <connector name="ajp" protocol="AJP/1.3" 
               scheme="ajp" socket-binding="ajp" 
               max-connections="800"/>

  * Change <interfaces>:
    <interfaces>
        <interface name="management">
            <nic name="eth1"/>
        </interface>
        <interface name="public">
            <nic name="eth1"/>
        </interface>
        <interface name="unsecure">
            <nic name="eth1"/>
        </interface>
    </interfaces>

     --> Remove "unsecure"
     --> Change jboss.bind.address.management to jboss.bind.address


- Further modifications:
  * JGroups and Infinispan configs in domain.xml
  * Update JGroups and Infinispan versions to 3.1 and 5.2 (possibly snapshots)