Each service has its own queue. You must configure the queue for each service using the QConfigurator
tool. When you perform any operation that requires a service to be restarted, the tool adds the request to the service queue. As you perform more operations that require services to be restarted, the queue is updated. When the queue interval reaches the set threshold, the service is restarted for all the queued requests. The QConfigurator tool cuts back on frequent expensive restart operations enhancing service accessibility and ensuring better utilization of system resources. If you disable a service before a queued restart operation, the current queue is flushed and further restart operations for the service are not attempted.
You can force the qsvcd
daemon to review the current service configuration and reset the queues. The restart requests that are queued prior to resetting are retained to be addressed in the next cycle.
Syntax
To view the list of services on the Parallels Pro server, type the following command:
QConfigurator -l
To view help on the various command options you can use, type the following command:
QConfigurator -h
To configure the service queues, type the following command:
QConfigurator -s
<service><command_options>
where:
-s
<service>
is the name of the service for which you want to configure the restart interval. The service names are case-sensitive. To configure queued restart for the apache service, type apache
; to configure queued restart for the mailscanner service, type MailScanner
.
<command_options>
is the option you want to use for configuring the service queues. The following table lists the various options you can use with the command.
Option |
Value |
Description |
---|---|---|
-e |
1 (enabled) or 0 (disabled) |
If set to 1, the service is enabled. If set to 0, the service is disabled. |
-q |
Number |
The restart interval in seconds. The restart interval should range between 300 to 86400 seconds. Values outside this range are invalid. Note: Type 0 to disable queued restart for a service. Once you disable, you must manually restart the service. It may be useful to set the restart interval to 0 when you perform script operations. |
-r |
Text |
The type of restart you want to configure for the service. Each service has its own restart options. Refer to the service help for the restart options you can use. |
-c |
1 (enabled) or 0 (disabled) |
If set to 1, the service is enabled to restart one more time. If set to 0, the restart operation is not repeated. |
-x |
Text |
Restart the operating environment with the specified environment. |
-v |
None |
Shows the current service configuration. It also shows the queue status for the specified service. |
-a |
1 (enabled) or 0 (disabled) |
Autostart starts a service each time the service queue is refreshed and finds that the service is not running. Service restart requests will not be queued if Autostart is enabled. If set to 1, autostart is enabled for the services enabled. If set to 0, the autostart is disabled. |
The following example sets the queue interval for the Apache service to 1000 seconds.
QConfigurator -s apache -q1000