notify

The notify command notifies a specific task or process of a condition that it should act. Used for runtime protocol tracing for UDP/TCP sockets, this command provides for all protocol messages for ServiceSocket sockets to be written to a log file or sent out of the Oracle Communications Session Border Controller to a UDP port.

Syntax

notify <all | task-name> <action> [<arguments> ...]

Arguments

all: Sends the action to all tasks that can receive the notification.
task-name: Specifies the task or process to notify. The local system name is appended automatically when the value does not include @<system-name>.
action: Specifies the common or task-specific action. Common actions include trace, notrace, udplog, noudplog, syslog, nosyslog, rotate-logs, debug, and nodebug.
arguments: Specifies additional values required by the action.

Example 3-1 Example

ORACLE# notify all rotate-logs

notify algd

Syntax

notify algd <log | nolog>
notify algd debug [ +<log-type> ...]
notify algd nodebug
notify algd dump stats
notify algd dump sockets
notify algd dump trans <client | server>
notify algd dumpall

Arguments

log: Enables ALGD protocol logging to alg.log.
nolog: Disables ALGD protocol logging.
debug: Enables ALGD debugging and tracing. With no log type, ALGD enables flow, media, alg, mgcp, trans, and dns.
+log-type: Adds one or more ALGD log types to the default debug set.
nodebug: Disables ALGD debugging and returns log levels to the configured value.
dump stats: Writes ALGD statistics to the process log.
dump sockets: Writes ALGD socket information to the process log.
dump trans client | server: Writes ALGD client-side or server-side transaction information to the process log.
dumpall: Writes ALGD statistics to the process log.

Example 3-2 Example

ORACLE# notify algd log
ORACLE# notify algd dump trans client

notify berpd force

Force a manual switchover between SBCs in an HA node, regardless of the SBC on which the command is executed.

Syntax

notify berpd force

Arguments

None.

Example 3-3 Example

ORACLE# notify berpd force

notify debug

Syntax

notify <task-name> debug [ +<log-type> ...]
notify <task-name> nodebug

Arguments

task-name: Specifies the task or process for which to enable or disable debugging.
+log-type: Optionally specifies task-specific log types to add to that task's default debug set. Supported values depend on the task.

Example 3-4 Example

ORACLE# notify sipd debug
ORACLE# notify sipd nodebug

notify h323d

Syntax

notify h323d debug
notify h323d nodebug
notify h323d callinfo
notify h323d nocallinfo
notify h323d dump trans <client | server>
notify h323d refresh <local-route-config-name>

Arguments

debug: Enables H.323 debugging and sets the H.323 log level to debug.
nodebug: Disables H.323 debugging and restores the configured H.323 log level.
callinfo: Enables H.323 call information display in the process log.
nocallinfo: Disables H.323 call information display.
dump trans <client | server>: Writes H.323 client-side or server-side transaction information to the process log.
refresh local-route-config-name: Clears the cached local route entry for the specified local route configuration.

Example 3-5 Example

ORACLE# notify h323d debug
ORACLE# notify h323d dump trans server

notify lrtd

Use the notify lrtd command to control local routing logging, debugging, and route refresh operations.

Syntax

notify lrtd <log | nolog>
notify lrtd debug [ +<log-type> ...]
notify lrtd nodebug
notify lrtd refresh <local-route-config-name>

Arguments

log: Enables local routing protocol logging to lrt.log.
nolog: Disables local routing protocol logging.
debug: Enables LRTD debugging. With no log type, LRTD enables lrt, sip, trans, dns, spl, spc, trace, redundancy, and config.
+log-type: Adds one or more LRTD log types to the default debug set.
nodebug: Disables LRTD debugging.
refresh local-route-config-name: Refreshes routes from the specified local route file. The ACLI also sends this refresh to SIP and H.323 so those tasks clear matching local route cache entries.

Example 3-6 Example

ORACLE# notify lrtd refresh west-routes

notify mbcd

Use the notify mbcd command to control MBCD logging, debugging, and diagnostic dumps.

Syntax

notify mbcd <log | nolog>
					notify mbcd debug [ +<log-type> ...]
					notify mbcd nodebug
					notify mbcd dump stats
					notify mbcd dump sockets
					notify mbcd dump trans [client] [server]
					notify mbcd dump flows
					notify mbcd dump natflows
					notify mbcd dump nats
					notify mbcd dump freeports [<realm-name>]
					notify mbcd dump li
					notify mbcd dumpall
					notify mbcd dumprealms
					notify mbcd dump-config
					notify mbcd setmsrpdebug <level>
					notify mbcd msrpdebugoff
					notify mbcd setotlsdebug <level>
					notify mbcd otlsdebugoff
					notify mbcd setotcpdebug <level>
					notify mbcd otcpdebugoff

Arguments

log: Enables MBCD protocol logging to miboco.log.
nolog: Disables MBCD protocol logging.
debug: Enables MBCD debugging and tracing. With no log type, MBCD enables flow, media, and xserv.
+log-type: Adds one or more MBCD log types to the default debug set.
nodebug: Disables MBCD debugging and returns log levels to the configured value.
dump: Writes the selected MBCD diagnostic data to the process log. Valid dump values are stats, sockets, trans, flows, natflows, nats, freeports, and li.
realm-name: Optionally limits dump freeports to the specified realm.
setmsrpdebug | setotlsdebug | setotcpdebug: Sets the MSRP, oTLS, or oTCP debug level when that feature is present in the build.
level: Specifies the log level name or numeric level accepted by the task.

Example 3-7 Example

ORACLE# notify mbcd debug
					ORACLE# notify mbcd dump freeports core-realm

