GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


NAME

       ionadmin - ION node administration interface

SYNOPSIS

       ionadmin [ commands_filename | . ]

DESCRIPTION

       ionadmin configures, starts, manages, and stops the ION node on the
       local computer.

       It configures the node and sets (and reports on) global operational
       settings for the DTN protocol stack on the local computer in response
       to ION configuration commands found in commands_filename, if provided;
       if not, ionadmin prints a simple prompt (:) so that the user may type
       commands directly into standard input.  If commands_filename is a
       period (.), the effect is the same as if a command file containing the
       single command 'x' were passed to ionadmin -- that is, the ION node's
       rfxclock task is stopped.

       The format of commands for commands_filename can be queried from
       ionadmin by entering the command 'h' or '?' at the prompt.  The
       commands are documented in ionrc(5).

       Note that ionadmin always computes a congestion forecast immediately
       before exiting.  The result of this forecast -- maximum projected
       occupancy of the DTN protocol traffic allocation in ION's SDR database
       -- is retained for application flow control purposes: if maximum
       projected occupancy is the entire protocol traffic allocation, then a
       message to this effect is logged and no new bundle origination by any
       application will be accepted until a subsequent forecast that predicts
       no congestion is computed.  (Congestion forecasts are constrained by
       horizon times, which can be established by commands issued to ionadmin.
       One way to re-enable data origination temporarily while long-term
       traffic imbalances are being addressed is to declare a congestion
       forecast horizon in the near future, before congestion would occur if
       no adjustments were made.)

EXIT STATUS

       "0" Successful completion of ION node administration.

EXAMPLES

       ionadmin
           Enter interactive ION configuration command entry mode.

       ionadmin host1.ion
           Execute all configuration commands in host1.ion, then terminate
           immediately.

FILES

       Status and diagnostic messages from ionadmin and from other software
       that utilizes the ION node are nominally written to a log file in the
       current working directory within which ionadmin was run.  The log file
       is typically named ion.log.

       See also ionconfig(5) and ionrc(5).

ENVIRONMENT

       Environment variables ION_NODE_LIST_DIR and ION_NODE_WDNAME can be used
       to enable the operation of multiple ION nodes on a single workstation
       computer.  See section 2.1.3 of the ION Design and Operations Guide for
       details.

DIAGNOSTICS

       Note: all ION administration utilities expect source file input to be
       lines of ASCII text that are NL-delimited.  If you edit the ionrc file
       on a Windows machine, be sure to use dos2unix to convert it to Unix
       text format before presenting it to ionadmin.  Otherwise ionadmin will
       detect syntax errors and will not function satisfactorily.

       The following diagnostics may be issued to the log file:

       Can't open command file...
           The commands_filename specified in the command line doesn't exist.

       ionadmin SDR definition failed.
           A node initialization command was executed, but an SDR database
           already exists for the indicated node.  It is likely that an ION
           node is already running on this computer or that destruction of a
           previously started the previous ION node was incomplete.  For most
           ION installations, incomplete node destruction can be repaired by
           (a) killing all ION processes that are still running and then (b)
           using ipcrm to remove all SVr4 IPC objects owned by ION.

       ionadmin can't get SDR parms.
           A node initialization command was executed, but the
           ion_config_filename passed to that command contains improperly
           formatted commands.  Please see ionconfig(5) for further details.

       Various errors that don't cause ionadmin to fail but are noted in the
       log file may be caused by improperly formatted commands given at the
       prompt or in the commands_filename.  Please see ionrc(5) for details.

BUGS

       If the ion_config_filename parameter passed to a node initialization
       command refers to a nonexistent filename, then ionadmin uses default
       values are used rather than reporting an error in the command line
       argument.

       Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>

SEE ALSO

       ionrc(5), ionconfig(5)



  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to webmaster@gnu.wiki.
Page load time: 0.116 seconds. Last modified: November 04 2018 12:49:43.