Registering the TEA Agent for TIBCO Security Server

The TEA agent for TIBCO Security Server auto-registers itself with the TIBCO Enterprise Administrator server using the TIBCO Enterprise Administrator server URL specified in the tss.conf. However, there may be circumstances, when you have to explicitly register the agent. For example, if you want to register the TEA agent with any other TIBCO Enterprise Administrator server than the one in tss.conf, you must explicitly register agent with the URL http://<hostname/IPAdddress>:<portno>/teagent/ssa

Prerequisites

Ensure that the TIBCO Enterprise Administrator server and the TEA agent for TIBCO Security Server are running.

Procedure

  1. Log in to TIBCO Enterprise Administrator. The username and the password is admin. The landing page is displayed.
  2. Click the Agents card on the right.
    The Agent Management Pane is displayed.
  3. Select the TEA agent and click Register New.
  4. Provide the following details:
    • Agent Name
    • Agent URL :The default URL is http://localhost:8080/teaagent/ssa if TIBCO Enterprise Administrator server and the agent are on same machine. If you have changed the host name and port number in tss.conf then the URL is http://<host_name>:<port_number>/teaagent/ssa.
    • Agent Description
    Caution: When registering agents, ensure that the agent IDs do not collide.
  5. Click Register.
    The TEA agent is visible in the Agent Management pane. The landing page also shows an icon for every registered agent. Your landing page will look different from the one displayed depending on the agents registered.
    Caution: Watch out for the following:
    1. Ensure that you avoid registering two agents with the same ID. The TIBCO Enterprise Administrator server does not validate whether two agents have registered with the same ID.

    2. If there are two agents for the same object type, ensure that they have the same operation name and number. This is to ensure that when you invoke an operation, you can select the agent on which you want to execute the operation from the drop-down list.
    3. If the agent is not immediately visible in the pane, try refreshing the browser.
    4. If the URL used during registration is invalid, the "404-Page not Found" error occurs.
    5. Make sure that TEA agent is configured with correct hostname that is reachable from TIBCO Enterprise Administrator server.
    Note: The scope of the document limits to a discussion on the TEA agent. This document does not cover the TIBCO Enterprise Administrator Web UI in detail. If you want to learn to use the three interfaces provided by TIBCO Enterprise Administrator, refer to TIBCO Enterprise Administrator User's Guide.