Managing Orgs and Spaces Using Apps Manager

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.

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

You can manage org resources, including the spaces, domains, and members associated with the selected space, in Apps Manager. You can also manage org settings.

You can manage an org by navigating to the org in Apps Manager.

To navigate to an org, do one of the following:

  • On the Apps Manager home page, under Orgs, click the name of the org that you want to manage.
  • Search for the org by entering its name in the search bar.

By default, the landing page for an org in Apps Manager is the org Spaces page. You can use the panel on the left side of the screen to navigate to other pages for resources in the org, such as domains and members.

The following image shows an example of the landing page for an org in Apps Manager.

A panel on the left side of the screen has the following main sections: Org and Marketplace. The following links are under the Org section: Spaces, Domains, Members, and Settings. In the main content of the page, a page title of "test-org" appears at the top of the page under a smaller "Org" heading. To the right of the "test-space" title is a horizontal bar with the label "Quota". Below this header content is a table labeled "Spaces". The table has the following columns: Name, Apps, App Status, Services, and Org Quota Usage.

You can manage the following resources in an org using Apps Manager:

Manage Spaces

In the org 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.

Manage Domains

In the org Domains page, 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.

Manage Members

In the org Members page, you can do the following:

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

Manage Settings

In the org Settings page, 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

You can manage space resources, including the apps, service instances, routes, and members associated with the selected space, in Apps Manager. You can also manage space settings.

You can manage a space by navigating to the space in Apps Manager.

To navigate to the space, do one of the following:

  • On the org page, click the name of the space you want to manage.
  • Search for a space by entering its name in the search bar.

By default, the landing page for a space in Apps Manager is the space Apps page. You can use the panel on the left side of the screen to navigate to other pages for resources in the space, such as services and members.

The following image shows an example of the landing page for a space in Apps Manager.

A panel on the left side of the screen has the following main sections: Space, Networking, Marketplace. The following links are under the Space section: Apps, Services, Members, Settings. A Routes link is under the Networking section. In the main content of the page, a page title of "test-space" appears at the top of the page under a smaller "Space" heading. To the right of the "test-space" title are the headings: Running, Stopped, and Crashed. Under each of these headings is a number that signifies the number of apps in the space that are running, stopped, or crashed. Below this header content is a table labeled "Apps". The table has the following columns: Status, Name, Instances, Memory, Last Push, and Route.

You can manage the following resources in a space using Apps Manager:

Manage Apps

The Apps page lists information about all apps in the space. For each app, it shows the Status, Name, number of Instances, amount of Memory available, time since the Last Push, and associated Route.

Manage Services

The Services page shows the Service, Name, number of Bound Apps, and Plan for each service instance in the space.

For more information about configuring services, see the Services Overview topic.

Manage Members

The Members page lists all members of the space. For each member, the page also lists the associated user roles.

The following user roles can be assigned to space members on the Members page:

  • Space Manager: Space Managers can invite and manage users in the space.
  • Space Developer: Space Developers can create, manage, and delete apps and services in a space.
  • Space Auditor: Space Auditors have read-only access to space details, app logs, and reports.

Manage Routes

The Routes page lists the routes associated with the space.

For each Route, the page shows the Route Service and Bound Apps. For more information about route services, see Route Services.

Manage Settings

From the space Settings page, you can do the following:

  • Modify the space name.
  • View the Application Security Groups (ASGs) associated with the space.
  • View the space’s isolation segment assignment. For more information, see Isolation Segments.
  • Add metadata to the space. See Add Metadata.
  • Delete the 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.