AceStream 3.0/en

Where to download

You can download the latest alpha-versions of the engine here:

• Ubuntu 12 amd64: http://dl.acestream.org/ubuntu/12/acestream_3.0.0-b2_ubuntu_12.04_x86_64.tar.gz
• Ubuntu 13 i386: http://dl.acestream.org/ubuntu/13/acestream_3.0.0-a18_ubuntu_13.04_i686.tar.gz
• Ubuntu 13 amd64: http://dl.acestream.org/ubuntu/13/acestream_3.0.0-b2_ubuntu_13.04_x86_64.tar.gz
• Ubuntu 14 amd64: http://dl.acestream.org/ubuntu/14/acestream_3.0.0-b2_ubuntu_14.04_x86_64.tar.gz
• CentOS 6 amd64: http://dl.acestream.org/centos/6/acestream_3.0.0-b2_centos_6_amd64.tar.gz
• Debian 6 i386: http://dl.acestream.org/debian/6/acestream_3.0.0-a18_debian_6.0.10_i686.tar.gz
• Debian 6 amd64: http://dl.acestream.org/debian/6/acestream_3.0.0-b2_debian_6.0.10_x86_64.tar.gz
• Debian 7 i386: http://dl.acestream.org/debian/7/acestream_3.0.0-a18_debian_7.6_i686.tar.gz
• Debian 7 amd64: http://dl.acestream.org/debian/7/acestream_3.0.0-b2_debian_7.4_x86_64.tar.gz

Full package for Windows (engine + plugin + player):

• http://dl.acestream.org/products/acestream3-alpha/win/latest

Changelog

3.0.0-a18

