Ezserver User Guide

Table of Contents

System requirement

System Setup

System Maintenance

Management

Channel

Movie

Series

User

Group

Active connection

Alert connection

EPG

User Agent

Blacklist

Balancer

Setting

Statistics

Reseller

Output link

Multicast UDP

Unicast UDP

RTMP Input

Appendix A


Software requirement

Linux 64-bit platform: Debian 8, 9 (Recommended), Ubuntu 14, 16, Centos.


Hardware requirement

(The below numbers of channel and players are based on network card speed, RAM size and CPU core number.)

         

Minimum

Requirement

 

200

channels

 

300

channels

 

500

channels

   

800

concurrent players

 

1,000

concurrent players

 

4,500

concurrent players

 Dual-Core(1.2xGHz)

 

 Quad-Core (Intel i7 4790)

 

Intel Xeon E5-2630v3 8C/

16t 2.4 GHz/3.2 GHz

 

2x Intel Six-Core Xeon E5-2620v3

RAM 8GB

 

RAM 16GB

 

RAM 64 GB 

 

RAM 128GB

Network Card

1G Base

 

Network Card

1G Base

 

Network Card

10G Base

 

Network Card

Upload 10G BASE

Download 10G BASE

Storage

150MBytes

 

1.2Mbps Channel

 

1.2Mbps Channel

 

1.2Mbps Channel


Installation

  • Windows version

    • Enterprise version

      • Download ezserver_enterprise.zip from the checkout web page.

      • Refer Readme.txt in zip file to run Ezserver.exe.

  • Linux version

    • Download install.sh from the checkout web page.

    • Copy install.sh into /root or /home folder.

    • Login ssh

    • cd /root

    • chmod 777 install.sh

    • ./install.sh

    • Input installation password.

    • Select network interface, panel port, http streaming port and automatic startup.


License activation

  • Windows version

    • Enterprise version

      • Send us the ezserver_enterprise/serial_number.txt (size: 74bytes) to active ezserver license.

  • Linux version

    • Enterprise version

      • cd ezserver_enterprise

      • ls -al serial_number.txt

      • Send serial_number.txt to sales@ezhometech.com for license activation.


Start Ezserver

  • Windows version

    • Click Ezserver.exe

  • Linux version

    • Enterprise version

      • cd ezserver_enterprise

      • ./start.sh


Normally shutdown

  • Panel way

    • Login panel

    • Click Restart button

  • SSH way

    • Press Ctrl + C keys after ./start.sh in SSH console.


Emergency shutdown

  • cd ezserver_enterprise

  • ./shutdown.sh


Login Panel

  • After ./start.sh, ssh will show the below message:


Change System Setting

  • cd ezserver_enterprise

  • ./setup.sh

    1. Please select network interface (current setting is eth0)

      eth0

      eth1

      lo

      --> eth1

    2. Please type new panel port no. (18000): 18009

    3. Please type new http streaming port no. for players (8000): 8008

    4. Do you want to setup auto_start mode?(y/n): y


Backup System Configuration

  • cd ezserver_enterprise

  • ./shutdown.sh (shutdown ezserver first)

  • ./backup_setting.sh

  • ls -al ezserver_backup_setting.tar

    • includes system, channel, movie, group, user, reseller configuration.

  • download ezserver_backup_setting.tar to local PC.


Restore System Configuration

  • upload ezserver_backup_setting.tar to ezserver_enterprise folder

  • cd ezserver_enterprise

  • ./shutdown.sh (shutdown ezserver first)

  • ./restore_setting.sh

  • ./start.sh


Enable Auto Start

There are 2 options for auto start mode.

Option 1:

  • cd ezserver_enterprise

  • ./setup.sh

    1. Please select network interface (current setting is eth0)

      eth0

      eth1

      lo

      --> (Press enter key)

    2. Please type new panel port no. (18000): (Press enter key)

    3. Please type new http streaming port no. for players (8000):(Press enter key)

    4. Do you want to setup auto_start mode?(y/n): y

Option 2:

  • cd ezserver_enterprise

  • pwd

    To show path: /root/ezserver_enterprise

  • crontab -e

  • Add the below line in the end of the file:

    • */1 * * * * /root/ezserver_enterprise/checkmo.sh


Disable Auto Start

There are 2 options to disable start mode.

Option 1:

  • cd ezserver_enterprise

  • ./setup.sh

    1. Please select network interface (current setting is eth0)

      eth0

      eth1

      lo

      --> (Press enter key)

    2. Please type new panel port no. (18000): (Press enter key)

    3. Please type new http streaming port no. for players (8000):(Press enter key)

    4. Do you want to setup auto_start mode?(y/n): n

