Managing Domains
Adding domains
Perform the following steps to add domains to the
.- Procedure
-
To add domains to the data plane, click Add Domain, a dialog appears to specify the following information about the domains.
Fields Description Domain Name The name of the domain.
Transport The network transport used by the TIBCO Hawk domain.
Select EMS or RV transport from the dropdown list.
EMS Server URL (for EMS transport) The location of the EMS server.
For example:<tcp/ssl>://<host>:<port#>
EMS Username (for EMS transport) The username to log in to the EMS server. EMS Password (optional) (for EMS transport) The password for the EMS username. Hawk RV Service (for RV transport) The RV service instructs the Rendezvous daemon to use this RV service when it conveys the messages on this RV transport. Enter the port number of the service to be used. Hawk RV Network (optional) (for RV transport) The RV network instructs the Rendezvous daemon to use a specific network for all communications involving this transport. The network parameter consists of three parts separated by semicolons: network, multicast groups, and send address. Hawk RV Daemon (for RV transport)
The RV daemon instructs the transport creation function about how and where to find the Rendezvous daemon and establish communication. For remote daemons, specify two parts, Remote host name (optional): Port number.
You must register at least one Hawk domain. For more information about these fields, see TIBCO® Operational Intelligence Hawk® RedTail documentation.
Note: You cannot register a TLS Domain if you select RV as transport while registering the domain. -
To register TLS Domain, click the TLS Domain toggle icon. If the TIBCO EMS server is SSL-enabled, specify the SSL connection fields for TIBCO Enterprise Message Service Transport. If you want to connect to TIBCO EMS server, you have to add the required certificates to a folder that is mounted in the Hawk Console pod.
For more information on TIBCO Enterprise Message Service certificate requirements, see TLS Protocol.
Note: The certificate files must be in PKCS#12 file format, as no other file formats are supported due to Java JSSE limitations.To find the location of the mounted folder, run the following commands on the machine where the BMDP microk8s cluster is running
-
Set your BMDP namespace name as an environment variable. This will be used in the next command:
BMDP_NAMESPACE=<bmdp-namespace>
-
If you are using local storage, then run the below command to capture the base path of the mount:
BMDP_STORAGE_PATH=$(kubectl get pv/$(kubectl get pvc/hawk-console-data-tp-dp-hawk-console-0 -n $BMDP_NAMESPACE -o jsonpath={.spec.volumeName}) -o jsonpath={.spec.hostPath.path})
If you are using NFS storage, then run the below command to capture the base path of the mount:
BMDP_STORAGE_PATH=$(kubectl get pv/$(kubectl get pvc/hawk-console-data-tp-dp-hawk-console-0 -n $BMDP_NAMESPACE -o jsonpath={.spec.volumeName}) -o jsonpath="{.spec.csi.volumeAttributes.server}:{.spec.csi.volumeAttributes.share}/{.metadata.name}")
-
To print the location of the mounted volume:
echo "Place EMS related certificate at $BMDP_STORAGE_PATH/hawk/emscerts/"
Sample Output:
~$> echo "Place EMS related certificate at $BMDP_STORAGE_PATH/hawk/emscerts/"Place an EMS-related certificate at/var/snap/microk8s/common/default-storage/hkqatest1-my-ns-hawk-consoledata-tp-dp-hawk-console-0-pvc-785e674f-2378-4435-a54e-3c4e43dcdd70/hawk/emscerts/
For specifying the TLS Domain information on the domain registration screen, see the following details.
Fields Description EMS SSL Trusted The file name of the server certificate. This field is disabled if you select the Do not verify Host checkbox.
EMS SSL Private Key (optional) The private key of the TIBCO Hawk component. EMS SSL Identity The digital certificate of the TIBCO Hawk components. EMS SSL Password The password to decrypt the identity file of the Hawk component.
Note: This field is mandatory only if the EMS SSL Private Key and EMS SSL Identity are provided.EMS SSL Expected Host Name The name that is expected in the CN field of the server certificates. This field is disabled if you select the Do not verify Hostname checkbox. -
-
Click Add Domain.
The domains that are not successfully registered at the Hawk console can be edited if their status is disconnected. As a domain can be in a disconnected state due to some other reasons. In addition, if that domain was previously registered successfully at the Hawk console, the edit icon is not enabled for it.
ResultOnce the domain is registered/added to the data plane, the domain name and domain detail are listed under the Domains tab. You can view the TIBCO ActiveMatrix BusinessWorks 5, TIBCO ActiveMatrix Adapters, and TIBCO BusinessEvents® card on the product landing page.
Edit domains
Click the edit icon to edit the existing domain details and then click Update configuration.
Delete domains
Click the delete icon to delete the domain.