1 ========================
2 Integration/Distribution
3 ========================
11 * **Gitweb URL:** https://git.opendaylight.org/gerrit/gitweb?p=integration/distribution.git;a=blob;f=features/singles/odl-integration-all/pom.xml;h=c3df09e8828ff16299d96f82e78b1901de1a60ca;hb=refs/heads/stable/nitrogen
12 * **Description:** An aggregate feature grouping all user-facing ODL features
13 which can be installed together without Karaf becoming unusable or without port conflicts.
15 * **User Facing:** Yes, but not intended for production use (only for testing purposes).
16 * **Experimental:** No.
17 * **CSIT Test:** https://jenkins.opendaylight.org/releng/job/distribution-deploy-nitrogen
19 odl-integration-compatible-with-all
20 -----------------------------------
22 * **Gitweb URL:** https://git.opendaylight.org/gerrit/gitweb?p=integration/distribution.git;a=blob;f=features/singles/odl-integration-compatible-with-all/pom.xml;h=5ddd52a15cdc658ed18f4647469666b8c849cf4c;hb=refs/heads/stable/nitrogen
23 * **Description:** An aggregate feature grouping all user-facing ODL features
24 which are not pro-active and which (as a group) should be compatible with most other ODL features.
26 * **User Facing:** Yes, but not intended for production use (only for testing purposes).
27 * **Experimental:** No.
28 * **CSIT Test:** https://jenkins.opendaylight.org/releng/job/distribution-csit-1node-userfeatures-all-nitrogen
30 odl-distribution-version
31 ------------------------
33 * **Gitweb URL:** https://git.opendaylight.org/gerrit/gitweb?p=integration/distribution.git;a=blob;f=features/singles/odl-distribution-version/pom.xml;h=b504cbeb6889379492d33322f1c5cfa488a207a4;hb=refs/heads/stable/nitrogen
34 * **Description:** Allows NETCONF/RESTCONF users to determine the version of ODL they are communicating with.
36 * **User Facing:** Yes.
37 * **Experimental:** No.
38 * **CSIT Test:** https://jenkins.opendaylight.org/releng/job/distribution-csit-1node-userfeatures-all-nitrogen
40 Karaf 4 distribution archive
41 ----------------------------
42 * **Gitweb URL:** https://git.opendaylight.org/gerrit/gitweb?p=integration/distribution.git;a=blob;f=karaf/pom.xml;h=082fd09a2467e02e4303f8a5ce0bd42b48ad0267;hb=refs/heads/stable/nitrogen
43 * **Description:** Zip or tar.gz; when extracted, a self-consistent ODL installation is created.
45 * **User Facing:** Yes.
46 * **Experimental:** No.
47 * **CSIT Test:** https://jenkins.opendaylight.org/releng/job/distribution-deploy-nitrogen
52 * **Getting Started Guide**
54 * :ref:`Clustering scripts <getting-started-clustering-scripts>`
55 * :ref:`Distribution version <getting-started-opendaylight-version>`
59 * :ref:`Distribution version <user-guide-dist-version>`
63 * :ref:`Test features <developer-guide-dist-test-features>`
64 * :ref:`Distribution version <developer-guide-dist-version>`
66 Security Considerations
67 =======================
69 * Karaf 4 exposes ssh console on port 8101.
70 The security basically basically the same as in upstream Karaf of corresponding versions,
71 except library version overrides implemented in odlparent:karaf-parent.
73 See :ref:`securing-karaf`
75 There is `Bug 9044 <https://bugs.opendaylight.org/show_bug.cgi?id=9044>` which limits
76 accessibility of karaf console over SSH after restart.
78 * `Sonar Report <https://sonar.opendaylight.org/overview?id=61911>`_ (0%)
80 * Only 42 lines of java `code <https://git.opendaylight.org/gerrit/gitweb?p=integration/distribution.git;a=tree;f=version/src/main/java/org/opendaylight/yang/gen/v1/urn/opendaylight/params/xml/ns/yang/integration/distribution/version/rev160316;h=517b2d5a2e726b77360389a20ad8cd8b1a0a6a46;hb=refs/heads/stable/nitrogen>`_.
82 * `Test report page <https://wiki.opendaylight.org/view/Integration/Distribution/Nitrogen_Test_Report>`_
84 * No additional manual testing was needed.
89 * Version feature works exactly the same as in Carbon.
90 After migration the versions are set to the new default, configurable in runtime or via configfile.
91 The Carbon configfile would work, but users are strongly advised to consider reporting the migrated versions.
92 * No upgrade path for other major features.
97 * Multiple API changes, as Nitrogen is Karaf 4 while Carbon was Karaf 3.
98 * Even odl-distribution-version depends on different version of Config Subsystem.
99 * Only cluster configuration scripts remained compatible.
104 None since Carbon SR1 release.
109 * `Bug 9044 <https://bugs.opendaylight.org/show_bug.cgi?id=9044>`_
111 ** The ssh-dss method is used by Karaf SSH console, but no longer supported by clients such as OpenSSH.
113 *** **Workaround:** Use the bin/client script, which uses karaf:karaf as the default credentials.
115 ** After restart, Karaf is unable to re-use the generated host.key file.
117 *** **Workaround** Delete the etc/host.key file before starting Karaf again.
119 * `Bug 9161 <https://bugs.opendaylight.org/show_bug.cgi?id=9161>`_
121 ** Karaf is slow to start processing features after start.
123 *** **Workaround:** Use a wait loop to continue only when OpenDaylight starts restonding correctly
124 to requests to the desired northbound interface.
125 If no OpenDaylight feature is installed, use bin/client in the wait loop
126 until Karaf SSH console starts responding.
131 * All APIs and functionalities related to Karaf 3 were removed.
132 Only Karaf 4 (or higher) will be supported from now on.
137 No standard implemented directly (see upstream projects).
142 * `Release plan <https://wiki.opendaylight.org/view/Integration/Distribution/Nitrogen_Release_Plan>`_
144 * Major shifts in release schedule
146 * Upstream OpenDaylight projects were slow to controbute their Karaf 4 features and debug them when needed.
147 * While project deliverables were relatively on time, wiki updates were late,
148 and documentation and milestone report were extremely late.