Enterprise Recon 2.9.1

Install the Master Server Appliance (from ISO)

Ground Labs does not guarantee support for non-standard installations of the Enterprise Recon Master Server. Any deviation from the instructions provided in this manual, and/or any modification made to the Master Server that may impact the functionality of Enterprise Recon is considered a non-standard installation, including (but not limited to):
  • Addition of any third party software (e.g. anti-virus software), libraries, and/or packages, and/or
  • Removal of any software, libaries, and/or packages included by default in the Enterprise Recon appliance.

Please refer to Ground Labs Technical Support Services for more information.

This chapter describes how to perform a standard installation of the ER2 Master Server software appliance using the ISO installer.

See Install the Master Server on RHEL 8 (from RPM) on how to install the ER2 Master Server on a Red Hat Enterprise Linux (RHEL) 8 server.

Master Server as a Software Appliance

Enterprise Recon 2.9.1 is provided as a software appliance that runs the Oracle Linux 8 operating system. You do not have to install the operating system separately when installing the Master Server.

Instead, use the ISO to create a (i) bootable DVD or (ii) bootable USB media (using Fedora Media Writer), and use it to install the Master Server directly on bare-metal or a virtual machine.

See Install Enterprise Recon on a Virtual Machine for instructions on installing ER2 on a virtual machine.

Preparing to Install

This section explains the various prerequisites and aspects to consider before starting the installation.

System Requirements

You can install the ER2 Master Server appliance on a server with the following minimum requirements:

Item Requirement
CPU architecture 64-bit (x86_64) CPU.
Memory and disk space See System Requirements - Master Server - Memory and Disk Space for more information.

Backup the Master Server and Network Settings

If you have an existing installation of ER2:

  1. Create a backup of the current Master Server. Copy the backup file to a shared location separate from the current Master Server host that is accessible by the new Master Server host.
  2. Copy the datastore configuration file /var/lib/er2/datastore.cfg to a shared location separate from the current Master Server host that is accessible by the new Master Server host.
    Do this step to avoid having to reconfigure all Node Agents with a new Master Server public key.
  3. Take down the host name, IP address and network configuration settings of the current Master Server.
    Do this step to avoid having to reconfigure all Node Agents to point to a new IP address for the Master Server.

Download the ISO Installer

The ER2 ISO installer is a bootable ISO image that installs the Master Server appliance with an Oracle Linux 8-based operating system on your machine.

To download the Master Server ISO installer:

  1. Log in to Ground Labs Services Portal.
  2. From the Home tab, scroll down to the Enterprise Recon 2 > Enterprise Master Package > Appliance (OL8) section and look for version 2.9.1.
    Download ER2 ISO file in Ground Labs Services Portal.
  3. Click Download to download the Enterprise Recon ISO file (er2-2.x.x-OracleLinux8.iso).
  4. Load the ISO image on bootable media such as a USB stick or a DVD, and use it to install the Master Server directly on bare-metal server.

Installing the Master Server Appliance from ISO

To perform a standard installation of the ER2 Master Server appliance:

  1. On your machine, load the ER2 installation media.
  2. (Optional) To run a memory test, select Troubleshooting and press Enter.
  3. Select Install Enterprise Recon 2.x.x and press Enter.
  4. In the INSTALLATION SUMMARY screen, configure the following settings. Click Done to confirm each setting.
    Settings Description
    Keyboard Select the keyboard layout(s) to use.
    Language Support Select the language(s) to install.
    Network & Host Name
    1. Configure your network interfaces. Locally accessible interfaces are automatically detected and listed in the left panel of the installation window.

      Set the toggle button to ON to activate a network interface and click Configure to manually configure the network interface settings.

      You can re-configure the Master Server's network interface after the installation.
    2. Set the host name for your Master Server and click Apply.
    Time & Date
    1. Set the date, time format and time zone for the Master Server.
    2. Set the toggle button to ON to enable the network time.
    Disk Setup ER2 encrypts the disk that the Master Server is installed on. This LUKS passphrase is required to decrypt the disk every time you start up the Master Server.
  5. Once you have finished configuring the Master Server, click Begin Installation.
  6. After the system reboots to complete the installation, enter your LUKS passphrase to access the Master Server console.
  7. Log in to the Master Server console as root with the default password, ChangeMeNow.
  8. Run the following command:

    yum update

  9. Enter y to install available updates.

  10. (Optional) Restore ER2 from a backup file.

  11. (Optional) Restore the datastore configuration file copied from the previous Master Server.

    # Stop the er2-master service. /etc/init.d/er2-master stop
    # Rename and backup the original datastore.cfg file. mv /var/lib/er2/datastore.cfg /var/lib/er2/datastore.cfg.orig
    # Copy the datastore configuration file for the previous Master Server # from the "<shared_location>" to the RHEL 8 server. scp <user@source_host>:<shared_location>/datastore.cfg /var/lib/er2/datastore.cfg
    # Give ER2 ownership of the configuration file. chown erecon:root /var/lib/er2/datastore.cfg
    # Change the permissions for the datastore configuration file. chmod -x /var/lib/er2/datastore.cfg
    # Start the er2-master service. /etc/init.d/er2-master start
    # Once the restore operation has been verified to be successful, # delete the original datastore configuration file. rm /var/lib/er2/datastore.cfg.orig

Activating ER2

Once the Master Server has started, log in to the Web Console to activate ER2 and Install Node Agents.

See Installation Overview for more information.

Update ER2

Update ER2 to upgrade to the latest version of ER2.