Development
Overview
Background
The MPS History (MpsHist) is a software system for storing MPS History Messages in an RDB.
Thesaurus
- LP: link processor
Requirements
Use Cases
- User must figure out what's going on with MPS (performance statistics).
- Author: snorum
- Reason: Our mission.
- User must search and do analysis on messages.
- Author: snorum
- Reason: For diagnostics.
- User must be able to register with LP over UDP at 0.2 Hz.
- Author: snorum
- Reason: Zero configuration, dynamic change.
- User must switch from one MpsHist to another.
- Author: snorum
- Reason: Prevent loss of messages.
- User must be able to access all info messages.
- Author: snorum
- Reason: diagnostics
- User must be able to specify path to ConfigDB.
- Author: snorum
- Reason: changes in the hardware.
Functional Specification
- MpsHS must capture all messages.
- Origin: Use Case #1
- How to test: All accepted messages must be in the database.
- MpsHS must write all messages to RDB.
- Origin: Use Case #2
- How to test: All accepted messages must be in the database.
- MpsHs must send notification messages to LP at a rate of 0.2 Hz.
- Origin: Use Case #3
- How to test: Get messages from LP.
- One must be able to run several copies of MpsHS.
- Origin: Use Case #4
- How to test: Have 2 of them running.
- MpsHS must log all info messages.
- Origin: Use Case #5
- How to test: Look at the log.
- MpsHS must accept the path to ConfigDB as a command-line parameter.
- Origin: Use Case #6
- How to test: Finds ConfigDB as specified through command-line.
Constraints
- Messages are streamed at up to 1MB/sec.
- MpsHS must support Oracle RDB.
- LP is a time-critical VME IOC (2.8 msecs).
- LP might not be busy for a while, so no timeouts must be introduced.
- Connect only to 1 MpsHist at a time.
Design
- Use WaitFreeWriteQueue for repository.
- Send a datagram to a host name of LP on port 30000.
- 2 byte header: protocol version 1, message type: notification 2
- 2 bytes for port number
- Java server port from 30001 - 30009
Comments
- Open to possibility of sending messages directly from LP to RDB.
User's Guide
Programmer's Guide
References
Administration
Task lists and schedules, spreadsheets etc.