Editing Configure Elicit

As you will see, LiveDC utilizes data from all types of sources.  Since LiveDC is a platform hosted in the cloud, it requires an onsite data collector.  Elicit is LiveDC's local JavaScript application that collects data on an ongoing basis and securely pushes the data up to the LiveDC platform.  Elicit comes in two forms: 1) application that resides on a virtual server (Windows or Linux); 2) small appliance to be plugged into the network.

'''Prerequisite'''
<ul>
  <li>Java 32-bit must be installed. To download and install visit here: http://www.java.com/en/download/</li>
</ul>
<br>
The current version of the Elicit collector is 2015.04.01.000
<br>
Below is the configuration instructions for the application version of Elicit.


==Downloading Elicit==
<ol>
  <li>On the navigation menu (left-hand side) click "Data" and click "Elicit," this will open a new tab titled "Elicit"</li>
  <li>Within the Elicit tab (upper left-hand corner), click "Download" to create a new Elicit collector.  This will open up a new window titled "Download Elicit Install File."</li>
[[File:Elicit-Download.PNG]]
    <ol type="a">
      <li>Click "Download"</li>
      <li>Extract the zip file</li>
[[File:Collector Zip.png]]
      <li>Navigate to the folder that the file was extracted to.</li>
      <li>Open the file titled "GeniusEngineCollectorInstaller.exe", this will open a setup window called "Genius Engine Collector Setup"</li>
        <ol type="i">
          <li>Choose the destination to install the Elicit collector and click "Next"</li>
          <li>Account ID and Service URL will be populated automatically (don't change)</li>
          <li>Click "Install" and let the installation complete</li>
[[File:Elicit_Setup.png]]
          <li>Click "Close" once done</li>
        </ol>
      <li>Go back to the LiveDC platform, click the "Refresh" button (upper right-hand corner) for the new Elicit collector to appear in the Elicit list</li>
      <li>Highlight the new Elicit and click "Edit" to authorize</li>
        <ol type="i">
          <li>This will open a window titled “Edit Elicit”</li>
          <li>Check the box titled “Authorized” to change the red x to a green check mark to authorize the Elicit</li>
[[File:Elicit_Authorize.png]]
          <li>Click "Save"</li>
        </ol>
      <li>The Elicit collector should now be fully configured and will begin to send data to LiveDC once you have configured data series to collect data.</li>
    </ol>
</ol>
<br>

==Upgrading Elicit on Linux OS==
<ol>
  <li>Copy the three (3) new *.jar files to home directory on Elicit</li>
    <ol type="a">
      <li>Utilize WinSCP to copy these files to the host</li>
      <li>Open WinSCP connection to the IP address of the Elicit (i.e. 10.10.10.10)</li>
    </ol>
  <li>Open putty to the IP address of the Elicit (i.e. 10.10.10.10)</li>
  <li>Run the following command to ensure the collector is currently running</li>
    <ol type="a">
      <li>ps –ef |grep pyramid</li>
    </ol>
  <li>Run the following command to stop the collector service and release the files</li>
    <ol type="a">
      <li>sudo service collector stop</li>
    </ol>
  <li>Check in the following directory to ensure the current .jar files are there</li>
    <ol type="a">
      <li>ls /usr/local/bin/collector</li>
    </ol>
  <li>Move the three (3) new .jar files from the home directory to the collector directory</li>
    <ol type="a">
      <li>sudo mv *.jar /usr/local/bin/collector</li>
    </ol>
  <li>Change directory to ensure the new files are there and have the appropriate time stamp (file names will be red at this point)</li>
    <ol type="a">
      <li>cd /usr/local/bin/collector</li>
      <li>ls -la</li>
    </ol>
  <li>Change the ownership on the files from pi to root</li>
    <ol type="a">
      <li>sudo chown root.root *.jar</li>
    </ol>
  <li>Change the permissions on the three (3) *.jar files to enable execution</li>
    <ol type="a">
      <li>sudo chmod +x PyramidCo*</li>
    </ol>
  <li>This shows the files in this directory and the three (3) .jar files should be green and have a "x" in the permissions on the left-hand side</li>
    <ol type="a">
      <li>ls –la</li>
    </ol>
  <li>Reboot the Elicit to ensure that the system is reset and when it comes back up it will now use the new .jar files</li>
    <ol type="a">
      <li>sudo reboot</li>
    </ol>
  <li>Check LiveDC and make sure the version has updated to the date, which was associated with the .jar files</li>
    <ol type="a">
      <li>You may need to authorize it as a new collector on LiveDC</li>
    </ol>
</ol>