Supporting App for AXL | Installation Notes
2 - Install the app
Important note!
You need to have an on-prem Splunk Instance to run the Supporting App for AXL.
- If you are in Splunk Cloud and you do not have this set up yet, start in the Splunk Docs for using a Heavy Forwarder to get data in.
Install the Supporting App for AXL into Splunk
- Log into the on-prem Splunk instance mentioned above.
- Get to the Manage Apps page – either using the Apps menu at the top left of most pages in Splunk, or by going back to the “Launcher” app and clicking manage apps at the bottom left.
- Click the green button to Browse more apps in the upper right.
- Search for Cisco AXL and you’ll see the Supporting App for AXL listed, click on it.
- You should be able to just click “Install” and it will prompt you to restart Splunk after. If you see the app from that page but you don’t seem to be able to Install it, please contact us.
- ALTERNATIVE: If your Splunk admins have locked down your instance such that it can’t talk to Splunkbase, then you can download the tar.gz direct from Splunkbase and save it locally. Then in that same “Manage Apps” page from above you’ll see an “Install App From File” button. Click that and follow the prompts.
Install the Supporting App for AXL app’s AXL Toolkit Files
- Copy the three files AXLAPI.wsdl, AXLEnums.xsd and AXLSoap.xsd from the temporary directory where you extracted them before, to your $SPLUNKHOME/etc/apps/SA_cisco_cdr_axl/bin/ folder on the on-prem Splunk instance where you’ve installed the app.
- They can be deployed via most other “generally accepted” Splunk deployment methods as well – deployment server, deployer, puppet, etc…
- Restart Splunk!
Configure the AXL credentials.
- Log into the on-prem Splunk instance.
- Open the Supporting App for AXL app.
- Click Update Credentials at the top.
- Enter the publisher host, the port (generally 8443) and the username and password for the AXL user you created previously.
- Click Create to create the credentials.
If you have multiple clusters that you are going to use with AXL, continue to add credentials for each.
Testing
Try the following to confirm everything is set up correctly:
- Open the Supporting App for AXL app.
- Click on our Search navigation item near the top.
- Paste in the following search and press enter:
| ciscoaxl listPhone name="SEP%" columns="name,description"
If all is set up correctly, in a few moments (maybe minutes!) you should be presented with a list of all hardphones.
NOTE if your CUCM deployment is enormous you might want to filter that test down to a smaller subset of phones by changing “SEP%” to something more targeted. For instance “SEP0123%” will only match hardphones phones that have MAC addresses starting with “0123”. Or something like “CSF*” would find all Windows Jabber clients.
Next Steps
The last step is to Populate the devices lookup.