Option 2:

  • crontab -e

  • remove */1 * * * * /root/ezserver_enterprise/checkmo.sh


Software update

There are 2 options for software update.

Option 1: Get patch files. (recommended)

  • cd ezserver_enterprise

  • ./shutdown.sh

  • ./patch.sh

  • input patch password

  • ./start.sh

Option 2: Create new folder and backup the current folder.

  • cd ezserver_enterprise

  • ./shutdown.sh

  • ./update_latest_ezserver.sh

  • input patch password

  • ./start.sh


Cloudflare setting


Administrator profile setting

  • Add new user

  • Click Edit more options of the user

  • Change Level to Administrator as below:

  • Change root level to User.


Channel zapping with Max connection control

  • Add user_connection_fifo option in ezserver_config.txt.

    • user_connection_fifo=1 : Speed up channel fast time and disconnect the previous connection.

    • user_connection_fifo=0 : Strictly check user max connection from multiple connections. 

  • restart ezserver.


Amazon EC2

  • ifconfig 

    • List all network interface.

      • eth0

      • em3

  • Add new network interface with public IP

    • Example: ifconfig eth0:1 187.178,11.1 up

  • cd ezserver_enterprise

  • ./setup.sh

    • Please select network interface (current setting is eth0)

      eth0

      eth0:1

      em3

      --> eth0:1

  • ./start.sh


Disk Full

  • df 

    • List all disk space

    • /root 100%

    • /home 2%

  • cd /root

  • tar cvfz 1.tar ezserver_enterprise/

  • mv 1.tar /home/

  • cd /home

  • tar xfvz 1.tar

  • cd ezserver_enterprise

  • ./setup.sh

  • ./start.sh


New server installation with old server setting

  • In old server

    • cd ezserver_enterprise

    • ./shutdown.sh

    • ./backup_setting.sh

    • ls -al ezserver_backup_setting.tar

  • In new server

    • ./install.sh

    • copy ezserver_backup_setting.tar from old server into ezserver_enterprise folder of new server

    • ./restore_setting.sh

    • rm serial_number.txt

    • ./setup.sh

    • send us serial_number.txt for activation


DNS server setting

  • nslookup www.google.com

    • Server: 192.168.0.1  --- this Is the nearest DNS IP

  • Open ezt_dns.txt to change 8.8.8.8 to the nearest DNS IP.


System diagnostics

  • Click Setting button

  • Set 1 to System Log lines and Admin. System Log Lines.

  • Click Save button.

  • Click Restart button when the issue is happened.

  • Send us all files in ezserver_enterprise/log folder.


User Authorization control

  • Streaming URL with token or username / password:

    • Set user_authorization=1 in ezserver_config.txt.

  • Streaming URL without token or username / password:

    • Set user_authorization=0 in ezserver_config.txt.

  • Normally shutdown ezserver

  • ./start.sh


User Token control

  • Restore token after ezserver restarting:

    • Add one option token_restore=1 in ezserver_config.txt.

    • Normally shutdown ezserver

    • ./start.sh

  • Token expired: (unit: hour)

    • Add one option token_period=xxx in ezserver_config.txt, 

      • token_period=12 means unused tokens are expired after 12 hours.

      • token_period=5.5 means unused tokens are expired after 5 hours 30 min.

      • min. value 10 min.

    • Normally shutdown ezserver

    • ./start.sh


HTML access protection

  • HTML Access Protection allows per-directory access control requiring a username or groupname to access the content. It defines them in a xml file that is stored in ezserver_enterprise/security/folder_access.xml that has 3 tags, <folder>, <userid> and <group>. It can define the folder accessed by a user or by a group.

    <?xml version="1.0" encoding="iso-8859-1" ?>
    <folder>admin</folder>
    <userid>root</userid>
    <folder>security</folder>
    <userid>root</userid>
    <folder>users</folder>
    <userid>root</userid>
    <folder>middleware</folder>
    <group>golden</group>
    <folder>middleware</folder>
    <group>basic</group>


Country Filter

  • Country Filter is to filter all players by Countries to access video from Ezserver.

  • Country Filter defines them in a xml file that is stored in ezserver_enterprise /security/security_definition.xml.

<accepted_country>TW</accepted_country>

<accepted_country>IN</accepted_country>

<accepted_country>CN</accepted_country>

  • Country abbreviation : ezserver_enterprise/users/user_dot_ip_country.csv


Dashboard

