Vidiator Xenon Platform Training Platform Configuration, and Integration
System Configuration Configuring Platform Applications Xenon Streamer server.ini manager.ini SNMP snmpagent.ini CDR cdr.ini PhoneDB Xenon Encoder nxfilterconfig.exe Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
Xenon Streamer Configuration server.ini The main streaming server configuration file. Located in <Xenon Streamer root directory>\bin It contains the configurations and settings for the following parameters: Basic Server Configuration Mount Folder Settings Logging Configuration Data Packet Settings Signaling Settings Timeout Configuration Source Port Matching Settings Bandwidth Adaptation Settings Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
Xenon Streamer Configuration server.ini Mandatory Parameters (Basic Server Configuration): Parameter Name Usage RTSPPort RTSPPort=<positive integer smaller than 65535> RTPPortMax, RTPPortMin RTPPortMax=<positive integer smaller than 65535> RTPPortMin=<positive integer smaller than 65535> ResourceDIR ResourceDIR = <full path of a media root directory> LogDIR LogDIR=<full path of the log directory> Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
Xenon Streamer Configuration manager.ini Configuration file for the Report Manager (ReportMGR.exe) Located in: <root directory>\bin Report Manager generates statistics logs using CDR data which is used for generating statistics reports by the SiteReports application. Parameter Name Usage Port Port=<port number> SupportStatistics SupportStatistics=<0:off | 1:on> FileReadingDuration FileReadingDuration=<Min : 1 minute, Max: 1 day> LogFileBaseStorageFolder LogFileBaseStorageFolder=<log directory path> Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
SNMP Configuration snmpagent.ini Used to enable or disable trap sending Configures SNMP agent and manager settings Parameter Name Usage MasterAgent MasterAgent=<0:Sub-agent | 1:Master agent> SNMPPort SNMPPort=<positive integer> Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
CDR Configuration cdr.ini Configures the CDR functionality provided by Xenon Streamer Located in: <root directory>\bin It contains the configurations and settings for the following CDR parameters: Storage Folder Settings Saving Period Settings CDR Fields and File Naming Convention Settings Fields included in CDR data by the Streamer Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
CDR Configuration cdr.ini:Mandatory Fields Parameter Name Usage DefaultStorageFolder DefaultStorageFolder = <default storage folder path> SecondaryStorageFolder SecondaryStorageFolder = <secondary storage folder name> SessionStorageFolder SessionStorageFolder = <session storage folder path> LogFileBaseStorageFolder LogFileBaseStorageFolder=<log directory path> PeriodicUpdate PeriodicUpdate=<0:after session | 1:during session> FileGeneratingDuration FileGeneratingDuration =<positive integer+Duration unit> FileSizeLimit FileSizeLimit =<positive integer+Size unit> StreamerID StreamerID =<Streamer ID> ServiceName ServiceName =< Service name> TimeType TimeType =< Time Type> FileNameDelimiter FileNameDelimiter =< _ | . > FieldDelimiter FieldDelimiter =< 0:a blank | 1:a comma > Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
PhoneDB Configuration Database file Located in: <root directory>\bin PhoneDB includes phones from the following manufacturers: Nokia Motorola Sony/Ericsson LG Samsung NEC To configure additional phones, please contact Vidiator Professional Services. Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
Xenon Encoder Configuration nxfilterconfig.exe NxFilterConfig configures what codecs are available for encoding content. Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
Vidiator Xenon Platform Training Platform Integration
Platform Integration Xenon Platform provides a Gateway and API for various types of billing and authentication Customer can apply different billing rules such as pre/post-paid or subscription-based billing using one unified API API is written in SOAP/XML Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
General Integration Call Flow API integration Layer Client Device Gateway Streaming Server Service Broker Billing/Auth Center Streaming Request GetAuthRequest Authentication/User Information GetAuthRequestResponse StreamNotificationRequest StreamNotificationResponse GetUserQuotaRequest Available Credit for User GetUserQuotaResponse Streaming End of Stream BillingInfoReportRequest Billing Information BillingInfoReportResponse StreamNotificationRequest Termination Point StreamNotificationResponse Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
SOAP API Example Get User Information Request (Gateway ServiceAgent) POST /Streamer/Streamersoap.asmx HTTP/1.1 Host: localhost Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://localhost/Streamer/Streamersoap/GetUserInfoRequest" <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <GetUserInfoRequest xmlns="http://localhost/Streamer/Streamersoap/"> <SessionID>string</SessionID> <ClientAddr>string</ClientAddr> </GetUserInfoRequest> </soap:Body> </soap:Envelope> Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
SOAP API Messages GetAuthRequest GetAuthRequestResponse Request for user and content authorization. GetAuthRequestResponse Response for user and content authorization. GetUserQuotaRequest Periodic request to check if the streaming session will be continued. GetUserQuotaRequestResponse Periodic response to check if the streaming session will be continued. StreamNotificationRequest Notification for ‘Start’ / ‘End’ of Stream. StreamNotificationRequestResponse Response for the stream notification. BillingInfoReportRequest Final billing report after service. BillingInfoReportRequestResponse Response for the billing report. TerminateSessionRequest Terminate a streaming session from Service Broker. TerminateSessionRequestResponse Response for TerminateSessionRequest. GetSessionStatusRequest Check a streaming session status from Service Broker. GetSessionStatusRequestResponse Response for GetSessionStatus. ‘Configurable’ indicates whether these messages can be turned ON or OFF. In some customer environments, some messages are not needed, e.g., TerminateSessionRequest. Once these messages are turned OFF, Xenon Modules will not use them. Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
SOAP API Error Codes Error Code Description 105 Authorization failure. 106 not authorized 331 Content uploading failure. 332 Invalid content. 333 No matched data. 402 Invalid parameter. 403 Session not found 404 File not found. 405 Unknown method 406 Mandatory parameter is missing 500 Timeout 501 service broker failure 503 Service unavailable error Because SOAP messages are delivered on top of HTTP and XML, even if the API throws an error, the HTTP error code will always be “200 OK”. Therefore, the following API error codes are included in failed responses from the Service Broker Xenon Platform Training - Module 3 - Installation, Configuration, and Integration
Q&A ? Questions Xenon Platform Training - Module 3 - Installation, Configuration, and Integration