Skip to main content
Version: Archive

DxOdyssey Linux Installation Quick Start Guide

Introduction​

This quick start guide describes how to install DxOdyssey on a Linux server. Using this guide, the user will install DxOdyssey dependencies and software, then join a second server (gateway) into a gateway group.

Prerequisites​

  • Two physical or virtual machines running any mix of:
    • RHEL 7 or 8
    • CentOS 7
    • Ubuntu 16.04, 18.04, or 20.04
  • A valid DxOdyssey license. A fully featured Developer Edition is available for free for non-production use. To purchase DxOdyssey software for production workloads, visit the DH2i Store.

Installation​

This section guides the user through preparing the VM for a DxOdyssey installation.

Update Server and Install Dependencies​

  1. Update the server. If prompted to confirm, enter Y.

    yum update

  2. Ensure that the hostname is set and unique using the hostname command. If the server needs to renamed, run the hostnamectl command to rename the server. The server must be restarted for the change to take effect.

    hostnamectl set-hostname <name>

  3. Install Microsoft .NET 3.1 Runtime using installation instructions from Microsoft:

  4. Install the remaining DxOdyssey dependencies.

    yum install zip

Install DxOdyssey​

  1. Download the DxOdyssey repository configuration file.

    note

    Replace the <distro> parameter in the example below with rhel7, centos7, or rhel8 to download the correct .conf file.

    wget -O /etc/yum.repos.d/dh2i.repo https://repos.dh2i.com/<distro>/retail/repo.conf

  2. Install the product.

    yum install dxodyssey

Setup DxOdyssey and Create a Gateway Group​

This section describes how to configure DxOdyssey after installation and setup a gateway group.

Configure DxOdyssey​

  1. Activate the server using the command dxcli activate-server.

    Example

    dxcli activate-server AAAA-BBBB-CCCC-DDDD

  2. Set the gateway group passkey using the command dxcli gateway-group-set-secret.

    info

    The non-interactive version of this command is dxcli gateway-group-set-secret-ex.

    Example

    dxcli gateway-group-set-secret

  3. DxOdyssey utilizes NAT Matchmaking Service to easily connect servers across the internet. Use the command dxcli set-otpk to set a One-Time PassKey for the gateway group. The passkey expires one hour after creation by default.

    Example

    dxcli set-otpk

Setup Second Gateway and Join into Gateway Group​

  1. Complete all the steps in the Installation section for the second gateway.

  2. Activate the server using the command dxcli activate-server.

    Example

    dxcli activate-server AAAA-BBBB-CCCC-DDDD

  3. Join the second gateway to the gateway group using the command dxcli join-gateway-group and follow the prompts. Select Y when prompted to join via NAT proxy. Use the default NAT proxy of match.dh2i.com and enter the OTPK to join the gateway group.

    info

    The non-interactive version of this command is dxcli join-gateway-group-ex.

    Example

    dxcli join-gateway-group

References​