Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Machine Management and Domain Configuration : Adding a Machine to a Domain

Adding a Machine to a Domain
When you add a machine to an administration domain, the machine becomes visible in the TIBCO Administrator GUI Machines console in the Resource Management module. You can then use the Application Management console to deploy applications on the machine and start, stop, and monitor the applications using the TIBCO Administrator GUI.
The TIBCO Administrator GUI is used to remove a machine from an administration domain. See the TIBCO Administrator User’s Guide for details.
To Add a Machine to a Domain Using the GUI
1.
2.
Under Category, select Machine Management, then select Add Machine. Click Next.
3.
In the Add Machine panel, provide values in each field. See Add Machine Panel for field descriptions.
4.
Click Next. A summary dialog appears where you can verify that the values your provided are correct.
5.
Click Next to add the machine to the domain.
6.
On Microsoft Windows, a service is created using the domain name to which the machine has been added. Navigate to the Services panel and start the service.
On Unix platforms, an executable is created in the TIBCO_TRA_DOMAIN_HOME/domain-name folder. Navigate to the folder and start the TIBCO Hawk Agent.
7.
Click Finish to end the session.
To Add a Machine to a Domain Using the Command Line Utility
1.
2.
Copy the following file to your working directory: TRA_HOME\template\domainutility\cmdline\AddMachine.xml
3.
Open AddMachine.xml in a text editor.
Provide values for each parameter. See Add Machine Panel for parameter descriptions.
4.
5.
   domainutilitycmd -cmdFile working-dir-path\AddMachine.xml
6.
On Microsoft Windows, a service is created using the domain name to which the machine has been added. Navigate to the Services panel and start the service.
On Unix platforms, an executable is created in the TIBCO_TRA_DOMAIN_HOME/domain-name folder. Navigate to the folder and start the TIBCO Hawk Agent.
Add Machine Panel
 
Click the Discover button to find an administration domain. If a domain does not appear, select Show Advanced and increase the Discover Timeout value. Check also that the transport used by the domain is selected.
Machines are grouped in the TIBCO Administrator GUI under the value provided in the Hawk Cluster field. If you change the default value, this machine displays in the TIBCO Administrator GUI under the value you provide. The cluster name must be enclosed within quotes, if the name contains spaces.
Note: When adding a machine, you must select the transport already set for the primary domain. TIBCO Hawk and POF must use the same transport type. Mixed transport types are not supported.
TIBCO Rendezvous daemon used for communication with TIBCO Hawk. Default is tcp:7474. See the TIBCO Hawk Installation and Configuration manual for details about this parameter.
Specify the user account name authorized to administer the TIBCO Enterprise Message Service server. Specify a user that is a member of the $admin group (for example, the predefined admin user), or a user who has the following permissions:
com.tibco.pof.domain-name.>
com.tibco.pof.AUTH_domain-name.>
_HAWK.domain-name (for each domain)
Note: You must add the following topics to the TIBCO_HOME/ems/bin/topics.conf file:
com.tibco.pof.domain-name.>
com.tibco.pof.AUTH_domain-name.>
_HAWK.domain-name (one line for each domain)
You must also add the following queue to the TIBCO_HOME/ems/bin/queues.conf file:
Note that if domain-name, contains the characters '.', '>' and '*', the characters must be replaced by the following strings:
Select the Use default values check box unless you are an experienced user.
 
This property is used to secure the .properties files. The specified group will be given view access to the AuthorizationDomain.properties and AdministrationDomain.properties files when these property files are created as part of domain creation. Specifying this property allows the users in the specified group to use TRA utilities like AppManage.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved