blob: afece6d8cf72c6b477aab2d23b89539d206695b6 [file] [log] [blame]
<!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&trade;</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&amp;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&amp;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&amp;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&rsquo;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 (&lt;VALUE&gt;) 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">&copy; 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>