shows System, User, Channel and Movie information, 


Channel Web Management


Add new channel

  • Check your source link if it is available for your server as below:

    • Login ssh console

    • wget -O 1.ts source_url

      • Ex. wget -O 1.ts http://192.168.0.10:8063/1.ch?u=test:p=1234

    • If the response is as below, you can add this URL into channel list.

      • HTTP request sent, awaiting response... 200 OK.

    • If the response is as below, you can not add this URL into channel list.

      • Connecting to 192.168.0.10:8063... failed: Connection refused.

      • HTTP request sent, awaiting response... 403 Forbidden

  • Click Add button.

  • Media Source

    • Support UDP, HTTP, HLS, RTMP URL and Folder Playlist

    • URL

      • UDP Syntax:

        • udp://port_no (without @)

          • Example: udp://9001

        • udp://ip:port_no (without @)

          • Example: udp://224.1.1.1:9001

        • udp://ip:port_no/program_no (without @)

          • Example: udp://224.1.1.1:9001/1001

      • HTTP Syntax:

        • http://ip:port_no/path

          • Example: http://192.168.0.1/1.ch

      • HLS Syntax:

        • http://ip:port_no/path.m3u8

          • Example: http://192.168.0.1/ch1.m3u8

      • RTMP Syntax:

        • rtmp://ip:port_no/patch

          • Example: rtmp://192.168.0.1/live/live1

    • Folder Playlist

      • MPEG TS Playlist

        • Support video format: MPEG TS (.ts)

        • The playing sequence of videos is by alphabetical order.

        • Syntax: dir://folder_name

        • Example: dir://middleware/videos/episodecs1

          • The absolute folder path in the server side is /root/ezserver_enterprise /middleware/videos/episodecs1

      • Video and Image Playlist

        • Support video format: MPEG TS, MP4, FLV, AVI, MKV, MP3, JPEG, PNG

        • The playing sequence of videos is by alphabetical order.

        • Syntax: playlist://folder_name

        • Example: playlist://middleware/videos/episodecs1

          • The absolute folder path in the server side is /root/ezserver_enterprise /middleware/videos/episodecs1

  • Icon Path

    • Syntax: file://path

    • Example: file://middleware/pictures/episodecs.png

      • The absolute icon path in the server side is /root/ezserver_enterprise /middleware/pictures/episodecs.png

  • Type : Live, Inactive, Delay, DVR

  • Click Add button of Dialog Box.


Add backup channel

  • Click Edit more options of one channel as below:

  • Input the 2nd and 3rd URL.

  • Click Save button.


Update channel

  • Click 3-dot icon and Save button of one channel as below:


Delete channels

  • Click checkbox of channels.

  • Click Delete button.


Update channel more options

  • Click Edit more options button and disable pop-window locked option as below:


Create channel category

  • Click Channel: Category: Add button.


Refresh channels

  • Click checkbox of channels.

  • Click Refresh button.


Move channels

  • Click checkbox of channels, then click Cut button as below:

  • Click checkbox of one channel, then click Paste button as below:


Import channels

  • Download way:

  • Direct way:

    • Click Import button.

    • Input HTTP M3U URL, After Channel No. and Option.

    • Click import button of import dialog.


Show Inactive channels

  • Click OFF button to show OFF channels.

  • Click All button to show all channels.

 


Offline channel notice

  • Add channel_off_video_path=admin/channel_no_signal.ts in ezserver_config.txt.

  • ./start.sh


Unauthorized channel notice

  • Add channel_off_video_path=admin/authorized_channel.ts in ezserver_config.txt.

  • ./start.sh


Apple HLS channel

  • Click Edit more options of one channel and select Constant Bitrate (internal transcoder) as below:

  • Click Save button.

  • Streaming URL

    • Single channel: 

      • http://192.168.0.10:8000/ch1.m3u8?u=test:p=1234

      • http://192.168.0.10:8000/TV.m3u8?u=test:p=1234

    • All channels: http://192.168.0.10:8000/getlink?username=test:password=1234:type=hls


RAM Disk for HLS channels

  • du hls_archive

    • get hls_archive size (ex.4000), then set double size for RAMDisk.

  • Add RAMDisk=xxxx in ezserver_config.txt.

  • RAMDisk=8000 means 8Gbytes ramdisk for hls_archive folder.

  • df | grep tmpfs

    • check hls_archive.


