Creating an AppSpace

An AppSpace is created under a domain, which must exist before adding an AppSpace to it. An AppSpace contains one or more AppNodes. The domain name applies to the AppSpace.

The following characters are allowed in the AppSpace name:

  • A-Z
  • a-z
  • 0-9
  • - (hyphen)
  • _ (underscore)

Illegal characters are stripped from the name.

The maximum length of a runtime entity name is 100 characters. If the maximum length is exceeded, the entity name is shortened to 100 characters.

bwadmin Command Line

To create an AppSpace named MyAppSpace in the domain MyDomain, execute the following command at the command line: 

BW_HOME\bin>bwadmin create -d MyDomain -minNodes 1 appspace MyAppSpace

The MyAppSpace AppSpace is created in the domain MyDomain that exists on the machine where the bwagent is running. Use the -agent option to create an AppSpace running on a remote machine. Run the show agents command on the remote machine to get the agent name. If you are in local mode, the agent is not supported.

Admin UI

To create an AppSpace using the Admin UI:

Procedure

  1. On the Domain Management page, click the domain you want to add the AppSpace to.
    The Monitor page is displayed, showing that no runtime entities exist in the domain.

  2. Click AppSpaces on the side bar to open the AppSpaces page.
  3. Click Create AppSpace to open the Create AppSpace dialog box. Enter the following information.
    • Name: AppSpace name.
    • MinNodes: Minimum number of AppNodes for this AppSpace. Default is 1. The AppSpace status is set to Degraded if the minimum number of AppNodes is not created.
    • Agent: The bwagent registered with the TEA server.
    • Description: Optional description.

    Click Create AppNodes in the Create AppSpace dialog box to create AppNodes. You can also create AppNodes from the AppNodes Admin UI page. For information, see Creating an AppNode .

  4. Click Create.
    The AppSpace is created and displayed on the AppSpaces page. The AppSpace status is set to Degraded as there are no AppNodes yet to satisfy the minimum requirement.