...
----
h1. Defining Projects {anchor:indexterm-567}
{toc:type=list|minLevel=2|maxLevel=3}
h2. About Projects
Projects provide a means to organize joint computational tasks from multiple users. A project also defines resource usage policies for all jobs that belong to such a project.
Projects must be declared before they can be used in any of the three scheduling policy policies. Projects are used in three policy areas:
* Share-based, when shares are assigned to projects -- see [Configuring the Share-Based Policy|Managing Policies#indexterm-720]
* Functional, when projects receive a percentage of the functional tickets -- see [Configuring the Functional Policy|Managing Policies#indexterm-745]
* Override, when an administrator grants override tickets to a project -- see [Configuring the Override Policy|Managing Policies#indexterm754]
Grid Engine system managers define projects by giving them a name and some attributes. Grid Engine users can attach a job to a project when they submit the job. Attachment of a job to a project influences the job's dispatching, depending on the project's share of share-based, functional, or override tickets.
{anchor:i1004054}
h2. How to Define Projects With QMON
Grid Engine system managers can define and update definitions of projects by using the Project Configuration dialog box.
# *To define a project, on the QMON Main Control window, click the Project Configuration button.*
\\
The Project Configuration dialog box appears, as shown below.{anchor:eoxvm} The currently defined projects are displayed in the Projects list. The project definition of a selected project is displayed under Configuration.
!proj.png|alt="Dialog box titled Project Configuration. Shows Projects and Configuration lists. Shows Add, Modify, Delete, Done, and Help buttons."!
\\
\\
# {anchor:indexterm-570} {anchor:indexterm-571} {anchor:indexterm-572} {anchor:indexterm-573} *To add a new project, click Add.*
\\
\\
# *To modify a project, select it, and then click Modify.*
\\
Clicking Add or Modify opens the Add/Modify Project dialog box.
!proj_add.png|alt="Dialog box titled Add/Modify Project. Shows Name, User Lists, and Xuser Lists fields. Shows Ok and Cancel buttons."!
\\
\\
The name of the selected project is displayed in the Name field. The project defines the access lists of users who are permitted access or who are denied access to the project. See [Configuring Users|#indexterm-547] for more information.
\\
\\
The Add/Modify Project dialog box shows the following access lists:
#* The User Lists column shows access lists that contain users who have permission to access the project.
#* The Xuser Lists column shows access lists that contain users who do *not* have permission to access the project.
#* If both lists are empty, all users can access the project. If a user belongs to an access list that is in the User Lists and to an access list that is in the Xuser Lists, the user is denied access to the project.
\\
# {anchor:indexterm-568} {anchor:indexterm-569} *To delete a project immediately, select it, and then click Delete.*
\\
\\
# *To add or remove users from the User Lists or Xuser Lists, click the button at the right of the User Lists or the Xuser Lists.*
\\
The Select Access Lists dialog box, shown in the figure below, appears. Currently defined access lists are displayed under Available Access Lists. Currently selected access lists are displayed under chosen access lists. You can select access lists in either list. You can move access lists from one list to the other by using the red arrows.
!proj_add_acl.png|alt="Dialog box titled Select Access Lists. Shows Available Access Lists and Chosen Access Lists. Shows Ok, Cancel, and Help buttons."!
\\
\\
# *Click OK to save your changes and close the dialog box.*
\\
Click Cancel to close the dialog box without saving your changes.
h2. Defining Projects From the Command Line {anchor:i1004058}
To define projects from the command line, type the following command with appropriate options:
{code}
# qconf <options>
{code}
The following options are available:
* {anchor:indexterm-574} {anchor:indexterm-575} {{qconf -aprj}} -- The {{-aprj}} option (add project) opens a template project configuration in an editor. See the {{project}}(5) man page. The editor is either the default {{vi}} editor or the editor specified by the {{EDITOR}} environment variable. After you save your changes and exit the editor, the changes are registered with {{sge_qmaster}}.
* {anchor:indexterm-576} {anchor:indexterm-577} {{qconf -Aprj}} _filename_ -- The {{-Aprj}} option (add project from file) parses the specified file and adds the new project configuration. The file must have the format of the project configuration template.
* {anchor:indexterm-578} {anchor:indexterm-579} {{qconf -dprj}} _project-name_ -- The {{-dprj}} option (delete project) deletes one or more projects.
* {anchor:indexterm-580} {anchor:indexterm-581} {{qconf -mprj}} _project-name_ -- The {{-mprj}} option (modify project) enables you to modify an existing user entry. The option loads the project configuration in an editor. The editor is either the default {{vi}} editor or the editor specified by the {{EDITOR}} environment variable. After you save your changes and exit the editor, the changes are registered with {{sge_qmaster}}.
* {anchor:indexterm-582} {anchor:indexterm-583} {{qconf -Mprj}} _filename_ -- The {{-Mprj}} option (modify project from file) parses the specified file and modifies the existing project configuration. The file must have the format of the project configuration template.
* {anchor:indexterm-584} {anchor:indexterm-585} {{qconf -sprj}} _project-name_ -- The {{-sprj}} option (show project) displays the configuration of a particular project.
* {anchor:indexterm-586} {anchor:indexterm-587} {{qconf -sprjl}} -- The {{-sprjl}} option (show project list) displays a list of all currently defined projects.
----
{column}
{section}
|