AES-128 encrypted channel

  • Click Edit more options of one channel and select AES-128 Encryption (internal transcoder) as below:

  • Click Save button.

  • Streaming URL

    • Single channel: 

      • http://192.168.0.10:8000/ch1.m3u8?u=test:p=1234

      • http://192.168.0.10:8000/TV.m3u8?u=test:p=1234

    • All channels: http://192.168.0.10:8000/getlink?username=test:password=1234:type=hls


DVR type

Time-Shift channel is to save live stream from source URL into server local storage. When a player wants to play it, Ezserer restreams its videos from server local storage to the player. The player can backward and forward the channel with timestamp.

  • Select DVR as below:

  • Click Save button of the channel.

  • Streaming URL

    • http://serverip:port/xxx?u=xxx:p=xxx::timestamp=xxxxxxxxxx

    • Timestamp unit is millsecond.

    • Play video from the 600th second (10 min) of the DVR buffer.

      • http://192.168.0.6:8000/ch1.m3u8?u=test:p=1234:timestamp=600000

      • http://192.168.0.6:8000/sport.m3u8?u=test:p=1234:timestamp=600000

    • Play video back to live.

  • The storage size of per channel depends on video bitrate and duration.

    • Channel video bitrate is 1Mbps and duration is 1 hour, the storage size needs 450M bytes.

    • 100 channels, 1Mbps bitrate, 1-hour duration, the storage size needs 45G bytes.


Encrypted DVR type

  • Select DVR as below:

  • Click Save button of the channel.

  • Click Edit more options of one channel and select AES-128 Encryption (internal transcoder) as below:

  • Click Save button.


DVR duration

  • Click Setting button and set DVR Duration as below:

  • Click Save button.

  • Restart Ezserver.


Delay type

Time Delay channel is to save live stream into server local storage. Ezserver restreams recorded videos to players.

  • Select Delay as below:

  • Click Save button of the channel.

  • Streaming URL

    • Single channel: 

      • http://192.168.0.10:8000/ch1.m3u8?u=test:p=1234

      • http://192.168.0.10:8000/TV.m3u8?u=test:p=1234

    • All channels: http://192.168.0.10:8000/getlink?username=test:password=1234:type=hls

  • The storage size of per channel depends on video bitrate and delay time.

    • Channel video bitrate is 1Mbps and delay time is 1 hour, the storage size needs 450M bytes.

    • 100 channels, 1Mbps bitrate, 1-hour delay time, the storage size needs 45G bytes.


Encrypted Delay type

  • Select Delay as below:

  • Click Save button of the channel.

  • Click Edit more options of one channel and select AES-128 Encryption (internal transcoder) as below:

  • Click Save button.

  • Streaming URL

    • Single channel: 

      • http://192.168.0.10:8000/ch1.m3u8?u=test:p=1234

      • http://192.168.0.10:8000/TV.m3u8?u=test:p=1234

    • All channels: http://192.168.0.10:8000/getlink?username=test:password=1234:type=hls


Set catch-up days

  • Click Edit more options of one channel and input Day no. as below: 

  • Click Save button.

  • Streaming URL

    • Syntax: http://serverip:port/xxx?u=xxx:p=xxx:utc=xxxxxxxxxx

    • http://192.168.0.6:8000/1.ch?u=test:p=1234:utc=1460763600

     


Set program time

  • Click EPG button

 


Catch-UP Record Flow

 


COD setting

  • Click Edit more options of one channel and Set 1 to enable COD as below: 

  • Click Save button.


COD auto-stop setting

  • Add stop_ch_cache_interval=xxx in ezserver_config.txt.

  • Unit: min.

  • stop_ch_cache_interval=10

    • Ezserver periodically checks the video streaming of all COD channels per 10 min.

    • Once a COD channel does not have any player connection over 10 ~20 min., Ezserver stops the channel pulling.


HTTP User Agent

  • Click Edit more options of one channel and set HTTP User Agent as below:

  • Click Save button.


Channel Proxy

  • Click Edit more options of one channel and select proxy mode as below:

  • Click Save button.

  • Proxy mode

    • 1: forward main URL to players

    • 2: forward balancer URL to player

    • 3: create a m3u file with main / 2nd / 3 rd URLs into players.


All channel tolerance

  • Click Setting button:

Single channel tolerance

  • Click Edit more options of one channel as below:

  • Click Save button.


Movie Web Management


Add new movie

  • Click Add button.

MOVIE 10 is located in /home/ezserver_enterprise/media/videos/Movie/1.ts.

