Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 8 Deploying and Managing Engines with MM : Deploying or Starting Engines with the Command Line Utility

Deploying or Starting Engines with the Command Line Utility
This section explains how to deploy engines and start remote engines at the command line using the mm-tools utility.
All engines have to be predefined in the site topology file.
Before you can use the mm-tools utility you must configure it.
Configuring the MM Tools Utility TRA File
Before you can use the MM tools utility, you must configure the mm-tools.tra file to reference the cluster’s site topology file.
Prerequisite Configuration
The following setup is prerequisite to use of MM tools:
In addition, the mm-tools.tra file must be configured as explained in this section.
To Configure the mm-tools.tra File
1.
BE_HOME/mm/bin/mm-tools.tra
2.
   be.mm.topology.file pathToTopology/toplogy.st
3.
For remote start, if the if start-pu-method in the site topology file is Hawk, and you use non-default values, uncomment and specify the following Hawk properties. Use the values that are configured for the Hawk agent running on the remote machine:

 
#be.mm.tools.Domain=TIBCO Hawk Domain
#be.mm.tools.TIBHawkService=Rendezvous daemon used by Hawk
#be.mm.tools.TIBHawkNetwork=Rendezvous network used by Hawk
#be.mm.tools.TIBHawkDaemon=Rendezvous service used by Hawk

 
If Hawk is also used for machine level metrics, the values specified would be the same as those specified in the MM.cdd See Install and Configure TIBCO Hawk for Machine Level Metrics.
4.
Deploying or Starting a Remote Engine
Deployment is done through SSH. Remote start is done using the method configured in the site topology file start-pu-method setting.

 
BE_HOME/mm/bin/mm-tools [-h] [--propFile StartupProperty File] -op deploy | start -m MachineHostName [-puc ProcessingUnitConfig] [-user UserName] [-pwd Password>]

 
Deployment example:
mm-tools --propFile mm-tools.tra -op deploy -m Acme-PC
Remote start example:
mm-tools --propFile mm-tools.tra -op start -m Acme-PC -puc CacheServer
mm-tools Options Reference
 
Table 33 mm-tools Options 
When you execute mm-tools, by default it looks in the working directory (the directory where you execute the command) for a property file of the same name (mm-tools.tra). This property file provides startup values and other parameters to the executable.
For example, if you execute the command from a directory other than BE_HOME/mm/bin, then you would generally use --propFile to specify BE_HOME/mm/bin/mm-tools.tra.
deploy: The deploy operation is done through SSH
start: The start operation is done using the mechanism defined in the site topology file start-pu-method setting.
For the deploy option: The username used by SSH on the remote machine.
For the start option: The user name used to log into the remote machine for remote start.
For the deploy option: The password for the username used by SSH on the remote machine.
For the start option: The password for the username used to log into the remote machine for remote start.
 

Copyright © TIBCO Software Inc. All Rights Reserved