| <!DOCTYPE html> |
| <html lang="en-us"> |
| |
| <head> |
| <meta charset="utf-8"> |
| <meta name="robots" content="all,follow"> |
| <meta name="googlebot" content="index,follow,snippet,archive"> |
| <meta name="viewport" content="width=device-width, initial-scale=1"> |
| <title>Frequently Asked Questions :: Eclipse Hono™</title> |
| <meta name="author" content="" /> |
| |
| |
| |
| |
| <meta name="description" content="A set of micro-services for connecting millions of devices."> |
| |
| |
| <meta name="generator" content="Hugo 0.54.0" /> |
| |
| <link href='//fonts.googleapis.com/css?family=Roboto:400,100,100italic,300,300italic,500,700,800' rel='stylesheet' type='text/css'> |
| |
| |
| <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.8.2/css/all.css" integrity="sha384-oS3vJWv+0UjzBfQzYUhtDYW+Pj2yciDJxpsK1OYPAYjqT085Qq/1cq5FLXAZQ7Ay" crossorigin="anonymous"> |
| <link rel="stylesheet" href="//maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous"> |
| |
| |
| <link href="/hono/css/animate.css" rel="stylesheet"> |
| |
| |
| |
| <link href="/hono/css/style.hono.css" rel="stylesheet" id="theme-stylesheet"> |
| |
| |
| |
| |
| <link href="/hono/css/custom.css" rel="stylesheet"> |
| |
| |
| |
| <!--[if lt IE 9]> |
| <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script> |
| <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script> |
| <![endif]--> |
| |
| |
| |
| <link rel="apple-touch-icon" sizes="180x180" href="/hono/favicon/apple-touch-icon.png"> |
| <link rel="icon" type="image/png" sizes="48x48" href="/hono/favicon/favicon-48x48.png"> |
| <link rel="icon" type="image/png" sizes="32x32" href="/hono/favicon/favicon-32x32.png"> |
| <link rel="icon" type="image/png" sizes="16x16" href="/hono/favicon/favicon-16x16.png"> |
| <link rel="manifest" href="/hono/favicon/site.webmanifest"> |
| <link rel="mask-icon" href="/hono/favicon/safari-pinned-tab.svg" color="#5bbad5"> |
| <link rel="shortcut icon" href="/hono/favicon/favicon.ico"> |
| <meta name="msapplication-TileColor" content="#da532c"> |
| <meta name="msapplication-config" content="/hono/favicon/browserconfig.xml"> |
| <meta name="theme-color" content="#ffffff"> |
| |
| |
| |
| <link href="/hono/css/owl.carousel.css" rel="stylesheet"> |
| <link href="/hono/css/owl.theme.css" rel="stylesheet"> |
| |
| <link rel="alternate" href="https://www.eclipse.org/hono//index.xml" type="application/rss+xml" title="Eclipse Hono&trade;"> |
| |
| |
| <meta name="twitter:card" content="summary_large_image"> |
| <meta name="twitter:site" content="@EclipseHono"> |
| <meta name="twitter:title" content="Frequently Asked Questions :: Eclipse Hono&trade;"> |
| <meta name="twitter:image" content="https://www.eclipse.org/hono/img/twitter_image.png"> |
| <meta name="twitter:description" content="A set of micro-services for connecting millions of devices."> |
| |
| |
| <meta property="og:title" content="Frequently Asked Questions :: Eclipse Hono&trade;" /> |
| <meta property="og:type" content="website" /> |
| <meta property="og:url" content="https://www.eclipse.org/hono/faq//" /> |
| <meta property="og:image" content="https://www.eclipse.org/hono/img/twitter_image.png" /> |
| |
| <link rel="stylesheet" href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/vendor/cookieconsent/cookieconsent.min.css"> |
| |
| </head> |
| |
| |
| <body> |
| |
| <div id="all"> |
| |
| <header> |
| |
| <div class="navbar-affixed-top" data-spy="affix" data-offset-top="70"> |
| |
| <div class="navbar navbar-default yamm" role="navigation" id="navbar"> |
| |
| <div class="container"> |
| <div class="navbar-header"> |
| <a class="navbar-brand home" href="https://www.eclipse.org/hono/"> |
| <img src="https://www.eclipse.org/hono/img/HONO-Logo_Bild-Wort_quer-s-310x120px.svg" alt="Frequently Asked Questions logo" class="logo"> |
| <span class="sr-only">Frequently Asked Questions - go to homepage</span> |
| </a> |
| <div class="navbar-buttons"> |
| <button type="button" class="navbar-toggle btn-template-main" data-toggle="collapse" data-target="#navigation"> |
| <span class="sr-only">Toggle Navigation</span> |
| <i class="fa fa-align-justify"></i> |
| </button> |
| </div> |
| </div> |
| |
| |
| <div class="navbar-collapse collapse" id="navigation"> |
| <ul class="nav navbar-nav navbar-right"> |
| |
| |
| |
| <li class="dropdown"> |
| |
| |
| |
| |
| <a href="/hono/getting-started/">Getting started</a> |
| |
| </li> |
| |
| |
| <li class="dropdown"> |
| |
| |
| |
| |
| <a href="/hono/docs">Documentation</a> |
| |
| </li> |
| |
| |
| <li class="dropdown"> |
| |
| |
| |
| |
| <a href="/hono/downloads/">Download</a> |
| |
| </li> |
| |
| |
| <li class="dropdown"> |
| |
| |
| |
| |
| <a href="/hono/sandbox/">Sandbox</a> |
| |
| </li> |
| |
| |
| <li class="dropdown active"> |
| |
| |
| |
| |
| <a href="/hono/faq/">FAQ</a> |
| |
| </li> |
| |
| |
| <li class="dropdown"> |
| |
| |
| |
| |
| <a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Community <span class="caret"></span></a> |
| <ul class="dropdown-menu"> |
| |
| <li><a href="/hono/community/contributing/">Contributing</a></li> |
| |
| <li><a href="/hono/community/presentations/">Resources</a></li> |
| |
| <li><a href="/hono/community/get-in-touch/">Get in Touch</a></li> |
| |
| <li><a href="/hono/community/road-map/">Road Map</a></li> |
| |
| </ul> |
| |
| </li> |
| |
| </ul> |
| </div> |
| |
| |
| <div class="collapse clearfix" id="search"> |
| |
| <form class="navbar-form" role="search"> |
| <div class="input-group"> |
| <input type="text" class="form-control" placeholder="Search"> |
| <span class="input-group-btn"> |
| |
| <button type="submit" class="btn btn-template-main"><i class="fa fa-search"></i></button> |
| |
| </span> |
| </div> |
| </form> |
| |
| </div> |
| |
| |
| </div> |
| </div> |
| |
| |
| </div> |
| |
| |
| |
| |
| </header> |
| |
| <div id="heading-breadcrumbs"> |
| <div class="container"> |
| <div class="row"> |
| <div class="col-md-12"> |
| <h1>Frequently Asked Questions</h1> |
| </div> |
| </div> |
| </div> |
| </div> |
| |
| |
| <div id="content"> |
| |
| |
| <div class="container"> |
| |
| <div class="row"> |
| |
| <div class="col-md-12"> |
| |
| <div> |
| |
| |
| <h2 id="technical-questions">Technical Questions</h2> |
| |
| <h4 id="why-do-i-get-http-1-1-503-service-unavailable-when-sending-messages-to-the-http-protocol-adapter">Why do I get <code>HTTP/1.1 503 Service Unavailable</code> when sending messages to the HTTP protocol adapter?</h4> |
| |
| <p>Please check if you have a <a href="/hono/getting-started/#starting-a-consumer">consumer connected</a> |
| and that your consumer is for the same type of message (telemetry or event) that you are sending.</p> |
| |
| <h4 id="why-do-i-get-the-exception-io-vertx-core-vertxexception-openssl-is-not-available-during-startup-of-a-protocol-adapter">Why do I get the exception <code>io.vertx.core.VertxException: OpenSSL is not available</code> during startup of a protocol adapter?</h4> |
| |
| <p>Please check if you have set the property <code>nativeTlsRequired</code> in the protocol adapter’s configuration to <code>true</code>. The default Hono |
| containers do not contain <code>netty-tcnative</code>. To enable this option, please follow the explanation in the |
| <a href="https://www.eclipse.org/hono/docs/admin-guide/secure_communication/#using-openssl |
| ">Admin Guide</a> or build your own container images.</p> |
| |
| <h4 id="why-do-i-see-connectionlimitmanager-connection-limit-value-exceeded-in-the-logs-of-a-protocol-adapter">Why do I see <code>ConnectionLimitManager - Connection limit (<VALUE>) exceeded</code> in the logs of a protocol adapter?</h4> |
| |
| <p>The configured maximum number of concurrent connections is exceeded and the protocol adapter refuses to accept more |
| connections to prevent running out of resources. This limit is either configured on the protocol adapter |
| (<a href="https://www.eclipse.org/hono/docs/admin-guide/mqtt-adapter-config/#service-configuration |
| ">MQTT</a>, |
| <a href="https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/#service-configuration |
| ">AMQP</a>) or if not set, |
| the protocol adapter determines a reasonable value based on the available resources like memory and CPU.</p> |
| |
| <h4 id="why-do-i-see-memorybasedconnectionlimitstrategy-not-enough-memory-in-the-logs-of-a-protocol-adapter">Why do I see <code>MemoryBasedConnectionLimitStrategy - Not enough memory</code> in the logs of a protocol adapter?</h4> |
| |
| <p>The protocol adapter can not allocate enough memory for handle even a small number of connections reliably. |
| Please provide more memory. To try it anyways, configure the |
| maximum number of concurrent connections, as documented in the Admin Guides of the protocol adapter |
| (<a href="https://www.eclipse.org/hono/docs/admin-guide/mqtt-adapter-config/#service-configuration |
| ">MQTT</a>, |
| <a href="https://www.eclipse.org/hono/docs/admin-guide/amqp-adapter-config/#service-configuration |
| ">AMQP</a>).</p> |
| |
| <h4 id="how-do-i-use-client-certificates-for-authentication">How do I use client certificates for authentication?</h4> |
| |
| <p>Make sure that you are able to connect to the respective protocol adapter with TLS |
| (see the <a href="https://www.eclipse.org/hono/docs/admin-guide/secure_communication/#using-openssl |
| ">Admin Guide</a> for configuration). |
| <a href="https://blog.bosch-si.com/developer/x-509-based-device-authentication-in-eclipse-hono/">Here</a> is an article, that |
| provides a complete walk-through guide for all required steps. |
| Additionally you can use and adapt the script for the creation of demo certificates in the Hono repository. |
| More information can be found in the User Guide of the protocol adapter |
| (<a href="https://www.eclipse.org/hono/docs/user-guide/mqtt-adapter/#authentication |
| ">MQTT</a>, |
| <a href="https://www.eclipse.org/hono/docs/user-guide/http-adapter/#device-authentication |
| ">HTTP</a>).</p> |
| |
| <h2 id="organizational-questions">Organizational Questions</h2> |
| |
| <h4 id="will-you-add-feature-x-to-hono">Will you add feature <em>x</em> to Hono?</h4> |
| |
| <p>To find out about the future development you can have a look at the <a href="https://www.eclipse.org/hono/community/road-map/">Roadmap</a> or |
| <a href="https://www.eclipse.org/hono/community/get-in-touch/">get in touch</a> with the Hono developers.</p> |
| |
| </div> |
| |
| </div> |
| |
| </div> |
| |
| |
| </div> |
| |
| |
| |
| </div> |
| |
| |
| <footer id="footer"> |
| <div class="container"> |
| |
| <div class="col-md-4 col-sm-6"> |
| <h4>More</h4> |
| |
| <ul> |
| <li><a href="https://github.com/eclipse/hono" title="View Source Code on GitHub"><i class='fab fa-github'></i> GitHub Repository</a></li> |
| <li><a href="https://twitter.com/EclipseHono" title="Follow us on Twitter"><i class='fab fa-twitter'></i> Twitter</a></li> |
| <li><a href="/hono/thankyou">Thank you</a></li> |
| </ul> |
| |
| <hr class="hidden-md hidden-lg hidden-sm"> |
| |
| </div> |
| |
| |
| <div class="col-md-4 col-sm-6"> |
| |
| <h4>Eclipse Legal</h4> |
| |
| <ul> |
| <li><a href="http://www.eclipse.org/legal/privacy.php" target="_blank">Privacy Policy</a></li> |
| <li><a href="http://www.eclipse.org/legal/termsofuse.php" target="_blank">Terms of Use</a></li> |
| <li><a href="http://www.eclipse.org/legal/copyright.php" target="_blank">Copyright Agent</a></li> |
| <li><a href="http://www.eclipse.org/legal" target="_blank">Legal</a></li> |
| <li><a href="https://www.eclipse.org/legal/epl-2.0/" target="_blank">License</a></li> |
| <li><a href="https://eclipse.org/security" target="_blank">Report a Vulnerability</a></li> |
| </ul> |
| |
| <hr class="hidden-md hidden-lg"> |
| |
| </div> |
| |
| |
| <div class="col-md-4 col-sm-6"> |
| |
| <div> |
| <div class="incubation"> |
| <a href="https://www.eclipse.org/projects/what-is-incubation.php" target="_blank"> |
| <img src="https://www.eclipse.org/hono/img/eclipse_incubation_vertical_png-02.png" width="100%" /> |
| </a> |
| </div> |
| <div class="eclipse-logo"> |
| <a href="https://www.eclipse.org" target="_blank"> |
| <img src="https://www.eclipse.org/hono/img/eclipse_foundation_logo_wo.svg"/> |
| </a> |
| </div> |
| </div> |
| |
| </div> |
| |
| |
| </div> |
| |
| </footer> |
| |
| |
| |
| |
| |
| |
| |
| <div id="copyright"> |
| <div class="container"> |
| <div class="col-md-12"> |
| |
| <p class="pull-left">© 2019 The Eclipse Hono Project</p> |
| |
| <p class="pull-right"> |
| Template by <a href="http://bootstrapious.com/free-templates">Bootstrapious</a>. |
| |
| |
| Ported to Hugo by <a href="https://github.com/devcows/hugo-universal-theme">DevCows</a> |
| </p> |
| </div> |
| </div> |
| </div> |
| |
| |
| |
| |
| |
| </div> |
| |
| |
| <script src="//code.jquery.com/jquery-3.1.1.min.js" integrity="sha256-hVVnYaiADRTO2PzUGmuLJr8BLUSjGIZsDYGmIJLv2b8=" crossorigin="anonymous"></script> |
| <script src="//maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script> |
| |
| <script src="//cdnjs.cloudflare.com/ajax/libs/jquery-cookie/1.4.1/jquery.cookie.min.js"></script> |
| <script src="//cdnjs.cloudflare.com/ajax/libs/waypoints/4.0.1/jquery.waypoints.min.js"></script> |
| <script src="//cdnjs.cloudflare.com/ajax/libs/Counter-Up/1.0/jquery.counterup.min.js"></script> |
| <script src="//cdnjs.cloudflare.com/ajax/libs/jquery-parallax/1.1.3/jquery-parallax.js"></script> |
| |
| |
| |
| |
| |
| <script src="https://www.eclipse.org/hono/js/front.js"></script> |
| |
| |
| <script src="https://www.eclipse.org/hono/js/owl.carousel.min.js"></script> |
| |
| |
| |
| <script> |
| (function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': |
| new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], |
| j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= |
| 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); |
| })(window,document,'script','dataLayer','GTM-5WLCZXC'); |
| </script> |
| |
| |
| <script src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/vendor/cookieconsent/default.min.js"></script> |
| |
| |
| </body> |
| </html> |