Get Started

Before you start

Please consider that eyeUNIFY is just lunched. It is not fully featured yet and still under continuing development. The get started guide currently doesn’t cover all operating systems and platforms. We try to do our best to complete this. Feel free to contribute.

Things to know

You can download the current release of eyeUNIFY in the download section. The heart of the eyeUNIFY software is the eyeUNIFY.core. It provides the SOAP interface, which allows the communication between the different components of eyeUNIFY. eyeUNIFY.ctrl is the web frontend for eyeUNIFY. It provides a responsive and touch enabled web side where eyeUNIFY can be configured and controlled. eyeUNIFY.core and eyeUNIFY.ctrl require an Applications Server with support for Java EE 7 (Java Enterprise Edition). Tested with Wildfly 8.2.1.Final.

The eyeUNIFY.core uses a database to store its data. The database connection is realized over JDBC which brings the ability to use eyeUNIFY with different databases (please check download page for current tested databases).

Installation on a WildFly server with a MySQL Database

Requirements

To successfully follow this guide, you will need the following requirements:

  • A running WilfFly Server (Currently tested: WildFly 8.2.1Final Java EE7 Full & Web Distribution).
  • A running MySQL database.

Configuring the WildFly Server

Security domain

eyeUNIFY uses security domains for the user management. In this example you will learn how to setup a file based security domain. Other kinds are also possible (for example for LDAP login).

  1. Stop your WildFly server.
  2. Create the files unify-default-users.properties and unify-default-roles.properties in the wildfly …/standalone/configuration folder
  3. Enter your users in the unify-default-users.properties (username=password). Only one user per line! Example:
    user1=password1
    user2=password2
  4. Now you need to map the users to there roles. eyeUNIFY provides three different roles:
    admin: Users with this role are allowed to create, delete and edit sinks and sources and they can open, move and close windows on all walls ans screens.
    operator: Users with this role are not allowed to add, delete or edit any sinks or sources but they are able to open, close and move windows.
    guest: Users with this role have a view only access and are not allowed to change anything in eyeUNIFY.
    Open the file unify-default-roles.properties and enter your role mapping (user=role1,role2). Example:
    user1=administrator,operator
    user2=guest
  5. Add the following security-domain to the standalone-full.xml:

    <security-domain name="unify-default" cache-type="default">
    <authentication>
    <login-module code="UsersRoles" flag="required">
    <module-option name="usersProperties" value="${jboss.server.config.dir}/unify-default-users.properties"/>
    <module-option name="rolesProperties" value="${jboss.server.config.dir}/unify-default-roles.properties"/>
    </login-module>
    </authentication>
    </security-domain>

The data source

  1. Download the JDBC driver for MySQL.
  2. Deploy the JDBC driver to your WildFly server.
  3. Open the “Configuration” tab on the management¬†console of your WildFly.
  4. Open the “Connector”, select “Datasources” and click “Add”.
  5. Enter a new name for the new datascource (for example “eyeUNIFY_datasource”).
  6. Enter the JNDI-Name “java:/datasources/heliopsis” and click “Next”.
  7. Select the MySQL dirver and click “Next”.
  8. Enter the connection URL to your database (“jdbc:mysql://<host>:<port>/<database name>”) and click “Done”.
  9. Select the newly created datasourc, open the “Connection” tab and click “Edit”.
  10. Select “TRANSACTION_SERIALIZABLE” from the “Transaction Isolation” dropdown.

Deploying

  1. Open the the configuration interface of your WildFly server.
  2. Open the “Deployment” tab.
  3. Click “Add”.
  4. Browse for the “eyeUNIFYcore<Version.ear>” file.
  5. Click “Next” and select the “Activate” checkbox”.
  6. Click “Save”.
  7. Repeat this procedure with the file “eyeUNIFYctrl<Version.war>”.