Kids folder is located in /home/ezserver_enterprise/media/videos/Kids

  • Media Source

    • Support Local storage and HTTP URL.

    • Local storage

      • Syntax: file://path

      • Example: file://middleware/videos/Kids/1.mp4

        • The absolute folder path in the server side is /root/ezserver_enterprise /middleware/videos/Kids/1.mp4

    • HTTP URL

      • Syntax: http://ip:port_no/path

      • Example: http://192.168.0.6/films/1.mp4

  • Icon Path

    • Syntax: file://path

    • Example: file://middleware/pictures/Kids/1.jpg

      • The absolute icon path in the server side is /root/ezserver_enterprise /middleware/pictures/Kids/1.jpg

  • Click Add button of Dialog Box.

 


Update movie

  • Click 3-dot icon and Save button of one movie as below:


Delete movies

  • Click checkbox of movies.

  • Click Delete button.


Update movie more options

  • Click Edit more options button and disable pop-window locked option as below:


Refresh movies

  • Click checkbox of channels.

  • Click Refresh button.


Move movies

  • Click checkbox of movies, then click Cut button as below:

  • Click checkbox of one movie, then click Paste button as below:


Create Movie Category

  • Click Movie: Category: Add button.


AES-128 encrypted Movie

  • Add vod_encrypted=1 in ezserver_config.txt


Import movies

  • FTP / SFTP way:

    • rename your m3u filename to movie.m3u

    • upload it to ezserver_enterprise folder

    • ./start.sh

    • delete movie.m3u

  • HTTP way:

    • Click Import button.

    • Input HTTP M3U URL and After Movie No..

    • Click import button of import dialog.


Movie Proxy

  • Click Edit more options and select proxy mode as below:

  • Click Save button

  • Proxy mode

    • 0: Disable

    • 1: Enable


Remote movie storage

For external movies in other servers or outside ezserver folder, you can use Linux Symbolic Link or NFS to insert them into ezserver folder.

  • Symbolic Link

    • mkdir /root/movie

    • Upload your movie into /root/movie folder

    • cd /root/ezserver_enterprise

    • ln /root/media -s media/videos/

    • ls media/videos/

  • NFS

    • Install NFS in ezserver IP is 192.168.0.10 and Storage Server IP is 192.168.0.8.

    • Login server 192.168.0.8

      • mkdir /root/movie

      • add "/root/movie 192.168.0.10(rw)" in /etc/exports

      • ./etc/init.d/nfs-kernel-server restart

      • showmount -e localhost

    • Login server 192.168.0.10

      • cd /root/ezserver_enterprise

      • mount -t nfs 192.168.0.8:/root/movie media/videos

      • ls media/videos/


Movie description

  • Click Edit more options and input description as below:

  • Click Save button.


Movie subtitle

  • Supports HTML5 mp4 video tag for subtitle WebVTT.

  • Use same filename for .mp4 and .vtt in the same folder. 

    • Media Source is file://middleware/videos/Sports/1.mp4

    • subtitle file in ezserver_enterprise /middleware/videos/Sports/1.vtt

  •  Click "CC" to turn on/off the subtitle as below:


PPV flow


Set Movie Point

  • Click Edit more options and set Rent Point, Buy Point, Rent Period as below:

  • Click Save button.


Set User Point and Pay Mode

  • Click Edit more options and set user point as below:

  • Click Edit more options and set pay mode as below:

  • Pay Mode

    • Pre: The user rents or buys a move, User Point is subtracted by the movie point.

    • post: The user rents or buys a move,, User Point is added by the movie point.

    • free: User Point is disabled.

  • Click Save button.


Series Web Management


Add new Series

  • Click Add button.

Add new Episodes

  • Click Episode number link


Add new user

  • Click Add button.

    • Example 1:

      • Expired Time is Sep. 19, 2019

  • Example 2:

    • Expired Time is the 360th days after the first connection.

    • User IP is 192.168.0.19

    • User MAC ID is 001122334455 (Actual MAC ID: 00:11:22:33:44:55), This field needs to match Ezserver Player API: set_player_mac_address

  • Click Add button of Dialog Box.


Update user

  • Click 3-dot icon and Save button of one use as below:

 


Delete users

  • Click checkbox of users.

  • Click Delete button.


Update user more options

  • Click Edit more options button and disable pop-window locked option as below:


Cleanup Expired users

  • Click Cleanup button to clear all time-expired users.


Show Expired users

  • Click Expired button to show all expired-time users.


Move users

  • Click checkbox of users, then click Cut button as below:

  • Click checkbox of one user, then click Paste button as below:


Set Max connection

  • Click Edit more options and set max connection as below:

  • Click Save button.

  • Enable/Disable user First in First out connection.

    • Add user_connection_fifo=0/1 in ezserver_config.txt

      • 1: stop the previous connection and start new connection. (Default).

      • 0: reject start new connection over Max connection no.


