Mideye 4 Windows Install
Warning
Mideye Server 4 is no longer updated, and new installations are not supported. Only existing Mideye Server 4 installations and upgrades to latest release are supported. Please use Mideye Server 6 for new installations and continued support.
Introduction¶
This guide describes Mideye Server installation, upgrade and uninstall procedures for Windows server.
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:
- An updated release of Windows Server 2008(r2), 2012, 2012(r2), 2016 or 2019.
- 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:
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
To proceed further, it is necessary to accept the license agreement.
License Agreement
Select the installation directory and press “Next”.
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.
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
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
In the Database Connection tab, enter the database credentials (see section “Database Connection” in the Configuration guide for detailed instructions).
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
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:
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:
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
Pressing Ok upgrades Mideye Server to the latest version.
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:
Open Mideye Configuration Tool and the following window will ask for a confirmation to update the database.
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):
<pre style="padding-left: 30px;">C:\Program Files (x86)\Mideye Server\webserver\conf\logging.properties
- Customized SSL port for the administrative web interface:
- SSL certificates for the administrative web interface. Stored in the directory:
- 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
