Accelerator Plus Quick Start

Accelerator Plus has two main commands, wx and wxmgr.

Accelerator Plus has two main commands:
  • wx is used to submit, query, and stop jobs. This command can also be invoked as vnc or as nc.
  • wxmgr is used to start and stop a queue, that is, an Accelerator Plus instance.

wx


wx: Usage Message
  Usage: wx [-q queuename] <command> [command options]
  
  Queue selection:
    The default queue is called "wx".
  
    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 Accelerator Plus.
    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 $product server.
    source <file.tcl>   Source the given Tcl file.
    -                   Accept commands from stdin.
  
  For more help type:
    % $::command <command> -h
  
  Copyright (c) 1998-2023, Altair Engineering.
  

wxmgr

This program manages the vovserver for Accelerator Plus.


wxmgr: Usage Message
  
          This program manages the vovserver for WorkloadXelerator.
          Copyright (c) 1998-2021, Altair Engineering.
  
  USAGE:
          wxmgr help|info|reset|start|stop|cm [OPTIONS]
  
  ACTIONS:
          info   [-queue|-q <name>] [-v]
          reset  [-soft | -hard | -h ]
          start  [-dir <server_working_dir>] [-force] [-queue|-q <name>]
                 [-port <port> ] [-webport <port>] [-roport <port>]
                 [-dbhost <host>] [-dbroot <path>] [-dbport <port>]
                 [-prod nc|wx] [-basequeue <name>]
                 The default <server_working_dir> is
                 <...>/wx.
                 This is the parent of the configuration (.swd) directory for
                 the queue.
          stop   [-force] [-freeze] [-queue|-q <name>] [-writeprdir <dirname>]
                 -force       Do not prompt for confirmation
                 -freeze      Instruct taskers to keep running and wait for a
                              new server
                 -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:
          % wxmgr
          % wxmgr -h
          % wxmgr start -queue wx2
          % wxmgr start -port 6699 -queue wx99
          % wxmgr info
          % wxmgr reset -soft
          % wxmgr reset -hard
          % wxmgr cm help
  
  EXAMPLE TO STOP AND RESTART SERVER:
  
          % wxmgr stop -freeze
          % wxmgr start -force
          % wxmgr stop -freeze -force -writeprdir /tmp/abc123