Set user level

  • Click Edit more options and set level as below:

  • Level

    • Administrator

    • Supper Reseller

    • Reseller

    • Restreamer

    • User

  • Click Save button.


Set rating password for parent control

  • Click Edit more options and set rating password as below:

  • Click Save button.


Non-Register notice

  • Add unregistered_user_video_path=admin/not_registered_user.ts  in ezserver_config.txt.

  • ./start.sh


Max connection notice

  • Add exceed_max_connects_allowed_video_path=admin/exceed_max_connections_allowed.ts  in ezserver_config.txt.

  • ./start.sh


Time expired notice

  • Add time_expired_video_path=admin/time_expired.ts
     in ezserver_config.txt.

  • ./start.sh


User Setting

  • Click Setting button.

    • Enable / Disable ISP Locked Option of all users.

  • Click Save button of Dialog Box.


Add new group

  • Click Add button.

  • Period and Credit Units are for reseller use.

  • Click Add button of Dialog Box.


Update group

  • Click Save button of a group as below:



Delete group

  • Click Delete button of a group as below:


Set auto-refresh connection

  • Click Auto Refresh button.


Stop active connection

  • Click Stop button of a connection.



Stop active connection and Block IP

  • Click Block button of a connection.


Query altered connections

  • Click Query button.



Stop alerted connection

  • Click Stop button



Stop alerted connection and Block IP

  • Click Block button



Alert player duration

  • Click Setting button.

  • Input Alert Player Duration (Unit: hour)


Add new program

  • Click Add button.

  • Click Add button of Dialog Box.

  • Set Catch Up Days >=1 to enable channel recording.


Update program

  • Click Save button of a program.


Delete program

  • Click Delete button of a program.


Query program

  • Click Query button with Channel no., year and month.


Refresh EPG

  • Click Refresh button to refresh EPG content.


Record live program

  • Select ON / DAILY / PER MONDAY~SUNDAY of a program.

The path of recorded file is ezserver_enterprise /tv_program_archive/2018_05_14/CH0001_10_00.ts


Set MPEG TS source

  • For embedded EPG in MPEG TS streams as DVB stream.

  • Click Setting button.

  • Set 1 in MPEG Transport Stream.


Set XMLTV source

  • Click Setting button.

  • Input HTTP XMLTV URL

  • XMLTV channel name matches Ezserver Channel Name or EPG ID

  • XMLTV link: http://tvprofil.net/xmltv/


User Agent Filter modes

  • Mode: Disable, Reject and Accept.


Add user agent

  • Click Add button.

  • Click Add button of Dialog Box.


Delete user agent

  • Click Delete button.



Refresh user agents

  • Click Refresh button.


Blacklist modes

  • Mode: 1: Enabled, 0: Disabled.



Refresh blacklist

  • Click Refresh button.



Remove locked IP

  • Click Remove button.


Remove All locked IP

  • Click Remove All button..

  • Linux command:

    • iptables -L

      • List All locked IP.

    • iptables -F

      • Clear All locked IP.


Balancer modes

  • Mode

    • Disabled.

    • Geo. Location: Players connects Master Ezserver, then Ezserver will check the player location to redirect the request to the nearest slave server.

    • Max. Streaming number: Ezserver redirects connections to balancer when master active connections are equal to max. streaming no.



Add new balancer

  • Click Add  button.

  • Input Balancer IP or Domain name, Panel Administrator ID / Password, Panel port and its country.

  • Country abbreviation : ezserver_enterprise/users/user_dot_ip_country.csv

  • Click Add button of Dialog Box.

  • If balancer status is OFF, please refer the below steps to check their connections

    • Login main ssh and ping balancer IP. If not work, run "iptables -F" in ssh

    • Login balancer ssh and ping main IP. If not work, run "iptables -F" in ssh

    • Login main ssh and run "wget http://balancerIP:port/admin/index.htm". If not work, please open port in Balancer.

    • Login balancer ssh and run "wget http://mainIP:port/admin/index.htm". If not work, please open port in Main server.


Update balancer

  • Click Save button of a balancer.



Delete balancer

  • Click Delete button of a balancer.



Refresh balancer

  • Click Refresh button of a balancer.



Refresh all balancers

  • Click Refresh button.



