Upgrading the Webtrends SmartSource Data Collector
  • 21 Dec 2020
  • 2 Minutes To Read
  • Contributors
  • Print
  • Share
  • Dark
    Light

Upgrading the Webtrends SmartSource Data Collector

  • Print
  • Share
  • Dark
    Light

Webtrends recommends that you have at minimum two SmartSource Data Collector (SDC) servers behind a loadbalancer. The SDC server is unable to collect data while it is being reinstalled or upgraded.

Preparation for upgrade or recovery

  1. Contact Webtrends Technical Support for the installation files for both version of the SmartSource Data Collector that you have now and the version you are upgrading to.
  2. Stop the SmartSource Data Collector in IIS.
  3. Backup the dcs.cfg and webtrendssites.lst files from the cfg folder and any log files from the weblog folder to an alternate location.

Recovery or re-installing the SmartSource Data Collector

  1. Uninstall the SmartSource Data Collector from Control Panel > Add/Remove Programs.
  2. Delete the SmartSource Data Collector installation directory.
  3. Install the same version of SmartSource Data Collector using the stand-alone installation file. Install guide found here.
  4. Replace the dcs.cfg and webtrendssites.lst files in the cfg folder with the files that were backed up.
  5. Restore any log files from the backup to the weblog folder.
  6. Restart the The SmartSource Data Collector in IIS.
  7. Test SmartSource Data Collector functionality.

Upgrading the SmartSource Data Collector

  1. Uninstall the SmartSource Data Collector from Control Panel > Add/Remove Programs.
  2. Delete the SmartSource Data Collector installation directory.
  3. Install the newest version of SmartSource Data Collector using the stand-alone installation file. Install guide found here.
  4. Open the the previous versions dcs.cfg and notate the values for the following settings (most common changes):
    a. logfiledir
    b. hostedmodel
    c. servicemodel
    d. splitlogs
  5. Update the values in the new dcs.cfg to match the previous versions values (with the 9.3 SDC there are additional values specified in the file. Simple copy and paste replacement is not recommended).
  6. Replace the webtrendssites.lst files in the cfg folder with the file that we backed up.
  7. Restore any log files from the backup to the weblog folder.
  8. Restart the The SmartSource Data Collector in IIS.
  9. Test SmartSource Data Collector functionality.

How to test a SmartSource Data Collector installation

In order to test, a valid DCSID is required. The DCSID dcs5w0txb10000wocrvqy1nqm_6n1p is created by default with new SDC installations. Check the webtrendssites.lst file for a valid DCSID for your installation.

If dcs5w0txb10000wocrvqy1nqm_6n1p is listed in your webtrendssites.lst file, the following URL can be used for testing:
http://<sdc_server_name>/dcs5w0txb10000wocrvqy1nqm_6n1p/dcs.gif?dcsuri=/test.html&dcsref=webtrends.com

Replace "<sdc_server_name>" with the fully qualified domain name, host name, or IP address of the data collector server and replace the value "dcs5w0txb10000wocrvqy1nqm_6n1p" with the dcsid to be tested.

Testing tag implementation

  1. Open your preferred browser (instructions developed using Chrome, but are similar in most browsers)
  2. Open the developer tools. This can be done by:
    a. Pressing F12 on the keyboard.
    b. Ctrl + Shift + I on the keyboard.
    c. Clicking the vertical … icon in the upper right of the browser and clicking the More tools > Developer Tools
  3. Click on the Network tab near the middle of the list of tabs the top.
  4. Copy the URL created above into the address bar and press "Enter".
  5. Use the Filter box in the upper left and search for “statse.webtrendslive.com”.
  6. Click on the “dcs.gif” row that appears in the list.
  7. Click on the Headers tab in the right panel that appears.
  8. Collapse the General, Response Headers, and Request Headers sections, or scroll down to the Query String Parameters section.
  9. Review the data in the hit by looking at each parameter and value and determining if the expected values are appearing. (dcsuri and dcsref)
  10. If the dcs.gif doesn't return or an error is given, please contact Webtrends Technical Support.
Was This Article Helpful?