Creating Resource Instances on Nodes

You can create a resource instance on a node from the host, from the node, from the resource template, or from an Application using the Administrator GUI. You can also create a resource instance with the CLI.

The available nodes are the nodes managed by the selected host.
Note: The name of the resource instance does not have to be the same as the name of the resource template from which it gets its configuration. However, it is often a good idea to use the same name.

GUI

Procedure

  • Choose a starting point and follow the appropriate procedure.
    Starting Point Procedure
    Hosts
    1. Select Infrastructure > Hosts.
    2. Select a host.
    3. Click the Resource Instances tab. In the All Instances table, click New.

      You can select a resource template type from the View drop-down list and click New

    4. Select resource template type from the drop-down list.

      If no resource templates exist, click new resource template link and follow the procedure in Creating a Resource Template.

    5. Use the check boxes under Scope to filter resource templates with specific scopes.
    6. On TIBCO ActiveMatrix Service Bus and TIBCO ActiveMatrix Service Grid, accept the default instance name or type a new one in the Instance Name field. The name must not contain the characters : or &.

      On TIBCO ActiveMatrix Policy Director Governance, the name of the resource instance should be the same as the resource template.

    7. Select a node in the Available Nodes and move it to Selected Nodes using the arrow buttons.
    8. Choose one of the following options:
      • Save to add the resource instance to the selected nodes and continue adding resource instances.
      • Save and Close to add the resource instance to the selected nodes and close the dialog.
      • Save and Install to install the resource instance to the selected nodes and close the dialog.
    9. If you did not install the resource instance in the previous step, the Install Resource Instances dialog box displays. Select the resource instances to install and click Install.
    Applications
    1. Click Applications and select an application.
    2. Click Resource Templates > Resource Instances.
    3. Click New.
    4. Select a resource template from the drop-down menu.
    5. Select a node from the Available Nodes box and move to Selected Nodes box.
    6. Type an instance name.
    7. Save.
    Nodes
    1. Select Infrastructure > Nodes.
    2. In the Nodes table, click a node.
    3. Click the Resource Instances tab.
    4. Select All Instances and click New.
    5. Select a resource template type from the drop-down list.

      If no resource templates exist, click new resource template link and follow the procedure in Creating a Resource Template.

    6. Use the check boxes under Scope to filter resource templates with specific scopes.
    7. Accept the default instance name or type a new one in the Instance Name field. The name must not contain the characters : or &.

      On TIBCO ActiveMatrix Policy Director Governance, the name of the resource instance should be the same as the resource template.

    8. Click Save to add the resource instance to the selected nodes and continue adding resource instances or Save and Close to add to add the resource instance to the selected nodes and close the dialog.
    9. In the Install Resource Instances dialog box, select the resource instances to install and click Install.
    Resource Templates
    1. Select Shared Objects > Resource Templates.
    2. Click a resource template.
    3. Click New Resource Instances. Optionally, you can select a resource template and click the Resource Instances tab.
    4. Accept the default instance name or type a new one in the Instance Name field. The name must not contain the characters : or &.

      On TIBCO ActiveMatrix Policy Director Governance, the name of the resource instance should be the same as the resource template.

    5. Select a node in the Available Nodes and move it to Selected Nodes using the arrow buttons.
    6. Choose one of the following options:
      • Save to add the resource instance to the selected nodes and continue adding resource instances.
      • Save and Close to add the resource instance to the selected nodes and close the dialog.
      • Save and Install to install the resource instance to the selected nodes and close the dialog.
    7. If you did not install the resource instance in the previous step, the Install Resource Instances dialog box displays. Select the resource instances to install and click Install.

CLI

Prerequisites

The resource template specified in the resourceTemplateName attribute must exist in the Administrator database.

Procedure

  1. In the data file, specify a ResourceInstance element in full format.
    <ResourceInstance xsi:type="amxdata:ResourceInstance" 
    name="resourceHttpClient" 
    resourceTemplateName="HttpclientRT" />

    For example:

    <ResourceInstance xsi:type="amxdata:ResourceInstance" 
    name="${HttpInboundConnectionConfig_hello1connector}" 
    resourceTemplateName="hello1connector" 
    scopeType="Environment"/>
    <ResourceInstance xsi:type="amxdata:ResourceInstance" 
    name="amx.bpm.auth.harmonie" 
    resourceTemplateName="amx.bpm.auth.harmonie" 
    scopeType="Application" 
    applicationName="amx.bpm.app"/> 
  2. In the build file, set the action attribute of the AMXAdminTask element to add and the objectSelector attribute to Environment/Node/ResourceInstance.
    <AMXAdminTask action="add" objectSelector="Environment/Node/ResourceInstance"/>