Queue Selection
A queue is a cluster, a group or farm of machines. Accelerator supports multiple queues that are managed by the same vovserver. Queue names begin with the letters vnc.
Start a Queue
The command to start a queue is ncmgr start [queue-name]. Entering a queue name is optional. By default, if no name is entered, the queue will be named vnc.
ncmgr start
vncmgr: Usage Message
USAGE:
% ncmgr start [options]
OPTIONS:
-h This help.
-force Do not ask confirmation.
-block Do not return to the shell or command prompt
after starting. This is only useful, and
required, when starting Accelerator as a
Windows service.
-port <port|mode> Specify port number, port number list (colon
separated) or port mode. Modes are:
automatic - hash queue name into port number,
do not start if port is
unavailable. The default queue
name 'vnc' hashes to port
6271.
any - hash queue name into port number, try
additional ports in increments of 1
until an available one is found. The
default queue name 'vnc' hashes to
beginning port 11437.
Default: any
-eventport <port[:port]> Colon separated update port list wherein each
element may be of the form:
N - An integer specifying the exact
port number to use.
automatic - Calculates hash of project name
to derive a single port number.
any - Calculates hash of project name
to derive starting port number.
Ports are checked sequentially
up to 30000.
Event port will be non-functional if there is a
conflict with specified ports (default 5559).
-webport <port|mode> Specify a dedicated web interface port for
HTTP and HTTPS protocols. This port must be
configured to enable REST API v3 interface,
to enable the dashboard web UI page,
and to enable SSL. A value of 0 directs
VovServer not to open a web interface port.
Specify port number, port number list (colon
separated) or port mode. Modes are:
automatic - hash queue name into port number,
do not start if port is
unavailable. The default queue
name 'vnc' hashes to web port
6271.
any - hash queue name into port number, try
additional ports in increments of 1
until an available one is found. The
default queue name 'vnc' hashes to
beginning web port 9695.
Default: Any
-webprovider <provider> Specify the provider for
HTTP and HTTPS protocols.
This must be either "internal" or "nginx".
Default: "internal"
-roport <port|mode> Specify read-only guest access web interface
port. A value of 0 disables this interface,
requiring all web interface users to log in.
Default: 0
-pubkey <key> Specify the public VOV security key to be added
to a new project. If -pubkey is not specified,
the public key listed in ~/.vov/userkey or
%PROFILE%/.vov/userkey is added.
-q, -queue <name> Name for queue (default is $NC_QUEUE if set,
and otherwise vnc).
-dir <dir> Directory of the server
(default $VOVDIR/../../vnc).
-dbhost <host> Host for database.
-dbroot <path> Path on database host for database files.
-dbport <port> Port of the database to listen for
connections.
-v Increase verbosity.
EXAMPLES:
% ncmgr start -port 6271
% ncmgr start -port 6271:6272:6273:any -force
% ncmgr start -q bigqueue -dir /remote/queues
Select a Queue Name
The default name of the Accelerator queue is vnc. Unless otherwise specified, all Accelerator commands act on the default queue.
To request a different queue one command at a time, by use the
-q option with the nc command.
Example:
% nc [-q queue -name]run[run -options]command
Change the Default Queue with nc_queue
A different queue can be specified with using the -q option with the nc command.
To change the default Accelerator queue from
vnc, set the environment variable NC_QUEUE to
the queue name.
Example:
% setenv NC_QUEUE vnc_regr