Running in Enterprise Mode Using the Admin UI

Use the Admin UI to manage and monitor runtime entities.

The Admin UI is a web UI that runs in TIBCO® Enterprise Administrator (TEA). To enable the Admin UI, the bwagent must be registered with a running TEA server.

This procedure shows you how to create runtime entities and deploy and run an application using the Admin UI. You will learn how to register the TEA agent with the bwagent; open the Admin UI; create a domain, AppSpace, and AppNode; upload an archive; start the AppSpace; and deploy and start the uploaded application.

Procedure

  1. Install TEA and start the TEA server.
    • Windows:
      TEA_HOME\2.0\bin>tea.exe
    • Unix:
      [root@TEA_HOME bin]# ./tea.sh
  2. In a terminal, navigate to the following location:
    • Windows:
      BW_HOME\bin
    • Unix:
      BW_HOME/bin
  3. Set the bwadmin mode to enterprise.
    • Windows:
      BW_HOME\bin>bwadmin mode enterprise
      
    • Unix:
      [root@BW_HOME bin]# ./bwadmin mode enterprise
  4. Open a new terminal and navigate to BW_HOME\bin for Windows or ${BW_HOME}/bin for Unix. Register the bwagent TEA agent with the TEA server. This allows the bwagent to be available to the TIBCO Enterprise Administrator server. The URL to the TEA server is required in the command. The URL is available from the terminal where the TEA server was started.
    • Windows:
      BW_HOME\bin>bwadmin registerteaagent http://M1:8777/
      
    • Unix:
      [root@BW_HOME bin]# ./bwadmin registerteaagent http://M1:8777/
      
  5. Open a web browser and go to the TEA URL. Sign in, using admin for the user name and admin password.
    BusinessWorks is displayed in the Products list.
  6. Click the BusinessWorks icon to go to ActiveMatrix BusinessWorks. The Domain Management page is displayed. If you completed the steps in the "Running in Enterprise Mode Using the Command Line," you see a domain listed on the Domain Management page. Otherwise the page is empty.
    1. Click Create Domain to open the Create Domain dialog box.
    2. Enter the domain name in the Name field.
    3. Choose the bwagent registered with the TEA server from the Agent drop-down.
    4. Click Create to create the domain.
    The domain is created and displayed on the Domain Management page.
  7. Click the domain name to open the domain.
  8. Add an AppSpace to the domain.
    1. Click the AppSpaces icon to open the AppSpaces page.
    2. Click Create AppSpace.
    3. In the Create AppSpace dialog box, enter AppSpace name in the Name field. Accept the value of 1 in the MinNodes field.
    4. Select the agent registered with the TEA server and click Create.
    The AppSpace is created. A success notification is displayed at the top of the page. Notice that the AppSpace status is displayed as Degraded, because there are no AppNodes yet for the AppSpace. This will change to Stopped when an AppNode is added to the AppSpace. The AppSpaces page will look similar to this:
  9. Add an AppNode to the AppSpace.
    1. Click the AppNodes icon to open the AppNodes page.
    2. Click Create AppNode.
    3. In the Create AppNode dialog box, enter name of the AppNode in the Name field.
    4. Select the agent registered with the TEA server from the Agent drop-down.
    5. Enter a value in the HTTP Port field, for example: 8075. This port must be available; each AppNode on the machine must be assigned to a unique HTTP management port.
    6. Leave the OSGi fields empty. (This are optional fields for debugging the AppNode. For more information, see Enabling the OSGi Console for an AppNode.)
    7. Select the AppSpace from the AppSpace drop-down.
    8. Click Create.
    The AppNode is created. A success notification is displayed at the top of the page and the AppNode is displayed. The AppNodes page will look similar to the following image:
  10. Open the AppSpaces page and notice that the status has been updated to Stopped.
    1. Start the AppSpace by clicking the Start icon .
    The AppSpace starts and starts the AppNode. The status changes to Starting, then Running to indicate that both the AppNode and AppSpace are running.
  11. Upload an application archive to the AppSpace.
    1. Click the Application Archives icon .
    2. In the Application Archives page, click the Upload link and drag the BookStore sample application archive from BW_HOME\samples\AppSpace\core\admin\ears\bookstore\ears to the Upload Ear File dialog box.
    3. Click Upload.
    4. A success message is displayed in the dialog box. Click Done to close the dialog box.
    The application archive is displayed on the Application Archives page:
  12. Deploy the application.
    1. Click the application archive link on the Application Archives page to pivot to the application view, then click Deploy to deploy the BookStore application.
    2. In the Deploy Applications dialog box, make sure UI-AppSpace1 is selected in the AppSpace drop-down.
    3. Select WindowsProfile.substvar (Default) from the Profile drop-down.
    4. Check the Start applications on AppNodes after deployment option. This option starts the application after successful deployment.
    5. Click Deploy.
    The application is deployed to the selected AppSpace and is started on the AppNode.

  13. Click the REST Doc URL link to view the application's REST API. You can also open the Endpoints, Components, or Processes tabs to drill down into the running application.

Result

You registered the bwagent with the TEA server. You used the Admin UI to create a domain, AppSpace, and AppNode; start the AppSpace; upload an application archive; deploy the application; and start the application. Spend some time experimenting with the Admin UI. The web interface allows you to drill down into entities and pivot views.

For more information, see Using the Admin UI.