Skip to content

One Touch Installation

Last updated on Aug 27 2024.

Overview

OVD One Touch is an interactive shell script that provides an easy way to install different OVD roles and utilities needed for deployment of a fully functional OVD farm.

As an alternative to manual installation, OVD One Touch can install not just individual OVD roles, but also a quick "all-in-one" solution (where Session Manager, Web Access, File and Application Servers are installed within the same environment) and additional utilities that simplify additional configuration of the farm.

Requirements

Please make sure that all servers meet minimal system and hardware criteria for their corresponding OVD roles as listed in requirements.

Important notes

  • Internet access is required to install with the OVD One Touch installer, and if you are using URL filtering, please allow access to https://ovd.one and https://archive.inuvika.com alongside the standard operating system repositories required.

  • All commands need to be run with root privileges.

  • Where multiple roles are required on the same server, the installer can be re-run multiple times.

  • If you make a mistake during installation, you can abort the script at any point by pressing CTRL + C.

  • OVD Enterprise Secure Gateway (optional) must be installed on a separate server.

  • For RHEL: OVD is compatible with SELinux. If SELinux is enabled, the installation process will configure SELinux rules accordingly. If SELinux is disabled, it will remain so, and no SELinux rules will be applied.

Installation walk-through

  1. Connect to the server you want the role/utility to install. For Windows Application Server role installation, use any other role server.

  2. Elevate your shell to the superuser if you are not already root: 

    $
    sudo -s

  3. Update your system

    • Ubuntu 

      #
      apt update && apt upgrade

    • RHEL 

      #
      yum update

  4. Download and launch installation script, replacing the <version> with the specific version code you wish to install: 

    #
    curl -s https://ovd.one | OVD_VERSION=<version> bash

    or

    #
    wget https://ovd.one | OVD_VERSION=<version> bash

    Info

    You will find the version code on the Inuvika OVD supported versions page. You may also contact Inuvika to request the code.

  5. After a short period, you will be presented with the welcome screen. Press ENTER to proceed with a preparation of the installation environment.

Installation options

After the successful preparation of the installation environment, the following options will appear in the menu: One Touch Menu

Options 1-4 and 6 install specified roles.

Option 5: All of the above (all in one installation) installs following roles on the same server:

  • Session Manager
  • File Server
  • Linux Application Server
  • Web-Access

Option 7: Windows Application Server remotely installs Windows Application Server on any supported Windows server. Please refer to Windows OVD Application Server installation for more information.

Option 8: Utilities displays selection of following options:

  • Setup ESG for Let's Encrypt
  • Install Grafana Server
  • Install Speed Test on the OWA

Please choose the required option and press ENTER. Depending on the role selected, the Installer will then ask you for additional information such as IP address, passwords etc.

The installer will then beging and automatically install the requested roles and/or features you have requested

Windows OVD Application Server installation

The Installer allows you to install OVD Windows Application Server remotely from any supported Linux server.

Important

If you plan to integrate application server with Active Directory domain, do not join the server to the domain before finishing OVD installation.

Before running the Installer, you need to configure Windows server as follows:

Important

You must use the local administrator account.

iex ((new-object net.webclient).DownloadString('https://ovd.one'))

If you encounter an SSL/TLS error, please run this command first:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12,[Net.ServicePointManager]::SecurityProtocol

Each option will ask a series of questions for information such as IP address, passwords etc. Please answer these in sequence. Remember that all inputs are case-sensitive.

Error Messages

If installation process fails, error is displayed as standard error in the output of the shell. The complete installation standard output is stored at /var/log/ovd-install.log.

These are the most common errors:

  • Invalid version number
  • Connection issues related to DNS, Proxy servers
  • Configuration input mistakes (invalid version number, incorrect IP address, incorrect password...)

After resolving the issues, run the script again and selected. If you are not able resolve issues yourself, please contact Inuvika Support and include a copy of the log file from /var/log/ovd-install.log of the affected server.

Cleanup and Next Steps

Remove the playbooks containing sensitive information:

rm playbook.yml playbook-win.yml

Remove the folder with installation credentials:

rm -rf credentials

Remove Ansible installation files and directories:

rm -rf /opt/ovd

To finalize your installation, please follow Initial Configuration.