Channel input buffer

  • Unit: 1K bytes

  • SD Value 8000: RAM 8M bytes for channel cache, 100 channels need RAM 800M.

  • HD Value 20000: RAM 20M bytes for channel cache, 100 channels need RAM 2G. And #9 Value: 5000, #10 value: 0.99, too

  • Channel buffer has 8 sec. for channel bitrate 1Mbps .



Zapping time buffer

  • Unit: 1K bytes.

  • SD Value 2000: RAM 2M bytes for channel I-frame search.

  • HD Value 5000: RAM 5M bytes for channel I-frame search.



Channel drop reconnection

  • When the source URL is down, Ezserver will reconnect source URL after x seconds.



Max Streaming no.

  • Active connection no. must be below Max. Streaming no.


Channel Statistics

  • Click Channel button.


Movie Statistic

  • Click Movie button.


Channel Statistic auto-refresh Query

  • Click Auto Refresh button. 


Movie Statistic Query

  • Click Query button. 


Create super reseller

  • Click Reseller: Add button and set level to Supper Reseller as below:


Create reseller

  • Click Reseller: Add button and set level to Reseller as below:


Delete reseller

  • Click Reseller: reseller name and Del button as below:


Update reseller

  • Click Save button.



Reseller Web Management

  • Input http://server_ip:18000/reseller/index.htm in an internet browser.


Channel list download

  • Click User:CH List as below:

  • Select one of options to save it.


Movie list download

  • Click User:Movie List as below:

  • Select one of options to save it.


Single URL

  • http://ip_address:port/channel_name?u=xxxx:p=xxxx

    • http://172.16.10.50:8000/robert?u= test:p=1234

  • http://username:password@ip_address:port/channel_name

    • http://test:1234@172.16.10.50:8000/robert

    • http://test:1234@172.16.10.50:8000/NBC%20SPORT%20NEWS

  • http://username:password@ip_address:port/channel_name.m3u8

    • http://test:1234@172.16.10.50:8000/robert.m3u8

  • http://ip_address:port/x.ch?u=xxxx:p=xxxx

    • http://172.16.10.50:8000/1.ch?u=test:p=1234

  • rtmp://ip_address:port/live/channel_name?u=xxxx:p=xxxx

    • rtmp://172.16.10.50/live/TV1?u=test:p=1234

  • rtmp://ip_address:port/live/x.ch?u=xxxx:p=xxxx

    • rtmp://172.16.10.50/live/1.ch?u=test:p=1234


Balancer Setup

Load Balancer not only redirects the player request by Geo. Location or Max. Streaming No. of the server to slave servers, but also supports distributed users and channels.

  • For Geo. Location, all players connect one master Ezserver, then Ezserver will check the player location to redirect the request to the nearest slave server.
  • For max. streaming connections, when the connections are equal to max. streaming no. Ezserver will redirect the requests to balancer.
  • All users in master server, balancers have only root use for panel management.
  • Balancer needs its channels.

Balancer model 1:

  • Master server handles user database.
  • Balancers handle video streaming.

Balancer model 2:

  • Master server handles user database and streaming.
  • Balancers handle video transcoding.

Master server for balancer setting:

  • Login Panel of Master server.
  • Click Setting button to set Max. Streaming No.
  • Click Balancer button and Add button to add balancers.
  • Input balancer server domain or IP, panel port, root user, password and country.

Balancer model 1 Configuration:

Configuration

Balancer model 1 Setup Flow:

Setting

  • Login Panel of Master server.

  • Click Balancer button and Add button to add balancers.

  • Input balancer server domain or IP, panel port, root user, password and country.

  • Open API port of Master server in firewall for balancer connection.

  • Add all uses in master server and keep all balancers with root user only.

  • Keep EMPTY channels in master server.

  • Add source URLs into each balancer.

  • There are two options to provide URL to users

    • If you want to hide master IP, you can only provide area balancer IP to its area players.

    • if you provide master IP to users, master auto redirects requests to slaves by incoming location.


Multicast SPTS Input

Input UDP IP and Port no. (without @) into channel Media source as below:

Multicast MPTS Input

Input UDP IP, Port no. and program ID (without @) into channel Media source as below:

Multicast input network card

Add the 2nd network card into a server and click more option of a channel to select the 2nd card for input  as below.:


Multicast SPTS output

  • Click Setting button to set multicast output IP and port:

  • 225.1.1.1: 9001 for ch1, 225.1.1.2:9001 for ch2 and 225.1.1.10:9001 for ch10.

  • need to restart ezserver after setting.

