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;hb=refs/heads/stable/oxygen
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-oxygen
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;hb=refs/heads/stable/oxygen
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-oxygen
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;hb=refs/heads/stable/oxygen
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-oxygen
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;hb=refs/heads/stable/oxygen
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-oxygen
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`
78 * CSIT job: https://jenkins.opendaylight.org/releng/job/distribution-csit-1node-userfeatures-all-oxygen
79 * No additional manual testing was needed.
84 * Version feature works exactly the same as in Nitrogen.
85 After migration the versions are set to the new default, configurable in runtime or via configfile.
90 * Version feature works exactly the same as in Nitrogen.
91 * Test features change every release but these are only intended for distribution test.
96 * `INTDIST-92 <https://jira.opendaylight.org/browse/INTDIST-92>`_
98 ** odl-distribution-version contains list of bundles instead of nice feature dependency.
100 * `ODLPARENT-142 <https://jira.opendaylight.org/browse/ODLPARENT-142>`_
102 ** Karaf-plugin packages mysql-connector-java.
107 * `ODLPARENT-110 <https://jira.opendaylight.org/browse/ODLPARENT-110>`_
109 ** Successive feature installation from karaf4 console causes bundles refresh.
113 * Use --no-auto-refresh option in the karaf feature install command.
117 feature:install --no-auto-refresh odl-netconf-topology
119 * List all the features you need in the karaf config boot file.
120 * Install all features at once in console, for example:
124 feature:install odl-restconf odl-netconf-mdsal odl-mdsal-apidocs odl-clustering-test-app odl-netconf-topology
126 * `ODLPARENT-113 <https://jira.opendaylight.org/browse/ODLPARENT-113>`_
128 ** The ssh-dss method is used by Karaf SSH console, but no longer supported by clients such as OpenSSH.
132 * Use the bin/client script, which uses karaf:karaf as the default credentials.
133 * Use this ssh option:
137 ssh -oHostKeyAlgorithms=+ssh-dss -p 8101 karaf@localhost
139 ** After restart, Karaf is unable to re-use the generated host.key file.
141 *** **Workaround:** Delete the etc/host.key file before starting Karaf again.
146 * Version feature is deprecated and will be removed in Flourine release.
151 No standard implemented directly (see upstream projects).
156 * `Release plan <https://wiki.opendaylight.org/view/Integration/Distribution/Oxygen_Release_Plan>`_