Installation on Linux OS

Platform Verification

If you are unsure if the distribution you downloaded is appropriate for your Operating System, you can use the platformTests program. This program is available with all distributions and provides a suite of platform compatibility tests. It can be found in the bin directory.

On all systems, open a console or terminal (command prompt) and run the platformTests executable (./platformTests). It will print out the results of the platform compatibility tests. If the test succeeds, then you have an appropriate distribution!

Linux Limitations

Linux systems place limits on the number of sockets and file descriptors a process may use. This will apply to the EMS as well. If you plan on using more than 1024 connections at one time for your server, you will need to modify the following configuration file: /etc/security/limits.conf

The following lines will need to be added/modified:

soft nofile 16384
hard nofile 65536
soft nproc 4096
hard nproc 16384

Installation Procedure

Linux Package (Linux apt/yum Installer)

Pre-requisites:

Disable firewall making sure that keys will be downloaded
Administrative privileges are required. This can be accomplished in many ways.

If the sudo utility is available:
```
$ su –
```
If the sudo utility is not available:
```
$ sudo su –
```
Note: The prompt changes from $ to # when administrative privileges are enabled.

Installation Procedure:

1. Retrieve the script used to install the EvoStream software repository and store it

Debian based Linux distributions (Ubuntu or Debian)

# wget http://apt.evostream.com/installkeys.sh -O /tmp/installkeys.sh

RedHat based Linux distributions (CentOS, Fedora, RHEL)

# curl http://yum.evostream.com/installkeys.sh -o /tmp/installkeys.sh

2. Execute the script to install the EvoStream software repository and keys

# sh /tmp/installkeys.sh

If successful, the following message should be printed on the console:
```
"EvoStream keys installed successfully"
```

At this stage, the EvoStream software repository and keys are successfully installed and you can install packages from it.

Note: Steps 1 and 2 above must be executed only once.

The following steps are used to install the EvoStream Media Server, and can be repeated to update the EMS to the most recent release.

3. Install EvoStream Media Server.

Debian based Linux distributions (Ubuntu or Debian)
```
# apt-get install evostream-mediaserver
```
RedHat based Linux distributions (CentOS, Fedora, RHEL)
```
# yum install evostream-mediaserver
```

License Installation

To install the license, simply copy the License.lic file to /etc/evostreamms/.

Linux Archive (.tar.gz Distribution)

You can install the EMS from a simple archive file (.tar.gz). The latest EMS Release can be found on the EvoStream website: https://evostream.com/software-downloads/.

You will need to choose the most appropriate distribution for the Operating System that you are using. Once you have downloaded your distribution.

Simply extract the EMS package. The location of the installation is not important. However, for security reasons, the EvoStream Media Server should NOT be installed into the web-root of the target computer (if one exists).

License Installation

To install the license, simply copy the License.lic file to ../config/License.lic.

Distribution Content

Linux Package

A. Configuration Files

├── etc
│   └── evostreamms
│       ├── blacklist.txt
│       ├── config.lua
│       ├── server.cert
│       ├── server.key
│       ├── users.lua
│       ├── webconfig.lua
│       └── whitelist.txt

B. Executable and Node Files

