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

# amsd(1)

AMS configuration server and/or registrar daemon

## NAME

amsd - AMS configuration server and/or registrar daemon

## SYNOPSIS

**amsd** { @ \| *MIB\_source\_name* } { . \| @ \| *config\_server\_endpoint\_spec* } \[*application\_name* *authority\_name* *registrar\_unit\_name*\]

## DESCRIPTION

**amsd** is a background "daemon" task that functions as an AMS "configuration server" in the local continuum, as an AMS "registrar" in a specified cell, or both.

If *MIB\_source\_name* is specified, it must name a MIB initialization file in the correct format for **amsd**, either [*amsrc*(5)](/amsrc/5.md) or [*amsxml*(5)](/amsxml/5.md), depending on whether or not -DNOEXPAT was set at compile time.  Otherwise **@** is required; in this case, the built-in default MIB is loaded.

If this **amsd** task is **NOT** to run as a configuration server then the second command-line argument must be a '.' character.  Otherwise the second command-line argument must be either '@' or *config\_server\_endpoint\_spec*. If '@' then the endpoint specification for this configuration server is automatically computed as the default endpoint specification for the primary transport service as noted in the MIB: "*hostname*:2357".

If an AMS module is **NOT** to be run in a background thread for this daemon (enabling shutdown by [*amsstop*(1)](/amsstop/1.md) and/or runtime MIB update by [*amsmib*(1)](/amsmib/1.md)),  then either the last three command-line arguments must be omitted or else the "amsd" role must not be defined in the MIB loaded for this daemon.  Otherwise the *application\_name* and *authority\_name* arguments are required and the "amsd" role must be defined in the MIB.

If this **amsd** task is **NOT** to run as a registrar then the last command-line argument must be omitted.  Otherwise the last three command-line arguments are required and they must identify a unit in an AMS venture for the indicated application and authority that is known to operate in the local continuum, as noted in the MIB.  Note that the unit name for the "root unit" of a venture is the zero-length string "".

## EXIT STATUS

- "0"

  **amsd** terminated without error.

- \-1

  **amsd** terminated due to an anomaly as noted in the **ion.log** file.  If this termination was not commanded, investigate and solve the problem identified in the log file and restart **amsd**.

## FILES

If *MIB source name* is specified, then a file of this name must be present. Otherwise a MIB initialization file with the applicable default name (see [*amsrc*(5)](/amsrc/5.md)) must be present.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

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

- amsd can't load MIB.

  MIB initialization file was missing, unreadable, or invalid.

- amsd can't start CS.

  Configuration server initialization failed for reasons noted in ion.log file.

- amsd can't start RS.

  Registrar initialization failed for reasons noted in ion.log file.

## BUGS

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

## SEE ALSO

[*amsmib*(1)](/amsmib/1.md), [*amsstop*(1)](/amsstop/1.md), [*amsrc*(5)](/amsrc/5.md), [*amsxml*(5)](/amsxml/5.md)