--- name: "qconf" section: "1" platform: "linux" package: "gridengine-client" version: "8.1.9+dfsg-13.1" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/qconf" --- # qconf(1) Grid Engine Queue Configuration ## NAME qconf - Grid Engine Queue Configuration ## SYNTAX **qconf options** ## DESCRIPTION *Qconf* allows the system administrator to add, delete, and modify the current Grid Engine configuration, including queue management, host management, complex management and user management. *Qconf* also allows you to examine the current queue configuration for existing queues. *Qconf* allows the use of the backslash, '\\', character at the end of a line to indicate that the next line is a continuation of the current line. When displaying settings, such as the output of one of the **-s***\** options, *qconf* will break up long lines (lines greater than 80 characters) into smaller lines using backslash line continuation where possible. Lines will only be broken up at commas or whitespace. This feature can be disabled by setting the SGE\_SINGLE\_LINE environment variable. ## OPTIONS Unless denoted otherwise, the following options and the corresponding operations are available to all users with a valid account. - **-Aattr** *obj\_spec* *fname* *obj\_instance*,... *\*\ Similar to **-aattr** (see below) but takes specifications for the object attributes to be enhanced from file named *fname*. As opposed to **-aattr**, multiple attributes can be enhanced. Their specification has to be listed in *fname* following the file format of the corresponding object (see *queue\_conf*(5) for the queue, for example).\ Requires root or manager privileges. - **-Acal** *fname* *\* Adds a new calendar definition to the Grid Engine environment. Calendars are used in Grid Engine for defining availability and unavailability schedules of queues. The format of a calendar definition is described in *calendar\_conf*(5). The calendar definition is taken from the file *fname*. Requires root or manager privileges. - **-Ackpt** *fname* *\* Add the checkpointing environment as defined in *fname* (see *checkpoint*(5)) to the list of supported checkpointing environments. Requires root or manager privileges. - **-Aconf** *fname\_list* *\* Add the configurations (see [*sge\_conf*(5)](/sge_conf/5.md)) specified in the files in the comma-separated *fname\_list*. The configuration is added for the host that is identical to the file name.\ Requires root or manager privileges. - **-Ae** *fname* *\* Add the execution host defined in *fname* to the Grid Engine cluster. The format of the execution host specification is described in *host\_conf*(5). Requires root or manager privileges. - **-Ahgrp** *fname* *\* Add the host group configuration defined in *file*. The file format of *fname* must comply with the format specified in *hostgroup*(5). Requires root or manager privileges. - **-Arqs** *fname* *\* Add the resource quota set (RQS) defined in the file named *fname* to the Grid Engine cluster. Requires root or manager privileges. - **-Ap** *fname* *\* Add the parallel environment (PE) defined in *fname* to the Grid Engine cluster. Requires root or manager privileges. - **-Aprj** *fname* *\* Adds the project description defined in **fname** to the list of registered projects (see *project*(5)). Requires root or manager privileges. - **-Aq** *fname* *\* Add the queue defined in *fname* to the Grid Engine cluster. Requires root or manager privileges. - **-Au** *fname* *\* Add the user access list (ACL) defined in file **fname** to Grid Engine. User lists are used for queue usage authentication. Requires root, manager, or operator privileges. The file format of *fname* must comply with the format specified in *access\_list*(5). - **-Dattr** *obj\_spec* *fname* *obj\_instance*,... *\*\ Similar to **-dattr** (see below) but the definition of the list attributes from which entries are to be deleted is contained in the file named *fname*. As opposed to **-dattr**, multiple attributes can be modified. Their specification has to be listed in *fname* following the file format of the corresponding object (see *queue\_conf*(5) for the queue, for example).\ Requires root or manager privileges. - **-Mattr** *obj\_spec fname obj\_instance,...* *\*\ Similar to **-mattr** (see below) but takes specifications for the object attributes to be modified from file named *fname*. As opposed to **-mattr**, multiple attributes can be modified. Their specification has to be listed in *fname* following the file format of the corresponding object (see *queue\_conf*(5) for the queue, for example).\ Requires root or manager privileges. - **-Mc** *fname* *\* Overwrites the complex configuration with the contents of *fname*. The argument file must comply with the format specified in [*complex*(5)](/complex/5.md). Requires root or manager privileges. - **-Mcal** *fname* *\* Overwrites the calendar definition as specified in *fname*. The argument file must comply with the format described in *calendar\_conf*(5). Requires root or manager privileges. - **-Mckpt** *fname* *\* Overwrite an existing checkpointing environment with the definitions in *fname* (see *checkpoint*(5)). The name attribute in *fname* has to match an existing checkpointing environment. Requires root or manager privileges. - **-Mconf** *fname\_list* *\* Modify the configurations (see [*sge\_conf*(5)](/sge_conf/5.md)) specified in the files in the comma-separated *fname\_list*. The configuration is modified for the host that is identical to the file name.\ Requires root or manager privileges. - **-Me** *fname* *\* Overwrites the execution host configuration for the specified host with the contents of *fname*, which must comply with the format defined in *host\_conf*(5). Requires root or manager privilege. - **-Mhgrp** *fname* *\* Allows changing the host group configuration with a single command. All host group configuration entries contained in **fname** will be applied. Configuration entries not contained in **fname** will be deleted. The file format of *fname* must comply to the format specified in *hostgroup*(5). Requires root or manager privileges. - **-Mrqs** *fname \[mrqs\_name\]* *\* Same as **-mrqs** (see below) but instead of invoking an editor to modify the RQS configuration, the file *fname* is considered to contain a changed configuration. The name of the rule set in *fname* must be the same as **rqs\_name**. If **rqs\_name** is not set, all rule sets are overwritten by the rule sets in *fname* Refer to [*sge\_resource\_quota*(5)](/sge_resource_quota/5.md) for details on the RQS configuration format. Requires root or manager privileges. - **-Mp** *fname* *\* Same as **-mp** (see below) but instead of invoking an editor to modify the PE configuration the file *fname* is considered to contain a changed configuration. Refer to [*sge\_pe*(5)](/sge_pe/5.md) for details on the PE configuration format. Requires root or manager privilege. - **-Mprj** *fname* *\* Same as **-mprj** (see below) but instead of invoking an editor to modify the project configuration the file *fname* is considered to contain a changed configuration. Refer to *project*(5) for details on the project configuration format. Requires root or manager privilege. - **-Mq** *fname* *\* Same as **-mq** (see below) but instead of invoking an editor to modify the queue configuration the file *fname* is considered to contain a changed configuration. Refer to *queue\_conf*(5) for details on the queue configuration format. Requires root or manager privilege. - **-Msconf** *fname* *\* The current scheduler configuration (see *sched\_conf*(5)) is overridden with the configuration specified in the file. Requires root or manager privilege. - **-Mstree** *fname* *\* Modifies the definition of the share tree (see *share\_tree*(5)). The modified sharetree is read from file *fname*. Requires root or manager privileges. - **-Mu** *fname* *\* Takes the user access list (ACL) defined in *fname* to overwrite any existing ACL with the same name. See *access\_list*(5) for information on the ACL configuration format. Requires root or manager privilege. - **-Muser** *fname* *\* Modify the user defined in *fname* in the Grid Engine cluster. The format of the user specification is described in *user*(5). Requires root or manager privileges. - **-Rattr** *obj\_spec* *fname* *obj\_instance,...* *\*\ Similar to **-rattr** (see below) but the definition of the list attributes whose content is to be replaced is contained in the file named *fname*. As opposed to **-rattr**, multiple attributes can be modified. Their specification has to be listed in *fname* following the file format of the corresponding object (see *queue\_conf*(5) for the queue, for example).\ Requires root/manager privileges. - **-aattr** *obj\_spec* *attr\_name* *val* *obj\_instance*,... *\*\ Allows adding specifications to a single configuration list attribute in multiple instances of an object with a single command. Currently supported object types are queues, hosts, host groups, parallel environments, resource quota sets, users, projects, calendars, and checkpointing interface configurations, specified respectively as **queue**, **exechost**, **hostgroup**, **pe**, **resource\_quota**, **user**, **project**, **calender**, **userset**, or **ckpt** in *obj\_spec*. For the *obj\_spec* **queue** the *obj\_instance* can be a cluster queue name, a queue domain name or a queue instance name. Find more information concerning different queue names in [*sge\_types*(5)](/sge_types/5.md). Depending on the type of the *obj\_instance*, this adds to the cluster queues attribute sublist the cluster queue's implicit default configuration value or the queue domain configuration value or queue instance configuration value. The queue **load\_thresholds** parameter is an example of a list attribute. With the **-aattr** option, entries can be added to such lists, while they can be deleted with **-dattr**, modified with **-mattr**, and replaced with **-rattr**.\ For the *obj\_spec* *rqs* the *obj\_instance* is a unique identifier for a specific rule. The identifier consists of a rule-set name and either the number of the rule in the list, or the name of the rule, separated by a "/".\ The name of the configuration attribute to be enhanced is specified with *attr\_name* followed by *val* as a *name*=*value* pair. The space-separated list of object instances (e.g., the list of queues) to which the changes have to be applied are specified at the end of the command.\ The following restriction applies: For the *exechost* object the **load\_values** attribute cannot be modified (see *host\_conf*(5)).\ Requires root or manager privileges. - **-acal** *calendar\_name* *\* Adds a new calendar definition to the Grid Engine environment. Calendars are used in Grid Engine for defining availability and unavailability schedules of queues. The format of a calendar definition is described in *calendar\_conf*(5). With the calendar name given in the option argument, *qconf* will open a temporary file and start up the text editor indicated by the environment variable EDITOR (default [*vi*(1)](/vi/1.md) if EDITOR is not set). After entering the calendar definition and closing the editor the new calendar is checked and registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). Requires root/manager privileges. - **-ackpt** *ckpt\_name* *\* Adds a checkpointing environment under the name **ckpt\_name** to the list of checkpointing environments maintained by Grid Engine and to be usable to submit checkpointing jobs (see *checkpoint*(5) for details on the format of a checkpointing environment definition). *Qconf* retrieves a default checkpointing environment configuration and executes [*vi*(1)](/vi/1.md) (or $EDITOR if the EDITOR environment variable is set) to allow you to customize the checkpointing environment configuration. Upon exit from the editor, the checkpointing environment is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). Requires root/manager privileges. - **-aconf** *host*,... *\* Successively adds configurations (see [*sge\_conf*(5)](/sge_conf/5.md)) For the hosts in the comma-separated host list. For each host, an editor ($EDITOR, if defined, or [*vi*(1)](/vi/1.md)) is invoked and the configuration for the host can be entered. The configuration is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md) after saving the file and quitting the editor.\ Requires root or manager privileges. - **-ae** \[*host\_template*\] *\* Adds a host to the list of Grid Engine execution hosts. If a queue is configured on a host this host is automatically added to the Grid Engine execution host list. Adding execution hosts explicitly offers the advantage to be able to specify parameters like load scale values with the registration of the execution host. However, these parameters can be modified (from their defaults) at any later time via the **-me** option described below.\ If the *host\_template* argument is present, *qconf* retrieves the configuration of the specified execution host from [*sge\_qmaster*(8)](/sge_qmaster/8.md) or a generic template otherwise. The template is then stored in a file and *qconf* executes [*vi*(1)](/vi/1.md) (or the editor indicated by $EDITOR if the EDITOR environment variable is set) to change the entries in the file. The format of the execution host specification is described in *host\_conf*(5). When the changes are saved in the editor and the editor is quit the new execution host is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). Requires root/manager privileges. - **-ah** *hostname,...* *\* Adds hosts *hostname* to the Grid Engine trusted host list (a host must be in this list to execute administrative Grid Engine commands, the sole exception to this being the execution of *qconf* on the [*sge\_qmaster*(8)](/sge_qmaster/8.md) node). The default Grid Engine installation procedures usually add all designated execution hosts (see the **-ae** option above) to the Grid Engine trusted host list automatically. Requires root or manager privileges. - **-ahgrp** *group* *\* Adds a new host group with the name specified in *group*. This command invokes an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable). The new host group entry is registered after changing the entry and exiting the editor. Requires root or manager privileges. - **-arqs** \[*rqs\_name*\] *\* Adds one or more *Resource Quota Set* (RQS) description under the names *rqs\_name* to the list of RQSs maintained by Grid Engine. (See [*sge\_resource\_quota*(5)](/sge_resource_quota/5.md) for details on the format of an RQS definition.) *Qconf* retrieves a default RQS configuration and executes [*vi*(1)](/vi/1.md) (or $EDITOR if the EDITOR environment variable is set) to allow you to customize the RQS configuration. Upon exit from the editor, the RQS is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). Requires root or manager privileges. - **-am** *user*,... *\* Adds the indicated users to the Grid Engine manager list. Requires root or manager privileges.\ Managers have full access to the Grid Engine configuration and operational features. Superusers on administration hosts have manager privileges by default. - **-ao** *user*,... *\* Adds the indicated users to the Grid Engine operator list. Requires root or manager privileges.\ Operators have the same privileges as managers except that they cannot make configuration changes. - **-ap** *pe\_name* *\* Adds a *Parallel Environment* (PE) description under the name **pe\_name** to the list of PEs maintained by Grid Engine and to be usable to submit parallel jobs (see [*sge\_pe*(5)](/sge_pe/5.md) for details on the format of a PE definition). *Qconf* retrieves a default PE configuration and executes [*vi*(1)](/vi/1.md) (or $EDITOR if the EDITOR environment variable is set) to allow you to customize the PE configuration. Upon exit from the editor, the PE is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). Requires root/manager privileges. - **-at** *thread\_name* *\* Activates an additional thread in the master process. *thread\_name* can be either "scheduler" or "jvm". The corresponding thread is only started when it is not already running. There may be only one scheduler and only one JVM thread in the master process at the same time. - **-aprj** *\* Adds a project description to the list of registered projects (see *project*(5)). *Qconf* retrieves a template project configuration and executes [*vi*(1)](/vi/1.md) (or $EDITOR if the EDITOR environment variable is set) to allow you to customize the new project. Upon exit from the editor, the template is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). Requires root or manager privileges. - **-aq** \[*queue\_name*\] *\* *Qconf* retrieves the default queue configuration (see *queue\_conf*(5)) and executes [*vi*(1)](/vi/1.md) (or $EDITOR if the EDITOR environment variable is set) to allow you to customize the queue configuration. Upon exit from the editor, the queue is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). A minimal configuration requires only that the queue name and queue hostlist be set. Requires root or manager privileges. - **-as** *hostname*,... *\* Add hosts **hostname** to the list of hosts allowed to submit Grid Engine jobs and control their behavior only. Requires root or manager privileges. - **-astnode** *node\_path***=***shares*,... *\* Adds the specified share tree node(s) to the share tree (see *share\_tree*(5)). The *node\_path* is a hierarchical path (\[**/**\]*node\_name*\[\[**/.**\]*node\_name*...\]) specifying the location of the new node in the share tree. The base name of the node\_path is the name of the new node. The node is initialized to the number of specified shares. Requires root or manager privileges. - **-astree** *\* Adds the definition of a share tree to the system (see *share\_tree*(5)). A template share tree is retrieved and an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by $EDITOR) is invoked for modifying the share tree definition. Upon exiting the editor, the modification is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). Requires root or manager privileges. - **-Astree** *fname* *\* Adds the definition of a share tree to the system (see *share\_tree*(5)) from the file *fname*. Requires root or manager privileges. - **-au** *user*,... *acl\_name*,... *\* Adds users to Grid Engine user access lists (ACLs). User lists are used for queue usage authentication. Requires root/manager/operator privileges.\ Users can submit jobs and run them if they have access to a submit host and and execution host, but cannot affect the Grid Engine configuration or operation (other than altering or deleting their own jobs). - **-Auser** *fname* *\* Add the user defined in *fname* to the Grid Engine cluster. The format of the user specification is described in *user*(5). Requires root or manager privileges. - **-auser** *\* Adds a user to the list of registered users (see *user*(5)). This command invokes an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) for a template user. The new user is registered after changing the entry and exiting the editor. Requires root or manager privileges. - **-bonsai** *\* Shows a textual tree layout of the share tree analogous to the graphical view in [*qmon*(1)](/qmon/1.md). **-sstree** shows the same information in a less-readable (linearized) form. - **-clearusage** \[*user\_list*\] *\* Clears usage from the sharetree, either just for *user\_list* or for all users and projects if *user\_list* isn't supplied. All specified usage will be set to zero. - **-cq** *wc\_queue\_list* *\* Cleans queue of jobs which haven't been reaped. (Actually purges jobs remaining on the queue.) Primarily a development tool. Requires root/manager/operator privileges. Find a description of *wc\_queue\_list* in [*sge\_types*(5)](/sge_types/5.md). - **-dattr** *obj\_spec* *attr\_name* *val* *obj\_instance*,... *\*\ Allows deleting specifications in a single configuration list attribute in multiple instances of an object with a single command. Find more information concerning *obj\_spec* and *obj\_instance* in the description of **-aattr**. - **-dcal** *calendar\_name*,... *\* Deletes the specified calendar definition from Grid Engine. Requires root/manager privileges. - **-dckpt** *ckpt\_name* *\* Deletes the specified checkpointing environment. Requires root/manager privileges. - **-dconf** *host*,... *\* The local configuration entries for the specified hosts are deleted from the configuration list. Requires root or manager privilege. - **-de** *host\_name*,... *\* Deletes hosts from the Grid Engine execution host list. Requires root or manager privileges. - **-dh** *host\_name*,... *\* Deletes hosts from the Grid Engine trusted host list. The host on which [*sge\_qmaster*(8)](/sge_qmaster/8.md) is currently running cannot be removed from the list of administrative hosts. Requires root or manager privileges. - **-dhgrp** *group* *\* Deletes host group configuration with the name specified in **group.** Requires root or manager privileges. - **-drqs** *rqs\_name\_list* *\* Deletes the specified resource quota sets (RQS). Requires root or manager privileges. - **-dm** *user*\[,*user*,...\] *\* Deletes managers from the manager list. Requires root or manager privileges. It is not possible to delete the admin user or the user root from the manager list. - **-do** *user*\[,*user*,...\] *\* Deletes operators from the operator list. Requires root or manager privileges. It is not possible to delete the admin user or the user root from the operator list. - **-dp** *pe\_name* *\* Deletes the specified parallel environment (PE). Requires root or manager privileges. - **-dprj** *project*,... *\* Deletes the specified project(s). Requires root/manager privileges. - **-dq** *queue\_name*,... *\* Removes the specified queue(s), which must be empty. Requires root or manager privileges. - **-ds** *host\_name*,... *\* Deletes hosts from the Grid Engine submit host list. Requires root or manager privileges. - **-dstnode** *node\_path*,... *\* Deletes the specified share tree node(s). The *node\_path* is a hierarchical path (\[**/***\]node\_name*\[\[**/.***\]node\_name*...\]) specifying the location of the node to be deleted in the share tree. Requires root or manager privileges. - **-dstree** *\* Deletes the current share tree. Requires root or manager privileges. - **-du** *user*,... *acl\_name*,... *\* Deletes one or more users from one or more Grid Engine user access lists (ACLs). Requires root/manager/operator privileges. - **-dul** *acl\_name*,... *\* Deletes one or more user lists from the system. Requires root/manager/operator privileges. - **-duser** *user*,... *\* Deletes the specified user(s) from the list of registered users. Requires root or manager privileges. - **-help** Prints a listing of all options. - **-k**{**m**\|**s**\|**e**\[**j**\] {*host*,...\|**all**}} *\* **Note:** The **-ks** switch is deprecated and may be removed in future release. Please use the **-kt** switch instead.\ Used to shutdown Grid Engine components (daemons). In the form **-km** [*sge\_qmaster*(8)](/sge_qmaster/8.md) is forced to terminate in a controlled fashion. In the same way the **-ks** switch causes termination of the scheduler thread. Shutdown of running [*sge\_execd*(8)](/sge_execd/8.md) processes currently registered is initiated by the **-ke** option. If **-kej** is specified instead, all jobs running on the execution hosts are aborted prior to termination of the corresponding [*sge\_execd*(8)](/sge_execd/8.md). The comma-separated host list specifies the execution hosts to be addressed by the **-ke** and **-kej** option. If the keyword **all** is specified instead of a host list, all running [*sge\_execd*(8)](/sge_execd/8.md) processes are shutdown. Job abortion, initiated by the **-kej** option will result in **dr** state for all running jobs until [*sge\_execd*(8)](/sge_execd/8.md) is running again.\ Requires root or manager privileges. - **-kt** *thread\_name* *\* Terminates a thread in the master process. Currently it is only supported to shutdown the "scheduler" and the "jvm" thread. The command will only be successful if the corresponding thread is running. - **-kec** {*id*,...\|**all**} *\* Used to shutdown event clients registered at [*sge\_qmaster*(8)](/sge_qmaster/8.md). The comma-separated event client list specifies the event clients to be addressed by the **-kec** option. If the keyword **all** is specified instead of an event client list, all running event clients except special clients like the scheduler thread are terminated. Requires root or manager privilege. - **-mattr** *obj\_spec* *attr\_name* *val* *obj\_instance*,... *\*\ Allows changing a single configuration attribute in multiple instances of an object with a single command. Find more information concerning *obj\_spec* and *obj\_instance* in the description of **-aattr**. - **-mc** *\* The complex configuration (see [*complex*(5)](/complex/5.md)) is retrieved, an editor is executed (either [*vi*(1)](/vi/1.md) or the editor indicated by $EDITOR) and the changed complex configuration is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md) upon exit of the editor. Requires root or manager privilege. - **-mcal** *calendar\_name* *\* The specified calendar definition (see *calendar\_conf*(5)) is retrieved, an editor is executed (either [*vi*(1)](/vi/1.md) or the editor indicated by $EDITOR) and the changed calendar definition is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md) upon exit of the editor. Requires root or manager privilege. - **-mckpt** *ckpt\_name* *\* Retrieves the current configuration for the specified checkpointing environment, executes an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) and registers the new configuration with the [*sge\_qmaster*(8)](/sge_qmaster/8.md). Refer to *checkpoint*(5) for details on the checkpointing environment configuration format. Requires root or manager privilege. - **-mconf** \[*host*,...\|**global**\] *\* The configuration for the specified host is retrieved, an editor is executed (either [*vi*(1)](/vi/1.md) or the editor indicated by $EDITOR) and the changed configuration is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md) upon exit of the editor. If the optional *host* argument is omitted, or if the special host name **global** is specified, the global configuration is modified. The format of the configuration is described in [*sge\_conf*(5)](/sge_conf/5.md).\ Requires root or manager privilege. - **-me** *hostname* *\* Retrieves the current configuration for the specified execution host, executes an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) and registers the changed configuration with [*sge\_qmaster*(8)](/sge_qmaster/8.md) upon exit from the editor. The format of the execution host configuration is described in *host\_conf*(5). Requires root or manager privilege. - **-mhgrp** *group* *\* The host group entries for the host group specified in **group** are retrieved and an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) is invoked for modifying the host group configuration. By closing the editor, the modification is registered. The format of the host group configuration is described in *hostgroup*(5). Requires root or manager privileges. - **-mrqs** \[*rqs\_name*\] *\* Retrieves the resource quota set (RQS)configuration defined in *rqs\_name*, or if *rqs\_name* is not given, retrieves all resource quota sets, executes an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) and registers the new configuration with the [*sge\_qmaster*(8)](/sge_qmaster/8.md). Refer to [*sge\_resource\_quota*(5)](/sge_resource_quota/5.md) for details on the RQS configuration format. Requires root or manager privilege. - **-mp** *pe\_name* *\* Retrieves the current configuration for the specified *parallel environment* (PE), executes an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) and registers the new configuration with the [*sge\_qmaster*(8)](/sge_qmaster/8.md). Refer to [*sge\_pe*(5)](/sge_pe/5.md) for details on the PE configuration format. Requires root or manager privilege. - **-mprj** *project* *\* Data for the specific project is retrieved (see *project*(5)) and an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by $EDITOR) is invoked for modifying the project definition. Upon exiting the editor, the modification is registered. Requires root or manager privileges. - **-mq** *queuename* *\* Retrieves the current configuration for the specified queue, executes an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) and registers the new configuration with the [*sge\_qmaster*(8)](/sge_qmaster/8.md). Refer to *queue\_conf*(5) for details on the queue configuration format. Requires root or manager privilege. - **-msconf** *\* The current scheduler configuration (see *sched\_conf*(5)) is retrieved, an editor is executed (either [*vi*(1)](/vi/1.md) or the editor indicated by $EDITOR) and the changed configuration is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md) upon exit of the editor. Requires root or manager privilege. - **-mstnode** *node\_path***=***shares*,... *\* Modifies the specified share tree node(s) in the share tree (see *share\_tree*(5)). The *node\_path* is a hierarchical path (*\[fB/*\]*node\_name*\[\[**/.**\]*node\_name*...\]) specifying the location of an existing node in the share tree. The node is set to the number of specified *shares*. Requires root or manager privileges. - **-mstree** *\* Modifies the definition of the share tree (see *share\_tree*(5)). The present share tree is retrieved and an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by $EDITOR) is invoked for modifying the share tree definition. Upon exiting the editor, the modification is registered with [*sge\_qmaster*(8)](/sge_qmaster/8.md). Requires root or manager privileges. - **-mu** *acl\_name* *\* Retrieves the current configuration for the specified user access list, executes an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) and registers the new configuration with the [*sge\_qmaster*(8)](/sge_qmaster/8.md). The format of the configuration must comply with the format specified in *access\_list*(5). Requires root or manager privilege. - **-muser** *user* *\* Data for the specific user is retrieved (see *user*(5)) and an editor (either [*vi*(1)](/vi/1.md) or the editor indicated by the EDITOR environment variable) is invoked for modifying the user definition. Upon exiting the editor, the modification is registered. Requires root or manager privileges. - **-purge** *queue* *attr\_nm*,... *obj\_spec* *\*\ Delete the values of the attributes defined in *attr\_nm* from the object defined in *obj\_spec*. *obj\_spec* can be "queue\_instance" or "queue\_domain". The names of the attributes are described in *queue\_conf*(5).\ This operation only works on a single queue instance or domain. It cannot be used on a cluster queue. In the case where the *obj\_spec* is "queue@@hostgroup", the attribute values defined in *attr\_nm* which are set for the indicated hostgroup are deleted, but not those which are set for the hosts contained by that hostgroup. If the *attr\_nm* is '**\***', all attribute values set for the given queue instance or domain are deleted.\ The main difference between **-dattr** and **-purge** is that **-dattr** removes a value from a single list attribute, whereas **-purge** removes one or more overriding attribute settings from a cluster queue configuration. With **-purge**, the entire attribute is deleted for the given queue instance or queue domain. - **-rattr** *obj\_spec* *attr\_name* *val* *obj\_instance*,... *\*\ Allows replacing a single configuration list attribute in multiple instances of an object with a single command. Find more information concerning *obj\_spec* and *obj\_instance* in the description of **-aattr**.\ Requires root or manager privilege. - **-rsstnode** *node\_path*,... *\* Recursively shows the name and shares of the specified share tree node(s) and the names and shares of its child nodes (not showing leaves). See *share\_tree*(5).) The *node\_path* is a hierarchical path (\[**/**\]*node\_name*\[{**/**\|**.**}*node\_name*...\]) specifying the location of a node in the share tree. - **-sc** *\* Display the complex configuration. - **-scal** *calendar\_name* *\* Display the configuration of the specified calendar. - **-scall** *\* Show a list of all calendars currently defined. - **-sckpt** *ckpt\_name* *\* Display the configuration of the specified checkpointing environment. - **-sckptl** *\* Show a list of the names of all checkpointing environments currently configured. - **-sconf** \[*host*,...\|**global**\] *\* Print the global or local (host specific) configuration. If the optional comma-separated host list argument is omitted, or the special string **global** is given, the global configuration is displayed. The configuration in effect on a certain host is the merger of the global configuration and the host specific local configuration. The format of the configuration is described in [*sge\_conf*(5)](/sge_conf/5.md). - **-sconfl** *\* Display a list of hosts for which configurations are available. The special host name **global** refers to the global configuration. - **-sds** *\* Displays detached settings in the cluster configuration (see *queue\_conf*(5)). - **-se** *hostname* *\* Displays the definition of the specified execution host. - **-sel** *\* Displays the Grid Engine execution host list. - **-secl** *\* Displays the Grid Engine event client list. - **-sh** *\* Displays the Grid Engine administrative host list. - **-shgrp** *group* *\* Displays the host group entries for the group specified in *group*. - **-shgrpl** *\* Displays a name list of all currently defined host groups which have a valid host group configuration. - **-shgrp\_tree** *group* *\* Shows a tree like structure of the host group. - **-shgrp\_resolved** *group* *\* Shows a list of all hosts which are part of the definition of host group. If the host group definition contains sub host groups than also these groups are resolved and the hostnames are printed. - **-srqs** \[*rqs\_name\_list*\] *\* Show the definition of the resource quota sets (RQS) specified by the argument. - **-srqsl** *\* Show a list of all currently defined resource quota sets (RQSs). - **-sm** *\* Displays the managers list. - **-so** *\* Displays the operator list. - **-sobjl** *obj\_spec* *attr\_name* *val* *\* Shows a list of all configuration objects for which *val* matches at least one configuration value of the attributes whose name matches *attr\_name*. *obj\_spec* can be "queue" or "queue\_domain" or "queue\_instance" or "exechost". Note: When "queue\_domain" or "queue\_instance" is specified as *obj\_spec*, matching is only done with the attribute overridings concerning the host group or the execution host. In this case queue domain names resp. queue instances are returned. *attr\_name* can be any of the configuration file keywords listed in *queue\_conf*(5) or *host\_conf*(5). Also wildcards can be used to match multiple attributes. *val* can be an arbitrary string or a wildcard expression. - **-sp** *pe\_name* *\* Show the definition of the *parallel environment* (PE) specified by the argument. - **-spl** *\* Show a list of all currently defined parallel environments (PEs). - **-sprj** *project* *\* Shows the definition of the specified project (see *project*(5)). - **-sprjl** *\* Shows the list of all currently defined projects. - **-sq** *wc\_queue\_list* \ Displays one or multiple cluster queues or queue instances. A description of *wc\_queue\_list* can be found in [*sge\_types*(5)](/sge_types/5.md). - **-sql** *\* Show a list of all currently defined cluster queues. - **-ss** *\* Displays the Grid Engine submit host list. - **-ssconf** *\* Displays the current scheduler configuration in the format explained in *sched\_conf*(5). - **-sstnode** *node\_path,...* *\* Shows the name and shares of the specified share tree node(s) (see *share\_tree*(5)). The *node\_path* is a hierarchical path (\[**/**\]*node\_name*\[{**/**\|**.**}*node\_name*...\]) specifying the location of a node in the share tree. - **-sstree** *\* Shows the definition of the share tree (see *share\_tree*(5)). A different view is provided by **-bonsai**. - **-sst** *\* Shows the definition of the share tree in a tree view (see *share\_tree*(5)). - **-sss** *\* Currently displays the host on which the Grid Engine scheduler is active or an error message if no scheduler is running. - **-su** *acl\_name* *\* Displays a Grid Engine user access list (ACL). - **-sul** *\* Displays a list of names of all currently defined Grid Engine user access lists (ACLs). - **-suser** *user*,... *\* Shows the definition of the specified user(s) (see *user*(5)). - **-suserl** *\* Shows the list of all currently defined users. - **-tsm** *\* The Grid Engine scheduler is forced by this option to print trace messages of its next scheduling run to the file *\/\/common/schedd\_runlog*. The messages indicate the reasons for jobs and queues not being selected in that run. Requires root or manager privileges. Note, that the reasons for job requirements being invalid with respect to resource availability of queues are displayed using the format as described for the [*qstat*(1)](/qstat/1.md) **-F** option (see description of **Full Format** in section **OUTPUT FORMATS** of the [*qstat*(1)](/qstat/1.md) manual page. ## ENVIRONMENT VARIABLES - **SGE\_ROOT** Specifies the location of the Grid Engine standard configuration files. - **SGE\_CELL** If set, specifies the default Grid Engine cell. To address a Grid Engine cell *qconf* uses (in the order of precedence): The name of the cell specified in the environment variable SGE\_CELL, if it is set. The name of the default cell, i.e. **default**. - **SGE\_DEBUG\_LEVEL** If set, specifies that debug information should be written to stderr. In addition the level of detail in which debug information is generated is defined. - **SGE\_QMASTER\_PORT** If set, specifies the tcp port on which [*sge\_qmaster*(8)](/sge_qmaster/8.md) is expected to listen for communication requests. Most installations will use a services map entry instead to define that port. - **SGE\_EXECD\_PORT** If set, specifies the tcp port on which [*sge\_execd*(8)](/sge_execd/8.md) is expected to listen for communication requests. Most installations will use a services map entry instead to define that port. - **SGE\_SINGLE\_LINE** If set, indicates that long lines should not be broken up using backslashes. This setting is useful for scripts which expect one entry per line. ## RESTRICTIONS Modifications to a queue configuration do not affect an active queue, taking effect on next invocation of the queue (i.e., the next job). ## FILES ``` //common/act_qmaster Grid Engine master host file ``` ## SEE ALSO [*sge\_intro*(1)](/sge_intro/1.md), *access\_list*(5), *checkpoint*(5), [*complex*(5)](/complex/5.md), *host\_conf*(5), *project*(5), [*qstat*(1)](/qstat/1.md), *queue\_conf*(5), [*sge\_conf*(5)](/sge_conf/5.md), [*sge\_execd*(8)](/sge_execd/8.md), [*sge\_pe*(5)](/sge_pe/5.md), [*sge\_qmaster*(8)](/sge_qmaster/8.md), [*sge\_resource\_quota*(5)](/sge_resource_quota/5.md) ## COPYRIGHT See [*sge\_intro*(1)](/sge_intro/1.md) for a full statement of rights and permissions.