# Presentation: 207447

## Network Control Center (NCC) Central Delogger (NCD) Design Review

- Network Control Center (NCC) Central Delogger (NCD) Design Review

- June 30, 1997

**Notes:**
June 30, 1997
1
NCD Design Review

## Agenda

- 2

- NCD Design Review

- Introduction
- Overview
- Functional Capabilities
- Development Approach
- GUI and Output Reports
- Summary

- Jason Garris
- Jason Garris
- Cindy Cacace
- Cindy Cacace
- Cindy Cacace
- Jason Garris

**Notes:**
June 30, 1997
2
NCD Design Review

## IntroductionJason Garris

- 3

- NCD Design Review

- IntroductionJason Garris

**Notes:**
June 30, 1997
3
NCD Design Review

## Purpose of Review

- 4

- NCD Design Review

- Present the high-level design for NCD
- Review functional capabilities
- Outline development approach
- Present GUI layout and output reports
- Review issues

**Notes:**
June 30, 1997
4
NCD Design Review

## Comments

- 5

- NCD Design Review

- No formal “RID” process
- Submit email comments to:
- Jason.Garris@gsfc.nasa.gov
- Please submit comments by COB 7/11/97

**Notes:**
June 30, 1997
5
NCD Design Review

## OverviewJason Garris

- 6

- NCD Design Review

- OverviewJason Garris

**Notes:**
June 30, 1997
6
NCD Design Review

## Purpose of the NCD

- 7

- NCD Design Review

- Provide a central, uniform, and efficient means to review log data from CCS, NPG, and SPSR
- Allow user to apply various filter criteria to extract the most relevant information
- Decrease time examining log files during test and problem resolution

**Notes:**
June 30, 1997
7
NCD Design Review

## Purpose of the NCD (cont.)

- 8

- NCD Design Review

- Promote common logging between segments
- Provide, at a minimum, the capabilities of current CCS delogger

**Notes:**
June 30, 1997
8
NCD Design Review

## Operational Scenario

- 9

- NCD Design Review

- User identifies log files to be delogged, and if necessary contacts the NSM operator to restore archived log files
- User invokes NCD from the toolbar and enters filter criteria
- Filter criteria, NCD support files, and log files are made available to the delog process

**Notes:**
June 30, 1997
9
NCD Design Review

## Operational Scenario, (cont.)

- 10

- NCD Design Review

- Multiple delog processes may run at a time, and if necessary, continue running after the user logs off the workstation
- Output is sent to a delog report file which the user can view and print
- User may check the status of or cancel executing delog processes

**Notes:**
June 30, 1997
10
NCD Design Review

## Conceptual Architecture

- 11

- NCD Design Review

- CCS

- NPG

- SPSR

- W/S

- NSM

- NCD

**Notes:**
June 30, 1997
11
NCD Design Review

## Context Diagram

- 12

- NCD Design Review

- Setup
- File

- Support
- Files

- Log
- Files

- Delog
- Report

**Notes:**
June 30, 1997
12
NCD Design Review

## Software Architecture

- 13

- NCD Design Review

- Log
- Files

- User Home
- Directory

- Setup File

- Setup  File

- Start/Stop Times

- Delog Report File

- Log Entries

**Notes:**
June 30, 1997
13
NCD Design Review

## Software Architecture

- 14

- NCD Design Review

- NCD processes are executed on demand
- GUI process located on each workstation
- Delog process located on server
- NFS mounted directories to workstation and server
- Segment log files directories
- NCD log file directory
- NCD user home directory

**Notes:**
June 30, 1997
14
NCD Design Review

## GUI Process

- 15

- NCD Design Review

- Manages windows displays
- Accepts user input
- Checks filter criteria for syntax, not data validation
- Retrieves/modifies/saves NCD setup file
- Opens the log files for reading

**Notes:**
June 30, 1997
15
NCD Design Review

## GUI Process (cont.)

- 16

- NCD Design Review

- Sends necessary information to delog process
- Filter criteria
- Appropriate log files names
- User preferences
- Display log file start/stop times
- Display executing delog processes
- Allow termination of executing delog processes

