Load Balancing an Application Using an AppSpace

This process demonstrates the concept of an AppSpace for scaling an application.

Setup the Domain

1. In a terminal, navigate to TIBCO_HOME\bw\n.n\bin and type bwadmin.
2. Create a Domain, AppSpace and AppNode:

   bwadmin[admin]> create domain MyDomain
   bwadmin[admin]> cd MyDomain
   bwadmin[admin@MyDomain]> create appspace MyAppSpace
   bwadmin[admin@MyDomain]> cd MyAppSpace
   bwadmin[admin@MyDomain/MyAppSpace]> create –httpPort 9999 appnode MyAppNode
   

Create the config.ini File

3. Copy TIBCO_HOME\bw\n.n\config\appspace_config.ini_template to a temporary location.
4. Rename the appspace_config.ini_template file to config.ini.
   1. Uncomment the following property and change the value to group.

      bw.engine.persistenceMode=group

   2. Set the datastore configuration with values similar to:

      # BW Engine Database Driver. 
      bw.engine.db.jdbcDriver=org.postgresql.Driver
      
      # BW Engine Database URL.
      bw.engine.db.url=jdbc:postgresql://localhost:5432/postgres1
      
      # BW Engine Database User Name.
      bw.engine.db.userName=postgres
      
      # BW Engine Database User Password.
      bw.engine.db.password=root
      
      # BW Engine Database Connection Pool Size.  
      bw.engine.db.maxConnections=10

   3. Save the config.ini file.
      For the JMS Receive Message activity, load balancing is done by setting Max Jobs limit and the flow limit. If one instance is down, the other instance processes the messages. Thus avoiding any outage. For the HTTP Receiver activity, load balancing is done at the external load balancer level. If one instance is down, all requests are sent to the other instance. However, when you use load balancing with fault tolerance, a database is required.
5. Push the configuration to the AppSpace running the following command in the bwadmin terminal:

   bwadmin[admin@MyDomain/MyAppSpace]> config -cf <temporary_location>/config.ini
   

6. In the bwadmin terminal, upload and deploy the EAR file into the AppSpace:

   bwadmin[admin@MyDomain/MyAppSpace]>upload
   TIBCO_HOME\bw\x.x\samples\core\admin\ears\samples\tibco.bw.sample.core.scalability.LoadBalancingUsingAppSpace.application_1.0.0.ear

   bwadmin[admin@MyDomain/MyAppSpace]> deploy -as
   tibco.bw.sample.core.scalability.LoadBalancingUsingAppSpace.application_1.0.0.ear

7. Start the AppSpace using the following command:

   bwadmin[admin@MyDomain/MyAppSpace]> start appspace MyAppSpace

Configure and Start the Client

8. Start TIBCO Designer and click New Empty Project.
9. Click Project > Import and import the client project, TIBCO_HOME\bw\n.n\samples\core\scalability\LoadBalancingUsingAppSpace\bw5\tibco.bw.sample.core.scalability.LoadBalancingUsingAppSpace.client.
10. Update the JMS shared resource configuration and verify the Host and Port values.
11. In TIBCO Designer, click Tools > Tester > Start. Wait for 30 seconds before completing the next steps.

Create a Second AppNode

12. In the bwadmin terminal, create a second AppNode in MyAppSpace. Execute the create command to create the AppNode and then the start command to start the AppNode:
    The TIBCO ActiveMatrix BusinessWorks™ JMS application should be deployed to MySecondAppNode automatically by the AppSpace.

    bwadmin[admin@MyDomain/MyAppSpace]> create –httpPort 9996 appnode MySecondAppNode
    bwadmin[admin@MyDomain/MyAppSpace]> start appnode MySecondAppNode

13. Open the bwappnode.log files on each node located under <DomainLocation>/<appnodes>/<appspace>/<nodename>/log [Example: <DomainLocation>/appnodes/betaappspace/betaappnode1/log] and monitor the messages flow.
14. Stop the second AppNode using the following command:

    bwadmin[admin@MyDomain/MyAppSpace]> stop appnode MySecondAppNode