Hi Recently I was assigned a task of analyzing DMaaP and its external dependencies among other things. It was found that DMaaP (and as I understand it, some other ONAP subsystems as well) depend on a number of legacy dependencies under AT&T namespace. The issue is, that most AT&T Github repositories that were presumably supposed to contain the source codes are currently throwing a 404 error when accessing them. This issue does not appear to have been yet acknowledged by the community, and it would be important to do so.
The situation is quite problematic, as there does not appear to be any documentation on these packages available anywhere either. These dependencies were apparently internal AT&T projects originally and then later released as open source, which explains why very little public information is available on them. The little information about these packages I've been able to collect has been comprised of archive.org snapshots, scattered mentions on ONAP documentation and mailing lists, some disorganized AT&T or other unofficial repositories still available, limited number of sources.jar packages in Maven repositories, DMaaP code and Maven pom file analysis, and decompiled sources. We did consider the chance that perhaps these repositories could have been moved or renamed, but exhaustive searches have so far come empty. If they do still exist somewhere online, they have been well hidden. In the case of DMaaP Message Router, these dependencies were: *AT&T Java Service Container Framework (com.att.ajsc) * A Spring based framework on top of which DMaaP was apparently designed to run. It is at least being used for some configuration management purposes, but we are not sure what the exact capabilities of the AJSC are and which are actively used. Unavailable: https://github.com/att/AJSC/ Snapshot: https://web.archive.org/web/20180627155358/https://github.com/att/AJSC/ *Network Service Assurance Library (com.att.nsa) * NSA appears to contain a large number of miscellaneous utilities. We are not sure where the "definitive" source repository was supposed to exist, and the package appears in multiple abandoned AT&T repositories with differing sets of sub-packages inside the namespace. Available(partially): https://github.com/att/dmaap-framework/tree/master/CambriaClient/satoolkit/src/main/java/com/att/nsa Available(partially): https://github.com/att/NSASERVER *Direct Messaging Engine (com.att.aft.dme2) * It is my understanding that a large number of DME references and related configuration options in DMaaP are not actually being used and could even be cleaned from the repositories. Unavailable: https://github.com/att/DME Snapshot: https://web.archive.org/web/20180627185025/https://github.com/att/DME Unofficial(?): https://github.com/sv8675/DME-1 * Event and Error Logging Framework (com.att.eelf) * EELF is probably not a major issue, as it seems to be used mainly for simple logging purposes, but it is included here anyway. Unavailable: https://github.com/att/EELF Snapshot: https://web.archive.org/web/20180612210618/https://github.com/att/EELF *Some of the raised questions were: * 1. Is this truly the case that these source repositories on top of which DMaaP is built are no longer available anywhere? 2. Has there ever been proper documentation publicly available on these packages? 3. Could we reaffirm if the removal of these AT&T repositories was intentional (or possibly accidental)? 4. Would it be realistic to work towards: a. Reacquiring access to these sources? b. Attempting to include and them into ONAP project? (where possible) c. Attempting to refactor the dependencies out? (where possible) d. Producing at least some documentation on these dependencies? Thank you. -=-=-=-=-=-=-=-=-=-=-=- Links: You receive all messages sent to this group. View/Reply Online (#18393): https://lists.onap.org/g/onap-discuss/message/18393 Mute This Topic: https://lists.onap.org/mt/32681819/21656 Mute #dmaap: https://lists.onap.org/mk?hashtag=dmaap&subid=2740164 Mute #documentation: https://lists.onap.org/mk?hashtag=documentation&subid=2740164 Group Owner: [email protected] Unsubscribe: https://lists.onap.org/g/onap-discuss/unsub [[email protected]] -=-=-=-=-=-=-=-=-=-=-=-
