1) Getting the updated Mitel/Shoretel Call Reporting App

Go to the app’s homepage ( https://sideviewapps.com/apps/splunk-for-shoretel/ )
Scroll down a little and click “Download Full Version”.

On that download page read the license agreement and below it all you’ll see a form. Enter the “technical contact” email address, accept the license and submit the form. You’ll be emailed a link to download the full version. Click the link and save the resulting shoretel.tar.gz file to your desktop for now.

(NOTE: If the link takes more than a minute to arrive in your inbox, chances are it is getting hung up in your corporate spam filtering. If the link is expired by the time you get it, just go back and submit the download form a second time – for whatever reason the link will usually go through right away the second time.)

2) Update Sideview Utils

  • Log into the Splunk UI as an admin user.
  • Click the “splunk>enterprise” logo in the upper left
  • Click the gears icon next to Apps
  • If there’s a link next to the “Sideview Utils” app to Update it, please click it.

    (As soon as I find a system that needs updating, that arrow will point to a link!)
  • Follow the prompts as required.
  • Restart Splunk if asked.

3) Updating the Mitel/Shoretel Call Reporting app in Splunk

  • Log into the Splunk UI as an admin user, if you aren’t already logged in.
  • Click the “splunk>enterprise” logo in the upper left
  • Click the gears icon next to Apps
  • In the upper right, click Install app from file.
  • Locate the downloaded file (shoretel.tar.gz) with the Browse… button.
  • Be SURE to click the checkbox to Upgrade app.  The upgrade will fail without this checked.
  • Click Upload.
  • Restart Splunk if asked.

4) Clear your browser cache

Unfortunately Splunk’s aggressive caching on static files will often result in some old content interleaving with the new. There are two methods of fixing this. The recommended method is to invalidate the cached files for everyone, but you could also simply clear your own browser cache.

To invalidate the cache for everyone

This method is non-destructive to anything in your browser.  What it does is trigger Splunk to append a new version string into all the web pages it is serving and thus make all browsers get a new copy.

  • Open your Splunk server in your browser.
  • In the address bar, you should have something similar to one of the below URLs being displayed.
    • http://<ip address or servername>:8000/en-US/app/launcher/home
    • https://<ip address or servername>:8443/en-US/app/shoretel/browse
  • Click up in there, and then carefully remove everything to the right of “en-US/” (or other localized version).  You will be left with something like
    • http://<ip address or servername>:<portnumber>/en-US/
  • Now, in that place add _bump, like so
    • http://<ip address>:8000/en-US/_bump
  • And press enter.  You’ll be take to a screen with a version number and a button labeled “Bump version”
  • Click the grey “Bump version” button, which will bump your version.
  • That’s it.  Simply navigate back to your Splunk instance’s regular log in page and all should be well now.

To clear the cache for a single browser

This method removes cached files from your computer, and your computer only.  When you next visit your Splunk server’s page, you won’t have a cached version of any of the web pages it is serving, and thus will have to get a new copy.

  • Press Ctrl-Shift-Delete.
    • This works for Firefox and Chrome, it may work for other browsers as well.
  • There are a variety of options exposed to you – our recommendation, which will erase all cached files but not erase anything else like browsing history, is to..
  • Uncheck all options except “Cache”
  • Change the time frame to “All Time”
  • Then click Clear Now, or whatever your button is called.
  • Be careful – there are options to remove all sorts of things inside here.  Some of which you may not want removed.
Notes

All the indexed data, the searches, reports, dashboards — all that will be backwards compatible. Of course if you have any questions or if you hit any problems, contact us