Table of Contents

Skyline CDMR LogCollector

This application protocol allows you to load a Skyline Log Collector package into the CDMR DMS and visualize system data, system trends and debug information based on the SLWatchdog reports.

The CDMR LogCollector extracts information from a .zip package generated by the SLLogCollector tool and creates a corresponding element with the relevant data from the package.

It can be used in any of the following situations:

  • If it is not possible to connect to a DMS remotely.
  • If a "Microsoft Platform" element is missing in the DMS.
  • If the "Microsoft Platform" element misses the required trending to identify a problem.
  • In case of older issues, where a Log Collector package is available but insufficient data exists on the system to debug.
  • If a DMS does not send reports to CDMR, this protocol allows you to partly replace the live data CDMR gets from these reports with contents from these packages.
  • ...

The CDMR LogCollector is a virtual connector that connects to a remote location to transfer log items. Once the preferred selection has been configured, the retrieving process can start. This implies the extraction of the archive and copying the notifications and reports to a local path based on a mail domain found by communicating with the CDMR Manager element.

About

Version Info

Range Key Features Based on System Impact
1.0.0.x [SLC Main] Initial version - -

System Info

Range DCF Integration Cassandra Compliant Linked Components Exported Components
1.0.0.x No Yes - -

Configuration

Connections

This connector uses a virtual connection and does not require any input during element creation.

How to use

General

This is the most important page of the connector. It allows you to upload an SLLogCollector package to a customer element on the CDMR cluster, and achieve the following goals with the data from the package:

  • Updating a Skyline Communications CDMR Agent element corresponding to a customer DMA with new data.
  • Creating a new Skyline Communications CDMR Agent element for an existing customer (and adding new data).
  • Creating a new Skyline Communications CDMR Customer/Skyline Communications CDMR Agent element for a new customer (and adding new data).

Here is how you can upload and process a Log Collector package:

  1. Run SL_LogCollector.exe on the target (customer) DMA. For more information, see SLLogCollector.

  2. Copy the resulting package to a location with a short path, e.g., a personal root directory.

    Note that the SLC CDMR LogCollector suffers from the Windows limitation that a path may only have 255 characters. If the path is longer than that, it may not work correctly and log an error.

  3. Navigate to cdmr.skyline.be/, open the Apps in the side panel, and click SLC CDMR LogCollector.

  4. Fill in your domain credentials and password.

    Note that there is a 12-hour timer that clears your credentials automatically in case you forget to do so. Also, if you log in many times in a short period of time, your account may be locked.

  5. Fill in the path of the package and select its customer acronym.

    As mentioned above, it is important that you keep the path short (e.g., \SLC-NAS-01.skyline.local\Users\LaurensVC). It is also important that the customer acronym is selected at this point

  6. Click Retrieve Packages. This will retrieve all Log Collector zip files from the specified location.

  7. Optionally, to create a new element for a customer that does not yet exist on CDMR, fill in a New Customer Mail Domain, and click Add Customer Element*.*

    If the customer already exists, the customer view with the corresponding element will have the format [CustomerAcronym] [CustomerName], e.g., SLC Skyline Communications.

  8. Select the DMA Name, then select the Filename for that DMA. If you have several different packages for one DMA, make sure to select the correct one.

  9. Click Upload File to automatically create a new Skyline Communications CDMR Agent and upload package data to it, or to upload the data to an existing CDMR Agent element*.*

    You will be able to follow the unzipping process in the log box on the right-hand side of the page.

Clean Up

This page is obsolete but is kept for the purpose of backwards compatibility. It used to list any temporary directories that were not deleted because of interruptions, e.g., a DMA restart or connection problems.

However, in case such temporary directories that have not removed exist, we recommend to remove them manually instead of using this page.

Notes

ASP.NET 4.0 is required because System.Web.Extensions.dll is used.