Installation

After you've taken care of the requirements, you're ready to install the components of the Splunk SDK for JavaScript.

 

Client-side installation

The Splunk SDK for JavaScript includes pre-built client-side files that run in a web browser. To install the client-side files, you just need to copy them to your site and include them in your code. The client-side SDK also uses the jQuery library, so you also need jquery.min.js.

To install the client-side files

  1. Copy the /splunk-sdk-javascript/client directory to your site.
  2. Copy jquery.min.js, which is included with the SDK in /splunk-sdk-javascript/examples/browser/resources, to your site.
  3. Include one of the following <script> tags in your client-side code, specifying the correct path to the files on your site: 
    4. <script type="text/javascript" src="/YOUR_PATH/splunk.js"></script>

    Or:

    <script type="text/javascript" src="/YOUR_PATH/splunk.min.js"></script>

    This tag creates a global variable called splunkjs, which is the root of the SDK. No other global variables are introduced.

  4. Include a <script> tag specifying the correct path to the jquery.min.js file:
    5. <script type="text/javascript" src="/YOUR_PATH/jquery.min.js"></script>
 

Server-side installation

The Splunk SDK for JavaScript requires Node.js for server-side scripting. To use the Splunk SDK for JavaScript in your own Node.js programs, install the server-side files and require them in your script.

To install the server-side files

  1. At the command line, go to your project's directory and enter: 
    2. npm install splunk-sdk
  2. Use the require() function in your script as follows: 
    3. var splunkjs = require('splunk-sdk');
 

xml2json, the XML to JSON Splunk app

Note This app is only required for Splunk 4.2.x or 4.3.x, or if you want to run the unit tests (with any Splunk version).

JavaScript uses the JavaScript Object Notation (JSON) format for structured data. The Splunk SDK for JavaScript provides a Splunk app, xml2json, that converts the XML that Splunk returns into JSON.

To install the xml2json app

  1. Copy the xml2json directory (/splunk-sdk-javascript/xml2json) to the Splunk apps directory ($SPLUNK_HOME/etc/apps), or create a symbolic link to the xml2json directory.

    2. The following examples show how to do this at the command line.

    On Mac OS X: To copy the xml2json directory to the Splunk apps directory, go to the /splunk-sdk-javascript directory and enter:

    cp -r xml2json /applications/splunk/etc/apps/xml2json

    Or, to create a symbolic link to the xml2json directory, enter: 

    ln -s /users/currentusername/splunk-sdk-javascript/xml2json 
/applications/splunk/etc/apps/xml2json

    On Windows: To copy the xml2json directory to the Splunk apps directory, enter:

    xcopy C:\splunk-sdk-javascript\xml2json "C:\Program Files\Splunk\etc\apps
\xml2json" /s
  2. Restart Splunk.

    3. On Mac OS X: Go to the /Applications/splunk/bin directory and enter:

    ./splunk restart

    On Windows: Go to the C:\Program Files\Splunk\bin directory and enter: 

    splunk restart