Crash Analysis Data Collector 
        (CADC)

Installation and User's Guide

NEW for 3.0
===========

As the New HP migrates towards a uniform mechanism for
electronic communication with customers, the DSNLink 
hosts and accompanying software are gradually being deactivated.
Proactive Remote Services (PRS) will be the replacement
for DSNLink.

The 3.0 version of CADC contains new files and additional
logic to interact with the new PRS system.  The DSNLink option
is also still available in this kit.  However, if you have migrated
your production environment to the new PRS system, and you
have a Customer Service Gateway (CSG) node within your network,
it is recommended you choose the CSG options during installation.

If you have not yet moved to the PRS system, but will be in the future, 
you may de-install and re-install (choosing the CSG options), at
that time. 



Overview
========

The Crash Analysis Data Collector (CADC) may be installed by 
Compaq customers who have DSNLink or PRS installed.   It consists 
of a set of script files that work together to send a crash file,
generated by the crashdc routine, back to Compaq for analysis.
A service call is also logged, with the time of the crash and the 
name of the crash file generated.  When the crash file is received
at Compaq, it is compared to other crashes for similarities.  
If the comparison turns up a know solution, the support person can
contact the customer with the actions to take to effect a 
remedy.


Installation
============
De-install any previous versions of CADCUNIX before installing
this kit.  setld will tell you if CADCUNIX is currently installed:
  /usr/sbin/setld -i


Once the kit has been down-loaded and expanded, it may be installed 
with the setld command. The kits contains the following files:

CADCUNIX     - The main processing script.

cadc-unix    - Start up script called during re-boot.

fakedc       - Script that creates a fake crash file used during the
               installation verification step. 

history      - History file of previous events.

lastcrashsent - Used to see if the current crash has 
                previously been processed.  Date comparisones
                are performed to ensure a crash file is only processed
                once.

enp          - An executable program that interfaces with the CSG

csg_notify_event    - A shell script that calls the enp executable

cadcunix_mailserver - Converts CADCUNIX mail message to 
                      DSNLink service request.


All of these files reside in /usr/opt/CADCUNIX after installation is complete.




Running setld
-------------

To run the setld command, you will need to have root privileges.
The command can be invoked by entering:

   /usr/sbin/setld -l [path to kit, or '.' if the current directory] CADCUNIX300

   example:  /usr/sbin/setld -l . CADCUNIX300



The kit contains verification steps which may be invoked after installation.

Use the "-v" option of setld to run installation verification.
   /usr/sbin/setld -v CADCUNIX300


The setld command moves the script files to /usr/opt/CADCUNIX, and creates the links
to run them during start-up.   CADC keeps track of the crash files it has processed.
It will only forward new crashes to the support center.