Multicast MPTS output

  • Click Setting button to set multicast output IP and port:

  • set mpts_channel_no_per_ip=x in ezserver_config.txt, x means channel no. in same IP and port.

  • for example, mpts_channel_no_per_ip=7

    • 225.1.1.1: 9001 sends ch1~ch7 UDP streams

    • 225.1.1.2:9001 sends ch8~ch15 UDP streams.

  • need to restart ezserver after setting.

Multicast AES-128 encryption output

  • Click Setting button to set multicast output IP and port:

  • set hls_multicast_aes=1 or hls_multicast_aes=2 in ezserver_config.txt.

  • need to restart ezserver after setting.

  • Support players: Ezserver Multicast Player

Multicast output network card

If you server has two network cards, the 1st card is for internet input link and the 2nd card is multicast output, You can add multicast_output_ip option into ezserver_config.txt to assign stream output to the 2nd network card.

  • Ex. multicast_output_ip=192.168.2.30


Unicast SPTS Output

  • Click Setting button to set unicast IP and port:

  • Ezserver will

    • send ch1 streams to Server 199.12.48.1: 9001.

    • send ch2 streams to Server 199.12.48.1: 9002.

    • send ch10 streams to Server 199.12.48.1: 9010.

  • need to restart ezserver after setting.


FFMPEG Unicast UDP

  • Click Channel button to set Media source to udp://port_no..

  • Click Save button of the channel.

  • FFMPEG Setting:

    • Syntax: ./ffmpeg -i input_url -f mpegts udp://ezserver_ip:port_no?pkt_size=1316

    • Example: ./ffmpeg -i http://192.168.1.100:8001/1:0:1:135:2:1:5F0B1BF:0:0:0: -f mpegts udp://127.0.0.1:9001?pkt_size=1316


VLC Unicast UDP

  • Click Channel button to set Media source to udp://port_no..

  • Click Save button of the channel.

  • VLC Setting:

    • Syntax: ./cvlc -vvv input_url --sout '#transcode{vcodec=h264,vb=750,fps=24,scale=1,acodec=mp4a,ab=96,channels=2,samplerate=44100}:udp{dst=ezserver_ip,port=port_no,mux=ts}'

    • Example: ./cvlc -vvv http://192.168.1.100:8001/1:0:1:135:2:1:5F0B1BF:0:0:0: --sout '#transcode{vcodec=h264,vb=750,fps=24,scale=1,acodec=mp4a,ab=96,channels=2,samplerate=44100}:udp{dst=123.1.3.189,port=9001,mux=ts}'


Adobe FME

  • Click Setting button to set RTMP port as below:

  • Click Save button.

  • Click Channel button to define Channel name and set Media source to rtmpencoder.

  • Click Save button of the channel.

  • Adobe FME Setting:

    • Set FMS URL with ezserver IP, "live" and channel name (robert) as the below:

  • Select Video Format : H.264 and Audio format : Mp3/AAC, Stereo

  • Select one of three bitrate options.

  • Click Start button.


XSplit

  • Click Setting button to set RTMP port as below:

  • Click Save button.

  • Click Channel button to define Channel name and set Media source to rtmpencoder.

  • Click Save button of the channel.

  • XSplit Setting:

    • Set RTMP URL with ezserver IP and channel name (robert) as the below:

  • Select Video Format : X.264 and Audio format : AAC, Stereo

  • Select one of three bitrate options.

  • Click OK button.


FFMPEG RTMP

  • Click Setting button to set RTMP port as below:

  • Click Save button.

  • Click Channel button to define Channel name and set Media source to rtmpencoder.

  • Click Save button of the channel.

  • FFMPEG Setting:

    • Syntax: ./ffmpeg -i input_url -preset ultrafast -vcodec libx264 -b 300k -bt 500k -s 720x480 -acodec aac -ar 44100 -ab 128k -strict experimental -f flv rtmp://ezserver_ip/live/channel_name

    • ./ffmpeg -i udp://224.1.1.1:9001 -preset ultrafast -vcodec libx264 -b 300k -bt 500k -s 720x480 -acodec aac -ar 44100 -ab 128k -strict experimental -f flv rtmp://192.168.0.8/live/robert


Appendix A:  Revision History

 

 

Version Date Notes
4.1.0 2018-08-29

Create HTML User Guide

4.1.0 2018-12-01

Add Channel and Movie Move functions

4.1.0 2019-01-06

Add Channel and Movie Category functions

4.1.0 2019-01-13

Add "shutdown ezserver" before backup and restore system configuration setting.

4.1.0 2019-08-07

Add Balancer configuration and setup flow.

4.1.0 2019-08-19

Add "Software Upgrade from Trial version to Formal version."