To Create an Application-Based Project

Steps

1. start the New Project wizard, as described in To Start the New Project Wizard.

   The Overview panel appears.

2. Select Application as the project type for the container.

   The application-based project container tracks processes that are associated with the application. For more information about this project type, see Table 3–2.

3. Provide a name for the project.

   The name must be unique and not exceed 32 characters. This name identifies the project in the navigation window, status tables, and resource utilization reports. If a duplicate name is typed, the creation of the project fails.

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

4. Provide either the UNIX user names or UNIX group names under which the application's processes will run.

   The UNIX user names or UNIX group names under which the application's processes will run must be supplied. If these names are not provided, the corresponding processes will not be moved under the container until they are supplied. Separate multiple entries with a comma.

5. Determine whether you want to move application processes under the project automatically when the container is activated or to move them manually from the command line.

   • To indicate that you want to move application processes manually from the command line, select the check box Do Not Use Match Expression.

   • To move application processes under the project automatically when the project is activated, provide an expression in the Match Expression field.

     You can use wildcards in the Match Expression field to identify the processes that are associated with an application. Examples of match expressions using wildcards are moz, cat that identify the processes associated with Mozilla and Tomcat respectively.

     

     The match expression must be supplied to automatically move the application's processes to the container. This expression is case sensitive. To determine the correct match expression, see To Determine the Match Expression for an Application.

     If a match expression is not provided at this time, the application's processes will not be moved under this container until this expression is supplied.

6. If you access the New Project wizard from the host name (without selecting a pool), assign a resource pool that supports the project's resource requirements.

   New processes that are started in a project are bound to the corresponding resource pool. After the project is activated, the new processes that are held in the container 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.

        To 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 project is bound to the selected resource pool.

7. (Solaris 10 only) Select an existing zone.

   Click the button from one of the available zones.

8. Provide the resource reservations for the project.

   The maximum CPUs, unreserved CPU shares, and memory resources that are available on the host is provided.

   The CPU reservation (CPU shares) is required and must be provided as an integer. A project 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 should be provided in Mbytes.

   The shared memory value is the total amount of shared memory allowed to be used by the processes that run within this project. The shared memory is also optional. The default value of the shared memory is one-quarter of the physical memory.

9. Provide a name for the container.

   The name must be unique and not exceed 32 characters. This name identifies the container in the navigation window, status tables, and resource utilization reports. If a duplicate name is entered, the creation of the container will fail. A container name cannot be changed after the creation procedure is finished.

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

11. Review the information in the Summary panel.

    

12. Click Finish.

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