BSSADMIN(1) BP executables BSSADMIN(1)NAME
bssadmin - Interplanetary Internet (IPN) scheme administration interface for use with Bundle Streaming Service
SYNOPSIS
bssadmin [ commands_filename ]
DESCRIPTION
bssadmin is a BSS variant of ipnadmin(1) that configures the local ION node's routing of bundles to endpoints whose IDs conform to the ipn
endpoint ID scheme. ipn is a CBHE-conformant scheme; that is, every endpoint ID in the ipn scheme is a string of the form
"ipn:element_number.service_number" where element_number is a CBHE "node number" and service_number identifies a specific application
processing point.
bssadmin operates in response to IPN scheme configuration commands found in the file commands_filename, if provided; if not, bssadmin
prints a simple prompt (:) so that the user may type commands directly into standard input.
The format of commands for commands_filename can be queried from bssadmin with the 'h' or '?' commands at the prompt. The commands are
documented in bssrc(5).
EXIT STATUS
0 Successful completion of IPN scheme administration.
1 Unsuccessful completion of IPN scheme administration, due to inability to attach to the Bundle Protocol system or to initialize the IPN
scheme.
EXAMPLES
bssadmin
Enter interactive IPN scheme configuration command entry mode.
bssadmin host1.bssrc
Execute all configuration commands in host1.bssrc, then terminate immediately.
FILES
See bssrc(5) for details of the BSS configuration commands for the IPN scheme.
ENVIRONMENT
No environment variables apply.
DIAGNOSTICS
Note: all ION administration utilities expect source file input to be lines of ASCII text that are NL-delimited. If you edit the bssrc
file on a Windows machine, be sure to use dos2unix to convert it to Unix text format before presenting it to bssadmin. Otherwise bssadmin
will detect syntax errors and will not function satisfactorily.
The following diagnostics may be issued to the logfile ion.log:
bssadmin can't attach to BP.
Bundle Protocol has not been initialized on this computer. You need to run bpadmin(1) first.
bssadmin can't initialize routing database.
There is no SDR data store for dtnadmin to use. Please run ionadmin(1) to start the local ION node.
Can't open command file...
The commands_filename specified in the command line doesn't exist.
Various errors that don't cause bssadmin to fail but are noted in the ion.log log file may be caused by improperly formatted commands given
at the prompt or in the commands_filename file. Please see bssrc(5) for details.
BUGS
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO bssrc(5)perl v5.14.2 2012-05-25 BSSADMIN(1)
Check Out this Related Man Page
BPADMIN(1) BP executables BPADMIN(1)NAME
bpadmin - ION Bundle Protocol (BP) administration interface
SYNOPSIS
bpadmin [ commands_filename | . ]
DESCRIPTION
bpadmin configures, starts, manages, and stops bundle protocol operations for the local ION node.
It operates in response to BP configuration commands found in the file commands_filename, if provided; if not, bpadmin 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 bpadmin -- that is, the ION node's bpclock task, forwarder tasks, and
convergence layer adapter tasks are stopped.
The format of commands for commands_filename can be queried from bpadmin with the 'h' or '?' commands at the prompt. The commands are
documented in bprc(5).
EXIT STATUS
0 Successful completion of BP administration.
EXAMPLES
bpadmin
Enter interactive BP configuration command entry mode.
bpadmin host1.bp
Execute all configuration commands in host1.bp, then terminate immediately.
bpadmin .
Stop all bundle protocol operations on the local node.
FILES
See bprc(5) for details of the BP configuration commands.
ENVIRONMENT
No environment variables apply.
DIAGNOSTICS
Note: all ION administration utilities expect source file input to be lines of ASCII text that are NL-delimited. If you edit the bprc file
on a Windows machine, be sure to use dos2unix to convert it to Unix text format before presenting it to bpadmin. Otherwise bpadmin will
detect syntax errors and will not function satisfactorily.
The following diagnostics may be issued to the logfile ion.log:
ION can't set custodian EID information.
The custodial_endpoint_id specified in the BP initialization ('1') command is malformed. Remember that the format for this argument is
ipn:element_number.0 and that the final 0 is required, as custodial/administration service is always service 0. Additional detail for
this error is provided if one of the following other errors is present:
Malformed EID.
Malformed custodian EID.
bpadmin can't attach to ION.
There is no SDR data store for bpadmin to use. You should run ionadmin(1) first, to set up an SDR data store for ION.
Can't open command file...
The commands_filename specified in the command line doesn't exist.
Various errors that don't cause bpadmin to fail but are noted in the ion.log log file may be caused by improperly formatted commands given
at the prompt or in the commands_filename file. Please see bprc(5) for details.
BUGS
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO ionadmin(1), bprc(5), ipnadmin(1), ipnrc(5), dtnadmin(1), dtnrc(5)perl v5.14.2 2012-05-25 BPADMIN(1)