**Notes:**
June 30, 1997
16
NCD Design Review

## Delog Process

- 17

- NCD Design Review

- Reads NCD setup file
- Reads NCD support files
- Reads log file entries
- Parses log file entries
- Checks log file entries against filter criteria
- Formats and writes log entries that pass filter criteria to output report

**Notes:**
June 30, 1997
17
NCD Design Review

## Delog Process (cont.)

- 18

- NCD Design Review

- Closes the log files after reading
- User may execute multiple delog processes at a time
- Delogs will be executed as background processes
- User will be notified when each delog process is completed

**Notes:**
June 30, 1997
18
NCD Design Review

## Log File Format

- 19

- NCD Design Review

- Common log file format for all 3 segments
- Log entries stored in ascending chronological order
- Each log entry consists of 2 parts
- Fixed length log file header
- Variable length log entry data

**Notes:**
June 30, 1997
19
NCD Design Review

## Log File Header

- 20

- NCD Design Review

- Log time (YYYYDDDHHMMSSMMM)
- Process ID
- Length of log entry
- Log source (segment)
- I/O flag
- PEP
- IP address
- Protocol port

**Notes:**
June 30, 1997
20
NCD Design Review

## CCS Log Entry Types

- 21

- NCD Design Review

- NCC blocks
- Data exchanges
- Error messages and alerts

**Notes:**
June 30, 1997
21
NCD Design Review

## NPG Log Entry Types

- 22

- NCD Design Review

- NCC blocks
- NCC messages
- Process information
- Error messages and alerts

**Notes:**
June 30, 1997
22
NCD Design Review

## SPSR Log Entry Types

- 23

- NCD Design Review

- NCC messages
- Operator events
- Process information
- Error messages and alerts
- Note: database entries are _not_ logged

**Notes:**
June 30, 1997
23
NCD Design Review

## NCD Setup File

- 24

- NCD Design Review

- Contains filter criteria, user preferences, and other information used to create delog report
- Setup file can be saved and retrieved for subsequent delogs

**Notes:**
June 30, 1997
24
NCD Design Review

## NCD Support Files

- 25

- NCD Design Review

- Site configuration file
- Contains information for each site (i.e., octal code, mnemonic, IP address, user ID)
- Service offset file
- Contains information required to parse ODM services
- Valid message file
- Contains information for each NCC message (i.e., type/class, SIC/SUPIDEN location, TDRS name/ID location)

**Notes:**
June 30, 1997
25
NCD Design Review

## Functional CapabilitiesCindy Cacace

- 26

- NCD Design Review

- Functional CapabilitiesCindy Cacace

**Notes:**
June 30, 1997
26
NCD Design Review

## Functional Capabilities, Release 1

- 27

- NCD Design Review

- Basic graphical user interface (GUI)
- NCD Main Window
- NCD Filter Criteria Window containing text  boxes for user input of filter criteria
- Allow creation, modification, and execution of NCD setup file
- Displays log file start/stop times
- Displays executing delog processes
- Allows termination of executing delog processes

**Notes:**
June 30, 1997
27
NCD Design Review

## Capabilities, Release 1 (cont.)

- 28

- NCD Design Review

- Capability to open and read log files in ascending chronological order from the following 4 locations:
- CCS log file directory
- NPG log file directory
- SPSR log file directory
- NCD log file directory (contains log files restored via NSM)

**Notes:**
June 30, 1997
28
NCD Design Review

## Capabilities, Release 1 (cont.)

- 29

- NCD Design Review

- Read and process NCD support files
- Formatted output
- NCC blocks
- NCC messages
- CCS data exchanges
- Produce and print output reports:
- Summary:	one line profile of each log entry
- Detailed:	formatted output of each log entry

**Notes:**
June 30, 1997
29
NCD Design Review

## Capabilities, Release 1 (cont.)

- 30

- NCD Design Review

- Filter criteria
- Log entries may be included or excluded
- Amount and level of data input as filter criteria affects the granularity of filtering
- A log entry must meet the criteria in each field to pass the filter criteria
- Syntax checking, not data validation

