How to access AXL/SOAP on CUCME

Version 1
    This document was generated from CDN thread

    Created by: TASOS PAPADOPOULOS on 15-10-2009 04:35:19 PM
    Hi all,


    I would like to ask you about the AXL URI on CME for POST AXL queries. Which format should I have in my request and to which URI I should make the http/https POST?

    I found no information about it by searching Cisco documentation and developer community. Only CUCM AXL is well documented. It seems that the old URI path of CME (/ISApi/AXL/V1/soapisapi.is) has be changed after CME v4. I've already set my CME v7.0 for AXL according to document on "Configuring the AXL API" (http://www.cisco.com/en/US/docs/voice_ip_comm/cucme/admin/configuration/guide/cmeapi.html). By reading "XML Provisioning for CME/SRST" (http://www.cisco.com/en/US/docs/voice_ip_comm/cucme/xml/developer/guide/xmldev.html#wp1062172) there is no reference for the proper URI.

    I only found the document on the following url: http://www.cisco.com/univercd/cc/td/doc/product/voice/its/xmldev.htm but it seems very obsolete.


    Please help. Is there any document about AXL for CME that I've missed?


    Regards,

    Tasos

    Subject: RE: How to access AXL/SOAP on CUCME
    Replied by: TASOS PAPADOPOULOS on 21-10-2009 04:29:30 PM
    Is there anyone who can answer my previous simple question ?
     
    Which is the url to query/POST Callmanager Express v7.x for AXL/SOAP ?
     
    Regards,
    T.

    Subject: RE: How to access AXL/SOAP on CUCME
    Replied by: David Staudt on 21-10-2009 11:15:17 PM
    I had to ask the engineers, because I couldn't find it myself either, but the URL is actually in the 'Configuring the XML API' guide: http://www.cisco.com/en/US/docs/voice_ip_comm/cucme/admin/configuration/guide/cmeapi.html
     
    Note This command defines URL of Cisco Unified CME XML server as http://<routerIPaddress>/ios_xml_app/cme.

     

    Subject: RE: How to access AXL/SOAP on CUCME
    Replied by: TASOS PAPADOPOULOS on 22-10-2009 04:34:31 PM
    I'm sending requests to this url (/ios_xml_app/cme) but it seems that it isn't responding by Not Found error 404:
     
    HTTP/1.0 404 Not Found
    Set-Cookie: JSESSIONIDSSO=e1ba9wo5j1;Path=/
    Content-Type: text/html
    Content-Length: 176
    Set-Cookie: JSESSIONID=e1ba9wo5j1;Path=/
    Date: Thu, 22 Oct 2009 16:25:50 GMT
    Server: Tomcat Web Server/3.3.1 Final ( JSP 1.1; Servlet 2.2 )

    <head><title>Not Found (404)</title></head>
    <body><h1>Not Found (404)</h1>
    Original request: /ios_xml_app/cme
    <br><br>
    <b>Not found request:</b> /ios_xml_app/cme
    </body>
     
    Pls help.
     
    Regards,
    T.

    Subject: RE: How to access AXL/SOAP on CUCME
    Replied by: David Staudt on 22-10-2009 05:42:01 PM
    Are you sure you are sending the request to a CallManager Express (running on a Cisco router?)  Can you confirm the exact version?
     
    The response looks more like something the webserver on regular Communications Manager would return.  That URL is https://[cm_address]:8443/axl.  Note that UCM AXL requires HTTPS/SSL transport.

    Subject: RE: How to access AXL/SOAP on CUCME
    Replied by: TASOS PAPADOPOULOS on 22-10-2009 06:25:08 PM
    YES Indeed I'sending my request to a CME ! I did a telnet to its IP port 80 and posted a request to the cme AXL url. It seems that it has an internal tomcat server. Below is the requested info. I 've sent the following request:
    POST /ios_xml_app/cme HTTP/1.0<CR><CR> and responded as above.
     
    Here is the version info you've requested:
     
    #sh telephony-service
    CONFIG (Version=7.1)
    =====================
    Version 7.1
    Cisco Unified Communications Manager Express
    For on-line documentation please see:
    http://www.cisco.com/en/US/products/sw/voicesw/ps4625/tsd_products_support_series_home.html

    ip source-address 192.168.2.254 port 2000
    ip qos dscp:
     ef (the MS 6 bits, 46, in ToS, 0xB8) for media
     cs3 (the MS 6 bits, 24, in ToS, 0x60) for signal
     af41 (the MS 6 bits, 34, in ToS, 0x88) for video
     default (the MS 6 bits, 0, in ToS, 0x0) for serviceservice directed-pickup
    service dnis dir-lookup
    service dss
    no auto-reg-ephone
    load 7906 SCCP11.8-5-3S
    load 7911 SCCP11.8-5-3S
    load 7960-7940 P00308010200
    load 7941GE SCCP41.8-5-2S
    load 7970 SCCP70.8-5-2S
    load 7971 SCCP70.8-5-2S
    load ata ATA030203SCCP051201A
    max-ephones 42
    max-dn 144
    max-conferences 16 gain -6
    dspfarm units 0
    dspfarm transcode sessions 0
    conference software
    no privacy
    no privacy-on-hold
    hunt-group report delay 1 hours
    Number of hunt-group configured: 1
    hunt-group logout DND
    max-redirect 10
    voicemail 3000
    cnf-file location: system:
    cnf-file option: PER-PHONE-TYPE
    network-locale[0] US   (This is the default network locale for this box)
    network-locale[1] US
    network-locale[2] US
    network-locale[3] US
    network-locale[4] US
    user-locale[0] US    (This is the default user locale for this box)
    user-locale[1] US
    user-locale[2] US
    user-locale[3] US
    user-locale[4] US
    srst mode auto-provision is OFF
    srst ephone template is 0
    srst dn template is 0
    srst dn line-mode single
    phone service videoCapability 1
    moh Dr_Who_is_Back(ulaw_LowerVolume).wav
    time-format 24
    date-format dd-mm-yy
    timezone 26 E. Europe Standard/Daylight Time
    url directories http://192.168.2.254/localdirectory
    call-forward pattern .T
    call-forward pattern 3...
    call-forward pattern 9..
    call-forward pattern 0..........
    call-forward system redirecting-expanded
    transfer-pattern 0..........
    transfer-pattern 3...
    transfer-pattern 9..
    transfer-pattern 1..
    transfer-pattern .T
    after-hours day Thu 00:01 23:59
    keepalive 30 auxiliary 30
    timeout interdigit 10
    timeout busy 10
    timeout ringing 180
    timeout transfer-recall 15
    timeout ringin-callerid 8
    timeout night-service-bell 12
    caller-id name-only: enable
    system message CUCME 7.1
    edit DN through Web:  enabled.
    edit TIME through web:  enabled.
    Log (table parameters):
         max-size: 100
         retain-timer: 30
    create cnf-files version-stamp 7960 Oct 14 2009 20:11:01
    transfer-system full-consult
    transfer-digit-collect new-call
    login timeout 1
    local directory service: enabled.
    Extension-assigner tag-type ephone-tag.
    Call List BLF is enabled
     
    and
     
    #sh ip http server session-module

    HTTP server application session modules:
     Session module Name  Handle Status   Secure-status  Description
    ITS_LOCDIR            11     Active   Active         ITS Local Directory Search             
    CME_SERVICE_URL       12     Active   Active         CME Service URL                        
    ITS                   10     Active   Active         IOS Telephony Service                  
    HTTP_IFS              1      Active   Active         HTTP based IOS File Server             
    CWMP_SERVER           2      Active   Active         CWMP Connection Request Server         
    HOME_PAGE             3      Active   Active         IOS Homepage Server                    
    http_ezsetup          4      Active   Active         HTTP EZSETUP Server                    
    QDM                   5      Active   Active         QOS Device Manager Server              
    QDM_SA                6      Active   Active         QOS Device Manager Signed Applet Server
    WEB_EXEC              7      Active   Active         HTTP based IOS EXEC Server             
    IXI                   8      Active   Active         IOS XML Infra Application Server       
    XML_Api               9      Active   Active         XML Api                                
    CME_AUTH_SRV_LOGIN    13     Active   Active         CME Authentication Server              
    CME_EM_LOGIN          14     Active   Active         CME Extension Mobility Login           
    GSI48D8D9BC           15     Active   Active         license agent app                      

    Subject: RE: How to access AXL/SOAP on CUCME
    Replied by: David Staudt on 22-10-2009 07:18:29 PM
    Hmm...I was able to get this working with a CME 7.2 router, following all of the steps (providing sane values for every option, even if it didn't particularly look important) here: http://www.cisco.com/en/US/docs/voice_ip_comm/cucme/admin/configuration/guide/cmeapi.html
     
     
     
     

    Subject: RE: How to access AXL/SOAP on CUCME
    Replied by: TASOS PAPADOPOULOS on 23-10-2009 11:50:14 AM
    Hi David,
     
    I finaly managed to do it working. I'm used http but it needs https to work.
     
    Thank you very much for your help.
     
    Regards,
    Tasos

    Subject: RE: How to access AXL/SOAP on CUCME
    Replied by: James Chaundy on 30-10-2009 10:07:54 AM
    Hi All,
     
    I have been doing some research into getting AXL working on our cucme 7 box, reading all the documents on the cisco site, I believe I have successfully set up the service on the system but have been unable to find get it working using PHP.
     
    Has anyone got a working example they wouldn't mind sharing so that I could test the configuration and better understand the steps involved.
     
    Thanks in advance
     
    James