December 4, 2002 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 "" $ DEFINE/SYSTEM/EXEC CS_GATEWAY$NOTIFY SYS$MANAGER:CSGNOTIFY.COM Where 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 "" 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 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://: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://: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: 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.