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
        -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 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: 0
        -webprovider <provider>    Specify the provider for
                                   HTTP and HTTPS protocols.
                                   This must be either "internal" or "nginx".
                                   Default: "nginx"
        -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
        -q, -queue <name>       Name for queue (default is 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.
EXAMPLS:
        % 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