Get Started Guide Install eyeUNIFY on Windows

Get Started Guide for installing Version 1.2 on Window(10)

Install MariaDB and create a database for eyeUNIFY

DISCLAIMER: If you already have a MariaDB/MySQL-Server setup in your environment and want to use  this for wildlfy, you can just skip this part.

In this guide the 32-Bit MariaDB .msi Installer is used.

Installing MariaDB-Server on Windows requires just a few steps:

  1. Go to the MariaDB Donwload-Page and download the installer or use this link to download mariadb-10.1.18-win32.msi
  2. Run the installer with Administrator rights and the following settings.
    mariadbinstaller01

    mariadbinstaller02
    mariadbinstaller03
  3. Connect with a SQL Client to your new Database. You can use the ‘MySQL Client (MariaDB 10.1)’ over the Windows Start Menu or open a CMD go to Folder C:\PathToYourMariaDB\bin\ and run ‘mysql.exe -uroot -p’. Enter your root password you configure while installing mariaDB.
  4. With the following command you create a new Database, a new user and give the user access to the database.

    Replace the Password with your own password while creating the user

    CREATE DATABASE eyeUNIFY_db;
    CREATE USER 'eyeUNIFY'@'localhost' IDENTIFIED BY 'ReplaceThisWithYourPassword';
    GRANT ALL PRIVILEGES ON eyeUNIFY_db.* TO 'eyeUNIFY'@'localhost';
    FLUSH PRIVILEGES;
    mariadbcreatedb

 

Install and configure Wildfly

Installing Wildfly is a bit more complex, as you need to adjust the configuration as well. In order for eyeUNFIY to run properly on Wildfly, you must install Java 8 x64 (link), not x86 as eyeUNIFY uses some instructions only present in the 64-bit Version of JRE.

First of all, install Wildfly:
  1. Get Wildfly 10.1.0-Final from their download page (Use the “zip”-one) or use this link to download wildfly-10.1.0.Final.zip
  2. Unzip the package and place Wildfly into C:\Program Files\eyevis\eyeUNIFY\wildfly-10.1.0-Final (NOTE: This directory will be referred to as $WILDFLY)
  3. In order to get the Management-Console accessible from outside your box, you need to edit the configuration-file. Open $WILDFLY\standalone\configuration\standalone-full.xml and replace every “127.0.0.1” with “0.0.0.0”.
  4. In a CMD run “$WILDFLY\bin\add-user.bat USERNAME PASSWORD”. This will add a management user to your wildlfy installation.
    wildflymanagmentuser
  5. Again run $WILDFLY\bin\add-user.bat This time follow the script instructions to add a application user
    Enter “b”
    Enter a Username
    Enter a password for your application user
    As Group enter “administrator”
    wildflyadmuser
  6. Start your wildlfy server with $WILDFLY\bin\standalone.bat -c standalone-full.xml
