Skip to main content
Version: v23.0

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, 8 or 9

    • CentOS 7

    • Ubuntu 16.04, 18.04, 20.04, or 22.04

    • SUSE Linux Enterprise Server (SLES) 15

  • 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.

  • Ensure the server hostname is set and unique.

  • Set host resolution for all servers (agents) that will be participating in the group by adding their entries to DNS or the hosts file located at /etc/hosts.

Installation​

This section covers preparing the server and installing DxOdyssey.

Update Server and Install Dependencies​

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

    sudo yum update

  2. Install Microsoft .NET Runtime 6.0 using installation instructions from Microsoft:

  3. Install the remaining DxOdyssey dependencies.

    sudo yum install zip

Install DxOdyssey​

  1. Install the repository configuration file.

    info

    Replace the <distro> parameter in the example below with rhel7, centos7, rhel8 or rhel9 to install the correct package for your OS.

    sudo yum install https://repos.dh2i.com/<distro>/retail/repo.rpm

  2. Install the product.

    sudo 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 the First Member​

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

    Example

    sudo dxcli activate-server AAAA-BBBB-CCCC-DDDD

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

    info

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

    Example

    sudo dxcli gateway-group-set-secret

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

    Example

    sudo dxcli set-otpk

Configure Additional Members​

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

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

    Example

    sudo dxcli activate-server AAAA-BBBB-CCCC-DDDD

  3. Join the second gateway to the gateway group using the command sudo 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 generated in the previous section to join the gateway group.

    info

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

    Example

    sudo dxcli join-gateway-group

Additional Information​