├── usr
│   ├── bin
│   │   ├── evo-avconv
│   │   ├── evo-mp4writer
│   │   ├── evo-node
│   │   ├── evostreamms
│   │   ├── node-ews
│   │   ├── node-webservices
│   │   ├── node-webui
│   └── share
│       ├── evo-avconv
│       │   └── presets
│       │       ├── libx264-baseline.avpreset
│       |       ├── libx264-fast.avpreset
│       |       ├── libx264-fast.avpreset
│       |       ├── libx264-faster.avpreset
│       |       ├── libx264-faster.avpreset
│       |       ├── libx264-ipod320.avpreset
│       |       ├── libx264-ipod640.avpreset
│       |       ├── libx264-lossless_fast.avpreset
│       |       ├── libx264-lossless_max.avpreset
│       |       ├── libx264-lossless_medium.avpreset
│       |       ├── libx264-lossless_slow.avpreset
│       |       ├── libx264-lossless_slower.avpreset
│       |       ├── libx264-lossless_ultrafast.avpreset
│       |       ├── libx264-main.avpreset
│       |       ├── libx264-medium.avpreset
│       |       ├── libx264-medium_firstpass.avpreset
│       |       ├── libx264-placebo.avpreset
│       |       ├── libx264-placebo_firstpass.avpreset
│       |       ├── libx264-slow.avpreset
│       |       ├── libx264-slow_firstpass.avpreset
│       |       ├── libx264-slower.avpreset
│       |       ├── libx264-slower_firstpass.avpreset
│       |       ├── libx264-superfast.avpreset
│       |       ├── libx264-superfast_firstpass.avpreset
│       |       ├── libx264-ultrafast.avpreset
│       |       ├── libx264-ultrafast_firstpass.avpreset
│       |       ├── libx264-veryfast.avpreset
│       |       ├── libx264-veryfast_firstpass.avpreset
│       |       ├── libx264-veryslow.avpreset
│       |       └── libx264-veryslow_firstpass.avpreset
│       └── doc
│           └── evostreamms
│               ├── copyright
│               ├── EvoStream Media Server EULA v2.pdf
│               ├── README.txt
│               └── version
│                   ├── BUILD_DATE
│                   ├── BUILD_NUMBER
│                   ├── CODE_NAME
│                   ├── OS_NAME
│                   ├── OS_VERSION
│                   └── RELEASE_NUMBER

B.1. Node-WebServer Files

├── usr
│   ├── bin
│   │   ├── node-ews
│   │   |   ├── evo-phpengine
│   │   |   ├── ews.node
│   │   |   ├── fileRotateSize.js
│   │   |   ├── helper.js
│   │   |   ├── node-ews.js
│   │   |   ├── node_modules
│   │   │   |   ├── basic-auth
│   │   │   |   ├── connect
│   │   │   |   └── winston
│   │   |   └── req_handlers     
│   │   │   |   ├── authproxy.js
│   │   │   |   ├── default.js
│   │   │   |   ├── httpstream.js
│   │   │   |   ├── php.js
│   │   │   |   └── resphdrs.js  

B.2. Node-Webservices Files

├── usr
│   ├── bin
│   │   ├── node-webservices
│   │   |   ├── app.js
│   │   |   ├── base_plugins
│   │   │   |   ├── basehdsplugin.js
│   │   │   |   ├── basehlsplugin.js
│   │   │   |   └── baseplugin.js    
│   │   |   ├── bin
│   │   │   |   └── www       
│   │   |   ├── config
│   │   │   |   ├── logging.json
│   │   │   |   └── plugins.json    
│   │   |   ├── core_modules
│   │   │   |   └── ems-api-core.js      
│   │   |   ├── LICENSE
│   │   |   ├── logs
│   │   │   |   └── evowebservices.log          
│   │   |   ├── node_modules
│   │   │   |   ├── body-parser
│   │   │   |   ├── comment-json
│   │   │   |   ├── concat-stream
│   │   │   |   ├── debug
│   │   │   |   ├── express
│   │   │   |   ├── morgan
│   │   │   |   ├── request-enhanced
│   │   │   |   ├── s3
│   │   │   |   └── winston
│   │   |   ├── package.json
│   │   |   ├── plugins
│   │   │   |   ├── amazondashupload.js
│   │   │   |   ├── amazonhdsupload.js
│   │   │   |   ├── amazonhlsupload.js
│   │   │   |   ├── streamautorouter.js
│   │   │   |   ├── streamloadbalancer.js
│   │   │   |   └── streamrecorder.js   
│   │   |   ├── README.md
│   │   |   ├── README.txt
│   │   |   ├── routes
│   │   │   |   ├── evowebservices.js
│   │   │   |   └── index.js      
│   │   |   ├── services
│   │   │   |   └── plugin-service.js
│   │   |   ├── views
│   │   │   |   ├── error.hbs
│   │   │   |   ├── index.hbs
│   │   │   └── └── layout.hbs

B.3. Node-WebUI Files

