64-bit Support in Web Server 7

SIP Access Logging in Sailfin

SIP Access logging is disabled by default in Sailfin. The following steps need to be done to enable SIP access logging. (Example mentioned below is for enabling sip access logging in DAS)

1. Start the DAS.

2. Use the following Administration CLI command to enable the SIP access logging.

    # asadmin set server-config.sip-service.property.accessLoggingEnabled = true

    server-config need to be replaced by config for which you need to enable the access logging.

    The above command will create the access log file sip_access_log under the directory
    <sailfin_install_dir>/domains/<domain_name>/logs/sipacess.

3. To get the default access log format

    # asadmin get server-config.sip-service.access-log.format

    The default access log format is "%client.name% %auth-user-name% %datetime% %request% %status% %response.length%". 
 
    The following sip headers are supported

            client.name
            auth-user-name
            datetime
            request
            status
            response.length
            max.forwards
            from
            cseq
            contact
            to
            content.type
            via
            call.id


    To enable all headers, run the following command

    # asadmin set server-config.sip-service.access-log.format="%client.name% %auth-user-name% %datetime% %request% %status%
       %response.length% %max.forwards% %from% %cseq% %contact% %to% %content.type% %via% %call.id%"

        NOTE: Need to escape the format string, else asadmin will fail

4. Now send the SIP request to DAS, you can see the requests logged in the sip access log. Following is the sample access log on sending a
    request with all headers enabled.

    "NULL-CLIENT-NAME" "129.158.228.116" "23/Oct/2008:13:13:06 +0530" "INVITE sip:bar@129.158.228.116:5060"  247 "SIP/2.0/UDP
    129.158.228.116:5080;branch=z9hG4bK7a45cc230bb906944221f6fc5606c11f"
    "249a31b3f8c16af039fbdb937d78e43b@129.158.228.116" ""Mr.    Bar"<sip:bar@java.net>" ""Mr. Foo"
     <sip:foo@sun.com>;tag=70560" "1 INVITE" "70" ""Mr. Foo" <sip:foo@129.158.228.116:5080;transport=udp>" "application/sdp"

5. The above can also be done using Administration GUI.

    i) In the common tasks tree click on Configurations.

    ii) Click on server-config

    iii) Click on sip-service

    iv) Add property accessLoggingEnabled and set it to true.

    v) Click on the Access Log Tab, set the access log format.

    Repeat step 4 and you can see the requests logged in the sip access log.

Posted at 01:50AM Jan 29, 2009 by srinik in Sun  |  Comments[0]