Difference between revisions of "Streaming/en"

From Ace Stream Wiki
Jump to: navigation, search
(Common work scheme)
(Syntax of acestreamengine --stream-source command)
(32 intermediate revisions by 2 users not shown)
Line 9: Line 9:
 
Repository should be selected according to operating system.
 
Repository should be selected according to operating system.
  
''Debian 6+:''
+
''Debian 6:''
 
  <tt><nowiki>deb http://repo.acestream.org/debian/ squeeze main</nowiki></tt>
 
  <tt><nowiki>deb http://repo.acestream.org/debian/ squeeze main</nowiki></tt>
 
  or
 
  or
Line 16: Line 16:
 
Note: packages in sid repository are assembled with dependencies that correspond to official sid-repositories of Debian.
 
Note: packages in sid repository are assembled with dependencies that correspond to official sid-repositories of Debian.
 
If you don't know, which repository to choose, use squeeze.
 
If you don't know, which repository to choose, use squeeze.
 +
 +
''Debian 7:''
 +
<tt><nowiki>deb http://repo.acestream.org/debian/ wheezy main</nowiki></tt>
  
 
''Ubuntu 11.10:''
 
''Ubuntu 11.10:''
Line 25: Line 28:
 
''Ubuntu 12.10:''
 
''Ubuntu 12.10:''
 
  <tt><nowiki>deb http://repo.acestream.org/ubuntu/ quantal main</nowiki></tt>
 
  <tt><nowiki>deb http://repo.acestream.org/ubuntu/ quantal main</nowiki></tt>
 +
 +
''Ubuntu 13.04:''
 +
<tt><nowiki>deb http://repo.acestream.org/ubuntu/ raring main</nowiki></tt>
  
 
'''Step 2'''
 
'''Step 2'''
Line 57: Line 63:
 
For Debian only the engine (acestream-engine) is available.
 
For Debian only the engine (acestream-engine) is available.
  
 +
<!--
 
=== Installing ACE Stream package on Ubuntu from deb-package ===
 
=== Installing ACE Stream package on Ubuntu from deb-package ===
 
You can install ACE Stream on Ubuntu without using repository. To do this you need to download the installation package by one of links below and install it using a package manager (for example, by double click on downloaded package).
 
You can install ACE Stream on Ubuntu without using repository. To do this you need to download the installation package by one of links below and install it using a package manager (for example, by double click on downloaded package).
Line 69: Line 76:
  
 
This intallation package is an analog of <tt>acestream-full</tt> package from repository. It includes the engine, player and plug-in for browsers.
 
This intallation package is an analog of <tt>acestream-full</tt> package from repository. It includes the engine, player and plug-in for browsers.
 +
-->
 +
 +
=== Installing Ace Stream on the CentOS ===
 +
Requirements:
 +
* installed python 2.6
 +
* installed module python-argparse
 +
 +
To install Ace Stream on CentOS you need:
 +
* download an archive that corresponds to your CentOS version (links are below)
 +
* extract files from archive and copy contents to /usr dir
 +
 +
The following packages are available at this moment:
 +
*'''CentOS 5 64bit''': http://dl.acestream.org/centos/5/acestream-engine-2.1.6_4-centos5-x86_64.tar.gz
 +
*'''CentOS 6 64bit''': http://dl.acestream.org/centos/6/acestream-engine-2.1.6_4-centos6-x86_64.tar.gz
 +
 +
This package was tested on CentOS 5.8 and 6.3.
  
 
==Launching broadcast==
 
==Launching broadcast==
  
 
===Main terms===
 
===Main terms===
*'''Source''' - program that accepts HTTP-stream of broadcast and provides broadcast viewing with a help of ACE Stream software.
+
*'''Source''' - a program that accepts broadcast's HTTP-stream and provides playback of broadcast using ACE Stream software.
*'''Support node''' - program, allowing to scale broadcast, using additional server equipment and Internet-channels.
+
*'''Support node''' - a program allowing to scale broadcast using additional server equipment and Internet-channels.
 
*'''Client''' - ACE Stream software, which is used to play broadcast.
 
*'''Client''' - ACE Stream software, which is used to play broadcast.
 +
 +
===Transition from versions 2.0.х to version 2.1 and higher===
 +
From September, 10, 2013, upgraded version of the engine (2.1.6) for Ubuntu, Debian and CentOS is available.
 +
 +
Before using a new version for production, we recommend to test it on one or several broadcasts, if possible.
 +
 +