├── usr
│   ├── bin
│   │   ├── node-webui
│   │   |   ├── app.js
│   │   |   ├── auth
│   │   │   │   ├── passport-config.js
│   │   │   │   └── restrict.js
│   │   |   ├── bin
│   │   │   │   └── webui_activate
│   │   |   ├── config
│   │   │   │   ├── dir-config.js
│   │   │   │   ├── logging.json
│   │   │   │   └── social-auth-config.js
│   │   |   ├── core_modules
│   │   │   │   ├── ems-api-core.js
│   │   │   │   ├── ems-api-proxy.js 
│   │   │   │   ├── ems-config-core.js
│   │   │   │   └──  socket-io-api.js
│   │   |   ├── data
│   │   │   │   ├── help.json
│   │   │   │   └──  user.json   
│   │   |   ├── logs
│   │   │   │   ├── webui.log 
│   │   |   ├── models
│   │   │   │   ├── list-config.js
│   │   │   │   ├── list-streams.js
│   │   │   │   └──  user.js
│   │   |   ├── node_modules
│   │   │   │   └──  [168 node_module files]
│   │   |   ├── public
│   │   │   │   ├── css
│   │   │   │   ├── fonts
│   │   │   │   ├── images
│   │   │   │   ├── js
│   │   │   │   └──  media
│   │   |   ├── routes
│   │   │   │   ├── api-explorer.js   
│   │   │   │   ├── dashboard.js
│   │   │   │   ├── ems.js
│   │   │   │   ├── index.js
│   │   │   │   ├── tream.js
│   │   │   │   └── users.js
│   │   |   ├── services 
│   │   │   │   └──  stream-service.js
│   │   |   ├── views
│   │   │   │   ├── admin
│   │   │   │   ├── index
│   │   │   │   ├── error.hbs
│   │   │   └── └──  index.hbs  

4. XML Files

└── var
    ├── evostreamms
    │   ├── media
    │   └── xml
    │       ├── auth.xml
    │       ├── bandwidthlimits.xml
    │       ├── connlimits.xml
    │       ├── ingestpoints.xml
    │       └── pushPullSetup.xml

5. Evo-Webroot Files

└── var
    ├── evo-webroot
    │   ├── demo
    │   │   ├── css
    │   │   ├── evoplayers.html
    │   │   ├── evo.png
    │   │   ├── evowsabrvideo.html
    │   │   ├── js
    │   │   │   └── evohtml5player-latest.bundle.js 
    │   │   ├── jsonMetaTest.html
    │   │   ├── jsonMetaWriteTest.html
    │   │   └── loading.gif
    │   ├── clientaccesspolicy.xml
    │   └── crossdomain.xml    

6. Log Files

└── var
    ├── log
    │   └── evostreamms

7. Executable Files

└── var
    └── run
        └── evostreamms

Linux Archive

