Readme file

        Version last updated: 10/25/2022

        The TidalScale administration software, WaveRunner, is a Linux based application that installs as an RPM. Once installed and configured, WaveRunner provides the administration interface (GUI) for creating and managing software-defined servers (SDServers) as well as the pools of Worker Nodes, the physical servers. The WaveRunner package also contains the software for the HyperKernel, TidalScale's type-1 hypervisor, that is deployed on Worker Nodes to create an SDServer.

        Information Please check with TidalScale Support for information on how to download the latest version of WaveRunner for your environment.

        Prerequisites

        • Verify that the Pre-Installation steps have been performed.
        • SSH access (with root permission) to the server where WaveRunner will be installed
        • RPM package of the latest TidalScale software
        • Access to WaveRunner requires the following ports open:
          tcp: 3443, 22
          Firewall between WaveRunner application and Worker Nodes requires the following ports open:
          tcp: 3443, 3001 - udp: 67, 68, 69, 9020
        • ipmitool packages must be installed on the WaveRunner server
        • openssl package must be installed on the WaveRunner server

        Software Installation

        Login to the server where WaveRunner will be installed as root or su to obtain root access during installation steps.

        Warning: Installation and any configuration changes must be performed as root or with sudo

        Disable firewall:

        Bash (Unix Shell)

        • systemctl stop firewalld
        • systemctl disable firewalld

        Information: The firewall may be left on or reenabled as long as the ports listed above have been opened.

        Install the TidalScale RPM:

        Warning: Please use the command below for the installation - using other package management tools such as "yum" or "zypper" is not compatible with our software, and may complicate future upgrades.

        Bash (Unix Shell)

        • rpm -i tidalscale.rpm

        Post-Installation

        • Set the control network interface and admin password
        • Run '/usr/local/tidalscale/bin/wr_config.sh' on the WaveRunner server.

        You will be prompted to input the "control network interface" to point to the local network interface (e.g., eth1) used to access the Control Network that will provide boot services (dhcp/pxe) and allow control of the Worker Nodes. The script will request you verify the selected interface.

        Information If you are running WaveRunner on a Virtual Machine, you must ensure the network permissions for the interface assigned to WaveRunner in "control_network_interface" allows MAC address changes and Forged Transmits. Failure to do so will make Worker Nodes unable to boot.
        Set the password associated with the 'admin' account and provide the ability to login through the WebUI.

        Warning The admin password must be set to access the WebUI. The default configuration provides no ability to log in. The password is hashed before being stored on the system.
        The WaveRunner service will be automatically started at the completion of the script.

        Set the any special configuration parameters
        If necessary, provide setting updates to /usr/local/tidalscale/etc/waverunner/waverunner.conf for service specific options or /usr/local/tidalscale/etc/hyperkernels/loader.conf for Worker Node boot specific options.

        Information
        If manual changes are made to waverunner.conf or loader.conf, it is recommended to work with TidalScale support.

        If changes are made to the loader.conf you will need to powercycle the nodes on the SDServer in order for the changes to take effect. If your guest is currently powered on you will need to power it down first in order to power down your nodes.

        If changes are made to the waverunner.conf you will need to restart the waverunner service for the changes to take effect. To restart the service you can issue the following command on the WaveRunner server: sudo systemctl restart waverunner

        The WaveRunner administration software is now installed and ready for use to configure software defined servers.

        Copy Installation ISOs to create SDServers
        The files used to install the guest operating systems must be placed in /usr/local/tidalscale/etc/isos. Simply copy the installation ISO files for your deployments into this directory.

        Warning Copies of the installation images for desired Guest OS deployments must be placed in /usr/local/tidalscale/etc/isos prior to creating a SDServer.