Installing and Administering N1 Grid Console - Container Manager 1.0

Creating a User-Based or Group-Based Container


Note –

Only the user-based container type is available if you are running the Solaris 8 release.


If you want the container to manage processes that are identified by either a UNIX user or UNIX group name, you should create a user-based or group-based container. The project-type selected during the creation process will determine whether the finished container definition or container is user-based or group-based.

To Create a User-Based or Group-Based Container Definition
  1. Launch the New Container wizard, as described in To Launch the New Container Wizard.

    The Overview panel appears. Use the Next button to move through the wizard. Use the Previous button to return to any panel in the wizard to make any changes.

  2. Provide a name for the container.

    The name must be unique and not exceed 32 characters. This name will identify the container in the navigation window, status tables, and resource utilization reports. If a duplicate name is entered, the creation of the container definition will fail.

    A container name cannot be changed after the creation procedure is finished.

  3. (Optional) Provide a description for the container.

  4. Select User or Group as the project type for the container.

    A container with a user-based project type tracks processes with the same UNIX user name.

    A container with a group-based project type tracks processes with the same UNIX group name.


    Note –

    In the Solaris 8 OS, only the user-based container type is supported.


  5. Provide project type identifiers according to the following:

    • User-Based Project - You must provide a valid UNIX user name in the first field. UNIX user names of those users that can join the project can be added in the second field. UNIX group names of those groups that can join the project can be added in the third field. Separate multiple entries with a comma.

      Do not provide a user name that is being used in another user-based container or in a Default Container in the first field.

    • Group-Based Project - You must provide a valid UNIX group name in the first field. UNIX group names of those groups that can join the project can be added in the second field. UNIX user names of those users that can join the project can be added in the third field. Separate multiple entries with a comma.

      Do not provide a group name that is being used in another group-based container or in a Default Container in the first field.

    For additional information regarding this project type, see Table 3–2.

  6. Select Later in the Create an Active Container panel.

    All the required information to create the container definition has been supplied.

  7. Review the information in the Summary panel.

    Use the Previous button to move backward through the wizard to make any changes.

  8. Click Finish.

    The container definition is saved in the navigation window in the Containers view. The wizard is dismissed.

To Create a User-Based or Group-Based Active Container
  1. Launch the New Container wizard, as described in To Launch the New Container Wizard.

    The Overview panel appears. Use the Next button to move through the wizard. Use the Previous button to return to any panel in the wizard to make any changes.

  2. Provide a name for the container.

    The name must be unique and not exceed 32 characters. This name will identify the container in the navigation window, status tables, and resource utilization reports. If a duplicate name is entered, the creation of the container definition will fail.

    A container name cannot be changed after the creation procedure is finished.

  3. (Optional) Provide a description for the container.

  4. Select User or Group as the project type for the container.

    A container with a user-based project type tracks processes with the same UNIX user name.

    A container with a group-based project type tracks processes with the same UNIX group name.


    Note –

    In the Solaris 8 OS, only the user-based container type is supported.


  5. Provide project type identifiers according to the following:

    • User-Based Project - You must provide a valid UNIX user name in the first field. UNIX user names of those users that can join the project can be added in the second field. UNIX group names of those groups that can join the project can be added in the third field. Separate multiple entries with a comma.

      Do not provide a user name that is being used in another user-based container or in a Default Container in the first field.

    • Group-Based Project - You must provide a valid UNIX group name in the first field. UNIX group names of those groups that can join the project can be added in the second field. UNIX user names of those users that can join the project can be added in the third field. Separate multiple entries with a comma.

      Do not provide a group name that is being used in another group-based container or Default Container in the first field.

    For additional information regarding this project type, see Table 3–2.

  6. Select Now in the Create an Active Container panel.

  7. Depending upon the entry point from which you launched the wizard, choose from the following actions:

    • If you accessed the wizard from a host name in the navigation window of the Hosts view, the container is automatically associated with that host. Continue with Step 11.

    • If you accessed the wizard from a location other than the host name, you must associate this container with a host. Continue with Step 8.

  8. The container must be associated with a host that supports its resource reservation. Select from the following options:

    • If the name of the desired host is already known, select Enter the Host Name. Type the host name in the text field. Continue with Step 11.

    • To initiate a search for all available hosts that meet the reservation requirements, select Search For a Host. Continue with Step 9.

  9. To begin the search for available hosts, provide the following information.

    Name

    Default is '*' for searching all hosts. If you want to specify a particular host, you can provide the name here.

    Operating System

    Select an operating system from this drop-down menu. Default is ALL.

    Platform

    Select a platform from this drop-down menu. Default is ALL.

    Total Processors

    Provide an integer that specifies the minimum number of processors required. The results returned will be hosts that have an equivalent, or more, number of CPUs.

    Total Physical Memory (MB)

    Provide an integer that specifies the minimum amount of required memory in Mbytes. The results returned will be hosts that have an equivalent, or more, amount of total physical memory.

    Clock Speed

    Provide an integer that specifies the minimum required processor clock speed in MHz. The results returned will be hosts that have at least that clock speed.

    A list is returned of all hosts that meet the search criteria.

  10. Make your selection from the list of the matching hosts.

    The container is now associated with this host.

  11. Assign a resource pool that supports the resource requirements of the container.

    New processes started in a project are bound to the corresponding resource pool. Once the container is activated, the new processes the container is holding are bound to its resource pool.

    • To assign a new resource pool:

      1. Select Create a New Resource Pool.

      2. Provide a name for the resource pool.

        The name must be alphanumeric and contain no spaces. The characters dash (-), underscore (_), and dot (.) are allowed.

      3. Assign the number of CPUs.

        The number of CPUs must be an integer not less than one and cannot exceed the number of CPUs available on the host. The total number of CPUs on the host and the number that are currently available are shown.

    • To assign an existing pool:

      1. Select Use an Existing Resource Pool.

        A list of available resource pools is displayed.

      2. Select the radio button next to the pool's name in the list.

        The total number of CPUs assigned to each resource pool is given, as well as the amount of unreserved CPU still available in each pool. The container is bound to the selected resource pool.

  12. Provide the resource reservations for the container.

    The amount of unreserved CPU and memory resources available on the host is provided.

    The minimum CPU reservation is required, and must be provided in integer or decimal units. Decimal units up to 100th decimal place are accepted. If you provide a value at 1000th decimal place, the value will be treated as zero. For example, a CPU reservation of 0.002 is treated as zero. A container with a CPU reservation of zero receives CPU resources only when no processes are running in any other container that is associated with the same host.

    The memory cap is optional, and must be provided in Mbytes.

  13. Review the information in the Summary panel.

    Use the Previous button to move backward through the wizard to make any changes.

  14. Click Finish.

    The selections are saved, and the container is now active. The Solaris kernel begins enforcing the container's resource reservations.