• bug, because of which some support nodes could lose connection with the source, was fixed
• parameter --title became required (this parameter transfers "readable" name of broadcast which is displayed at users' players during playback)
• two required parameters for the source are added:
  • --quality - channel's quality; possible values:
    • SD
    • HD
  • --category - channel's category; possible values:
    • informational
    • entertaining
    • educational
    • movies
    • documentaries
    • sport
    • fashion
    • music
    • regional
    • ethnic
    • religion
    • teleshop
    • erotic_18_plus
    • other_18_plus
    • cyber_games
    • amateur
    • webcam

3.0.0-a12

• CPU usage was significantly optimized
• memory leaks were eliminated

3.0.0-a5

• start nodes are added

3.0.0-a2

• support nodes are added
• options for configuration of private nodes and schemes of distribution of traffic between support nodes and a source are added

3.0.0-a1

• the first alpha-version

How to install over the old version

• download package for your OS
• unzip to a temporary folder (for example, to /tmp/acestream)
• copy appropriate files from temporary folder to root folders /usr/bin/ and /usr/share/acestream (all old files and folders can be deleted)

IMPORTANT: For the work of a new engine package python-setuptools must be installed.

How to launch without deleting an old version

Alpha-version can be launched on a server simultaneously with any release version.

For the launching you need to:

• download archive for your OS
• unpack archive in any folder (for example, /opt/acestream/engine_new)
• launch acestreamengine file in the unpacked folder with a parameter --lib-path /path/to/acestream_libraries. Example:

/opt/acestream/engine_new/acestreamengine --lib-path /opt/acestream/engine_new

Parameter --lib-path sets the path to Ace Stream libraries. By default the path /usr/share/acestream is used. If the release version of the engine is already installed on the server, it will be launched without specifying the parameter --lib-path. To know for sure which version was launched, you can check the version from command line. For example, if version 2.1.6 is already installed, the result without specifying --lib-path will be following:

# /opt/acestream/engine_new/acestreamengine --version
version: 2.1.6 revision: 293

With specifying --lib-path a new version will be launched:

# /opt/acestream/engine_new/acestreamengine --lib-path /opt/acestream/engine_new --version
version: 3.0.0-a1 revision: 565

Launch on CentOS

On CentOS there are some features of the engine launch.

Standard library openssl on CentOS do not support some necessary for the engine functions. In this regard, together with the engine for CentOS there is a recompiled library openssl and module python-m2crypto, which is superstructure over openssl. These libraries are in the folder usr in archieve with the engine. To use them you have to copy folders "lib64" and "local" from the folder "usr" into appropriate folders in /usr. If the engine of the previous version is installed on the server, these libraries are in your system and there is no need to copy them.

To launch the engine under CentOS script start.sh is used instead of acestreamengine in the folder with the engine.

This script sets an environment variable LD_LIBRARY_PATH=/usr/local/ssl/lib before the engine launch, so the recompiled version of the library openssl was used.

Also this script automatically passes the path to libraries to the engine through the parameter --lib-path, so there is no need to specify it additionally.

Changes in launch parameters

In a new version there are some differences on launch parameters.

New flags for the engine launch in different modes

• --stream-source-node (instead of --stream-source)
• --stream-support-node (instead of --stream-node)

New parameters for setting up cache

• --live-cache-type (string) - cache type: disk - store the cache on the disk in the folder specified by parameter --cache-dir, memory - store the cache in random-access memory (by default: disk)
• --live-cache-size (integer) - maximum size of the cache in bytes (by default: 209715200 bytes (200 Mb))

New parameters for configuration of support nodes infrastructure

• --private-node (0 or 1) - if you specify 1, the node will be private (by default: 0)
• --download-from (string) - add the address to a list of nodes from which this node is allowed to receive data. The address must be specified in a format ipv4_address:port. This parameter may occur more than once.
• --upload-to (string) - add the address to the list of nodes to which this node is allowed to give data. The address must be specified in a format ipv4_address:port. This parameter may occur more than once.
• --monitor-node-ip (string) - ipv4 address of monitoring-server

New parameters to launch the source

• --metatracker (string) - add the address of metatracker to the transport file

These parameters are not used any more

• --stream-source (is changed to --stream-source-node)
• --stream-node (is changed to --stream-support-node)
• --add-authorized-peers (list of authorized peers is not added to transport file any more)
• --private-source (is changed to --private-node)
• --support-node
• --source-node
• --allow-source-download
• --allow-support-download
• --allow-peers-download

New functional

Setting up support nodes

In a new version it is necessary to explicitly specify to support nodes from which nodes they have to download data. For this, parameter --download-from is used. A list of nodes, from which downloading is allowed, can be changed without restarting support node through node's web-interface (look below). For example, if node-source is launched by address 192.168.1.2:7764 and we want to launch support node which loads data only from the source, a command to launch support node will be following:

acestreamengine \
 --stream-support-node \
 --url http://192.168.1.2/transport/test.acelive \
 --port 8631 \
 --download-from "192.168.1.2:7764"

Private nodes

Private node gives data only to nodes that explicitly are added to its list of allowed. In order to make a node private you have to launch it with a parameter --private-node 1. To add the address to the list of allowed to upload a parameter --upload-to is used. Both, node-source and support node, can be private. Private node repulses incoming connections from all addresses except specified by parameters --download-from, --upload-to and --monitor-node-ip. To filter only ip-address is used (port is not used). Parameter --monitor-node-ip sets ip-address of the monitoring server and is used in case if there is a need to provide monitoring of the private node (without specifying this parameter private node will repulse all requests from the monitoring server).

Example of launching the private source which will give data only to support node from the previous example:

acestreamengine \
  --stream-source-node \
  --port 7764 \
  --source "http://brodilo.tv/channel.php" \
  --name "test" \
  --title "test" \
  --bitrate 350000 \
  --publish-dir /var/www/transport \
  --cache-dir /var/cache/acestream \
  --private-node 1 \
  --upload-to "192.168.1.3:8631"

Start nodes

Start node is intended to provide the fastest possible start of a broadcast from users' side.

A special feature of the start node is a constant rotation of connections. When new incoming connections are received the start node terminates connections to nodes which were connected earlier and have already downloaded certain amount of data.

To launch the engine in the start node mode parameter --stream-startup-node is used.

The start node takes the same set of parameters as the support node.

Example of launching the start node:

acestreamengine \
 --stream-startup-node \
 --url http://192.168.1.2/transport/test.acelive \
 --port 8632 \
 --download-from "192.168.1.2:7764"

Metatrackers

Metatracker is a server which informs nodes about available trackers and start nodes.

Metatracker's URL is given at the source when creating a broadcast and is recorded to the transport file.

Metatrackers allow to add trackers and/or start nodes for the broadcast automatically without the need to restart the broadcast and recreate the transport file.

Example of launching a source with the metatracker:

acestreamengine \
  --stream-source-node \
  --port 7764 \
  --source "http://brodilo.tv/channel.php" \
  --metatracker "http://example.org/metatracker.php"
  --name "test" \
  --title "test" \
  --bitrate 350000 \
  --publish-dir /var/www/transport \
  --cache-dir /var/cache/acestream \
  --private-node 1 \
  --upload-to "192.168.1.3:8631"

Metatracker accepts requests via HTTP protocol and gives responds in JSON format, therefore the metatracker can be implemented on the basis of any web server.

When broadcast starts, each node sends to the metatracker HTTP GET request with parameter infohash (broadcast hash as a hex-string). Example of the request to the metatracker:

http://example.org/metatracker.php?infohash=a94a8fe5ccb19ba61c4c0873d391e987982fbbd3

Respond format:

{
    "trackers": ["tracker_url_1", "tracker_url_2", ...],
    "startup_nodes": ["node1_address", "node2_address", ...],
    "interval": UPDATE_INTERVAL_IN_SECONDS
}

where

• tracker_url_1, tracker_url_2 - trackers' URL
• node1_address, node2_address - start nodes' addresses as strings in ip:port format (for example, 192.168.1.2:8632)
• UPDATE_INTERVAL_IN_SECONDS - update interval in seconds (how often each client has to reapply to metatreker)

Respond example:

{
    "trackers":["udp:\/\/tracker.example.org:2710\/announce"],
    "startup_nodes":["192.168.1.2:8632"],
    "interval":3600
}

Example of a server code on PHP:

<?php
$infohash = isset($_GET['infohash']) ? $_GET['infohash'] : '';

$trackers = array(
    'udp://tracker.example.org:2710/announce',
);

$startup_nodes = array(
    '192.168.1.2:8632',
);

$data = array(
    'trackers'      => $trackers,
    'startup_nodes' => $startup_nodes,
    'interval'      => 30,
);

header('Content-Type: application/json');
echo json_encode($data);

Node's web-interface

Every node Каждый узел имеет веб-интерфейс для просмотра текущего состояния, а также возможности изменения некоторых параметров "на лету" (без перезапуска узла).

Веб-интерфейс работает на основном порту узла (заданном параметром --port).

По умолчанию веб-интерфейс доступен только с той же машины, на которой запущен узел. Для того, чтобы разрешить удаленный доступ, необходимо запустить узел с опцией --service-remote-access. Также можно задать пароль на веб-интерфейс для предотвращения несанкционированного доступа с помощью опции --service-access-token

Полный список опций для настройки веб-интерфейса:

• --stats-report-interval - частота обновления статистики узла в секундах (по умолчанию 60)
• --stats-report-peers - если данная опция задана, то в мониторинг будет выдаваться список узлов, с которыми в данный момент соединен данный узел (по умолчанию список узлов не выводится)
• --service-remote-access - разрешить удаленный доступ на веб-интерфейс
• --service-access-token - задать пароль на веб-интерфейс

Доступ к веб-интерфейсу осуществляется по HTTP-GET запросом на порт узла:

• мониторинг - http://node.address:PORT/app/TOKEN/monitoring
• управление - http://node.address:PORT/app/TOKEN/update

Если узел запущен без опции --service-access-token, то TOKEN в запросе не указывается.
Ответы выдаются в формате JSON.

Примеры:

• запрос на узел без пароля на веб-интерфейс:

http://192.168.1.3:8640/app/monitor

• запрос на узел с паролем qwerty на веб-интерфейс:

http://192.168.1.3:8640/app/qwerty/monitor

Мониторинг

Интерфейс мониторинга выдает такую информацию:

• version - версия узла
• max_connections - максимальное кол-во TCP-соединений
• max_peers - максимальное кол-во одновременно подсоединенных узлов
• max_upload_slots - максимальное кол-во открытых слотов для раздачи
• download_speed - текущая скорость загрузки данных (байт/с)
• upload_speed - текущая скорость отдачи данных (байт/с)
• connected_peers_count - кол-во подсоединенных узлов
• connected_peers - список подсоединенных узлов (пустой, если не задана опция --stats-report-peers)
• upload_slots - текущее кол-во слотов для раздачи

Управление

Для изменения параметров узла "на лету" нужно отправить запрос такого вида на веб-интерфейс:

http://192.168.1.3:8640/app/update?param1=value1&param2=value2...

param1 и param2 задают названия параметров, которые необходимо обновить, value1 и value2 - новые значения для параметров.

Доступные для обновления параметры:

• max_peers
• max_upload_slots

Пример:

http://192.168.1.3:8640/app/update?max_peers=100&max_upload_slots=30
(держать соединения с 100 узлами одновременно и открыть 30 слотов на раздачу)