M-Link Administration Guide M-Link Administration Guide Ii
Total Page:16
File Type:pdf, Size:1020Kb
MLINKADM-17.0 M-Link Administration Guide M-Link Administration Guide ii Table of Contents Chapter 1 Isode M-Link Overview............................................................................................. 1 This chapter gives an overview of Isode M-Link. Chapter 2 M-Link: Getting Started........................................................................................... 4 This chapter discusses M-Link Server creation. Chapter 3 Domains.................................................................................................................... 47 This chapter describes how M-Link Console can be used to view, modify, create and delete domains. Chapter 4 Con®guring Groups................................................................................................. 52 This chapter discusses how M-Link Console can be used to view, modify, create and delete groups for an M-Link service. Chapter 5 Con®guring TLS...................................................................................................... 54 This chapter discusses how to manage TLS con®guration of an M-Link service. Chapter 6 M-Link User Management...................................................................................... 68 This chapter discusses provisioning of user, user authentication and authorization, and groups. Chapter 7 Security Labels in XMPP........................................................................................ 90 This chapter discusses M-Link con®guration of security labels. Chapter 8 M-Link Edge, Peers and Links............................................................................. 100 This chapter introduces the M-Link Edge product, explains what XMPP trunking is, and how M-Link peers can be used to support it. It also shows use of links to support operation with XML Guards and operation over constrained links, including HF Radio using STANAG 5066. Chapter 9 Multi-User Chat..................................................................................................... 118 This chapter explains the M-Link Server implementation of Multi-User Chat rooms. Chapter 10 Publish-Subscribe, PEP, and FDP........................................................................ 131 This chapter discusses con®guration of M-Link Publish-Subscribe and related services. Chapter 11 M-Link FDP Gateway........................................................................................... 153 This chapter describes the M-Link FDP Gateway. Chapter 12 XMPP over BOSH................................................................................................. 170 This chapter discusses con®guration of XMPP over BOSH. Chapter 13 Filtering using Schematron................................................................................... 172 This chapter describes how stanzas can be ®ltered using schematron, and how M-Link Console can be used to con®gure certain types of ®lters. Chapter 14 Clustering................................................................................................................ 174 This chapter explains M-Link clustering, and how M-Link Console can be used to con®gure it. Chapter 15 Archive Management............................................................................................. 195 This chapter describes the M-Link archiving capabilities. M-Link Administration Guide M-Link Administration Guide iii Chapter 16 Troubleshooting...................................................................................................... 211 This chapter discusses troubleshooting. Chapter 17 Statistics.................................................................................................................. 214 This chapter discusses collection and viewing of M-Link Server statistics. Chapter 18 Monitoring the M-Link Server............................................................................. 221 Chapter 19 Session Monitoring................................................................................................. 236 This chapter discusses monitoring of sessions. Chapter 20 M-Link Web Application....................................................................................... 240 This chapter discusses deployment, con®guration and use of the M-Link Web Application Chapter 21 SPIF Editor............................................................................................................. 245 This chapter describes the SPIF Editor application and explains how to use it to create, edit and view a SPIF (Security Policy Information File) and various utility functions. Appendix A Command Line Operations................................................................................... 265 This chapter explains the command-line operations to manage the M-Link. Appendix B Backing up M-Link................................................................................................ 278 This appendix explains how to take a backup of the M-Link system and restore it with the backup. Appendix C Message Archive Format....................................................................................... 279 Appendix D Customizing Archive PDF/A Files........................................................................ 282 This appendix discusses customization of the Archive PDF/A ®les. Appendix E Administrator Archive Access Protocol............................................................... 284 This chapter provides the protocol for administrator access to message archives. Appendix F Advanced Con®guration....................................................................................... 289 This appendix explains how to do advanced con®guration. Appendix G Ad-Hoc Command Reference............................................................................... 290 This appendix lists the Ad-Hoc Commands offered by the M-Link Server. Appendix H Con®guration Option Reference.......................................................................... 320 This appendix describes each M-Link Server con®guration option. Appendix I MUC Room Settings Reference............................................................................ 447 This appendix describes each Multi-User Chat room con®guration setting. Appendix J TLS Cipher List Format....................................................................................... 457 This chapter describes the TLS cipher list format. Appendix K References............................................................................................................... 464 Appendix L Glossary.................................................................................................................. 468 M-Link Administration Guide M-Link Administration Guide iv and Isode are trade and service marks of Isode Limited. All products and services mentioned in this document are identi®ed by the trademarks or service marks of their respective companies or organizations, and Isode Limited disclaims any responsibility for specifying which marks are owned by which companies or organizations. Isode software is © copyright Isode Limited 2002-2020, all rights reserved. Isode software is a compilation of software of which Isode Limited is either the copyright holder or licensee. Acquisition and use of this software and related materials for any purpose requires a written licence agreement from Isode Limited, or a written licence from an organization licensed by Isode Limited to grant such a licence. This manual is © copyright Isode Limited 2020, all rights reserved. Copyright M-Link Administration Guide v 1 Software version This guide is published in support of Isode M-Link R17.0. It may also be pertinent to later releases. Please consult the release notes for further details. 2 Readership This guide is intended for administrators who plan to con®gure and manage Extensible Messaging and Presence Protocol (XMPP) services using Isode M-Link R17.0. 3 How to use this guide You are advised to read through Chapter 1, Isode M-Link Overview before you start to set up your XMPP service. You may also want to review Appendix L, Glossary as you come across technical terms you are not familiar with. 4 Typographical conventions The text of this manual uses different typefaces to identify different types of objects, such as ®le names and input to the system. The typeface conventions are shown in the following table and subsequent note. Object Examples Applications M-Link Server Literals (domain names, IP addressses, DNs, etc.). example.com, 192.0.2.1, cn=Example File and folder (directory) names C:\isode Commands and program options unique_id --verbose GUI elements Label, Menu, Menu Item, Sub-Menu User input hello! Citation, glossary terms, and cross references [[RFC6120]], Glossary term, Section 4, ªTypographical conventionsº (cross reference). Additional information to note, or a warning that the system Notes are additional information; cautions are warnings. could be damaged by certain actions. Note: This is an example of a note. Preface M-Link Administration Guide vi 5 File system place holders Where directory names are given in the text, they are often place holders for the names of actual directories where particular ®les are stored. The actual directory names used depend on how the software is built and installed. All of these directories can be changed by con®guration. Certain con®guration ®les are searched for ®rst in (ETCDIR) and then (SHAREDIR), so local copies can override shared information. The actual