Accelerator Quick Start

Accelerator has two main commands, nc and ncmgr.

  • nc is used to submit, query, and stop jobs. This command can also be invoked as vnc.
  • ncmgr is used to start a queue: ncmgr start. By default, the queue (vnc) starts in a server working directory (SWD) that is a subdirectory in $VOVDIR/../../vnc.

The output of ncmgr start/stop is logged in ${VOVDIR}/local/logs/nc, if it exists.

This page shows the usage messages that are generated by the nc and ncmgr commands.

nc


nc: Usage Message
Usage: nc [-q queuename] <command> [command options]

Queue selection:
  The default queue is called "vnc".

  You can specify a different queue with the option -q <queuename>
  or by setting the environment variable NC_QUEUE.

Commands:
  clean               Cleanup log files and env files.
  debug               Show how to run the same job without NetworkComputer.
  dispatch            Force dispatch of a job to a specific tasker.
  forget              Forget old jobs from the system.
  getfield            Get a field for a job.
  gui                 Start a simple graphical interface.
  help                This help message.
  hosts               Show farm hosts (also called taskers).
  info                Get information about a job and its outputs.
  list                List the jobs in the system.
  jobclass            List the available job classes.
  kerberos            Interface to Kerberos (experimental).
  modify              Modify attributes of scheduled jobs.
  monitor             Monitor network activity.
  rerun               Rerun a job already known to the system.
  resources           Shows resource list and current statistics.
  resume              Resume a job previously suspended.
  run <job>           Run a new job (also called 'submit').
  preempt             Preempt a job.
  stop                Stop jobs.
  submit <job>        Same as 'run'.
  summary             Get a summary report for all my jobs.
  suspend             Suspend the execution of a job.
  taskerlist          Show available tasker lists.
  wait                Wait for a job to complete.
  who                 Report on who is using the system.
  why                 Analyze job status reasons.


Unique abbreviations for commands are accepted.

Advanced features:
  cmd <command>       Execute an arbitrary VOV command in the
                      context of the NetworkComputer server.
  source <file.tcl>   Source the given Tcl file.
  -                   Accept commands from stdin.

For more help type:
  % nc <command> -h

Copyright (c) 1998-2021, Altair Engineering.

ncmgr

This program manages the vovserver for Accelerator.

Usage


vncmgr: Usage Message

        This program manages the vovserver for Accelerator.
        Copyright (c) 1998-2023, Altair Engineering.

USAGE:
        ncmgr help|info|rehost|reset|start|stop|cm [OPTIONS]

ACTIONS:
        info   [-queue|-q <name>] [-v]
        reset  [-soft | -hard | -h ]
        rehost [-force] [-queue|-q <name>] -host <host>
        start  [-dir <server_working_dir>] [-force] [-queue|-q <name>]
               [-port <port> ] [-webport <port>] [-roport <port>]
               [-dbhost <host>] [-dbroot <path>] [-dbport <port>]
               [-prod nc|wx|he] [-basequeue <name>] [-dd]
               The default <server_working_dir> is
               <...>/vnc.
               This is the parent of the configuration (.swd) directory for
               the queue.
        stop   [-force] [-freeze] [-freeze_nocpr] [-queue|-q <name>]
               [-writeprdir <dirname>]
               -force       Do not prompt for confirmation
               -freeze      Instruct taskers to keep running and wait for a
                            new server
               -freeze_nocpr Instruct taskers to keep running and wait for a
                             new server, and do not compress PR file
               -writeprdir  Writes the PR file to the specified directory
               (which is created if necessary)
        cm     [-queue|-q name] <ACTION> [ARGUMENTS]
               Configuration Management. Pass "help" for detailed usage.

EXAMPLES:
        % ncmgr
        % ncmgr -h
        % ncmgr start -queue vnc2
        % ncmgr start -port 6699 -queue vnc99
        % ncmgr info
        % ncmgr reset -soft
        % ncmgr reset -hard
        % ncmgr cm help

EXAMPLE TO STOP AND RESTART SERVER:

        % ncmgr stop -freeze
        % ncmgr start -force
        % ncmgr stop -freeze -force -writeprdir /tmp/abc123