**Notes:**
June 30, 1997
30
NCD Design Review

## Capabilities, Release 1 (cont.)

- 31

- NCD Design Review

- Universal filter criteria
- Log time (UTC)
- Segment (log source)
- Log entry type (process ID)

**Notes:**
June 30, 1997
31
NCD Design Review

## Capabilities, Release 1 (cont.)

- 32

- NCD Design Review

- Filter criteria for NCC block/message
- Message type/class
- Block type (byte 9 - NCC block)
- Source/destination (octal code)
- SIC/SUPIDEN
- TDRS ID/name
- String pattern at byte position

**Notes:**
June 30, 1997
32
NCD Design Review

## Capabilities, Release 1 (cont.)

- 33

- NCD Design Review

- Special case filter criteria for NCC block/message
- SN element         ⇒ source/destination code
- Any data field      ⇒ block pattern by byte position
- Operator console ⇒ not possible
- Operator position ⇒ not possible

**Notes:**
June 30, 1997
33
NCD Design Review

## Capabilities, Release 1 (cont.)

- 34

- NCD Design Review

- Filter criteria for CCS data exchanges
- Function type
- Command code/subcode
- Source/destination application
- String pattern at byte position

**Notes:**
June 30, 1997
34
NCD Design Review

## Functional Capabilities, Release 2

- 35

- NCD Design Review

- Enhanced filter criteria GUI
- Allow range input for select filter criteria fields
- Filter criteria input entered via option menus or text fields
- Capability to both include and exclude filter criteria data within a particular field

**Notes:**
June 30, 1997
35
NCD Design Review

## Capabilities, Release 2 (cont.)

- 36

- NCD Design Review

- Enhanced filter criteria for source/destination
- Enter octal code or mnemonic
- Additional filter criteria for NCC block/message
- TDRS service
- Service start & stop times
- Event start & stop times

**Notes:**
June 30, 1997
36
NCD Design Review

## Capabilities, Release 2 (cont.)

- 37

- NCD Design Review

- Filter criteria for NPG operator alerts/errors and process information
- Severity level
- Message ID
- Task name

**Notes:**
June 30, 1997
37
NCD Design Review

## Capabilities, Release 2 (cont.)

- 38

- NCD Design Review

- Filter criteria for SPSR operator alerts/errors, operator events, and process information
- Log message ID
- Local host
- Process ID (UNIX)
- Source file name
- Severity indicator
- NCD support files GUI
- Display/modify NCD support files

**Notes:**
June 30, 1997
38
NCD Design Review

## Capabilities, Release 2 (cont.)

- 39

- NCD Design Review

- Delog report viewer GUI
- Display completed delog reports
- Split-window display containing summary and detailed output reports
- NCD tools GUI
- Display log file start/stop times
- Display executing delog processes
- Allow termination of executing delog processes

**Notes:**
June 30, 1997
39
NCD Design Review

## Capabilities, Release 2 (cont.)

- 40

- NCD Design Review

- Formatted output for other log entry types
- NPG operator alerts/errors and process information
- SPSR operator alerts/errors, operator events, and process information
- NCD logging
- Record error messages and alerts in an NCD log       file that will be monitored by NSM for anomalies
- Online help

**Notes:**
June 30, 1997
40
NCD Design Review

## Potential Enhancements

- 41

- NCD Design Review

- Statistics
- NCC block extraction
- Block compare
- Alphanumeric field-by-field output report

**Notes:**
June 30, 1997
41
NCD Design Review

## Development ApproachCindy Cacace

- 42

- NCD Design Review

- Development ApproachCindy Cacace

**Notes:**
June 30, 1997
42
NCD Design Review

## Development Approach

- 43

- NCD Design Review

- Use object oriented design for all new GUI components [C++]
- Code reuse of existing NTS DART software for delog process [C]
- Use Builder Xcessory GUI design tool
- Consistency with the CCS and SPSR development teams

**Notes:**
June 30, 1997
43
NCD Design Review

## Development Approach (cont.)

- 44

- NCD Design Review

