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

# ipnadmin(1)

Interplanetary Internet (IPN) scheme administration interface

## NAME

ipnadmin - Interplanetary Internet (IPN) scheme administration interface

## SYNOPSIS

**ipnadmin** \[ *commands\_filename* \]

## DESCRIPTION

**ipnadmin** 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:*node\_number*.*service\_number*" where *node\_number* is a CBHE "node number" and *service\_number* identifies a specific application processing point.

**ipnadmin** operates in response to IPN scheme configuration commands found in the file *commands\_filename*, if provided; if not, **ipnadmin** 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 **ipnadmin** with the 'h' or '?' commands at the prompt.  The commands are documented in [*ipnrc*(5)](/ipnrc/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

- ipnadmin

  Enter interactive IPN scheme configuration command entry mode.

- ipnadmin host1.ipnrc

  Execute all configuration commands in *host1.ipnrc*, then terminate immediately.

## FILES

See [*ipnrc*(5)](/ipnrc/5.md) for details of the IPN scheme 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 ipnrc file on a Windows machine, be sure to **use dos2unix to convert it to Unix text format** before presenting it to **ipnadmin**.  Otherwise **ipnadmin** will detect syntax errors and will not function satisfactorily.

The following diagnostics may be issued to the logfile ion.log:

- ipnadmin can't attach to BP.

  Bundle Protocol has not been initialized on this computer.  You need to run [*bpadmin*(1)](/bpadmin/1.md) first.

- ipnadmin can't initialize routing database.

  There is no SDR data store for *ipnadmin* 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 **ipnadmin** 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 [*ipnrc*(5)](/ipnrc/5.md) for details.

## BUGS

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

## SEE ALSO

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