./EvoStream Archive
  ├── bin
  │   ├── node-evowebservices
  │   │   ├── base_plugins
  │   │   │	  ├── basehdsplugin.js
  │   │   │	  ├── basehlsplugin.js
  │   │   │	  └── baseplugin.js    
  │   │   ├── bin
  │   │   │   └── www       
  │   │   ├── config
  │   │   │	  ├── logging.json
  │   │   │	  └── plugins.json    
  │   │   ├── core_modules
  │   │   │	  └── ems-api-core.js       
  │   │   ├── logs
  │   │   │	  └── evowebservices.log          
  │   │   ├── node_modules
  │   │   │	  ├── body-parser
  │   │   │	  ├── comment-json
  │   │   │	  ├── concat-stream
  │   │   │	  ├── debug
  │   │   │   ├── express
  │   │   │   ├── morgan
  │   │   │	  ├── request-enhanced
  │   │   │	  ├── s3
  │   │   │	  └── winston
  │   │   ├── plugins
  │   │   │	  ├── amazondashupload.js
  │   │   │	  ├── amazonhdsupload.js
  │   │   │	  ├── amazonhlsupload.js
  │   │   │	  ├── streamautorouter.js
  │   │   │	  ├── streamloadbalancer.js
  │   │   │	  └── streamrecorder.js   
  │   │   ├── routes
  │   │   │	  ├── evowebservices.js
  │   │   │	  └── index.js      
  │   │   ├── services
  │   │   │	  └── plugin-service.js
  │   │   ├── views
  │   │   │   ├── error.hbs
  │   │   │	  ├── index.hbs
  │   │   │	  └── layout.hbs
  │   │   ├── app.js
  │   │   ├── LICENSE
  │   │   ├── package.json
  │   │   ├── README.md
  │   ├── └── README.txt  
  │   ├── node-ews
  │   │   ├── node_modules
  │   │   │   ├── basic-auth
  │   │   │   ├── connect
  │   │   │   └── winston 
  │   │   ├── req_handlers
  │   │   │   ├── authproxy.js
  │   │   │   ├── default.js
  │   │   │   ├── httpstream.js
  │   │   │   ├── php.js
  │   │   │   └── resphdrs.js  
  │   │   ├── evo-phpengine.exe
  │   │   ├── ews.node
  │   │   ├── fileRotateSize.js
  │   │   ├── helper.js
  │   │   └── node-ews.js
  │   ├── node-webui
  │   │   ├── auth
  │   │   │   ├── passport-config.js
  │   │   │   └── restrict.js
  │   │   ├── bin
  │   │   │   └── webui_activate
  │   │   ├── config
  │   │   │   ├── dir-config.js
  │   │   │   ├── logging.json
  │   │   │   └── social-auth-config.js
  │   │   ├── core_modules
  │   │   │   ├── ems-api-core.js
  │   │   │   ├── ems-api-proxy.js 
  │   │   │   ├── ems-config-core.js
  │   │   │   └── socket-io-api.js
  │   │   ├── data
  │   │   │   ├── help.json
  │   │   │   └── user.json   
  │   │   ├── logs
  │   │   │   └── webui.log 
  │   │   ├── models
  │   │   │   ├── list-config.js
  │   │   │   ├── list-streams.js
  │   │   │   └── user.js
  │   │   ├── node_modules
  │   │   │   └── [168 node_module files]
  │   │   ├── public
  │   │   │   ├── css
  │   │   │   ├── fonts
  │   │   │   ├── images
  │   │   │   ├── js
  │   │   │   └── media
  │   │   ├── routes
  │   │   │   ├── api-explorer.js   
  │   │   │   ├── dashboard.js
  │   │   │   ├── ems.js
  │   │   │   ├── index.js
  │   │   │   ├── stream.js
  │   │   │   └── users.js
  │   │   ├── services 
  │   │   │   └── stream-service.js
  │   │   ├── views
  │   │   │   ├── admin
  │   │   │   ├── index
  │   │   │   ├── error.hbs
  │   │   │   └── index.hbs  
  │   │   ├── app.js
  │   │   ├── LICENSE
  │   │   └── package.json     
  │   ├── emsTranscoder.sh
  │   ├── evo-avconv
  │   ├── evo-mp4writer
  │   ├── evostreamms
  │   ├── platformTests
  │   ├── run_console_ems.sh
  │   ├── run_console_webui.sh
  │   ├── run_daemon_ems.sh
  │   ├── run_daemon_webui.sh  
  │   └── run_stop_webui.sh
  ├── config
  │   ├── auth.xml
  │   ├── bandwidthlimits.xml
  │   ├── blacklist.txt
  │   ├── config.lua
  │   ├── connlimits.xml
  │   ├── ingestpoints.cml
  │   ├── pushPullSetup.xml
  │   ├── server.cert
  │   ├── server.key
  │   ├── users.lua
  │   ├── webconfig.json
  │   └── whitelist.txt
  ├── evo-avconv-presets
  │   └── [30 transcode preset files]
  ├── evo-webroot
  │   ├── demo
  │   │   ├── css
  │   │   │   ├── common.css
  │   │   │	  └── common.css.orig  
  │   │   ├── js
  │   │   │	  └── evohtml5player-latest.bundle.js 
  │   │   ├── evo.png
  │   │   ├── evoplayers.html
  │   │   ├── evowsabrvideo.html
  │   │   ├── jsonMetaTest.html
  │   │   ├── jsonMetaWriteTest.html
  │   │   └── loading.gif
  │   ├── clientaccesspolicy.xml
  │   └── crossdomain.xml
  ├── logs
  ├── media
  ├── BUILD_DATE
  ├── Evostream Media Server EULA v2.pdf
  └── README.txt