Managing Orgs and Spaces Using Apps Manager

Page last updated:

This topic explains how to view and manage orgs and spaces in Apps Manager.

Note: To manage a space, you must have Space Manager permissions in that space.

Overview

You can use Apps Manager to manage orgs and spaces. This includes creating and deleting orgs, domains, and spaces, managing member permissions, adding metadata, and more.

For information about managing apps and service instances, see Managing Apps and Service Instances Using Apps Manager.

You can manage orgs and spaces across multiple foundations. For more information, see Configuring Multi-Foundation Support in Apps Manager.

Prerequisite

To do the following, you must first log in to Apps Manager with an account that has adequate permissions.

For more information, see About Permissions.

Manage an Org

The following sections describe how to manage your orgs using the org management interface in Apps Manager. You can navigate to your org from the Home page or through the global search.

For details about each tab in the org page, see the following sections.

Spaces

In the Spaces tab, you can do the following:

  • See the following information for each space:

    • Name
    • Number of apps
    • Number of apps in running, stopped, and crashed states
    • Number of services
    • Memory quota usage
  • Create a new space

Domains

In the Domains tab, you can do the following:

  • See each Domain in your org.

  • See the Type associated with each domain. A type is either Globally Shared or Privately Shared. For more information about globally and locally shared domains, see Shared Domains and Private Domains.

  • Delete a domain by clicking the vertical three-dot icon and selecting Delete. You must have permission to manage the domain to delete it.

  • Create a new private domain by clicking Add a Domain. You must have Org Manager permissions to create a private domain.

    Note: To create globally shared domains, you must have Admin permissions and use the Cloud Foundry Command Line Interface (cf CLI). For more information, see Create a Shared Domain.

See the following screenshot for an example Domains interface with Org Manager permissions:

The screenshot shows the
'Domains' tab selected. At the top of the tab content is an 'Add a Domain' button. Below is a table with
three example domains listed: 'apps.internal' which is a 'Global' type, 'apps.test.cf-app.com,'
which is also a 'Global' type, and 'dev.private,' which is a 'Private' type. Only the domain with the 'Private'
type has the horizontal three-dot menu, indicating that the domain can be deleted.

Members

In the Members tab, you can do the following:

  • See member email addresses
  • Toggle member permissions
  • Remove member from org
  • Invite a new member

Settings

In the Settings tab, you can do the following:

  • Change the org name
  • See spaces assigned to isolation segments. For more information, see Isolation Segments.
  • Delete the org. You must have admin permissions to delete an org.

Add Metadata

You can add metadata, including labels and annotations, to orgs using Apps Manager.

For more information about adding metadata to objects in PAS, see Using Metadata.

To add labels or annotations to an org using Apps Manager, do the following:

  1. Click the Settings tab of the desired org and navigate to the Metadata section. The Metadata section of the Apps Manager Settings page includes  fields for labels and annotations. Each field includes two text boxes for entering name and value pairs, a toggle labeled "Enter JSON" that allows you to enter metadata in JSON format, and  aplus-sign button that allows you to add more name and value pairs. There are also "Cancel" and "Update Metadata" buttons to save or abandon your changes.

  2. For Labels, complete the Name and Value fields. Or, select Enter JSON to enter the label in JSON.

  3. For Annotations, complete the Name and Value fields. Or, select Enter JSON to enter the annotation in JSON.

  4. To add more labels or annotations, click + next to the Labels or Annotations field.

  5. Click Update Metadata.

Manage a Space

The space page displays the apps, service instances, and routes associated with the selected space.

Space apps view

Apps

The Apps tab shows the Status, the Name, the number of Instances, the amount of Memory available, the time since the Last Push, and the Route for each app.

Apps in space

Services

The Services list shows the Service, the Name, the number of Bound Apps, and the Plan for each service instance. If you want to add a service to your space, click Add Service. For more information about configuring services, see the Services Overview topic.

Services space

Routes

From the Routes tab, you can view and delete routes associated with your space. For each Route, the tab shows Route Service and Bound Apps. Refer to the Route Services topic to learn more about route services.

Routes tab

Settings

From the Settings tab, you can do the following:

  • Modify the space name by entering a new name and clicking Update.
  • View the Application Security Groups (ASGs) associated with the space in the Security Groups section.
  • View the space’s isolation segment assignment in the Isolation Segment Assignment section. For more information, see Isolation Segments.
  • Add metadata to the space. See Add Metadata.
  • Delete the space by clicking Delete Space.

Rename space

Add Metadata

You can add metadata, including labels and annotations spaces using Apps Manager.

For more information about adding metadata to objects in PAS, see Using Metadata.

To add labels or annotations to a space using Apps Manager, do the following:

  1. Click the Settings tab of the desired space and navigate to the Metadata section.

  2. For Labels, complete the Name and Value fields. Or, select Enter JSON to enter the label in JSON.

  3. For Annotations, complete the Name and Value fields. Or, select Enter JSON to enter the annotation in JSON.

  4. To add more labels or annotations, click + next to the Labels or Annotations field.

  5. Click Update Metadata.