Windows installation guide

Introduction

This guide describes Mideye Server installation, upgrade and uninstall procedures for Windows server. This document refers to the Pre-install checklist.

Installation

This chapter describes the procedure for a fresh installation of Mideye Server. If a previous version of Mideye Server is already installed, please see the section Upgrade below.

Prerequisites

Before executing the Mideye Server installation package you need the following:

  1. An updated release of Windows Server 2008(r2), 2012, 2012(r2), 2016 or 2019.
  2. A clean database on Microsoft SQL or MySQL dedicated to Mideye.

Administrator Account

In order to install Mideye Server it is necessary to execute the installation package as a local administrator.

Obtaining Installation Package

Mideye Server installation package can be downloaded here with username and password provided by Mideye Support. Provide your mobile phone number when asking for credentials since the download page is protected with two-factor authentication.

Database

Mideye Server needs a database that be can installed locally or be hosted on an external server. Supported database servers are listed in the Pre-install checklist.

Firewall

For required firewall openings, please refer to the Firewall section of the Pre-install checklist. It is possible to proceed with the installation steps below while waiting for firewall openings. However, one-time password delivery requires that the server-switch communication is working.

Installation Path

The Mideye Server default installation folder is different depending on the operating system architecture. In this document, all the paths referring to the Mideye Server’s installation directory relate to the MideyeServer folder.

For 64-bit operating systems the default path is:

C:\Program Files (x86)\MideyeServer

Mideye Server installation

Execute the Mideye Server installation package as a local Administrator and follow the instructions on the screen. Windows will prompt a confirmation, press “Yes” to continue.

Confirmation dialog

Confirmation dialog

To proceed further, it is necessary to accept the license agreement.

License Agreement

License Agreement

Select the installation directory and press “Next”.

Installation Directory

Installation Directory

By clicking on “Install” the Mideye Server installation will start. The install procedure will extract the files from the installation package to the selected directory.

Installation Directory

Start installation

During the installation, you may be prompted for a system re-start. These messages can be ignored.

The following window confirms that Mideye Server was successfully installed:

Installation Confirmation

Installation Confirmation

To finalize the installation, the Mideye Configuration tool must be executed, see the next section.

Post-installation configuration

Configuration tool

The first time Mideye Configuration Tool is executed, a popup window will inform that the database needs to be configured.

Database not configured

Database not configured

In the Database Connection tab, enter the database credentials (see section “Database Connection” in the Configuration guide for detailed instructions).

Database Configuration

Database Configuration

Note: If MySQL is selected, the MySQL connector must be installed, see section Database.

The following dialog will be shown when a connection with the database is established:

Running install scripts on a new database

Running install scripts on a new database

The install scripts will create all the required tables.  Select “Close”, “Save” and re-start Mideye services.

Upgrade

Upgrading the Mideye Server involves two steps:  first upgrading the server software, followed by upgrading the database.

Backup

Before proceeding with an upgrade, take a backup of the Mideye Server file system and the Mideye database. Some files containing customized settings may need to be replaced after the update.

Mideye Server file system

To take a backup of the Mideye Server, copy or compress the whole Mideye Server installation directory. The default directory is:

C:\Program Files (x86)\Mideye Server

Database

To back up a database on Microsoft SQL Server, use SQL Server Management Studio. Right-click the database used by Mideye and choose “Tasks” followed by “Back up”.

To take a backup of the Mideye Server database on MySQL, run the following command:

# mysqldump -u[username] -p[password] [database name] > mideye_backup.sql

where [username]/[password] are the database login credentials.

Upgrade Mideye Server

Starting from release 4.6.5, Java comes bundled with the installation package. Older versions of Java can be removed.

Note: To execute the installation/upgrade package, the Mideye Server requires an SQL account with rights to ALTER, CREATE and DELETE tables.

Execute the Mideye Server installation package. If a previous version of Mideye Server is installed, the following dialog will be shown:

Click OK to proceed with updating Mideye

Click “Ok” to proceed with updating Mideye

Pressing Ok upgrades Mideye Server to the latest version.

Mideye Server upgraded

Mideye Server upgraded

Note: At this point, the new version of Mideye Server still uses the previous database and all services are stopped until the database has been updated.

Note: If MySQL is used as a database, the MySQL connector needs to be restored from the pre-upgrade backup:

C:\Program Files (x86)\Mideye Server\webserver\lib\mysql-connector.jar

Open Mideye Configuration Tool and the following window will ask for a confirmation to update the database.

Update scripts

Update scripts

Note: After pressing “Yes” and the database is updated, Mideye services have to be restarted by clicking “Save” followed by “Close”.

Post-upgrade tasks

After an upgrade, some files from the pre-upgrade backup may need to be restored:

  • Customized log configuration (Syslog, Event Viewer, log levels etc):
C:\Program Files (x86)\Mideye Server\webserver\conf\logging.properties
  • Customized SSL port for the administrative web interface:
C:\Program Files (x86)\Mideye Server\webserver\conf\server.xml
  • SSL certificates for the administrative web interface.  Stored in the directory:
C:\Program Files (x86)\Mideye Server\webserver\conf\
  • Any custom certificate stored in:
    C:\Program Files (x86)\Mideye Server\certificates

Uninstall

If the latest version of the Mideye Server is already installed, executing MideyeServer.exe will give you the option to remove it. Removing the Mideye Server keeps the database, configuration and log files intact. These can be removed manually.

Uninstall Mideye Server

Uninstall Mideye Server

Configuration

Further configuration of the Mideye Server can be found in the Configuration guide

Support Contact

Email: support@mideye.com
Phone: +46 (0)854514750