Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

About this Resource

Excerpt

Defines an initial setup resource in the SBC system. This is a unique one-time resource used to create an initial configuration for the node, after which the resource becomes unavailable.

REST API Methods for this Resource

Resource Schema

Configuration

Parameter Name Required Service Affecting Data Type Default Value Possible Values Description
ifIpAddrAssignMethodNoNoEnum0Possible values:
  • 0 - static
  • 1 - dynamic
Determines whether specific node-level settings are configured dynamically (via DHCP) or statically.
hostNameNoNostringnone64 - Max LengthSpecifies a hostname for the SBC. The combination of the host and domain names is the FQDN, which must not exceed 255 characters. If this is not provided then the default 'hostname' will be the node serial number.
domainNameNoNostringnone255 - Max LengthSpecifies a domain name for the SBC - only used if IP addressing is static. The combination of the host and domain names is the FQDN, which must not exceed 255 characters.
applicationIPV4AddressNoNostringnone15 - Max LengthSets the Ethernet 1 IP address. This field is inapplicable if the ifIpAddrAssignMethod attribute is set to dynamic. For static addressing, this field must be provided as a valid IPv4 address.
applicationIPV4NetmaskNoNostringnone15 - Max LengthSets the Ethernet 1 IP subnet. This field is inapplicable if the ifIpAddrAssignMethod attribute is set to dynamic. For static addressing, this field must be provided as a valid IPv4 subnet.
gatewayAddressNoNostringnone15 - Max LengthSets the gateway address for the default static route. This field is inapplicable if the ifIpAddrAssignMethod attribute is set to dynamic. For static addressing, this field must be provided, must not be empty, and must be within the same subnet but not the same address as the applicationIPV4Address.
asmDHCPEnabledNoNoBOOLEAN_TYPEDetermines whether DHCP is enabled on the Application Solution Module. This field is inapplicable if the node does not have an ASM or if the ifIpAddrAssignMethod attribute is set to dynamic.
asmIPV4AddressNoNostringnone15 - Max LengthSets the ASM's IPV4 address. This field is inapplicable if the node does not have an ASM, or if asmDHCPEnabled is set to true.
timeZoneGeoNameNoNostringUTC128 - Max LengthSets the system's time zone.
primaryDNSServerIPNoNostringnone15 - Max LengthSets the IP address (IPv4 format) of the primary DNS server. This field is inapplicable if the ifIpAddrAssignMethod attribute is set to dynamic. Setting this field to empty (with static addressing) will disable DNS.
secondaryDNSServerIPNoNostringnone15 - Max LengthSets the IP address (IPv4 format) of the secondary DNS server. This field is inapplicable if the ifIpAddrAssignMethod attribute is set to dynamic. Setting this field to empty (with static addressing) will disable secondary DNS server.
adminUserNameYesNostringnone32 - Max LengthSpecifies an administrative username to be used in subsequent logins
adminUserPasswordYesNostringnone128 - Max LengthSpecifies an administrative user password to be used in subsequent logins
restUserNameNoNostringnone32 - Max LengthSpecifies a REST username to be used in subsequent authentications. If this attribute, and restUserPassword, are empty or not provided then the node will not be set up for REST access until a REST user is created from the UI.
restUserPasswordNoNostringnone128 - Max LengthSpecifies a REST user password to be used in subsequent authentications. If this attribute, and restUserName, are empty or not provided then the node will not be set up for REST access until a REST user is created from the UI.
PasswordRecoveryNoNoEnum0Possible values:
  • 0 - btFalse
  • 1 - btTrue
Specifies whether password recovery is enabled. (Used when all administrator user passwords are forgotten).
ServerAddressNoNoSpecifies the IP address or FQDN of the Syslog server where log entries will be sent. Leaving this field empty will not add a Syslog server.
DefaultLevelNoNoEnum4Possible values:
  • 0 - llDefault
  • 1 - llTrace
  • 2 - llDebug
  • 3 - llInfo
  • 4 - llWarn
  • 5 - llError
  • 6 - llFatal
  • 7 - llOff
Controls the default minimum severity level of messages sent to this server. This default value can be overridden on a per-system basis via the Subsystems Configuration. Informational will produce the most output, and Fatal will produce the least. The more output generated, the more of an impact this feature has on system performance.
Info

Valid values for the DefaultLevel are:

  • 3
    - Informational
  • 4
    - Warning
  • 5
    - Error
  • 6
    - Fatal

SyslogFacilityYesNoEnum9Possible values:
  • 0 - sfUser
  • 1 - sfKern
  • 2 - sfMail
  • 3 - sfDaemon
  • 4 - sfAuth
  • 5 - sfLpr
  • 6 - sfNews
  • 7 - sfUucp
  • 8 - sfCron
  • 9 - sfLocal0
  • 10 - sfLocal1
  • 11 - sfLocal2
  • 12 - sfLocal3
  • 13 - sfLocal4
  • 14 - sfLocal5
  • 15 - sfLocal6
  • 16 - sfLocal7
Controls which Syslog Facility will be used when sending log entries. This can be used to facilitate the sorting of messages from different nodes on a central Syslog server.
ServerPortYesNoint514Possible values:
  • 514 - Minimum
  • 65534 - Maximum
Specifies the Syslog server port number where log entries will be sent.
ServerTransportYesNoEnum0Possible values:
  • 0 - stUDP
  • 1 - stTCP
  • 2 - stTLS
Specifies the protocol to be used for sending log entries to the Syslog server.