Add Database-Connector to Wildfly
  1. Download the MariaDB Connector/J from the MariaDB Download page. (mariadb-java-client-1.5.5.jar)
  2. Point your browser to the Wildfly Admin Console (http://localhost:9990)
  3. Login with your management user you added earlier in this guide. (in this guide manager)
  4. Go to the tab “Deployments” and press the “Add”-Button.
  5. Upload the MariaDB-Java-Connector as a new deployment and enable it.
    wildflyjdbc01
Configure Datasource
  1. Again, point your browser to the Wildfly Admin Console (http://localhost:9990)
  2. Login with your management user you added earlier in this guide. (in this guide manager)
  3. This time you need to open the Configuration-Tab.
  4. Go to “Subsystems -> Datasources -> Non-XA” and press the “Add”-Button
    wildflyjdbc02
  5. Select MySQL Datasource
    wildflyjdbc03
  6. You might use as name whatever you want, but the JNDI-Name must be “java:/datasources/heliopsis”
    wildflyjdbc04
  7. On “Step 2/3”, select the mysql-driver you just added from the “Detected Driver Tab”
    wildflyjdbc05
  8. On “Step 3/3”, modify the Connection URL to fit your setup. Enter the Database-Adminname and -password
    wildflyjdbc06
    wildflyjdbc07
  9. After adding the new Datasource you can test your connection while clicking on to the dropdown “view”
    wildflyjdbc08
    wildflyjdbc09
    Now your Wildfly and MariaDB are preared to deploy eyeUNIFY.

 

Deploy eyeUNIFY

  1. Download the latest 1.2 Version from eyeUNIFY download and extract it to “c:\Program Files\eyevis\eyeUNIFY\”
  2. Point your browser to the Wildfly Admin Console (http://localhost:9990)
  3. Login with your management user you added earlier in this guide. (in this guide manager)
  4. Just go the Deployments-Tab again and add “eyeUNIFYcore.war” and “eyeUNIFYctrl.jar” which are under “c:\Program Files\eyevis\eyeUNIFY\eyeUNIFY-v1.2”. On the “Verify Uplaod”-Page you can leave everything as is and just hit “Finish”.
    wildflydeplyunify
  5. Point your browser to http://localhost:8080/eyeUNIFYctrl and log in with your Application user you created earlier (in this guide eyeunify)

Add and configure eyeUNIFY.exec Device to eyeUNIFY

A eyeUNIFY.exec Device like netPIX, EPU or a other system where eyeUNIFY.exec is running can be used to show sources.

HINT: In order for eyeUNFIY.exec to run properly ,you must install Java 8 x64 (link), not x86 as eyeUNIFY.exec uses some instructions only present in the 64-bit Version of JRE.

  1. Download the latest 1.2 Version from eyeUNIFY download and extract it to “c:\Program Files\eyevis\eyeUNIFY\”
  2. To configure the supported source types for your device edit the processes.xml while add or remove the plugins/player you have installed.
  3. To start eyeUNIFY.exec on your System open a CMD (windows + r -> typ cmd -> enter)
    Change the directory to “C:\Program Files\eyevis\eyeUNIFY\eyeUNIFYexec” and run
    java -jar eyeUNIFYexec.jar
    eyeunifyexec
    The eyeUNIFYexec tells you under which url it is now reachable. In this guide it is http://10.0.2.15:8081/UnifyDevice
  4. Point your browser to http://localhost:8080/eyeUNIFYctrl and log in with your Application user you created earlier (in this guide eyeunify)
  5. Open the eyeUNIFY settings by clicking on the Settings icon
    eyeunifysettings_s
  6. Select Device and enter under Address the url of the eyeUNIFY.exec (http://10.0.2.15:8081/UnifyDevice) and a name
    addeyeunifyexec
    Click add to add it to eyeUNIFY
  7. Now you can initialize the device by clicking deploy. This step will initialize the eyeUNIFY.exec and apply it a Screen which can be controlled
    addeyeunifyexec2
  8. After deploying you can select the Screen by selecting it from the Wall section
    selectwall

Add a Source to eyeUNIFY

In order to be able to open Content on the Screen you need to add a Source to eyeUNIFY. The Source typ depend on the supported typs by the eyeUNIFYexecuter.

  1. Point your browser to http://localhost:8080/eyeUNIFYctrl and log in with your Application user you created earlier (in this guide eyeunify)
  2. Open the eyeUNIFY settings by clicking on the Settings icon
    eyeunifysettings_s
  3. Click on “add” to add a new source. Select the source typ from the tabs and full fill the fields depending on your circumstances
    addsource
  4. After this you should be able to open the source while selecting it from the Source sections of the sidebar
    addsource2

 

Troubleshooting

Wildfly

  • The Wildfly Server is started but I cannot connect to the admin console
    Try to start it from and cmd with administrator rights.
  • I cannot add a management or application user
    Run the add-user.bat from an cmd with administrator rights.

eyeUNIFY

  • I cannot add a eyeUNIFY.exec Device or a Source
    Check if the users your logged in is in the group ‘administrator’. To do that just run the steps from points add users from ‘Install and configure wildfly’ again.