Diffusion 6.6 User Guide Contents List of Figures..............................................................................................10 List of Tables............................................................................................... 12 Part I: Welcome.......................................................................... 15 Introducing Diffusion................................................................................................. 16 Introducing topics and data................................................................................................ 16 Introducing sessions.............................................................................................................20 What's new in Diffusion 6.6?...................................................................................... 23 Part II: Quick Start Guide............................................................ 26 Part III: Design Guide.................................................................. 27 Support.....................................................................................................................28 System requirements for the Diffusion server....................................................................28 Platform support for the Diffusion API libraries.................................................................31 Feature support in the Diffusion API...................................................................................33 License types.........................................................................................................................38 Protocol support...................................................................................................................39 Browser support................................................................................................................... 40 Browser limitations.............................................................................................................. 41 WebSocket limitations............................................................................................. 41 Cross-origin resource sharing limitations...............................................................41 Browser connection limitations.............................................................................. 42 Designing your data model.........................................................................................43 Topic tree.............................................................................................................................. 43 Topic naming............................................................................................................ 44 Topic selectors..........................................................................................................45 Topic views............................................................................................................... 51 Topics.................................................................................................................................... 65 Properties of topics.................................................................................................. 66 JSON topics...............................................................................................................70 Binary topics............................................................................................................. 72 String topics..............................................................................................................74 Int64 topics............................................................................................................... 76 Diffusion | 2 Double topics............................................................................................................78 Time series topics.....................................................................................................79 Routing topics...........................................................................................................82 Slave topics (DEPRECATED).....................................................................................83 RecordV2 topics........................................................................................................ 85 Pub-sub................................................................................................................................. 89 Publishing data.........................................................................................................90 Subscribing to topics................................................................................................92 Topic notifications................................................................................................................94 Request-response messaging.............................................................................................. 96 Conflation..............................................................................................................................98 Using conflation........................................................................................................98 Designing your solution............................................................................................. 99 Servers................................................................................................................................. 100 Server clusters for high availability...................................................................................101 Session replication................................................................................................. 103 Topic replication.....................................................................................................107 Failover of active update sources......................................................................... 108 Sharing data with remote servers.....................................................................................110 Remote topic views................................................................................................ 111 Fan-out.................................................................................................................... 112 Using missing topic notifications with fan-out.....................................................114 Topic persistence................................................................................................................116 Topic delivery priority........................................................................................................ 118 Automatic topic removal................................................................................................... 118 Clients..................................................................................................................................119 Client types............................................................................................................. 119 Using clients............................................................................................................121 Using clients for control.........................................................................................121 Client coordination.................................................................................................123 User-written components.................................................................................................. 124 Third party components.................................................................................................... 125 Load balancers....................................................................................................... 125 Web servers.............................................................................................................126 JMS.......................................................................................................................... 129 Example solutions.............................................................................................................. 131 Example: Simple solution...................................................................................... 131 Example: A solution using clients..........................................................................132 Example: Scalable and resilient solution..............................................................133 Security...................................................................................................................133 Role-based authorization...................................................................................................134 Permissions............................................................................................................. 138 Pre-defined roles.................................................................................................... 143 Authentication.................................................................................................................... 145 User-written authentication handlers...................................................................149 System authentication handler.............................................................................150 Pre-defined users....................................................................................................151