S8xxx Shell Commands

S8xxx Server administration is performed using a set of shell commands. These shell commands have a Linux look-and-feel. All shell commands administer or display information specific to the server they are being executed on. The information below is contained in Avaya document 555-245-101.

Quick Links:
almcall
almenable
almnotif
productid
testinads
testcustalm
custalmopt
almsnmpconf

almcall

This command displays or administers the OSS telephone numbers, the number of retries, the time interval between retries and Alarm Abbreviation parameters. It also applies to SNMP inform requests to INADS. All OSS parameters are stored in alarm_oss.conf file.

Usage:

    almcall     [-f first-number] [-a [y|n]]
                [-s second-number] [-b [y|n]] 
                [-t [abbreviation-timer]] 
                [-i [interval]] | [-?] 

    no argument: display
        -f: set first number to first-number values allowed: up to 30 digits. 
        -a: set alarm abbreviation on first number to y(es)(default) or n (o) 
        -s: set second number to second-number values allowed: up to 30 digits. ',' for pause

        -b: set alarm abbreviation on second number to y(es)(default) or n(o) 
        -t: set alarm abbreviation timer in hours values allowed: 1-24 default value: 4 
        -i: set interval between retries in minutes to interval 
            values allowed: 1-20
            default value: 7
        -?: usage (this)

almenable

The almenable command is used to administer or display Alarm Origination (Traditional Dial-out Modem Calls), and SNMP Alarm Origination. These parameters can no longer be administered via the DEFINITY SAT Interface. All almenable parameters will be logged into alarm_oss.conf file. For alarming with SNMP see almsnmpconf.

Usage:

    almenable [-d [n|f|b]] [-s [y|n]] ] | [-?]menable [-d [n|f|b]] [-s [y|n]] ] | [-?]
               
    no argument: display 
        -d: set dial out alarm origination to 
            n - neither (default)
            f - first number only
            b - both numbers
        -s: enable (y)(default) or disable (n) snmp alarm origination
                

almnotif

This command is used to administer Restart Notification Parameter, Clear Alarm Notification Parameter, and Suspension Threshold for Clear Alarm Notification.

Usage:

    almnotif [-r [y|n]] [-c [y|n]] [-s [threshold]] | [-?]
    
    no argument: display 
       -r: enable (y) - default - or disable (n) restart notification
       -c: enable (y) - default - or disable (n) clear alarm notification
       -s: set suspension threshold to "threshold" values allowed: 1-15 
           default value: 5
                

productid

Sets or displays the OSS productid of the software system. Partial Command functionality (display productID) shall be available from the Stingray WEB interface, in that users cannot set the product ID from the WEB Interface.

Usage:

    productid [-p|-m|-r productid] | [-?]
    
    no argument: display product identification number
        -p: set CommunicaMgr identification number to productid 
        -m: set Messaging identification number to productid 
        -r: set RMB identification number to productid 
        -?: usage (this)
                

testinads

Checks connectivity to the INADS port using the modem and SNMP inform requests. The test is successful only if INADS acknowledges the test alarm. At least the first OSS number or SNMP Inform Request IP Destination must be administered for this test to be successful. If both modes are administered, both modes shall be tested. For testing INADS with SNMP see almsnmpconf.

Usage:

    testinads
    
    No command line parameter required. It tests the health of alarm processing between the system and INADS.
                

testcustalm

Use testcustalm to generate a customer alarming test SNMP trap. No arguments are required. This command tests the health of alarm processing between the system and AlarmTraq.

Usage:

    testcustalm
    
    No command line parameter required. It tests the health of alarm processing between the system and AlarmTraq via SNMP Trap.
                

custalmopt

Use custalmopt to set or display the current customer alarm option. This command runs on the active server only, and Communication Manager must be running.

Usage:

    custalmopt [ -? ] [ -h ] [ -d ] [ -m ] [ -a ]
       -d Display current settings (default)
       -m Set to report Major/Minor alarms only 
       -a Set to report all alarms
                

almsnmpconf

Administer SNMP alarming to INADS. This is used to send SNMP v2c traps to a local Aurora Gateway or an Avaya SAL gateway.

Usage:

    almsnmpconf [-d IP] [-c community] [-b [y|n]] [-e y|n] [-add|-del|-mod] | [-?]

    Administer parameters for SNMP alarming to INADS.

    no parameters
        Display the administered information: destination IP address, community name, alarm abbreviation status. 
    -d IP
        Set IP address to send SNMP traps. 
        The IP address must be entered in dotted decimal notation a.b.c.d, where a, b, c, and d are integers between 1 and 255. 
    -c community
        Set the trap community name to use in the SNMP traps. 
        The community name is any string of characters and numbers. The string may not contain a space or tab. 
    -b [y|n]
        Enable or disable alarm abbreviation. 
        y - yes (default). Enable alarm abbreviation with respect to SNMP notifications. Alarm abbreviation for SNMP alarming has the same context as modem dial out. 
        n - no. Disable alarm abbreviation for SNMP alarming. 
    -e y|n
        Enable or disable trap destination. 
        y - yes. Enable this trap destination. 
        n - no. Disable this trap destination. 
    -add
        Add this as a new trap destination 
    -del
        Delete this trap destination. 
        The -d flag with a valid/existing ip address is required. 
    -mod
        Modify an existing trap destination. 
        The -d flag with a valid/existing ip address is required. 
        Note: In order to modify the ip address, the trap destination has to be deleted and re-added. 
    -?
        Display the command usage.