- Maintain effective communication with the CCS, NPG, NSM, and SPSR development teams
- Control changes through configuration management
- Provide demos for test and operational personnel
- Demonstrate GUI and capabilities
- Collect feedback
- Analyze and incorporate feedback accordingly

**Notes:**
June 30, 1997
44
NCD Design Review

## Development Environment

- 45

- NCD Design Review

- Hardware platform: HP 9000 series workstations
- Operating system: HP-UX, version 10.20
- Programming languages: C/C++
- GUI development: Builder Xcessory,   version 4.0

**Notes:**
June 30, 1997
45
NCD Design Review

## GUI and Output ReportsCindy Cacace

- 46

- NCD Design Review

- GUI and Output ReportsCindy Cacace

**Notes:**
June 30, 1997
46
NCD Design Review

## GUI Navigation

- 47

- NCD Design Review

- Toolbar

- NCD Status

- NCD Tools

- NCD Cancel

- NCD Tools

- Log File Times

- Detailed

- NCD Viewer

- Summary

- NCD Viewer

- Filter Criteria

- NCD Main

**Notes:**
June 30, 1997
47
NCD Design Review

## NCD Access

- 48

- NCD Design Review

- User can access the NCD via the toolbar
- Options from the toolbar
- NCD Main Window
- NCD Viewer Window
- NCD Tools Window

**Notes:**
June 30, 1997
48
NCD Design Review

## NCD Main Window

- 49

- NCD Design Review

- Retrieve/modify/save NCD setup file
- Execute delog process
- Enter filter criteria via the Filter Criteria Window
- View and print delog reports via NCD Viewer Window
- Access associated tools via the NCD Tools Window

**Notes:**
June 30, 1997
49
NCD Design Review

## NCD Viewer Window

- 50

- NCD Design Review

- Scrollable window to view delog reports
- Summary delog report
- Detailed delog report
- Both delog reports in a split-window with dynamic linking between log entries
- Print delog report

**Notes:**
June 30, 1997
50
NCD Design Review

## NCD Tools Window

- 51

- NCD Design Review

- Display log file start/stop times
- Display executing delog processes
- Allow termination of executing delog processes

**Notes:**
June 30, 1997
51
NCD Design Review

## Output Report Files

- 52

- NCD Design Review

- Contain input summary page detailing the information used to produce the reports
- Contain begin and end processing timestamps
- Read only and user-protected
- May be viewed using a text editor (release 1) or report viewer (release 2) and printed

**Notes:**
June 30, 1997
52
NCD Design Review

## Summary Display

- 53

- NCD Design Review

-                  UNIVERSAL                             NCC BLOCKS                    CCS DATA
- INDEX  YYYY:DDD:HH:MM:SS:MMM L PROC F LENTH  TT/CC SIT:OCT SUPIDEN TDR  MSGID   FT/CC/SCD SRCA/DESA
-    1  1997:238:15:23:48:555 N EXMG I   128  03/14 SGT:266             0012746
-    2  1997:238:15:23:49:555 C FELC I   128  99/01 SGT:266 M2008MS 041 0012748
-    3  1997:238:15:23:50:555 S OPEV O    64
-    4  1997:238:15:23:51:555 S EXMG O  1024  03/10 BRM:020  2008       0012750
-    5  1997:238:15:23:54:555 C FELC I  1660  05/   SGT:266 M2008MS  B  0012752
-    6  1997:238:15:23:54:755 S ALRT O   256
-    7  1997:238:15:23:55:555 S EXMG I   128  99/01 SGT:266 M2008MS 041 0012754
-    8  1997:238:15:23:56:555 N ALRT O    80
-    9  1997:238:15:23:57:555 C FELC I   128  99/01 WSC:371 M2008MS 041 0012758
-   10  1997:238:15:23:58:555 C ISLC O   112                                     05/01/123 ASSV/UTAS
-   11  1997:238:15:23:59:555 C FELC I   128  99/01 WSC:371 M2008MS 041 0012760
-   12  1997:238:15:24:00:555 S PINF O   144
-   13  1997:238:15:24:01:555 N EXBK I  1024  03/15 BRM:020  1294       0012762
-   14  1997:238:15:24:02:555 C ERRP O    64
-   15  1997:238:15:24:03:555 N PINF O   128

