Integration/Distribution

Major Features

odl-integration-all

  • Gitweb URL: Integration

  • Description: An aggregate feature grouping Managed projects user facing ODL features. This feature is used to verify all user features can be installed together without Karaf becoming unusable or without port conflicts.

  • Top Level: Yes.

  • User Facing: Yes, but not intended for production use (only for testing purposes).

  • Experimental: No.

  • CSIT Test: CSIT

odl-integration-compatible-with-all

  • Gitweb URL: Compatibility

  • Description: An aggregate feature grouping Managed projects user facing ODL features that are not pro-active and which (as a group) should be compatible with most other ODL features. This feature is used in CSIT multi-project feature test (-all- CSIT job).

  • Top Level: Yes.

  • User Facing: Yes, but not intended for production use (only for testing purposes).

  • Experimental: No.

  • CSIT Test: CSIT

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

  • Karaf 4 exposes ssh console on port 8101. The security is basically the same as in upstream Karaf of corresponding versions, except library version overrides implemented in odlparent:karaf-parent. See Securing the Karaf container.

Quality Assurance

Migration

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

Compatibility

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

Bugs Fixed

No significant bugs were fixed 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.

End-of-life

  • List of features/APIs that were EOLed, deprecated, and/or removed from this release.

    • None

Standards

No standard implemented directly (see upstream projects).

Release Mechanics

See Managed Release