-
Notifications
You must be signed in to change notification settings - Fork 45
Remove migrating section of FAQs #2860
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
4a97f7c
90e4bc4
828a245
5190f70
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -9,6 +9,14 @@ Ably SDKs are the recommended method for connecting to Ably because they offer s | |
|
||
Protocol adapters offer an alternative method for connecting to Ably. The advantage to protocol adapters is that they require fewer resources in terms of memory and network overhead such as in smaller footprint devices, or on a platform where an Ably SDK isn't available such as an Arduino-based IoT wearable. The potential drawback to consider when evaluating protocol adapters is that they do not support the full set of Ably features, for example the MQTT protocol adapter does not support presence, and the SSE protocol adapter does not support automatic token renewal. | ||
|
||
## Migration support <a id="migration-support"/> | ||
|
||
Ably helps customers migrate from other data streaming networks including PubNub and Pusher. Protocol adapters facilitate risk-free migration by allowing you to use existing protocols and client libraries while transitioning to Ably client libraries over time. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. "Client libraries" to "SDKs" when referring to our own here too please. |
||
|
||
Protocol adapters ensure interoperability between different protocols. For example, you can publish sensor data from an MQTT device, subscribe to that data using a Pusher client library for dashboard display, support mobile apps using Ably SDKs, and process data using AMQP worker queues - all within the same system. | ||
|
||
Migration times typically range from a few hours (using protocol adapters) to a week, depending on your migration strategy and whether you choose to adopt Ably's native SDKs immediately or transition gradually. | ||
|
||
A full list of Ably SDKs can be found on the [SDK page](/docs/sdks). | ||
|
||
## Available Protocol Adapters <a id="available-adapters"/> | ||
|
@@ -26,7 +34,7 @@ Ably supports multiple protocols in addition to the native WebSockets-based one: | |
|
||
MQTT (MQ Telemetry Transport) is a publish/subscribe, lightweight messaging protocol designed for constrained devices and low-bandwidth networks. One of the major uses of MQTT is with IoT (Internet of Things), where these principles are key to having effective communication between various devices. | ||
|
||
MQTT can also be used with Ably as a basic event broker or if we don't have an SDK for your target platform. However, without an SDK you don't get access to the full range of platform features and data guarantees. | ||
MQTT can also be used with Ably as a basic event broker or if an SDK is not available for your target platform. However, without an SDK you don't get access to the full range of platform features and data guarantees. | ||
|
||
Read more in the [MQTT section](/docs/protocols/mqtt). | ||
|
||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -14,6 +14,20 @@ Many of the advantages associated with using Ably, such as the use of WebSockets | |
|
||
You can use PuBNub and and an Ably SDK side-by-side as they are interoperable, with the exception of a few features. | ||
|
||
For a detailed comparison of Ably and PubNub features, see [Ably vs PubNub](https://ably.com/compare/ably-vs-pubnub). | ||
|
||
## Migration process <a id="migration-process"/> | ||
|
||
A typical migration from PubNub to Ably follows these steps: | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Can we change "Ably client libraries" to "Ably SDKs" please. |
||
|
||
1. Change the host name for all of your PubNub client library integrations to use Ably's endpoints. | ||
|
||
2. Migrate one app at a time over to Ably client libraries. At this stage, some of your apps will be using PubNub client libraries and others will be using Ably's client libraries. Since the adapter translates the PubNub protocol, there's no interruption and interoperability between both protocols is maintained. | ||
|
||
3. Migrate all your apps and servers to use Ably client libraries and terminate your old contracts. | ||
|
||
If you're interested in migrating from PubNub using protocol adapters, [get in touch](https://ably.com/contact). | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I don't think this is necessary in the docs considering the steps are outline here. |
||
|
||
## Supported features <a id="features"/> | ||
|
||
The following PubNub features are supported using the adapter: | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Migrate to Ably"?