/
Install the ESS

Install the ESS

Nov 21, 2016

In this section:

Overview

The EchoSystem Server (ESS) is supported on Windows and Linux platforms. For specific operating system support, see the Deployment Guide. You must have administrative/root privileges to install the ESS.

The installation software is provided through a compressed file downloaded from the Echo360 customer support portal. Save it to a directory location on the hard drive of the machine where you want to run the ESS.

Installation Pre-Requisites

Please note the following space and setting requirements prior to installation:

  • Be sure you have at least 5 GB of free space available on the installation directory/drive before you install the ESS. The installer will check the drive and return an error message if there is insufficient space on the drive. Installation cannot continue until more space is made available.

  • If you are installing on Linux, the ulimit setting for the "maximum number of open file descriptors per process" on the server MUST be set to at least 64K (64x1024) in order for ESS installation to succeed. If this setting is lower, the installer will ask to change it. See Linux ESS Installation below for more information.

Installation Checklists

Unknown macro: {multi-excerpt-include}

Flash Streaming Media Server Installation

You will need to install and configure a Wowza Media Server from v3.5 through v4.1, or an Adobe Media Server to serve flash streaming content to users. The flash media server is used to stream both on-demand content (echoes) as well as live webcasts. See Configure the Flash Media Streaming Server for additional information and configuration instructions.

Third-Party Database Installation

You will need to install and configure a MySQL or MSSQL database server on either the ESS computer itself or on an external server. See Supported Third-Party Components on the Supported Technologies page for a list of supported databases.

Configure MySQL

MySQL can be installed on either Linux or Windows. This section does not describe how to install a MySQL server. These directions assume it is already installed.

Basic configuration instructions are as follows:

  1. Verify you are running a supported version of MySQL (Community or Enterprise 5.5 or 5.6) See Supported Technologies if necessary.

  2. Log in to the MySQL server as the root user configured when MySQL was installed.

  3. If the MySQL binary log is enabled, make sure you are using a binary logging format of either ROW or MIXED. Consult your Database Administrator if necessary.

  4. Create an ESS database/schema named essdata, and if not already set, configure the character set for utf8.

  5. Create an ESS user for the database named essuser.

  6. Assign all privileges to the essuser for the essdata database schema.

If you require more detailed instructions for creating a database and user, refer to the section below that corresponds with the MySQL installation you are running.

Configure MySQL on Linux

Create the ESS database/schema:

CREATE DATABASE essdata CHARACTER SET 'utf8' COLLATE 'utf8_general_ci';

Create the ESS user for the ESS database, and grant all necessary privileges:

grant all on essdata.* to 'essuser'@'%' identified by <your-passwd>;

Configure MySQL on Windows through MySQL Workbench

Create the ESS database/schema:

  1. In the left pane of MySQL Workbench, right-click Schema and select Create New Schema.

  2. Enter essdata into the Name field, and retain the other defaults.

  3. Click Apply, then click Finish.

Create the ESS user for the ESS database, and grant all necessary privileges:

  1. In the left pane, click Users and Privileges (enter your password to access this feature).

  2. Click Add Account.

  3. Enter essuser in the Login Name field.

  4. Enter and confirm a password for the user.  

  5. Click the Schema Privileges tab to activate it.

  6. Click Add Entry.

  7. Enable the Selected Schema radio button.

  8. Select the newly created essdata schema from the list.

  9. Click OK.

  10. Click Select All to select all of the privileges listed.

  11. Click Apply.

Configure MySQL on Windows through MySQL Administrator

Create the ESS database/schema:

  1. Click Catalogs

  2. Right-click under Schemata and select Create New Schema.

  3. Enter essdata for the schema name.

  4. Click OK.

Create the ESS user for the ESS database, and grant all necessary privileges:

  1. Click User Administration and click the Add new user button.

    • MySQL User: essuser

    • Password: <your-passwd>

    • Confirm: <your-passwd>

  2. Click the Schema Privileges tab.

  3. Under Schemata, select essdata.

  4. Select all the Available Privileges and move them to the Assigned Privileges.

Configure Microsoft SQL Server

The procedure below provides instructions for creating a new Microsoft SQL Server database for use with the ESS. After completing the following steps, be sure to see Prevent Deadlocking immediately below for additional configuration tasks.

  1. Verify that you are running a supported version of the Microsoft SQL Server. See Supported Technologies.

  2. If necessary, install or upgrade to a supported version of the Microsoft SQL Server and Manager.

  3. Log in to the Microsoft SQL Server.

  4. Run SQL Server Manager or Management Studio.

  5. Create a user (SQL Server user) for the database.

    1. Right-click Security and select New Login.

    2. Enter essuser for the Login Name and select SQL Server Authentication.

    3. Enter an appropriate password and other desired properties.

    4. Click OK.

  6. Create an ESS database.

    1. Right-click Databases and select New Database.

    2. Enter essdata for the Database Name and select essuser for the Owner.

    3. Set all other desired properties.

    4. Click OK.