Vidiator Xenon Platform Training

Vidiator Technology (US) Inc.

Slide 3-1

Vidiator Xenon Platform TrainingVidiator Xenon Platform Training

Platform Configuration, and Integration

Platform Configuration, and Integration

Xenon Platform Training - Module 3 - Installation, Configuration, and IntegrationVidiator Technology (US) Inc.

Slide 3-2

System ConfigurationSystem Configuration

Configuring Platform Applications– Xenon Streamer

• server.ini• manager.ini

– SNMP• snmpagent.ini

– CDR• cdr.ini

– PhoneDB– Xenon Encoder

• nxfilterconfig.exe

Configuring Platform Applications– Xenon Streamer

• server.ini• manager.ini

– SNMP• snmpagent.ini

– CDR• cdr.ini

– PhoneDB– Xenon Encoder

• nxfilterconfig.exe


Slide 3-3

Xenon Streamer ConfigurationXenon 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

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


Slide 3-4


server.ini

– Mandatory Parameters (Basic Server 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>


Slide 3-5


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.

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.


Port Port=<port number>

SupportStatistics SupportStatistics=<0:off | 1:on>

FileReadingDuration FileReadingDuration=<Min : 1 minute, Max: 1 day>

LogFileBaseStorageFolder LogFileBaseStorageFolder=<log directory path>


Slide 3-6

SNMP ConfigurationSNMP Configuration

snmpagent.ini

– Used to enable or disable trap sending– Configures SNMP agent and manager settings

snmpagent.ini

– Used to enable or disable trap sending– Configures SNMP agent and manager settings


MasterAgent MasterAgent=<0:Sub-agent | 1:Master agent>

SNMPPort SNMPPort=<positive integer>


Slide 3-7

CDR ConfigurationCDR 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

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


Slide 3-8

CDR ConfigurationCDR Configuration

Parameter Name UsageDefaultStorageFolder 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 >

•cdr.ini:Mandatory Fields•cdr.ini:Mandatory Fields


Slide 3-9

PhoneDB ConfigurationPhoneDB 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.

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.


Slide 3-10

Xenon Encoder ConfigurationXenon Encoder Configuration

nxfilterconfig.exe– NxFilterConfig configures what codecs

are available for encoding content.

nxfilterconfig.exe– NxFilterConfig configures what codecs

are available for encoding content.

Vidiator Technology (US) Inc.

Slide 3-11

Vidiator Xenon Platform TrainingVidiator Xenon Platform Training

Platform IntegrationPlatform Integration


Slide 3-12

Platform IntegrationPlatform 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 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

Gateway(Streaming Serever)

Proxy

ServiceBroker

Billing(pre paid) / Authentication

Center of Service ProviderSOAP

Customization(SI) Issue

by Xenon Streamer’s API

by Operator’s API

InterConn


Slide 3-13

General Integration Call FlowGeneral Integration Call Flow

Streaming Request

GetAuthRequest

GetAuthRequestResponse

Authentication/User

Information

GetUserQuotaRequest

GetUserQuotaResponseAvailable Credit for User

StreamingStreaming

End of Stream End of Stream

BillingInfoReportRequest

BillingInfoReportResponseBilling Information

Client DeviceClient Device GatewayGateway Billing/Auth Center

Billing/Auth Center

StreamNotificationRequestStreamNotificationResponse

StreamNotificationRequest

StreamNotificationResponseTermination PointA

PI i

nteg

ratio

n La

yer

AP

I int

egra

tion

Laye

r

Streaming Server

Streaming Server

Service BrokerService Broker


Slide 3-14

SOAP API ExampleSOAP 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>

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>


Slide 3-15

SOAP API MessagesSOAP API Messages

GetAuthRequest– 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.

GetAuthRequest– 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.


Slide 3-16

SOAP API Error CodesSOAP API Error Codes

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

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

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


Slide 3-17

?Q&AQ&A

QuestioQuestionsns

Documents

Vidiator Xenon Platform Training