Deployment guides

There are two types of Replicator appliances available. A subscription or evaluation key is required with either install. A key can be obtained from Plixer or a local reseller.

Hardware appliance

Once the hardware appliance is installed in a network rack, power it on and follow the steps below.

  1. Using an SSH client, remotely log in using the username root and password replicator. The hardware appliance will perform a quick setup and immediately reboot.
CentOS Linux release 7.5.1804 (Core)
Kernel 3.10.0-862.3.2.el7.x86_64

localhost login: root
Password: _

Important

The default command line credentials are user root and password replicator.

  1. Log into the hardware appliance again as the root user with the default password replicator. Enter the answers to the configuration questions. The hardware appliance will reboot to apply the necessary settings.
Last Login: Fri Nov 15 11:067:45 on tty1

********************************
Replicator Virtual Appliance
Initial Configuration
********************************

What is the appliances static IP Address?
10.1.15.128

What is the appiances Netmask?
255.255.0.0

What is the appliances gateway?
10.1.1.1

What is the hostname for this appliance?
replicator.plxr.local_
  1. Log into the hardware appliance command line as the replicator user with the password configured in the previous step.

  2. To apply the license key, issue the license set command:

    1. In the new window, under “license=”, paste in the license key.
    2. Press CTRL+x to save.

Hint

In the user interface, manage the replicator’s license key and review the license details via the Settings > Licensing page.

The Replicator is now ready for configuration.

Virtual appliance - ESX

The Replicator virtual appliance is packaged as an all-in-one virtual machine template known as an OVF template.

For VMware deployments, ESX/ESXi 5 or higher is required. VMware Tools will be required to shut down the machine through the VMware vSphere Client.

System requirements

Component           Recommended specifications
RAM                 2GB
Disks               100GB
Processor           2 CPU 2 Core 2GHz+
Operating System    ESXi5+

Deploying the OVF template

  1. Connect to the ESX host using VMware vSphere, or vCenter.
  2. Select File, then Deploy OVF Template.
  3. Select Deploy from File, browse to the OVF Template, and click Next.
  4. Review the OVF template details and click Next.
  5. Define the name of the Replicator virtual appliance and click Next.
  6. Select a datastore and click Next.
  7. Select the disk format and click Next.
  8. Select the Network Mapping and click Next.
  9. Review the Virtual Settings and click Finish to import the OVF Template.
  10. Right-click on the Replicator virtual machine and power it on.
  11. Navigate to the Console tab and log in as the root user with the password replicator. The virtual appliance will perform a quick setup and immediately reboot.

Important

The default command line credentials are user root and password replicator.

  1. Log into the virtual appliance again as the root user. Enter the answers to the configuration questions. The virtual appliance will reboot to apply the necessary settings.
  2. Log into the appliance command line as the replicator user with the password configured in the previous step.
  3. To apply the license key, issue the license set command:
    1. In the new window, under “license=”, paste in the license key.
    2. Press CTRL+x to save.

Hint

In the web interface, manage the Replicator’s license key and review the license details via the Settings > Licensing page.

The Replicator is now ready for configuration.

Installing VMware Tools

VMware Tools are not required for proper function of the virtual appliance. However, there are certain advantages to deploying them. For more information, see VMware’s documentation.

Note

VMware Tools are not installed by default, since each version of ESX installs a different VMware Tools package. A script is included with the virtual Replicator to simplify the install process.

  1. In the VMware vSphere Client, right-click on the Replicator virtual machine. Select Guest, then Install/Upgrade VMware Tools.
  2. Log into the console of the Replicator virtual appliance as the root user. Launch the command below:
/home/replicator/conf/vmwareToolsInstall.sh

Upgrading the virtual machine hardware version

The Replicator virtual appliance is built on virtual machine hardware version 7 to maintain backwards compatibility with ESXi 5 hypervisors.

To upgrade, power off the virtual machine. In vSphere (or vCenter) right-click on the virtual machine and select Upgrade Virtual Hardware.

Virtual appliance – Hyper-V

System requirements

Component   Recommended specifications
RAM         2GB
Disks       100GB
Processor   2 CPU 2 Core 2GHz+

Importing virtual machine

  1. Download the latest Replicator.
  2. Unzip the file on the Hyper-V server.
  3. Open Hyper-V Manager and select Import Virtual Machine.
  4. Specify the Replicator system folder.
  5. Select the Virtual Machine.
  6. Choose the import type.
  7. Go to Settings.
  8. Select the Network Adapter and assign it to the appropriate Virtual Switch.
  9. Expand the Network Adapter section, select Advanced Features, set the MAC Address to Static, enter in a unique MAC Address, and then press “OK”.
  10. Start the Virtual Machine.
  11. Right-click on the Virtual Machine and click Connect to log into the Replicator appliance as the root user with the password replicator. The server will perform a quick setup and immediately reboot.
  12. To apply the license key, issue the license set command:
    1. In the new window, under “license=”, paste in the license key.
    2. Press CTRL+x to save.

Hint

In the web interface, manage the Replicator’s license key and review the license details via the Settings > Licensing page.

The Replicator is now ready for configuration.

Virtual appliance – KVM

System requirements

Component   Recommended specifications
RAM         2GB
Disks       100GB
Processor   2 CPU 2 Core 2GHz+

Importing virtual machine

  1. Create a directory for the install:
mkdir kvm/Scrut_VM_Guide/
  1. Download the latest Replicator virtual appliance to the KVM install:
wget https://files.plixer.com/Replicator_KVM.tar.gz

Note

Contact support for the latest image if the url above does not work.

  1. Unzip the file in the install directory on the KVM server:
sudo tar xvzf Replicator_KVM.tar.gz
  1. Run the Replicator install script:
sudo ./install.sh
  1. Log into the appliance. Run the command below to get to the console:
virsh console Replicator
  1. Log in as the root user with the default password replicator. The machine will reboot and promp to log in again. This time, there will be a shell script asking for networking information.

  2. To apply the license key, issue the license set command:

    1. In the new window, under “license=”, paste in the license key.
    2. Press CTRL+x to save.

Hint

In the web interface, manage the Replicator’s license key and review the license details via the Settings > Licensing page.

The Replicator is now ready for configuration.