Distribution

Overview

The Distribution project is the placeholder for the ODL karaf distribution. The project currently generates 2 artifacts:

  • The Managed distribution (e.g. karaf-<version>.tar.gz): This includes the Managed projects in OpenDaylight (See Managed Release).

  • The Common distribution (e.g. opendaylight-<version>.tar.gz): This includes Managed and Self-Managed projects (See Managed Release).

The distribution project is also the placeholder for the distribution scripts. Example of these scripts:

Major Features

Managed Distribution Archive

  • Gitweb URL: Managed Archive

  • Description: Zip or tar.gz; when extracted, a self-consistent ODL installation with Managed projects is created.

  • Top Level: Yes.

  • User Facing: Yes.

  • Experimental: No.

  • CSIT Test: CSIT

Full Distribution Archive

  • Gitweb URL: Distribution Archive

  • Description: Zip or tar.gz; when extracted, a self-consistent ODL installation with all projects is created.

  • Top Level: Yes.

  • User Facing: Yes.

  • Experimental: No.

  • CSIT Test: CSIT

Documentation

Security Considerations

  • CSIT job

  • No additional manual testing was needed.

Migration

Every distribution major release comes with new and deprecated project features, as well as new Karaf version. Because of this it is recommend to perform a new ODL installation.

Compatibility

Test features change every release, but these are only intended for distribution test.

Bugs Fixed

No issues were resolved in this release.

Known Issues

  • ODLPARENT-110

    Successive feature installation from karaf4 console causes bundles refresh.

    Workaround:

    • Use –no-auto-refresh option in the karaf feature install command.

      feature:install --no-auto-refresh odl-netconf-topology
      
    • List all the features you need in the karaf config boot file.

    • Install all features at once in console, for example:

      feature:install odl-restconf odl-netconf-mdsal odl-mdsal-apidocs odl-clustering-test-app odl-netconf-topology
      
  • ODLPARENT-113

    The ssh-dss method is used by Karaf SSH console, but no longer supported by clients such as OpenSSH.

    Workaround:

    • Use the bin/client script, which uses karaf:karaf as the default credentials.

    • Use this ssh option:

      ssh -oHostKeyAlgorithms=+ssh-dss -p 8101 karaf@localhost
      

    After restart, Karaf is unable to re-use the generated host.key file.

    Workaround: Delete the etc/host.key file before starting Karaf again.

Standards

No standard implemented directly (see upstream projects).

Release Mechanics