**Notes:**
June 30, 1997
53
NCD Design Review

## Detailed Log Entry Output Format

- 54

- NCD Design Review

- Universal information
- UTC
- Index number
- Segment
- Log entry type (Process ID)
- I/O flag
- Prominent fields
- Entire log entry data

**Notes:**
June 30, 1997
54
NCD Design Review

## Detailed NCC Block (CCS, NPG)

- 55

- NCD Design Review

- UTC: 1997:344:13:49:15:105    00005   NPG     EXBK    OUT
- MSG     SRC  DES    BLK   BLK   DATA    MSG   A|R|A|L  PEP   SUP/SIC  TDRS
- TY/CL    COD  COD    TYP  NUMBR  LNGTH   ID    R|B|E|B  COD    CODE     ID
- 03/14    217  371    360  01        23  1896   1 0 0 1   0      N/A     N/A
-    BYTES  1 - 14:  142166 047217 371313 027150 360162 004027 043311
-    BYTES 15 - 26:  051021 010000 377377 377377 060063 060060
- 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
- 030000001014Z9999ZZ.................................................................................
- ....................................................................................................
- ....................................................................................................
- ....................................................................................................
- ....................................................................................................
- ..........................................................................#

**Notes:**
June 30, 1997
55
NCD Design Review

## Detailed NCC Message (NPG, SPSR)

- 56

- NCD Design Review

- UTC: 1997:344:13:49:15:105    00005   SPSR    EXBK    INP
-  MSG   SRC  DES   DATA   NUM   TDRS
- TY/CL  COD  COD  LNGTH  SERV    ID
- 06/00  237  217    174    2      C
-              SERV     SUPT     SIC      SUPIDEN    VIC      SUPT
-              NUM      TYPE     CODE      CODE      CODE     SUBT
-                1        0      1120     A1120MS     01       N/A
-                2        1      1120     A1120MS     01       N/A
- 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
- 060009384 C00003600000091350164500020       0A1120MS01002-000-900-100021064062501251A1120MS011110259
- 99999991E11111031888888880E0008066067+011+0220500100-600021000441177100100#

**Notes:**
June 30, 1997
56
NCD Design Review

## Detailed CCS Data Exchange

- 57

- NCD Design Review

- UTC: 1997:241:12:23:40:000    00116    CCS     ISLC    OUT
- FUNC  COM     COM     SRC   DEST  SUBHDR    DATA
- TYPE  CODE  SUBCODE   APPL  APPL  LENGTH   LENGTH
-  5    22       0     ASSV  UTAS     0       112
- 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
- ....ASSV....UTAS........................5...   .....971521211041       B1294MS             971811211
-            #

**Notes:**
June 30, 1997
57
NCD Design Review

## Detailed NPG Operator Alert/Error

- 58

- NCD Design Review

- UTC:  1997:238:14:23:38:000    00001    NPG     ALRT    OUT
-      SEVERITY          MSG   TASK
-        LEVEL            ID   NAME
- EVENT_UNEXPECTED____   0505   UDPSiteProxy
- 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
- EVENT_UNEXPECTED____0505<UDPSiteProxy>Configuration error: unknown destination: 111.  Message droppe
- d.

**Notes:**
June 30, 1997
58
NCD Design Review

## Detailed NPG Process Information

- 59

- NCD Design Review

- UTC:  1997:238:14:23:40:000    00002    NPG      PINF   OUT
-      SEVERITY          MSG   TASK
-        LEVEL            ID   NAME
- EVENT_APP_ENTRY_____   0001   TCPServiceManager
- 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
- EVENT_APP_ENTRY_____0001<TCPServiceManager>NPG Application launched.

**Notes:**
June 30, 1997
59
NCD Design Review

## Detailed SPSR Operator Alert/Error

- 60

- NCD Design Review

