December 4, 2002

Dear DECevent Customer,

Customers who use the external notification feature of DECevent V3.4 could use 
transport services of DSNLink or WorldWire to automatically report the event to 
the Customer Support Centers.   
 
DSNLink is in the process of being retired and will require system administrators 
to use WorldWire.  This causes concern because DECevent users will now be 
required to install WorldWire on every system that uses SICL notification. 

A new service is now provided where customers can use to report service events 
through Proactive Remote Services (PRS) thus eliminating the need to install 
WorldWire on every system.

With PRS, a single gateway server known as the Customer Service Gateway 
(CSG) is defined.  DECevent can now route calls to the CSG. This is made 
possible by installing a new notification script file and an Event Notification 
Program (an extremely small executable) on each system that uses DECevent.  
Once registered and DECevent encounters a reportable event, DECevent will 
invoke the external notification script which in turn will call the Event Notification 
Program. The Event Notification Program will post the request to the CSG server.

Customers who wish to use this service will be required to:
	> Run DECevent V3.4 
	> Define a Customer Service Gateway server
	> Install a new script and executable
	> Register the new external notification script with DECevent

Installation instructions are provided for both Unix and OpenVMS (both VAX and 
ALPHA architectures).

Sincerely,
 
HP Services Tool Engineering



OpenVMS DECevent Install Instructions
=====================================

Log in as manager and execute the following steps: 

1.	Extract kit contents by executing the following commanda:

        For Alpha systems:

		$ RUN DECEVENT_ENP_ALPHA.EXE
		$ BACKUP DECEVENT_ENP_ALPHA.BCK/SAVE_SET *

	For VAX systems:

		$ RUN DECEVENT_ENP_VAX.EXE
		$ BACKUP DECEVENT_ENP_VAX.BCK/SAVE_SET *
	

	Copy the following files to the appropriate directories (*) . 

	File 		Target directory	Comment
	----		----------------	-------
	ENP.EXE		SYS$SYSTEM 		Event Notification Program.
	CSGNOTIFY.COM	SYS$MANAGER		DECevent external notification
						script.


	Example:	$ COPY /LOG ENP.EXE SYS$SYSTEM:  
			$ COPY /LOG CSGNOTIFY.COM SYS$MANAGER:


2.	In your system startup file define the following logical names: 
 
	$ DEFINE/SYSTEM/EXEC CS_GATEWAY$NODE  "<CSG-Server>" 
	$ DEFINE/SYSTEM/EXEC CS_GATEWAY$NOTIFY SYS$MANAGER:CSGNOTIFY.COM
 
	Where <CSG-Server> is the fully qualified name of the Customer Service 
	Gateway node. 

	Example:  $DEFINE/SYSTEM/EXEC  CS_GATEWAY$NODE "sharon.cxo.mycorp.com" 

3.	Additionally if the port of the Customer Service Gateway is other than 2069
	then also define the following logical name within the startup file. 
 
	$ DEFINE/SYSTEM/ECEC CS_GATEWAY$PORT "<Port-Number>" 

4.	Invoke DECevent and remove the wwnotify script and register the new 
	csgnotify script 
 
	Example:	$ dia /int
				! shows external registered scripts
			dia>show external 
				! remove the world-wire notify script 
			dia>remove external <logical> customer
				!add the new script  
			dia>add external  cs_gateway$notify customer 
			dia>exit

	NOTE:  To remove the previously registered Worldwire notification script
	may require the user to use another window to translate the logical names
	that are registered.  Remove the logical that translates to the file 
	"wwnotify.com". To translate a logical use the command "SHOW LOGICAL
	logical-name"


5.	Create the customer profile file. Refer to the section below entitled 
	"DECEvent Profile Creation and Configuration"

6.	Verify that script was installed and test script by invoking DECevent
	Test command.
 
	Example:	$ dia show external    ! shows external registered scripts
			$ dia test external  customer   ! tests script file 
 
	From a web browser type in the following URL   
	http://<CSG_SERVER>:2069/default.htm 
	where CSG_SERVER is the fully qualified name of the Customer Service 
	Gateway server and then select"NOTIFICATIONS" from the menu pane. You
	should see a notification event generated by DECevent.

