Updated git submodules
[docs.git] / docs / getting-started-guide / project-release-notes / alto.rst
1 =============================================
2 Application-Layer Traffic Optimization (ALTO)
3 =============================================
4
5 odl-alto-release
6 ----------------
7
8 * **Feature URL:** https://git.opendaylight.org/gerrit/gitweb?p=alto.git;a=blob;f=alto-release-features/features-alto/pom.xml;hb=refs/heads/stable/nitrogen
9 * **Feature Description:**  This is a summary feature containing the default
10   functionalities provided by ALTO project.
11 * **Top Level:** Yes
12 * **User Facing:** Yes
13 * **Experimental:** Yes
14 * **CSIT Test:** https://jenkins.opendaylight.org/releng/view/alto/job/alto-csit-1node-setup-all-nitrogen/
15
16 Documentation
17 =============
18
19 * **User Guide(s):**
20
21   * :ref:`ALTO User Guide <alto-user-guide>`
22
23 * **Developer Guide(s):**
24
25   * :ref:`ALTO Developer Guide <alto-developer-guide>`
26
27 Security Considerations
28 =======================
29
30 Besides RESTCONF, ALTO also uses customized Jetty interfaces because YANG model
31 is not compatible with formats specified in RFC 7285.
32
33 The customized interfaces use port 8080 and are NOT protected by the AAA
34 project. All resources exposed by customized interfaces are read-only.
35
36 Quality Assurance
37 =================
38
39 * `Link to Sonar Report <https://sonar.opendaylight.org/overview?id=50636>`_ 31.7%
40 * `Link to CSIT Jobs <https://jenkins.opendaylight.org/releng/view/alto/job/alto-csit-1node-setup-all-nitrogen/>`_
41 * The tests are using the OpenDaylight CSIT infrastructure.
42
43   * How extensive was it? Not very extensive since the tests are customized to
44     test certain functionalities.
45   * What should be expected to work? The core modules (northbound and
46     resourcepool) and also some basic components (simple-ird)
47   * What has not be tested as much? Some basic components (simple-ecs and spce)
48     and extended components (multicost, incremental update and RSA service).
49
50 Migration
51 ---------
52
53 Migration with data from Boron isn't supported.
54
55 Compatibility
56 -------------
57
58 This release is not compatible with the previous release from the developer's
59 point of view because we have changed the namespaces for most YANG models, which
60 involves both API changes and configuration changes (blueprint configuration
61 files).
62
63 Java projects using the ALTO classes generated by yangtools MUST change the
64 packages for the classes because of the namespace migration. The incompatibility
65 can be fixed using regex replacement.
66
67 Projects using RESTCONF or the customized ALTO service do not need to migrate.
68
69 Since ALTO is migrating services to Blueprint, services depending on ALTO may
70 also need to migrate to Blueprint instead of using CONFIG subsystem.
71
72 Bugs Fixed
73 ----------
74
75 * `Fixed Bugs <https://bugs.opendaylight.org/buglist.cgi?bug_status=RESOLVED&chfield=%5BBug%20creation%5D&chfieldfrom=2017-05-25&chfieldto=2017-08-14&list_id=84715&product=alto&query_format=advanced&resolution=FIXED>`_
76
77 Known Issues
78 ------------
79
80 Parallel query for simple-ecs service can conduct failure.
81
82 * `Bug 8826 <https://bugs.opendaylight.org/show_bug.cgi?id=8826>`_
83
84 End-of-life
85 ===========
86
87 * Nothing deprecated, EOL.
88
89 Standards
90 =========
91
92 * ALTO protocols are not compatible with YANG model
93 * Message types for RFC 7285 have been implemented
94 * ALTO project provides several basic services in RFC 7285
95 * Work-in-progress Internet drafts for path-vector, multi-cost, incremental
96   updates and RSA service are also scheduled but not fully implemented.
97
98 Release Mechanics
99 =================
100
101 * `Link to release plan <https://wiki.opendaylight.org/view/ALTO:Nitrogen_Release_Plan>`_
102 * Major shifts:
103
104   * Unable to finish the extensions (path-vector and RSA service)