system-config
Use the system-config element to configure general system information and system parameters.
Parameters
- hostname
- Enter the main hostname that identifies the Oracle Communications Session Border Controller. Entries must follow either the Hostname (or FQDN) Format or the IP Address Format.
- description
- Describe the Oracle Communications Session Border Controller. Entries must follow the Text Format
- location
- Enter the physical location of the Oracle Communications Session Border Controller used for informational purposes. Entries must follow the Text Format.
- mib-system-contact
- Enter the contact information for this Oracle Communications Session Border Controller for SNMP purposes. This field value is the value reported for MIB-II when an SNMP GET is issued by the NMS. Entries must follow the Text Format.
- mib-system-name
- Enter the identification of the Oracle Communications Session Border Controller for SNMP purposes. This value has no relation to the system-config > hostname field. By convention, this is the node’s FQDN. If this field remains empty, the Oracle Communications Session Border Controller name that appears in SNMP communications will be the target name configured in the boot parameters and nothing else.
- mib-system-location
- Enter the physical location of the Oracle Communications Session Border Controller for SNMP purposes. This parameter has no direct relation to the location field identified above. Entries must follow the Text Format.
- acp-tls-profile
- Enter the TLS profile name the system uses to encrypt ACP traffic, to and from the SEM management system.
- snmp-enabled
- Enable or disable SNMP is enabled. If SNMP is enabled, then the
system will initiate the SNMP agent. If SNMP is disabled, then the SNMP
agent will not be initiated, and the trap-receiver and snmp-community
elements will not be functional.
- Default: enabled
- Values: enabled | disabled
- enable-snmp-auth-traps
- Enable or disable the SNMP authentication traps
- Default: disabled
- Values: enabled | disabled
- enable-snmp-syslog-notify
- Enable or disable sending syslog notifications to an NMS via
SNMP; determines whether SNMP traps are sent when a Oracle Communications Session Border Controller generates a syslog message
- Default: disabled
- Values: enabled | disabled
- enable-snmp-monitor-traps
- Determine whether traps are sent out in ap-smgmt.mib trap. (See
MIB Reference Guide for more information)
- Default: disabled
- Values: enabled | disabled
- enable-env-monitor-traps
- Determine whether the environmental monitoring MIB is sent from
the Oracle Communications Session Border Controller. This trap will be
sent any time there is a change in state in fan speed, temperature, voltage
(SD 2 only), power supply (SD 1 for rev 1.32 or higher, SD 2 w/QoS for rev
1.32 or higher, SD II no QoS for rev 1.3 or higher), phy-card insertion, or
I2C bus status. If this parameter is set to enabled, fan speed, temperature,
and power supply notifications are not sent out in other traps.
- Default: disabled
- Values: enabled | disabled
- enable-l2-miss-report
- When this attribute is disabled, the L2 Miss Report is written
to log.octData if the ETC debug level is set to NORMAL. By default, this
attribute does not generate a log.
- Default: enabled
- Values: enabled | disabled
- snmp-syslog-his-table-length
- Enter the maximum entries that the SNMP Syslog message table
contains. The system will delete the oldest table entry and add the newest
entry in the vacated space when the table reaches maximum capacity.
- Default: 1
- Values: Min: 0 / Max: 500
- snmp-syslog-level
- Set the log severity levels that send syslog notifications to
an NMS via SNMP if snmp-syslog-notify is set to enabled. If the severity of
the log being written is of equal or greater severity than the
snmp-syslog-level value, the log will be written to the SNMP syslog history
table. If the severity of the log being written is of equal or greater
severity than the snmp-syslog-level field value and if
enabled-snmp-syslog-notify field is set to enabled, the system will send the
syslog message to an NMS via SNMP. If the severity of the log being written
is of lesser severity than the snmp-syslog-level value, then the log will
not be written to the SNMP syslog history table and it will be disregarded.
- Default: warning
- Values:
- emergency
- critical
- major
- minor
- warning
- notice
- info
- trace
- debug
- detail
- syslog-servers
- Access the syslog-servers subelement
- system-log-level
- Set the system-wide log severity levels write to the system log
- Default: warning
- Values:
- emergency
- critical
- major
- minor
- warning
- notice
- info
- trace
- debug
- detail
- process-log-level
- Set the default log level that processes running on the Oracle Communications Session Border Controller start
- Default: notice
- Values:
- emergency
- critical
- major
- minor
- warning
- notice
- info
- trace
- debug
- detail
- process-log-ip-address
- Enter the IP address of server where process log files are
stored. Entries must follow the IP Address Format. The default value of
0.0.0.0 causes log messages to be written to the local log file.
- Default: 0.0.0.0
- process-log-port
- Enter the port number associated with server IP address where
process log files are stored. The default value of 0 writes log messages to
the local log file.
- Default: 0
- Values: Min: 0; 1025 / Max: 65535
- collect
- Accesses the collect subelement
- call-trace
- Enable or disable protocol message tracing for sipmsg.log for
SIP
- Default: disabled
- Values: enabled | disabled
- internal-trace
- Enable or disable internal ACP message tracing for all processes
- Default: disabled
- Values: enabled | disabled
- log-filter
- Set to logs or all to send the logs to the log server
- Default: all
- Values:
- none
- traces
- traces-fork
- logs
- log-fork
- all
- all-fork
- default-gateway
- Enter the IP address of the gateway to use when IP traffic sent
by the Oracle Communications Session Border Controller is destined for a
network other than one of the LANs on which the 10/100 Ethernet interfaces
could be. Entries must follow the IP Address Format. A value of 0.0.0.0
indicates there is no default gateway.
- Default: 0.0.0.0
- restart
- Enable or disable the Oracle Communications Session Border Controller rebooting when a task is
suspended. When set to enabled, this field causes the Oracle Communications Session Border Controller to reboot automatically when
it detects a suspended task. When this field is set to disabled and a task
is suspended, the Oracle Communications Session Border Controller does
not reboot.
- Default: enabled
- Values: enabled | disabled
- exceptions
- Select system tasks that have no impact on system health or cause the system to restart. This field contains the name(s) of the task(s) surrounded by quotation marks. If there are multiple entries, they should be listed within quotation marks, with each entry separated by a <Space>.
- telnet-timeout
- Enter the time in seconds the Oracle Communications Session Border Controller waits when there is no Telnet
activity before an administrative telnet session, or SSH connection, is
terminated. A value of 0 disables this functionality, meaning no time-out is
being enforced.
- Default: 0
- Values: Min: 0 / Max: 65535
- console-timeout
- Enter the time in seconds the Oracle Communications Session Border Controller waits when there is no
activity on an ACLI administrative session before it terminates the session.
The ACLI returns to the User Access Verification login sequence after it
terminates a console session. A value of 0 disables this functionality.
- Default: 0
- Values: Min: 0 / Max: 65535
- remote-control
- Enable or disable listening for remote ACP config and control
messages before disconnecting
- Default: enabled
- Values: enabled | disabled
- cli-audit-trail
- Enable or disable the ACLI command audit trail. The
cli-audit-trail outputs to cli.audit.log.
- Default: enabled
- Values: enabled | disabled
- link-redundancy-state
- Enable or disable the link redundancy
- Default: disabled
- Values: enabled | disabled
- source-routing
- This parameter / feature has been deprecated.
- cli-more
- Enable this parameter to have the ACLI “more” paging feature
working consistently across console or SSH sessions with the Oracle Communications Session Border Controller. When this parameter is
disabled, you must continue to set this feature on a per session basis.
- Default: disabled
- Values: enabled | disabled
- terminal-height
- Set the Oracle Communications Session Border Controller
terminal height when the more prompt option is enable
- Default: 24
- Values: Minimum: 5 / Maximum: 1000
- debug-timeout
- Enter the time, in seconds, you want to the Oracle Communications Session Border Controller to timeout log levels for
system processes set to debug using the ACLI notify and debug commands. A
value of 0 disables this parameter.
- Default: 0
- Values: Min: 0 / Max: 65535
- trap-event-lifetime
- Set this parameter to the number of days you want to keep the
information in the alarm synchronization table; 0 turns alarm
synchronization off
- Default: 0
- Values: Min: 0 / Max: 7
- ids-syslog-facility
- Enter a syslog facility, as entered in the syslog-config
configuration element, facility parameter to send IDS-type syslog messages
to that syslog server. The default value of -1 disables selective message
transfer.
- Default: -1
- default-v6-gateway
- Set the IPv6 default gateway for this Oracle Communications Session Border Controller. This is the IPv6 egress gateway for traffic without an explicit destination. The application of your Oracle Communications Session Border Controller determines the configuration of this parameter.
- ipv6-signaling-mtu
- This sets the system-wide, default IPv6 MTU size.
- Default: 1500
- Values: 1280-4096
- ipv4-signaling-mtu
- This sets the system-wide, default IPv4 MTU size.
- Default: 1500
- Values: 576-4096
- alarm-threshold
- Accesses the alarm-threshold subelement.
- cleanup-time-of-day
- Enter the local time the Oracle Communications Session Border Controller begins inspecting directories
to perform the clean up process.
directory-cleanup—Enters the directory-cleanup subelement.
- Default: 00:00
- snmp-engine-id-suffix
- Sets a unique suffix for the SNMPEngineID. This value is entered as a string.
- snmp-agent-mode
- Determines which version of SNMP is supported on this system.
- Default: v3
- Values: v1v2 | v3
- snmp-rate-limit
- Specifies the maximum number of SNMP packets per second the
system accepts.
- Default: 0 (no rate limiting)
- Values: 0 - 9999
- forwarding-cores
- Specifies the number of CPUs to use for traffic forwarding.
- Default: 1
- Values: 1 - 128
- dos-cores
- Specifies the number of CPUs to use for DoS processing.
- Default: 0
- Values: 0 - 1
- transcoding-cores
- Specifies the number of CPUs to use to perform transcoding
processes.
- Default: 0
- Values: 0 - 128
- use-sibling-core-datapath
- Enables or disables the use of hyperthreading on your
hypervisor.
- Default: Disabled
- Values: Enabled | Disabled
- options
- Enter any customer-specific features and/or parameters for this global system configuration. This parameter is optional.
- enable-snmp-tls-srtp-traps
- This parameter is reserved for future use. Ensure it remains at
its default, disabled.
- Default: disabled
- Values: enabled | disabled
Path
system-config is an element under the system path. The full path from the topmost ACLI prompt is:
Note:
Under the system-config element, options are not RTC supported. This is a single instance configuration element.