- UTC: 1997:147:20:27:29:120    00001    SPSR    ALRT    INP
- DATA    PROT  MSG  LOCAL   PID   MSG  SOURCE  SOURCE
- LNGTH   PORT  ID   HOST          SEV   LINE   NAME
- 236   12345 1200  iste0   4563   I     483   IirvReceiptServer.cc
- 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
- 1200-Host:iste0:PID:4563:IirvReception::VectorMovedDueToEpoch-IirvReceiptServer.cc-483-20:27:29-I-Ep
- och time for newly stored transmission for SIC:1294 less than previously stored vectors in primary.
- Previous vectors moved to secondary

**Notes:**
June 30, 1997
60
NCD Design Review

## Detailed SPSR Operator Event

- 61

- NCD Design Review

- UTC: 1997:147:20:00:31:165    00002    SPSR    OPEV    INP
- DATA    PROT   MSG  LOCAL  PID   MSG  SOURCE  SOURCE
- LNGTH   PORT   ID   HOST         SEV   LINE   NAME
- 135   12345  1805  iste2  1524   I      16   Save-EditWindow.cc
- 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
- 1805-Host:iste2:PID:1524:Save-EditWindow.cc-268-20:00:16-I-Changes saved for ‘SGLT Resource Availabi
- lity’ by ‘op6’ at 05/27/97 20:00:16

**Notes:**
June 30, 1997
61
NCD Design Review

## Detailed SPSR Process Information

- 62

- NCD Design Review

- UTC: 1997:147:18:38:29:526    00003    SPSR    OPEV    INP
- DATA    PROT   MSG  LOCAL  PID    MSG  SOURCE  SOURCE
- LNGTH   PORT   ID   HOST          SEV   LINE   NAME
- 122   12345   100  iste0  2748    I     173   BatchBoundary.cc
- 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
- 100-Host:iste0:PID:2748:BatchBoundary-s::BatchBoundary.cc-173-18:38:29-I-Process BatchBoundary start
- ing up

**Notes:**
June 30, 1997
62
NCD Design Review

## SummaryJason Garris

- 63

- NCD Design Review

- SummaryJason Garris

**Notes:**
June 30, 1997
63
NCD Design Review

## Release 1 Schedule

- 64

- NCD Design Review

- Design
- Implementation
- Internal testing
- User’s manual
- Training materials
- Delivery to integration

- 05/12/97 - 06/27/97
- 06/30/97 - 09/19/97
- 09/22/97 - 10/03/97
- 10/06/97 - 10/17/97
- 10/13/97 - 10/17/97
- 10/17/97

**Notes:**
June 30, 1997
64
NCD Design Review

## Release 2 Schedule

- 65

- NCD Design Review

- Design
- Implementation
- Internal testing
- User’s manual
- Delivery to integration
- As-built documentation

- 10/20/97 - 11/28/97
- 12/01/97 - 02/19/98
- 02/20/98 - 03/12/98
- 03/13/98 - 03/31/98
- 04/01/98
- 04/02/98 - 04/30/98

**Notes:**
June 30, 1997
65
NCD Design Review

## NCD Related Documentation

- 66

- NCD Design Review

- System Requirements Document (SRD) for NCCDS 1998, sections 8.2.3 and 8.5
- NCD Operations Concept
- NCD Design Review presentation
- NCD User's Manual
- NCD As-Built System Documentation

**Notes:**
June 30, 1997
66
NCD Design Review

## Issues

- 67

- NCD Design Review

- NSM archive tapes containing log files - procedures to address security issues regarding movement of tapes containing  log files from operations (AIS level 3) to   the DT&T (AIS level 1)
- Print window - capability to be provided    by workstation toolbar or by NCD
- Close CCS, NPG, and SPSR log files - capability of NCD user to close the       active CCS, NPG, and SPSR log files

**Notes:**
June 30, 1997
67
NCD Design Review

## Comments

- 68

- NCD Design Review

- Submit email comments to:
- Jason.Garris@gsfc.nasa.gov
- Please submit comments by COB 7/11/97

**Notes:**
June 30, 1997
68
NCD Design Review