---
name: "bssadmin"
section: "1"
platform: "linux"
package: "ion"
version: "3.2.1+dfsg-1.1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/bssadmin"
---

# bssadmin(1)

Interplanetary Internet (IPN) scheme administration interface for use with Bundle Streaming Service

## 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)](/ipnadmin/1.md) 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)](/bssrc/5.md).

## 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)](/bssrc/5.md) 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)](/bpadmin/1.md) first.

- bssadmin can't initialize routing database.

  There is no SDR data store for *dtnadmin* to use.  Please run [*ionadmin*(1)](/ionadmin/1.md) 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)](/bssrc/5.md) for details.

## BUGS

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

## SEE ALSO

[*bssrc*(5)](/bssrc/5.md)