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


Chapter 2 Creating a TIBCO Silver Fabric Enabler for ActiveMatrix Service Grid Stack : Creating a TIBCO ActiveMatrix Runtime Component

Creating a TIBCO ActiveMatrix Runtime Component
The TIBCO ActiveMatrix Runtime is the runtime component used to start the TIBCO Host instance.
Each TIBCO ActiveMatrix Runtime Component requires a component dependency on TIBCO ActiveMatrix Administrator component.
The ActiveMatrix Runtime Component will automate the following tasks:
Each ActiveMatrix Runtime Component may only start one runtime instance. If you want more than one ActiveMatrix Runtime instance you must copy the ActiveMatrix Runtime Component so that copy can be instantiated once also.
Create a TIBCO ActiveMatrix Runtime Component
1.
2.
3.
4.
5.
TIBCO Host Instance Name - Enter a unique TIBCO Host Instance name. This is the TIBCO ActiveMatrix Service Grid host name and it must be unique within the enterprise because multiple ActiveMatrix Service Grid instances may make reference to a single Administration instance.
If not specified, the Host Instance Name is derived from the Component name.
Deployment Directory - Defines the relative directory where the TIBCO ActiveMatrix Runtime Host will be installed on the Silver Fabric Engine.
Default for tibcoHome is:
   DSEngine_HOME/work/TIBCO_HOST_INSTANCE_NAME/home
Figure 17 Setting the Basic Configuration
TIBCO Host Instance Management Base Port - It is recommended that you accept the default port setting for TIBCO Host Instance Management Base Port unless you intend to change the Silver Fabric Java Admin API using a different JMX port. Refer to the TIBCO Silver Fabric Developers Guide for more information.
TIBCO Host Communicates with a Server that is SSL Enabled - if you want your ActiveMatrix Service Grid Component to use SSL to communicate with the ActiveMatrix Admin then check the box and the SSL Configuration page appears after you click Next to confirm your setting changes.
6.
Figure 18 SSL Configuration
SSL Configuration is required if you have checked the use SSL checkbox. The Trust Store file must be uploaded for use with a valid password or the component will fail to establish a proper connection.
Using Scripts with the Enabler
The next diagram shows how a script may be uploaded. Scripts can be executed at various points in the engine life cycle and uploaded for use with the Component or Enabler. Python, Jython, and JavaScript are supported. Refer to the TIBCO Silver Fabric Developers Guide for more information on the methods that may be called.
Figure 19 Upload, Edit, or Remove Scripts
Scripts can be written to accomplish many tasks. Scripts may be used to automate publishing ActiveMatrix application archives instead of manually publishing them.
TIBCO Silver Fabric has generic support for adding any JSR-223 compliant script engines that support interfaces that can be invoked and compiled. Support for Jython is included and the JDK includes JavaScript. Refer to https://developer.mozilla.org/en-US/docs/Rhino/Overview for more information.
The example Jython script included in the installation directory below demonstrates one way to accomplish this:
   SFSG_HOME\sfsg\1.3.1\samples\jython\applicationDeploy.py
A script can provide a way to add an ActiveMatrix Runtime node and can deploy ActiveMatrix application archives. The example script included with the installation, applicationDeploy.py, would unzip and deploy the application in the sample zipped archive:
   SFSG_HOME\sfsg\1.3.1\samples\archive\testAppDeployment.zip
If you were to use the example script to deploy an archive you would want to upload the demo data zipped archive for use with the ActiveMatrix Runtime Component as is shown here.
Figure 20 Upload an archive for use with a script
Refer to the TIBCO Silver Fabric Developer’s Guide on Enabler and Component scripting and methods for a more complete description of what can be done with scripts.
7.
If you have implemented the ScriptStatisticsProvider class added to this Component by a script or an archive, then this page allows for the addition of archives from that statistics provider.
Figure 21 Add, edit, or remove script-provided statistics
Refer to the TIBCO Silver Fabric Developer’s Guide for information on implementing script-provided or archive-provided statistics.
The next diagram shows the log file that will be preserved by default. You should accept the default setting.
8.
Figure 22 Adding a Log File Pattern
Component Dependency Requirements
The TIBCO ActiveMatrix Runtime Component is dependent on the TIBCO ActiveMatrix Administrator component and the TIBCO ActiveMatrix Administrator component is dependent on an instance of EMS. Both of those dependencies must be set. The Component Dependency may be set from the Stack definition, see Dependency Requirements, or you can set it directly on the Component definition as is described here.
To set the Component dependency:
1.
Or instead of using the Menu task list, you could step through the Component Wizard until you reach the page that allows you to "Change the allocation rules that are used by default when adding this Component to a Policy (including by activation in Dynamic Policy Mode)." selection link.
2.
Figure 23 Setting a Component Dependency
3.
4.
Shutdown Dependency - Uncheck the Shutdown Dependency checkbox when you want the TIBCO Hosts to continue running even if contact with the ActiveMatrix Administrator is lost.
5.
Ordered Shutdown should always be checked to provide for proper cleanup of allocated resources.
6.
Restart Component for new rules should use the default setting.
Complete the wizard by accepting the defaults on the remaining screens.

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