Ezserver User Guide

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.)

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:

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

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.

  • 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.

• 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:

  • refer here

• 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.

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

• 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 / 2^nd / 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