If you face any problems, please, write to the forum (http://forum.torrentstream.org) or email support@acestream.net.
 +
 +
Old versions are temporarily available in repository and by direct links:
 +
 +
'''Ubuntu''':
 +
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1oneiric6_amd64.deb
 +
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1oneiric6_i386.deb
 +
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1precise6_amd64.deb
 +
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1precise6_i386.deb
 +
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1quantal6_amd64.deb
 +
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1quantal6_i386.deb
 +
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1raring6_amd64.deb
 +
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1raring6_i386.deb
 +
 +
'''Debian''':
 +
* http://dl.acestream.org/debian/acestream-engine_2.0.8-1sid5_amd64.deb
 +
* http://dl.acestream.org/debian/acestream-engine_2.0.8-1sid5_i386.deb
 +
* http://dl.acestream.org/debian/acestream-engine_2.0.8-1squeeze5_amd64.deb
 +
* http://dl.acestream.org/debian/acestream-engine_2.0.8-1squeeze5_i386.deb
 +
 +
'''CentOS 6''':
 +
* http://dl.acestream.org/centos/6/acestream-engine-2.0.8_7-centos6-x86_64.tar.gz
 +
 +
<span style="color: #900;">ATTENTION!</span> In the nearest future support for older versions will be stopped.
 +
 +
<span style="color: #009;">IMPORTANT!</span> All broadcasts created via new version of Ace Stream (2.1 and higher) are not suppported by client software of old versions (2.0.х and lower). If you attempt to watch a new broadcast using the old engine, an error "Cannot load transport file" will appear.
 +
 +
====Changes in launch parameters====
 +
Some parameters of the launch of sources and support nodes from the command line have been changed, therefore the launch with the old command line will not work.
 +
 +
Main changes:
 +
* one executable file is used <tt>acestreamengine</tt>; different launch modes (a source, support node) are set by options:
 +
** instead of <tt>acestreamengine-stream</tt> you should launch <tt>acestreamengine --stream-source</tt>
 +
** instead of <tt>acestreamengine-node</tt> you should launch <tt>acestreamengine --stream-node</tt>
 +
** instead of <tt>acestreamengine-client-console</tt> you should launch <tt>acestreamengine --client-console</tt>
 +
** instead of <tt>acestreamengine-client-gtk</tt> you should launch <tt>acestreamengine --client-gtk</tt>
 +
* log system is changed. In old versions the engine output all debug information into STDERR and redirecting the output was required to write logs into a file. In a new version it is possible to define in options, where to write logs - into STDOUT, into STDERR, into a file or syslog. Rotation of logs by their size is supported for files. You can read description of all options in [[#acestreamengine command|acestreamengine command]]
 +
 +
===acestreamengine command===
 +
Starting from version 2.1 Ace Stream Engine for Linux represents a single executable file <tt>acestreamengine</tt>, which works in different modes, depending on specified parameters.
 +
 +
Work mode is set by one of the following parameters:
 +
* <tt>--client-console</tt> - launch engine in a client mode from console (without a graphic interface)
 +
* <tt>--client-wx</tt> - launch engine in a client mode with a graphic interface WX
 +
* <tt>--client-gtk</tt> - launch engine in a client mode with a graphic interface GTK
 +
* <tt>--stream-source</tt> - launch a source of broadcast
 +
* <tt>--stream-node</tt> - launch a support node
 +
* <tt>--create-transport</tt> - create a transport file from existing content (VOD)
 +
* <tt>--create-transport-multi</tt> - create a multi-stream transport file
 +
* <tt>--version</tt> - show engine version
 +
 +
Each work mode has their own required and not required parameters, described in appropriate sections.
 +
 +
Also all work modes have common parameters that manage the output of debug information.
 +
* <tt>--log-stdout</tt> - deduce information in STDOUT
 +
* <tt>--log-stderr</tt> - deduce information in STDERR
 +
* <tt>--log-file PATH</tt> - deduce information in a specified file
 +
* <tt>--log-max-size SIZE</tt> - maximum file size (bytes)
 +
* <tt>--log-backup-count COUNT</tt> - how many backup logs have to be stored (backup log file is created when a limit, specified by a parameter --log-max-size, is reached)
 +
* <tt>--log-file-buffer SIZE</tt> - enable buffering of output into the file (using buffer of specified size in bytes)
 +
* <tt>--log-syslog HOST</tt> - deduce information in syslog-server at the specified address
 +
* <tt>--log-syslog-port PORT</tt> - syslog-server port
 +
* <tt>--log-syslog-facility FACILITY</tt> - used facility
 +
* <tt>--log-syslog-buffer SIZE</tt> - enable buffering of output into syslog (using buffer of specified size in bytes)
  
 
===Common work scheme ===
 
===Common work scheme ===
Broadcast organizing starts from launching the source (command <tt>acestreamengine-stream</tt>).
+
Broadcast organization starts from launching the source (command <tt>acestreamengine-stream</tt>).
The source accepts HTTP-stream to input(at this moment HTTP-streams with MPEG-TS encapsulation are supported) with the original of broadcast and creates a file with acelive extension after the launch. This file is a unique identifier of broadcast and is used for connection and playback by clients.
+
The source accepts HTTP-stream to input (at this moment HTTP-streams with MPEG-TS encapsulation are supported) with original broadcast and creates a file with acelive extension after the launch. This file is a unique identifier of broadcast and it is used for connection and playback by clients.
  
===Синтаксис команды acestreamengine-stream===
+
===Syntax of acestreamengine --stream-source command===
Команда <tt>acestreamengine-stream</tt> запускает источник трансляции.
+
<tt>acestreamengine --stream-source</tt> command launches broadcast source.
  
''обязательные параметры''
+
''required parameters''
*<tt>--name NAME</tt> - название трансляции (это название используется при создании файла acelive и других служебных файлов)
+
*<tt>--name NAME</tt> - broadcast name (this name is used when creating acelive and other service files)
*<tt>--source SOURCE</tt> - источник (ссылка на http-поток)
+
*<tt>--source SOURCE</tt> - source (link to http-stream)
*<tt>--bitrate BITRATE</tt> - средний битрейт потока в байтах в секунду
+
*<tt>--bitrate BITRATE</tt> - average bitrate of stream in bytes per second
  
''необязательные параметры''
+
''optional parameters''
*<tt>--title TITLE</tt> - "читабельное" название транляции (это название выводится у клиентов). Если не задано, берется из --name
+
*<tt>--title TITLE</tt> - "readable" broadcast name (this name is shown to clients). If it's not specified, it's taken from --name
*<tt>--destdir DESTDIR</tt> - устаревшний параметр, лучше использовать --cache-dir и --publish-dir
+
*<tt>--destdir DESTDIR</tt> - old parameter, it's better to use --cache-dir and --publish-dir
*<tt>--cache-dir CACHE_DIR</tt> - папка для создания служебных файлов (кеш трансляции и другие)
+
*<tt>--cache-dir CACHE_DIR</tt> - directory for creating service files (broadcast cache and others)
*<tt>--publish-dir PUBLISH_DIR</tt> - папка, в которой будет создан acelive-файл
+
*<tt>--publish-dir PUBLISH_DIR</tt> - directory, in which acelive-file will be created
*<tt>--piecesize PIECESIZE</tt> - размер куска в байтах (если не задан, выставляется автоматически в зависимости от битрейта)
+
*<tt>--piecesize PIECESIZE</tt> - piece size in bytes (if it's not specified, it's set automatically depending on bitrate)
*<tt>--duration DURATION</tt> - размер кеша трансляции в формат ЧЧ:ММ:СС (по умолчанию один час: 01:00:00)
+
*<tt>--duration DURATION</tt> - size of broadcast cache in format HH:MM:SS (by default, one hour: 01:00:00)
*<tt>--host HOST</tt> - вручную задать адрес локального трекера
+
*<tt>--host HOST</tt> - set address of local tracker manually
*<tt>--port PORT</tt> - порт, на котором работает движок
+
*<tt>--port PORT</tt> - port, where the engine works
*<tt>--skip-internal-tracker</tt> - отключить локальный трекер
+
*<tt>--skip-internal-tracker</tt> - disable local tracker
*<tt>--add-authorized-peers</tt> - добавить список авторизованных пиров в acelive файл
+
*<tt>--add-authorized-peers</tt> - add list of authorized peers to acelive file
*<tt>--private-source</tt> - сделать источник приватным
+
*<tt>--private-source</tt> - make the source private
*<tt>--support-node SUPPORT_NODE</tt> - добавить узел поддержки (в формате ip:port). Этот параметр может встречаться несколько раз, если нужно добавить несколько узлов поддержки.
+
*<tt>--support-node SUPPORT_NODE</tt> - add support node (in format ip:port). This parameter may appear multiple times if several support nodes have to be added.
*<tt>--tracker TRACKER</tt> - добавить трекер (announce url). Этот параметр может встречаться несколько раз.
+
*<tt>--tracker TRACKER</tt> - add tracker(announce url). This parameter may appear multiple times.
*<tt>--trackers TRACKERS</tt> - старый формат добавления трекеров (список announce url через запятую)
+
*<tt>--trackers TRACKERS</tt> - old format for adding trackers (announce url list separated by commas)
*<tt>--provider-key PROVIDER_KEY</tt> - ключ провайдера (только для коммерческих трансляций)
+
*<tt>--provider-key PROVIDER_KEY</tt> - provider's key (only for commercial broadcasts)
*<tt>--maxclients MAXCLIENTS</tt> - максимальное количество пиров, на которые одновременно отдаются данные с источника
+
*<tt>--maxclients MAXCLIENTS</tt> - maximum number of peers, on which data from the source are given simultaneously
*<tt>--show-pieces</tt> - выводить в лог номера кусков по мере их создания
+
*<tt>--log-debug DEBUG</tt> - set the debug level (default is 0 - minimum log level)
*<tt>--show-peers</tt> - периодически выводить в лог список подключенных пиров
+
*<tt>--source-read-timeout SECONDS</tt> - timeout for reading data from the original source (in seconds). Default is 30.
*<tt>--debug DEBUG</tt> - установить уровень отладки
+
*<tt>--source-reconnect-interval SECONDS</tt> - interval is seconds, after which the engine will try to reconnect to the original source in case of connection lost. Default is 5.
 +
*<tt>--pid-file-dir PATH</tt> - the directory where engine's pid file is created. Default is /tmp.
 +
*<tt>--provider-key</tt> - provider key (for an affiliate program)
 +
*<tt>--sid</tt> - content identificator for statistics(for an affiliate program)
 +
*<tt>--permanent</tt> - mark the broadcast as 24/7 (it's available all the time)
 +
*<tt>--date-start YYYY-MM-DD HH:mm:ss</tt> - set the data and time of the broadcast start (for the broadcasts which runs during a limited time)
 +
*<tt>--date-end YYYY-MM-DD HH:mm:ss</tt> - set the data and time of the broadcast end(for the broadcasts which runs during a limited time)
 +
*<tt>--premium</tt> - request a "premium" status for the broadcast
 +
*<tt>--upload-limit</tt> - limit upload speed (bytes/s, default is 0 - don't limit)
 +
*<tt>--max-connections</tt> - limit total number of connections (default is 1000)
 +
*<tt>--max-peers</tt> - limit number of connections to other peers (default is 50)
 +
*<tt>--service-remote-access</tt> - enable remote statistics
 +
*<tt>--service-access-token</tt> - password for remote statistics access
 +
*<tt>--stats-report-interval</tt> - interval in seconds between internal statistics update (default is 60)
 +
*<tt>--stats-report-peers</tt> - update information about connected peers in the internal statistics (increases CPU load)
  
''дополнительно''
+
''additional''
*<tt>-h, --help</tt> - показать описание команд
+
*<tt>-h, --help</tt> - show commands' description
  
===Синтаксис команды acestreamengine-node===
+
=== Syntax of acestreamengine --stream-node command===
Команда <tt>acestreamengine-node</tt> запускает узел поддержки
+
<tt>acestreamengine --stream-node</tt> command launches support node.
  
''обязательные параметры''
+
''required parameters''
*<tt>--url URL></tt> - ссылка на acelive файл трансляции
+
*<tt>--url URL></tt> - link to acelive file of broadcast
  
''необязательные параметры''
+
''optional parameters''
*<tt>--port PORT</tt> - порт (по умолчанию 8621)
+
*<tt>--port PORT</tt> - port(by default: 8621)
*<tt>--state-dir STATE_DIR</tt> - папка для временных файлов (удаляется после остановки узла поддержки)
+
*<tt>--state-dir STATE_DIR</tt> - directory for temporary files (it's deleted after support node installation)
*<tt>--source-node SOURCE_NODE</tt> - адрес источника трансляции (ip:port)
+
*<tt>--source-node SOURCE_NODE</tt> - address of broadcast source (ip:port)
*<tt>--support-node SUPPORT_NODE</tt> - добавить адрес другого узла поддержки (ip:port). Этот параметр может встречаться несколько раз.
+
*<tt>--support-node SUPPORT_NODE</tt> - add address of another support node (ip:port). This parameter may appear multiple times.
*<tt>--allow-source-download</tt> - разрешить получение данных от источника
+
*<tt>--allow-source-download</tt> - allow receiving data from the source
*<tt>--allow-support-download</tt> - разрешить получение данных от других узлов поддержки
+
*<tt>--allow-support-download</tt> - allow receiving data from other support nodes
*<tt>--allow-peers-download</tt> - разрешить получение данных от обычных пиров
+
*<tt>--allow-peers-download</tt> - allow receiving data from ordinary peers
*<tt>--max-incoming-connects MAX_INCOMING_CONNECTS</tt> - маскимальное кол-во входящих соединений (от других пиров) (по умолчанию 1000)
+
*<tt>--max-connections MAX_CONNECTIONS</tt> - limit number of total connections (default is 1000)
*<tt>--max-outgoing-connects MAX_OUTGOING_CONNECTS</tt> - маскимальное кол-во исходящих соединений (к другим пирам) (по умолчанию 50)
+
*<tt>--max-peers MAX_PEERS</tt> - limit number of connections to other peers (default is 50)
*<tt>--max-upload-slots MAX_UPLOAD_SLOTS</tt> - максимальное количество пиров, на которые одновременно отдаются данные с узла поддержки (по умолчанию 7)
+
*<tt>--max-upload-slots MAX_UPLOAD_SLOTS</tt> - maximum number of peers, on which data from support node are given simultaneously (by default: 7)
*<tt>--max-download-speed MAX_DOWNLOAD_SPEED</tt> - максимальная скорость загрузки (байт/с). По умолчанию 0 (без ограничений).
+
*<tt>--max-download-speed MAX_DOWNLOAD_SPEED</tt> - maximum download speed (byte/s). By default: 0 (no restrictions).
*<tt>--max-upload-speed MAX_UPLOAD_SPEED</tt> - максимальная скорость отдачи (байс/с). По умолчанию 0 (без ограничений).
+
*<tt>--max-upload-speed MAX_UPLOAD_SPEED</tt> - maximum upload speed (byte/s). By default: 0 (no restrictions).
*<tt>--show-pieces</tt> - выводить в лог номера кусков по мере их загрузки
+
*<tt>--log-debug DEBUG</tt> - set the debug level (default is 0 - minimum log level)
*<tt>--show-peers</tt> - периодически выводить в лог список подключенных пиров
+
*<tt>--service-remote-access</tt> - enable remote statistics
*<tt>--stats-report-interval STATS_REPORT_INTERVAL</tt> - задать интервал в секундах для вывода в лог информации о скорости загрузки/отдачи. По умолчанию 0 (не выводить).
+
*<tt>--service-access-token</tt> - password for remote statistics access
*<tt>--debug DEBUG</tt> - установить уровень отладки
+
*<tt>--stats-report-interval</tt> - interval in seconds between internal statistics update (default is 60)
 +
*<tt>--stats-report-peers</tt> - update information about connected peers in the internal statistics (increases CPU load)
  
''дополнительно''
+
''additional''
*<tt>-h, --help</tt> - показать описание команд
+
*<tt>-h, --help</tt> - show commands' description
  
===Встроенный трекер===
+
===Embedded tracker===
Встроенный трекер - это трекер встроенный в источник трансляции. Если он не отключен опцией <tt>--skip-internal-tracker</tt>, то его адрес будет автоматически добавлен в acelive-файл.
+
Embedded tracker is a tracker embedded into broadcast source. If it's not disabled by <tt>--skip-internal-tracker</tt> option, its address will be added to acelive-file automatically.
  
При организации трансляций с большим количеством пользователей мы рекомендуем отключать встроенный трекер и заменять его внешним трекером с хорошей производительностью (например, [http://xbtt.sourceforge.net/tracker/ XBT Tracker])
+
When organizing broadcast with many users, we recommend to disable embedded tracker and replace it with external tracker with a good productivity (for example, [http://xbtt.sourceforge.net/tracker/ XBT Tracker]).
  
===Авторизованные узлы===
+
===Authorized nodes===
Для того, чтобы клиент подключился к трансляции и начал просмотр, ему необходимо либо установить соединение минимум с двумя другими узлами, либо установить соединение с авторизованным узлом. Авторизованный узел - это узел, который был отмечен создателем трансляции как такой, которому можно "доверять". Как правило, это источник трансляции и/или узлы поддержки.
+
Client have to establish connection with at least two other nodes or an authorized node, to be connected to broadcast and start playback. Authorized node is a node, which was marked by broadcast's creator as a "trustworthy". Usually it's a broadcast source and/or support nodes.
  
Последние версии ПО ACE Stream поддерживают использование списка авторизованных узлов в acelive-файле. Для этого при создании трансляции задается опция <tt>--add-authorized-peers</tt>, после чего формируется список авторизованных узлов и добавляется в acelive-файл. В список авторизованных узлов попадает источник трансляции (если это не приватный источник) и все указанные узлы поддержки. Клиенты, которые получили данный acelive-файл, используют список для определения того, является ли какой-либо узел авторизованным.
+
The latest versions of ACE Stream software support using list of authorized nodes in acelive-file. For this <tt>--add-authorized-peers</tt> option is set when creating broadcast, after this the list of authorized nodes is created and added to acelive-file. Broadcast source (if it's not private) and all specified support nodes are in the list of authorized nodes. Clients that received this acelive-file use the list to determine whether a node is authorized.
  
Если в acelive-файл не был добавлен список авторизованных узлов, либо у клиента установлена старая версия ACE Stream, которая не распознает данный список, то авторизованным узлом считается узел, IP адрес которого совпадает с адресом первого трекера в списке трекеров. Если встроенный трекер на источнике не отключен, то он будет первым в списке и клиенты будут считать источник авторизованным узлом. В случае, если встроенный трекер отключен, для поддержки старых клиентов мы рекомендуем ставить на первое место трекер, расположенный на том же сервере, что и источник трансляции (чтобы адреса первого трекера и источника совпадали), либо использовать как минимум один узел поддержки (чтобы клиенты при старте могли установить соединение сразу с двумя пирами, даже если больше никто не смотрит трансляцию).
+
If the list of authorized nodes was not added to acelive-file or an old version of ACE Stream, which doesn't understand this list, is installed, then authorized node is a node, IP address of which matches address of the first tracker from trackers' list. If embedded tracker is enabled on the source, it will be the first one on the list and clients will consider the source as authorized node. If embedded tracker is disabled, to support other clients we recommend to put on the first place tracker, located on the same server as broadcast source (so addresses of the first tracker and the source matched) or use at least one support node (so clients, when starting broadcast, could connect to two peers simultaneously, even if nobody watches broadcast).
  
===Примеры===
+
===Examples===
Для примеров предроложим наличие локальной сети с тремя серверами:
+
For examples let's assume that there is a local network with three servers:
*192.168.1.1 - сервер для источника
+
*192.168.1.1 - server for the source
*192.168.1.2 - сервер для узла поддержки
+
*192.168.1.2 - server for support node
*192.168.1.3 - сервер для узла поддержки
+
*192.168.1.3 - server for support node
*192.168.1.100 - сервер, который отдает оригинальный поток трансляции (HTTP MPEG-TS) по адресу <nowiki>http://192.168.1.100/stream</nowiki> (средний битрейт потока - 300 000 байт/с)
+
*192.168.1.100 - server that gives original broadcast's stream (HTTP MPEG-TS) at <nowiki>http://192.168.1.100/stream</nowiki> (average bitrate of stream - 300 000 byte/s)
  
На сервере 192.168.1.1 предполагается наличие веб-сервера с корневой папкой <tt>/home/www</tt>, а также двух папок:
+
It's assumed that on server 192.168.1.1 there is a web-server with a core directory <tt>/home/www</tt> and two other directories:
*<tt>/home/www/streams</tt> - для хранения acelive-файлов, которые будут доступны для скачивания по ссылке вида <tt><nowiki>http://192.168.1.1/streams/test.acelive</nowiki></tt>
+
*<tt>/home/www/streams</tt> - for keeping acelive-files, which will be available for downloading by a link like <tt><nowiki>http://192.168.1.1/streams/test.acelive</nowiki></tt>
*<tt>/tmp/streams</tt> - для хранения кэша и служебных файлов трансляций
+
*<tt>/tmp/streams</tt> - for keeping cache and service files of broadcast
  
====Источник с встроенным трекером====
+
====Source with embedded tracker====
Это наиболее простой способ запуск трансляции, не требующий запуска узлов поддержки и установки дополнительных трекеров. Данный способ подходит для трансляций с небольшим количество пользователей.
+
This is the easiest way to launch broadcast that does not require launching support nodes and installing additional trackers. This method is suitable for broadcasts with a small number of users.
  
На сервере 192.168.1.1 запускаем источник:
+
We launch the source on server 192.168.1.1:
  <tt>acestreamengine-stream \
+
  <tt>acestreamengine --stream-source \
 
  --name "test" \
 
  --name "test" \
  --title "Тестовая трансляция" \
+
  --title "Test broadcast" \
 
  --source "<nowiki>http://192.168.1.100/stream</nowiki>" \
 
  --source "<nowiki>http://192.168.1.100/stream</nowiki>" \
 
  --bitrate 300000 \
 
  --bitrate 300000 \
 
  --publish-dir "/home/www/streams" \
 
  --publish-dir "/home/www/streams" \
 
  --cache-dir "/tmp/streams" \
 
  --cache-dir "/tmp/streams" \
  --add-authorized-peers \
+
  --add-authorized-peers</tt>
> /tmp/test-source.log 2>&1</tt>
 
  
Последняя строка используется для записи логов в файл /tmp/test-source.log. <tt>acestreamengine-stream</tt> выводит всю отладочную информацию на консоль в STDERR.
+
The last line is used to write logs into file /tmp/test-source.log. By default <tt>acestreamengine --stream-source</tt> outputs all debug information in the STDOUT.
  
Опция <tt>--add-authorized-peers</tt> добавляет в acelive-файл список авторизованных узлов (в данном случае это источник: 192.168.1.1).
+
<tt>--add-authorized-peers</tt> option adds the list of authorized nodes to acelive-file (in this case, it's the source: 192.168.1.1).
  
После запуска трансляции в папке /home/www/streams будет создан файл test.acelive, в папке <tt>/tmp/streams</tt> будут созданы такие файлы:
+
After broadcast's launch a file test.acelive will be created in directory /home/www/streams, in directory <tt>/tmp/streams</tt> such files will be created:  
*<tt>test</tt> - кэш трансляции. Размер этого файла примерно равен длительность_потока_в_секундах (опция <tt>--duration</tt>, по умолчанию 1 час) * битрейт байт
+
*<tt>test</tt> - broadcast cache. This file's size is approximately equal to stream_duration_in_seconds (<tt>--duration</tt> option, by default: 1 hour) * bitrate byte
*<tt>test.restart</tt> - здесь хранится информация для корректного перезапуска трансляции
+
*<tt>test.restart</tt> - information for correct restart of broadcast is kept here
*<tt>test.sauth</tt> - ключ для цифровой подписи трансляции
+
*<tt>test.sauth</tt> - key for a broadcast's digital signature
  
Для просмотра трансляции клиенты могут скачать файл трансляции по ссылке <tt><nowiki>http://192.168.1.1/streams/test.acelive</nowiki></tt> и запустить его в плеере ACE Stream, либо использовать другие способы ([[Способы просмотра трансляции]]).
+
To watch broadcasts clients can download broadcast file at <tt><nowiki>http://192.168.1.1/streams/test.acelive</nowiki></tt> and start it in ACE Stream player or use other ways ([[Ways to watch broadcasts]]).
  
====Источник с внешним трекером====
+
====Source with external tracker====
Если трансляция предполагает большое количество пользователей, то желательно использовать внешний трекер и отключить встроенный (для снижения нагрузки на источник).
+
If broadcast involves a large number of users, it's better to use external tracker and disable embedded one (to reduce burden on the source).
  
В качестве внешнего трекера мы советуем использовать [http://xbtt.sourceforge.net/tracker/ XBT Tracker]
+
We recommed to use [http://xbtt.sourceforge.net/tracker/ XBT Tracker] as external tracker.
  
В данном примере предполагаем, что XBT Tracker установлен и запущен на сервере 192.168.1.1.
+
In this example we assume that XBT Tracker is installed and launched on server 192.168.1.1.
Запуск трансляции теперь будет выглядеть таким образом:
+
Now broadcast's launch will look like:
  <tt>acestreamengine-stream \
+
  <tt>acestreamengine --stream-source \
 
  --name "test" \
 
  --name "test" \
  --title "Тестовая трансляция" \
+
  --title "Test broadcast" \
 
  --source "<nowiki>http://192.168.1.100/stream</nowiki>" \
 
  --source "<nowiki>http://192.168.1.100/stream</nowiki>" \
 
  --bitrate 300000 \
 
  --bitrate 300000 \
Line 204: Line 311:
 
  --add-authorized-peers \
 
  --add-authorized-peers \
 
  --skip-internal-tracker \
 
  --skip-internal-tracker \
  --tracker "udp://192.168.1.1:2710/announce" \
+
  --tracker "udp://192.168.1.1:2710/announce"</tt>
> /tmp/test-source.log 2>&1</tt>
+
 
 +
<tt>--skip-internal-tracker</tt> option disconnects embedded tracker, <tt>--tracker</tt> option connects external tracker.
  
Опция <tt>--skip-internal-tracker</tt> отключает встроенный трекер, опция <tt>--tracker</tt> подключает внешний трекер.
+
====Source with two support nodes====
 +
If there is not enough upstream bandwidth for normal work of broadcast on the source, support nodes can be used. Support node is often a node that receives data from the source and gives to clients (though support node can also receive data from other support nodes and even clients, depending on its settings). It makes sense to install support node on a separate server with a good width of output channel.
  
====Источник с двумя узлами поддержки====
+
To make a scheme with support nodes work with maximum efficiency, addresses of these nodes must be given to the source
В случае, если на источнике не хватает пропускной способности исходящего канала для нормальной работы трансляции, можно использовать узлы поддержки. Чаще всего узел поддержки представляет собой узел, который принимает данные от источника и отдает клиентам (хотя узел поддержки также может принимать данные от других узлов поддержки и даже от клиентов, в зависимости от его настроек). Узел поддержки имеет смысл ставить на отдельном сервере с хорошей шириной исходящего канала.
+
using <tt>--support-node</tt> option:
  
Для максимально эффективной работы схемы с узлами поддержки источнику необходимо сообщить адреса этих узлов с помощью опции <tt>--support-node</tt>:
+
  <tt>acestreamengine --stream-source \
  <tt>acestreamengine-stream \
 
 
  --name "test" \
 
  --name "test" \
  --title "Тестовая трансляция" \
+
  --title "Test broadcast" \
 
  --source "<nowiki>http://192.168.1.100/stream</nowiki>" \
 
  --source "<nowiki>http://192.168.1.100/stream</nowiki>" \
 
  --bitrate 300000 \
 
  --bitrate 300000 \
Line 225: Line 333:
 
  --tracker "udp://192.168.1.1:2710/announce" \
 
  --tracker "udp://192.168.1.1:2710/announce" \
 
  --support-node "192.168.1.2:8621" \
 
  --support-node "192.168.1.2:8621" \
  --support-node "192.168.1.3:8621" \
+
  --support-node "192.168.1.3:8621"</tt>
> /tmp/test-source.log 2>&1</tt>
 
  
Запускаем узлы поддержки на серверах 192.168.1.2 и 192.168.1.3 (команды для запуска одинаковые):
+
Launch support nodes on servers 192.168.1.2 and 192.168.1.3 (commands are the same):
  <tt>acestreamengine-node \
+
  <tt>acestreamengine --stream-node \
 
  --url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
 
  --url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
 
  --state-dir "/tmp" \
 
  --state-dir "/tmp" \
 
  --source-node "192.168.1.1:7764" \
 
  --source-node "192.168.1.1:7764" \
  --allow-source-download \
+
  --allow-source-download</tt>
> /tmp/test-node.log 2>&1</tt>
 
  
Опция <tt>--source-node</tt> задает адрес источника.
+
Option <tt>--source-node</tt> sets source address.
  
Опция <tt>--allow-source-download</tt> разрешает узлу поддержки скачивать данные с источника (скачивание с других узлов поддержки и клиентов в данном случае запрещено).
+
Option <tt>--allow-source-download</tt> allows support node to download data from the source (downloading from other support nodes and clients in this case is forbidden).
  
Если необходимо разрешить узлам поддержки скачивать данные с других узлов поддержки, то следует задать список других узлов опцией <tt>--support-node</tt> и разрешить скачивание опцией <tt>--allow-support-download</tt>.
+
To allow support nodes to download data from other suppport nodes, you should set a list of other nodes using <tt>--support-node</tt> option and allow downloading using <tt>--allow-support-download</tt> option.
  
На сервере 192.168.1.2 это будет выглядеть так:
+
On server 192.168.1.2 it will look like:
  <tt>acestreamengine-node \
+
  <tt>acestreamengine --stream-node \
 
  --url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
 
  --url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
 
  --state-dir "/tmp" \
 
  --state-dir "/tmp" \
Line 249: Line 355:
 
  --allow-source-download \
 
  --allow-source-download \
 
  --support-node "192.168.1.3:8621" \
 
  --support-node "192.168.1.3:8621" \
  --allow-support-download \
+
  --allow-support-download</tt>
> /tmp/test-node.log 2>&1</tt>
 
  
На сервере 192.168.1.3:
+
On server 192.168.1.3:
  <tt>acestreamengine-node \
+
  <tt>acestreamengine --stream-node \
 
  --url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
 
  --url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
 
  --state-dir "/tmp" \
 
  --state-dir "/tmp" \
Line 259: Line 364:
 
  --allow-source-download \
 
  --allow-source-download \
 
  --support-node "192.168.1.2:8621" \
 
  --support-node "192.168.1.2:8621" \
  --allow-support-download \
+
  --allow-support-download</tt>
> /tmp/test-node.log 2>&1</tt>
 
  
====Приватный источник с двумя узлами поддержки====
+
====Private source with two support nodes====
Иногда может возникнуть необходимость запретить клиентам напрямую обращаться к источнику трансляции. Например, источник может быть физически расположен на сервере в защищенной зоне без доступа из внешнего мира. В этом случае трансляцию можно организовать по следующей схеме:
+
Sometimes it may be necessary to prevent clients from direct access to broadcast source. For example, the source may be located on server in protected area without access from the outer world. In this case broadcast can be organized by the following scheme:
*источник делается приватным (получать от него данные смогут только узлы поддержки, указанные явным образом)
+
*the source is made private (only support nodes, specified explicitly, can receive data from it)
*узлы поддержки получают данные от источника и отдают клиентам
+
*support nodes receive data from the source and give to clients
*клиенты получают данные от узлов поддержки
+
*clients receive data from support nodes
  
Для того, чтобы сделать источник приватным, следует указать опцию <tt>--private-source</tt>:
+
To make the source private, option <tt>--private-source</tt> must be specified:
  <tt>acestreamengine-stream \
+
  <tt>acestreamengine --stream-source \
 
  --name "test" \
 
  --name "test" \
  --title "Тестовая трансляция" \
+
  --title "Test broadcast" \
 
  --source "<nowiki>http://192.168.1.100/stream</nowiki>" \
 
  --source "<nowiki>http://192.168.1.100/stream</nowiki>" \
 
  --bitrate 300000 \
 
  --bitrate 300000 \
Line 282: Line 386:
 
  --support-node "192.168.1.2:8621" \
 
  --support-node "192.168.1.2:8621" \
 
  --support-node "192.168.1.3:8621" \
 
  --support-node "192.168.1.3:8621" \
  --private-source \
+
  --private-source</tt>
> /tmp/test-source.log 2>&1</tt>
 
  
Следует обратить внимание на то, что в данной конфигурации адрес трекера изменен на <tt>udp://192.168.1.2:2710/announce</tt>. Это сделано для поддержки старых версий клиентов, которые не обрабатывают список авторизованных пиров (подробнее здесь [[#Авторизованные узлы|Авторизованные узлы]]).
+
Notice that in this configuration tracker's address is changed to <tt>udp://192.168.1.2:2710/announce</tt>. It was made to support old versions of clients, which do not process a list of authorized peers (more details here [[#Authorized peers|Authorized peers]]).
  
Узлы поддержки на серверах 192.168.1.2 и 192.168.1.3 запускаем как обычно:
+
Launch support nodes on servers 192.168.1.2 and 192.168.1.3 as usual:
  <tt>acestreamengine-node \
+
  <tt>acestreamengine --stream-node \
 
  --url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
 
  --url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
 
  --state-dir "/tmp" \
 
  --state-dir "/tmp" \
 
  --source-node "192.168.1.1:7764" \
 
  --source-node "192.168.1.1:7764" \
  --allow-source-download \
+
  --allow-source-download</tt>
> /tmp/test-node.log 2>&1</tt>
 

Revision as of 15:53, 18 September 2013

Installation

Installing ACE Stream on Debian/Ubuntu from repository

Step 1

Add link on appropriate repository into /etc/apt/sources.list file.

Repository should be selected according to operating system.

Debian 6:

deb http://repo.acestream.org/debian/ squeeze main
or
deb http://repo.acestream.org/debian/ sid main

Note: packages in sid repository are assembled with dependencies that correspond to official sid-repositories of Debian. If you don't know, which repository to choose, use squeeze.

Debian 7:

deb http://repo.acestream.org/debian/ wheezy main

Ubuntu 11.10:

deb http://repo.acestream.org/ubuntu/ oneiric main

Ubuntu 12.04:

deb http://repo.acestream.org/ubuntu/ precise main

Ubuntu 12.10:

deb http://repo.acestream.org/ubuntu/ quantal main

Ubuntu 13.04:

deb http://repo.acestream.org/ubuntu/ raring main

Step 2

Installing public key. To do this you have to run the following command:

Debian:

wget -O - http://repo.acestream.org/keys/acestream.public.key | apt-key add -

Ubuntu:

sudo wget -O - http://repo.acestream.org/keys/acestream.public.key | sudo apt-key add -

Step 3

Installing the right package. For example, for engine installation you have to install acestream-engine package.

Debian

apt-get update
apt-get install acestream-engine

Ubuntu

sudo apt-get update
sudo apt-get install acestream-engine

The following packages are available in the repository for Ubuntu:

  • acestream-engine - engine
  • acestream-mozilla-plugin - plug-in for browser
  • acestream-player - desktop player
  • acestream-player-data - set of common libraries for the player and plug-in
  • acestream-full - full package, including all of the above

For Debian only the engine (acestream-engine) is available.


Installing Ace Stream on the CentOS

Requirements:

  • installed python 2.6
  • installed module python-argparse

To install Ace Stream on CentOS you need:

  • download an archive that corresponds to your CentOS version (links are below)
  • extract files from archive and copy contents to /usr dir

The following packages are available at this moment:

This package was tested on CentOS 5.8 and 6.3.

Launching broadcast

Main terms

  • Source - a program that accepts broadcast's HTTP-stream and provides playback of broadcast using ACE Stream software.
  • Support node - a program allowing to scale broadcast using additional server equipment and Internet-channels.
  • Client - ACE Stream software, which is used to play broadcast.

Transition from versions 2.0.х to version 2.1 and higher

From September, 10, 2013, upgraded version of the engine (2.1.6) for Ubuntu, Debian and CentOS is available.

Before using a new version for production, we recommend to test it on one or several broadcasts, if possible.

If you face any problems, please, write to the forum (http://forum.torrentstream.org) or email support@acestream.net.

Old versions are temporarily available in repository and by direct links:

Ubuntu:

Debian:

CentOS 6:

ATTENTION! In the nearest future support for older versions will be stopped.

IMPORTANT! All broadcasts created via new version of Ace Stream (2.1 and higher) are not suppported by client software of old versions (2.0.х and lower). If you attempt to watch a new broadcast using the old engine, an error "Cannot load transport file" will appear.

Changes in launch parameters

Some parameters of the launch of sources and support nodes from the command line have been changed, therefore the launch with the old command line will not work.

Main changes:

  • one executable file is used acestreamengine; different launch modes (a source, support node) are set by options:
    • instead of acestreamengine-stream you should launch acestreamengine --stream-source
    • instead of acestreamengine-node you should launch acestreamengine --stream-node
    • instead of acestreamengine-client-console you should launch acestreamengine --client-console
    • instead of acestreamengine-client-gtk you should launch acestreamengine --client-gtk
  • log system is changed. In old versions the engine output all debug information into STDERR and redirecting the output was required to write logs into a file. In a new version it is possible to define in options, where to write logs - into STDOUT, into STDERR, into a file or syslog. Rotation of logs by their size is supported for files. You can read description of all options in acestreamengine command

acestreamengine command

Starting from version 2.1 Ace Stream Engine for Linux represents a single executable file acestreamengine, which works in different modes, depending on specified parameters.

Work mode is set by one of the following parameters:

  • --client-console - launch engine in a client mode from console (without a graphic interface)
  • --client-wx - launch engine in a client mode with a graphic interface WX
  • --client-gtk - launch engine in a client mode with a graphic interface GTK
  • --stream-source - launch a source of broadcast
  • --stream-node - launch a support node
  • --create-transport - create a transport file from existing content (VOD)
  • --create-transport-multi - create a multi-stream transport file
  • --version - show engine version

Each work mode has their own required and not required parameters, described in appropriate sections.

Also all work modes have common parameters that manage the output of debug information.

  • --log-stdout - deduce information in STDOUT
  • --log-stderr - deduce information in STDERR
  • --log-file PATH - deduce information in a specified file
  • --log-max-size SIZE - maximum file size (bytes)
  • --log-backup-count COUNT - how many backup logs have to be stored (backup log file is created when a limit, specified by a parameter --log-max-size, is reached)
  • --log-file-buffer SIZE - enable buffering of output into the file (using buffer of specified size in bytes)
  • --log-syslog HOST - deduce information in syslog-server at the specified address
  • --log-syslog-port PORT - syslog-server port
  • --log-syslog-facility FACILITY - used facility
  • --log-syslog-buffer SIZE - enable buffering of output into syslog (using buffer of specified size in bytes)

Common work scheme

Broadcast organization starts from launching the source (command acestreamengine-stream). The source accepts HTTP-stream to input (at this moment HTTP-streams with MPEG-TS encapsulation are supported) with original broadcast and creates a file with acelive extension after the launch. This file is a unique identifier of broadcast and it is used for connection and playback by clients.

Syntax of acestreamengine --stream-source command

acestreamengine --stream-source command launches broadcast source.

required parameters

  • --name NAME - broadcast name (this name is used when creating acelive and other service files)
  • --source SOURCE - source (link to http-stream)
  • --bitrate BITRATE - average bitrate of stream in bytes per second

optional parameters

  • --title TITLE - "readable" broadcast name (this name is shown to clients). If it's not specified, it's taken from --name
  • --destdir DESTDIR - old parameter, it's better to use --cache-dir and --publish-dir
  • --cache-dir CACHE_DIR - directory for creating service files (broadcast cache and others)
  • --publish-dir PUBLISH_DIR - directory, in which acelive-file will be created
  • --piecesize PIECESIZE - piece size in bytes (if it's not specified, it's set automatically depending on bitrate)
  • --duration DURATION - size of broadcast cache in format HH:MM:SS (by default, one hour: 01:00:00)
  • --host HOST - set address of local tracker manually
  • --port PORT - port, where the engine works
  • --skip-internal-tracker - disable local tracker
  • --add-authorized-peers - add list of authorized peers to acelive file
  • --private-source - make the source private
  • --support-node SUPPORT_NODE - add support node (in format ip:port). This parameter may appear multiple times if several support nodes have to be added.
  • --tracker TRACKER - add tracker(announce url). This parameter may appear multiple times.
  • --trackers TRACKERS - old format for adding trackers (announce url list separated by commas)
  • --provider-key PROVIDER_KEY - provider's key (only for commercial broadcasts)
  • --maxclients MAXCLIENTS - maximum number of peers, on which data from the source are given simultaneously
  • --log-debug DEBUG - set the debug level (default is 0 - minimum log level)
  • --source-read-timeout SECONDS - timeout for reading data from the original source (in seconds). Default is 30.
  • --source-reconnect-interval SECONDS - interval is seconds, after which the engine will try to reconnect to the original source in case of connection lost. Default is 5.
  • --pid-file-dir PATH - the directory where engine's pid file is created. Default is /tmp.
  • --provider-key - provider key (for an affiliate program)
  • --sid - content identificator for statistics(for an affiliate program)
  • --permanent - mark the broadcast as 24/7 (it's available all the time)
  • --date-start YYYY-MM-DD HH:mm:ss - set the data and time of the broadcast start (for the broadcasts which runs during a limited time)
  • --date-end YYYY-MM-DD HH:mm:ss - set the data and time of the broadcast end(for the broadcasts which runs during a limited time)
  • --premium - request a "premium" status for the broadcast
  • --upload-limit - limit upload speed (bytes/s, default is 0 - don't limit)
  • --max-connections - limit total number of connections (default is 1000)
  • --max-peers - limit number of connections to other peers (default is 50)
  • --service-remote-access - enable remote statistics
  • --service-access-token - password for remote statistics access
  • --stats-report-interval - interval in seconds between internal statistics update (default is 60)
  • --stats-report-peers - update information about connected peers in the internal statistics (increases CPU load)

additional

  • -h, --help - show commands' description

Syntax of acestreamengine --stream-node command

acestreamengine --stream-node command launches support node.

required parameters

  • --url URL> - link to acelive file of broadcast

optional parameters

  • --port PORT - port(by default: 8621)
  • --state-dir STATE_DIR - directory for temporary files (it's deleted after support node installation)
  • --source-node SOURCE_NODE - address of broadcast source (ip:port)
  • --support-node SUPPORT_NODE - add address of another support node (ip:port). This parameter may appear multiple times.
  • --allow-source-download - allow receiving data from the source
  • --allow-support-download - allow receiving data from other support nodes
  • --allow-peers-download - allow receiving data from ordinary peers
  • --max-connections MAX_CONNECTIONS - limit number of total connections (default is 1000)
  • --max-peers MAX_PEERS - limit number of connections to other peers (default is 50)
  • --max-upload-slots MAX_UPLOAD_SLOTS - maximum number of peers, on which data from support node are given simultaneously (by default: 7)
  • --max-download-speed MAX_DOWNLOAD_SPEED - maximum download speed (byte/s). By default: 0 (no restrictions).
  • --max-upload-speed MAX_UPLOAD_SPEED - maximum upload speed (byte/s). By default: 0 (no restrictions).
  • --log-debug DEBUG - set the debug level (default is 0 - minimum log level)
  • --service-remote-access - enable remote statistics
  • --service-access-token - password for remote statistics access
  • --stats-report-interval - interval in seconds between internal statistics update (default is 60)
  • --stats-report-peers - update information about connected peers in the internal statistics (increases CPU load)

additional

  • -h, --help - show commands' description

Embedded tracker

Embedded tracker is a tracker embedded into broadcast source. If it's not disabled by --skip-internal-tracker option, its address will be added to acelive-file automatically.

When organizing broadcast with many users, we recommend to disable embedded tracker and replace it with external tracker with a good productivity (for example, XBT Tracker).

Authorized nodes

Client have to establish connection with at least two other nodes or an authorized node, to be connected to broadcast and start playback. Authorized node is a node, which was marked by broadcast's creator as a "trustworthy". Usually it's a broadcast source and/or support nodes.

The latest versions of ACE Stream software support using list of authorized nodes in acelive-file. For this --add-authorized-peers option is set when creating broadcast, after this the list of authorized nodes is created and added to acelive-file. Broadcast source (if it's not private) and all specified support nodes are in the list of authorized nodes. Clients that received this acelive-file use the list to determine whether a node is authorized.

If the list of authorized nodes was not added to acelive-file or an old version of ACE Stream, which doesn't understand this list, is installed, then authorized node is a node, IP address of which matches address of the first tracker from trackers' list. If embedded tracker is enabled on the source, it will be the first one on the list and clients will consider the source as authorized node. If embedded tracker is disabled, to support other clients we recommend to put on the first place tracker, located on the same server as broadcast source (so addresses of the first tracker and the source matched) or use at least one support node (so clients, when starting broadcast, could connect to two peers simultaneously, even if nobody watches broadcast).

Examples

For examples let's assume that there is a local network with three servers:

  • 192.168.1.1 - server for the source
  • 192.168.1.2 - server for support node
  • 192.168.1.3 - server for support node
  • 192.168.1.100 - server that gives original broadcast's stream (HTTP MPEG-TS) at http://192.168.1.100/stream (average bitrate of stream - 300 000 byte/s)

It's assumed that on server 192.168.1.1 there is a web-server with a core directory /home/www and two other directories:

  • /home/www/streams - for keeping acelive-files, which will be available for downloading by a link like http://192.168.1.1/streams/test.acelive
  • /tmp/streams - for keeping cache and service files of broadcast

Source with embedded tracker

This is the easiest way to launch broadcast that does not require launching support nodes and installing additional trackers. This method is suitable for broadcasts with a small number of users.

We launch the source on server 192.168.1.1:

acestreamengine --stream-source \
--name "test" \
--title "Test broadcast" \
--source "http://192.168.1.100/stream" \
--bitrate 300000 \
--publish-dir "/home/www/streams" \
--cache-dir "/tmp/streams" \
--add-authorized-peers

The last line is used to write logs into file /tmp/test-source.log. By default acestreamengine --stream-source outputs all debug information in the STDOUT.

--add-authorized-peers option adds the list of authorized nodes to acelive-file (in this case, it's the source: 192.168.1.1).

After broadcast's launch a file test.acelive will be created in directory /home/www/streams, in directory /tmp/streams such files will be created:

  • test - broadcast cache. This file's size is approximately equal to stream_duration_in_seconds (--duration option, by default: 1 hour) * bitrate byte
  • test.restart - information for correct restart of broadcast is kept here
  • test.sauth - key for a broadcast's digital signature

To watch broadcasts clients can download broadcast file at http://192.168.1.1/streams/test.acelive and start it in ACE Stream player or use other ways (Ways to watch broadcasts).

Source with external tracker

If broadcast involves a large number of users, it's better to use external tracker and disable embedded one (to reduce burden on the source).

We recommed to use XBT Tracker as external tracker.

In this example we assume that XBT Tracker is installed and launched on server 192.168.1.1. Now broadcast's launch will look like:

acestreamengine --stream-source \
--name "test" \
--title "Test broadcast" \
--source "http://192.168.1.100/stream" \
--bitrate 300000 \
--publish-dir "/home/www/streams" \
--cache-dir "/tmp/streams" \
--add-authorized-peers \
--skip-internal-tracker \
--tracker "udp://192.168.1.1:2710/announce"

--skip-internal-tracker option disconnects embedded tracker, --tracker option connects external tracker.

Source with two support nodes

If there is not enough upstream bandwidth for normal work of broadcast on the source, support nodes can be used. Support node is often a node that receives data from the source and gives to clients (though support node can also receive data from other support nodes and even clients, depending on its settings). It makes sense to install support node on a separate server with a good width of output channel.

To make a scheme with support nodes work with maximum efficiency, addresses of these nodes must be given to the source using --support-node option:

acestreamengine --stream-source \
--name "test" \
--title "Test broadcast" \
--source "http://192.168.1.100/stream" \
--bitrate 300000 \
--port 7764 \
--publish-dir "/home/www/streams" \
--cache-dir "/tmp/streams" \
--add-authorized-peers \
--skip-internal-tracker \
--tracker "udp://192.168.1.1:2710/announce" \
--support-node "192.168.1.2:8621" \
--support-node "192.168.1.3:8621"

Launch support nodes on servers 192.168.1.2 and 192.168.1.3 (commands are the same):

acestreamengine --stream-node \
--url "http://192.168.1.1/streams/test.acelive" \
--state-dir "/tmp" \
--source-node "192.168.1.1:7764" \
--allow-source-download

Option --source-node sets source address.

Option --allow-source-download allows support node to download data from the source (downloading from other support nodes and clients in this case is forbidden).

To allow support nodes to download data from other suppport nodes, you should set a list of other nodes using --support-node option and allow downloading using --allow-support-download option.

On server 192.168.1.2 it will look like:

acestreamengine --stream-node \
--url "http://192.168.1.1/streams/test.acelive" \
--state-dir "/tmp" \
--source-node "192.168.1.1:7764" \
--allow-source-download \
--support-node "192.168.1.3:8621" \
--allow-support-download

On server 192.168.1.3:

acestreamengine --stream-node \
--url "http://192.168.1.1/streams/test.acelive" \
--state-dir "/tmp" \
--source-node "192.168.1.1:7764" \
--allow-source-download \
--support-node "192.168.1.2:8621" \
--allow-support-download

Private source with two support nodes

Sometimes it may be necessary to prevent clients from direct access to broadcast source. For example, the source may be located on server in protected area without access from the outer world. In this case broadcast can be organized by the following scheme:

  • the source is made private (only support nodes, specified explicitly, can receive data from it)
  • support nodes receive data from the source and give to clients
  • clients receive data from support nodes

To make the source private, option --private-source must be specified:

acestreamengine --stream-source \
--name "test" \
--title "Test broadcast" \
--source "http://192.168.1.100/stream" \
--bitrate 300000 \
--port 7764 \
--publish-dir "/home/www/streams" \
--cache-dir "/tmp/streams" \
--add-authorized-peers \
--skip-internal-tracker \
--tracker "udp://192.168.1.2:2710/announce" \
--support-node "192.168.1.2:8621" \
--support-node "192.168.1.3:8621" \
--private-source

Notice that in this configuration tracker's address is changed to udp://192.168.1.2:2710/announce. It was made to support old versions of clients, which do not process a list of authorized peers (more details here Authorized peers).

Launch support nodes on servers 192.168.1.2 and 192.168.1.3 as usual:

acestreamengine --stream-node \
--url "http://192.168.1.1/streams/test.acelive" \
--state-dir "/tmp" \
--source-node "192.168.1.1:7764" \
--allow-source-download