Skip to content

Installation Alternatives

This guide provides instructions for installing Mideye Server 6.x, whether you're performing a new installation or upgrading from previous versions.

Introduction

Mideye Server 6.x offers enhanced features and improvements over earlier versions. This guide covers the following installation scenarios:

  • New Installation of Mideye Server 6.x
  • Upgrading from Mideye Server 5.x to 6.x
    • Option 1: Install on a New Server
    • Option 2: Install Alongside Mideye Server 5.x

New Installation of Mideye Server 6.x

Performing a fresh installation of Mideye Server 6.x is straightforward and ideal for new deployments.

Prerequisites

  • Download Mideye Server 6.x: Obtain the latest installer from downloads.mideye.com.
  • Database Setup: Prepare a database server (MySQL, MSSQL, or MariaDB).
    • Windows: MSSQL Express is recommended when both the Mideye Server and the database are on the same server.
    • Linux: MariaDB or MySQL is preferred.

Installation Steps

  1. Install Database Server:

    • Set up your preferred database server.
    • Create a new database for Mideye Server.
    • Note down the database credentials (host, port, database name, username, password).

  2. Install Mideye Server 6.x:

    • Run the Mideye Server installer on your server.
    • Windows: When prompted, input the database credentials to configure Mideye Server's connection. This can also be done afterwards in C:\Program Files (x86)\Mideye Server 6\config\application-prod.yml.
    • Linux: Database is configured in /opt/mideyeserver6/config/application-prod.yml after the installation.

Initial Configuration:

  • Access the Mideye Server Web GUI at https://<server-ip>:<port>.
    • Windows default port: 443
    • Linux default port: 8443
  • Verify Installation Challenge:

  • Upon first login, you'll be prompted to verify the installation challenge that can be found in the server log file.

    • Windows: C:\Program Files (x86)\Mideye Server 6\logs\mideyeserver.log.
    • Linux: /opt/mideyeserver6/logs/mideyeserver.log

  • Set Root Password:

    • Create a secure root password for administrative access.

  • Configure Switch Port to Central Server:

    • Set up the switch port to connect to the Mideye Central Server.
    • For offline mode or additional assistance, contact Mideye Support.

  • Optional Configurations:

    • The Web GUI wizard may prompt you to set up:
      • LDAP Profiles
      • RADIUS Clients
      • RADIUS Shared Secrets
    • These steps can be skipped and configured later via the administrative interface.

Upgrading from Mideye Server 5.x to 6.x

Upgrading from Mideye Server 5.x to 6.x can be achieved using one of two methods. If you're upgrading from Mideye Server 4.x, please upgrade to version 5.x first.

Warning

If multiple Mideye Servers share the same database, special considerations are required due to the encryption of RADIUS Shared Secrets in version 6.x. Refer to Shared Database for details.

Option 1: Install on a New Server

Installing Mideye Server 6.x on a new server minimizes downtime and impact on your production environment.

Steps

  1. Preparation:

  2. Database Migration:

    • Export Mideye Server 5.x Database:
      • Use your database's export tools. Example for MySQL: 
        mysqldump -u <username> -p mideyeserver5_db > mideye5_backup.sql
    • Import into New Database:
      • Set up a new database for Mideye Server 6.x.
      • Import the exported data. Example: 
        mysql -u <username> -p mideyeserver6_db < mideye5_backup.sql

  3. Install Mideye Server 6.x:

    • Run the installer on the new server.
    • Provide the new database credentials during installation.
    • Complete the installation process.

  4. Initial Configuration:

  5. Redirect RADIUS Clients:

    • Update your RADIUS clients to point to the new Mideye Server 6.x.
    • This switch can often be done without downtime.

Option 2: Install Alongside Mideye Server 5.x

You can install Mideye Server 6.x on the same server as version 5.x. Note that both cannot run simultaneously due to port conflicts.

Steps

  1. Preparation:

  2. Database Handling:

    • Export Mideye Server 5.x Database: 
      mysqldump -u <username> -p mideyeserver5_db > mideye5_backup.sql
    • Create New Database for Version 6.x: 
      mysql -u root -p -e "CREATE DATABASE mideyeserver6_db;"
    • Import Data: 
      mysql -u <username> -p mideyeserver6_db < mideye5_backup.sql

  3. Stop Mideye Server 5.x:

    • To avoid port conflicts, stop and disable the old server: 
      systemctl stop mideyeserver
systemctl disable mideyeserver

  4. Install Mideye Server 6.x:

    • Run the installer on the same server.
    • Provide the new database credentials when prompted or configure it in the configuration file.
      • Windows: C:\Program Files (x86)\Mideye Server 6\config\application-prod.yml.
      • Linux: /opt/mideyeserver6/config/application-prod.yml.

  5. Initial Configuration:

  6. Start Mideye Server 6.x:

    systemctl enable mideyeserver6
systemctl start mideyeserver6

  7. Verify and Redirect:

    • Test the new installation to ensure it’s functioning correctly.
    • Redirect RADIUS clients to the new server as needed.

Upgrading from 6.x to Mideye Server 6.2 and greater.

Upgrading to version 6.2 involves minor configuration changes.

Steps

  1. Backup and Preparation:

    • Backup: Take a snapshot or backup of your current system.
      • Mideye Server Database
      • Mideye Server config directory
    • Download: Get the latest installer from the Downloads page.

  2. Run the Installer:

    • Execute the Mideye Server 6.2 installer.
    • Proceed through the installation.

  3. Update Configuration File:

    • Open the configuration file.
      • Windows: C:\Program Files (x86)\Mideye Server 6\config\application-prod.yml.
      • Linux: /opt/mideyeserver6/config/application-prod.yml.
    • Append ;trustServerCertificate=true; to the database URL. like 
      url: jdbc:sqlserver://localhost:1433;databaseName=mideye;authenticationScheme=NTLM;useNTLMv2=true;user=USERNAME;password=PASSWORD;trustServerCertificate=true;
    • Save and close the file.

  4. Verify Installation:

    • Check logs to confirm successful installation.
    • On Windows, you can monitor logs using PowerShell:

Get-Content 'C:\Program Files (x86)\Mideye Server 6\log\mideyeserver.log' -Wait

Additional Information

- Support: For assistance, contact Mideye Support.
- Offline Mode: If operating in offline mode, additional steps may be required. Contact support for guidance.
- Configuration Wizard: After installation, you can skip optional configurations (LDAP, RADIUS) during the initial setup and configure them later via the Web GUI.

By following this guide, you’ll successfully install or upgrade to Mideye Server 6.x, ensuring minimal disruption to your services.