notify radd

Use the notify radd command to control RADIUS accounting debugging and diagnostic dumps.

Syntax

notify radd debug
notify radd nodebug
notify radd dump trans
notify radd dump postpone-queue
notify radd dump pending-acrs
notify radd dump session-affinity-map
notify radd dump prio-wt-map
notify radd dump diam-rf-queue
notify radd dump active-server-list
notify radd dump all

Arguments

debug: Enables accounting debugging and tracing to extacct.log.
nodebug: Disables accounting debugging and tracing.
dump trans: Writes accounting transaction information to the process log.
dump postpone-queue: Writes the Diameter postpone queue to the process log.
dump pending-acrs: Writes pending accounting request data to the process log.
dump session-affinity-map: Writes the Diameter session affinity map to the process log.
dump prio-wt-map: Writes the priority weight map to the process log.
dump diam-rf-queue: Writes the Diameter Rf queue to the process log.
dump active-server-list: Writes the active external server list to the process log.
dump all: Writes all available Diameter accounting diagnostic data to the process log.

Example 3-8 Example

ORACLE# notify radd debug
ORACLE# notify radd dump pending-acrs

notify rotate-logs

Use the notify rotate-logs action to rotate a task's process and protocol trace logs.

Syntax

notify <all | task-name> rotate-logs

Arguments

all: Rotates logs for all tasks that receive the notification.
task-name: Specifies the task or process whose logs to rotate. Common values include sipd, sysmand, berpd, brokerd, lemd, mbcd, h323d, algd, and radd.

Example 3-9 Example

ORACLE# notify sipd rotate-logs

notify sipd

Use the notify sipd command to control SIP logging, debugging, runtime limits, and diagnostic dumps.

Syntax

notify sipd siplog
notify sipd nosiplog
notify sipd ldaplog
notify sipd noldaplog
notify sipd debug [ +<log-type> ...]
notify sipd nodebug
notify sipd report
notify sipd limit <rate> [<max-rate>]
notify sipd dumpall
notify sipd dump <sessions | stats | trip | dialogs | reg>
notify sipd dump trans [client] [server]
notify sipd dump sockets
notify sipd dump-agents
notify sipd dump-config
notify sipd start-track <profile-name>
notify sipd dump-track <profile-name>
notify sipd stop-track <profile-name>
notify sipd end-track <profile-name>
notify sipd tracker-profiles
notify sipd conditional-log-enable
notify sipd conditional-log-disable
notify sipd offload-users <realm-id>
notify sipd refresh <local-route-config-name>

Arguments

siplog: Enables SIP message logging.
nosiplog: Disables SIP message logging and SIP UDP logging.
ldaplog | noldaplog: Enables or disables LDAP tracing used by SIP.
debug: Enables SIP debugging and tracing. With no log type, SIP enables service, sip, session, trans, sipnat, sipreg, media, flow, dns, spl, spc, stir, rec, xcoding, trace, redundancy, config, fpe, and ldap.
+log-type: Adds one or more SIP log types to the default debug set.
nodebug: Disables SIP debugging, SIP tracing, and SIP UDP logging.
report: Writes SIP statistics to the process log.
limit: Sets SIP CPU load limits for runtime throttling.
dump: Writes the selected SIP diagnostic data to the process log. Valid dump values are sessions, stats, trip, dialogs, reg, trans, and sockets.
tracker-profiles: Displays SIP tracker profiles.
conditional-log-enable | conditional-log-disable: Enables or disables SIP conditional logging.
offload-users realm-id: Offloads SIP users in the specified realm.
refresh local-route-config-name: Clears the cached local route entry for the specified local route configuration.

Example 3-10 Example

ORACLE# notify sipd nosiplog
ORACLE# notify sipd dump trans client server

notify syslog

Use the notify syslog and notify nosyslog actions to enable or disable syslog output for one or more tasks.

Syntax

notify <all | task-name> syslog [<ip-address>[:<port>]]
notify <all | task-name> nosyslog [<ip-address>[:<port>]]

Arguments

all: Applies the syslog action to all tasks that receive the notification.
task-name: Specifies the task or process to notify.
ip-address: Specifies a syslog server address. If omitted with syslog, the task rereads the configured syslog servers. If omitted with nosyslog, the task disables all syslog destinations.
port: Optionally specifies a syslog server port. The default syslog port is used when no port is specified.

Example 3-11 Example

ORACLE# notify all syslog 100.1.0.20
ORACLE# notify all nosyslog 100.1.20.30

notify trace

Use the notify trace action to enable or disable protocol tracing for service sockets.

Syntax

notify <all | task-name> trace [<all | socket-address> [<file-name> [<remote-addr>]]]
notify <all | task-name> notrace [<all | socket-address>]

Arguments

all: For the target task, applies tracing to all eligible service sockets.
task-name: Specifies the task or process to notify.
socket-address: Specifies a local protocol socket as IP-address:port.
file-name: Specifies the protocol trace file. If omitted, the task uses its default trace log name.
remote-addr: Specifies the remote UDP destination as IP-address:port. If omitted, tracing is written to the trace file.

Example 3-12 Example

ORACLE# notify all trace all aug.gz
ORACLE# notify sipd notrace all

notify udplog

Use the notify udplog action to send task log messages to a remote UDP destination.

Syntax

notify <all | task-name> udplog <remote-addr>
notify <all | task-name> noudplog

Arguments

task-name: Specifies the task or process to notify.
remote-addr: Specifies the remote UDP destination as IP-address:port.

Example 3-13 Example

ORACLE# notify sipd udplog 192.0.2.20:514
ORACLE# notify sipd noudplog