(*)	If operating in a clustered environment and you want one copy then copy
	executable file  to SYS$COMMON:[SYSEXE] and com procedure to 
	SYS$COMMON:[SYSMGR]


Tru64 UNIX DECevent Install Instructions:
=========================================

Log in as super user, and execute the following steps:

1.	Extract kit contents by executing the following command:

        tar -xvf DECevent_ENP.tar	


	Copy the following files to the appropriate directories. 

	File 		Target directory	Comment
	----		----------------	-------
	enp		/usr/bin		Event Notification Program
	enp.config	/etc			Configuration file
	csgnotify	/usr/opt/DIA340/sbin	Script notification file.


	Example:  	# cp enp /usr/bin 
                        # cp enp.config  /etc
                        # cp csgnotify /usr/opt/DIA340/sbin 

2.	Change permission code on executable and script files. 
 
	Example:	# chmod +x /usr/bin/enp
        	     	# chmod +x /usr/opt/DIA340/sbin/csgnotify 

3.	Edit the enp.config file. The file contains two environmental variables.
	Set CSG_SERVER variable to the fully qualified name of the Customer 
	Service Gateway server. Additionally, if the port number of the CSG_SERVER
	is other than 2069 set PORT variable to the correct port number. 
 
	Example:	CSG_SERVER=sharon.cxo.mycorp.com
			PORT=2557 

4.	Invoke DECevent and remove the wwnotify script and register the new 
	csgnotify script 
 
	Example:	# /usr/sbin/dia -int
				! shows external registered scripts 
			dia>shw ext 
				! remove the world-wire script     
                        dia>rm ext -f /usr/opt/DIA340/sbin/wwnotify -l customer
				! add new script   
                        dia>ad ext -f /usr/opt/DIA340/sbin/csgnotify -l customer   
                    	dia>exit 

5.      Verify the existence of the file /usr/opt/DIA340/tmp/WWNotify_SysInfo.txt
        If this file does not exist, type the following command to create it.

	# /usr/sbin/diasetup

	Note: diasetup must be executed on each node of a cluster
              to ensure the proper reporting of node-specific information
              when event notification occurs.        

6.	Create the customer profile file. Refer to the section below entitled 
	"DECEvent Profile Creation and Configuration"


7.	Verify that script was installed and Test script by invoking DECevent 
	test command. 
 
	Example:	
				! shows external registered scripts
			# /usr/sbin/dia shw ext
				! tests script file			
			# /usr/sbin/dia tst -e customer		
 
	From a web browser type in the following URL   
	http://<CSG_SERVER>:2069/default.htm 
	where CSG_SERVER is the fully qualified name of the Customer Service 
	Gateway server and then select "NOTIFICATIONS" from the menu pane. You 
	should see a notification event generated by DECevent.





DECEvent Profile Creation and Configuration
===========================================	

	The notification described above works best when a customer profile has been
	defined. The profile is a text file that contains system information along 
	with the 
	names and phone numbers of contacts that should be notified when the 
	Customer Service Center receives a SICL message from DECevent. If the 
	system does not already have a profile file, create a text file with 
	the following contents to use as a profile:


	Customer: 
	Address: 
	System Type: 
	Serial number: 
	Primary Contact: 
	Secondary Contact: 
	Phone number (s): 	
	Special Instructions: 

	Configuration Information: 
	System:           Model: 
	System S/N:       System name: 
	System IP address: 

	<any other configuration information> 


Profile Configuration for UNIX
============================== 

1.	 Copy the text file containing the customer profile to: 
	/var/DIA/FMGPROFILE 


2.	Ensure the DECevent system setting (FMG__CUST_PROFILE) contains the correct 
	path and filename: 

	# dia shw set FMG__CUST_PROFILE 

	# dia -int 
	dia> sets FMG__CUST_PROFILE /var/DIA/FMGPROFILE 
	dia> sav sys 
	dia> exit 



Profile Configuration for VMS
=============================  


1.	Edit the DECevent startup file (SYS$STARTUP:DECEVENT$STARTUP.COM) to define a 
	logical name identifying your profile: 

	$ define/sys/exec FMGPROFILE DISK:[PATH]YOUR_FILENAME.TXT 


	Where DISK:[PATH]YOUR_FILENAME.TXT is the full path and filename of your profile. 
	




