DPX 4.10 Guide
Catalogic SoftwareKnowledge BaseMySupport
  • Welcome to DPX!
  • Introduction
    • About DPX
  • Installation and Configuration
    • How to Start – Basic Configuration
    • DPX Master Server
      • Deploying DPX with VMware vSphere
      • Deploying DPX with Microsoft Hyper-V
      • DPX Master Server Interface
      • Configuration
    • DPX Client
      • DPX Client for Microsoft Windows
        • Requirements
        • Installation
        • How to Uninstall
      • DPX Client for Linux
        • Requirements
        • Installation
        • How to Uninstall
      • Automated Deployment of DPX Client
      • Further Actions with DPX Client
    • DPX Proxy Server
      • Deploying DPX Proxy Server for VMware
      • DPX Proxy Server Web Interface
    • DPX Hyper-V Agent
    • Nodes
      • Adding a Client Node to the Master Server during Client Deployment
      • Adding a Client Node from the Master Server Level
      • Adding a Configured Hyper-V Host as a DPX Node
      • Adding Other Node Types to the Master Server
      • Adding a Node Group
    • Devices
      • Adding a Device Cluster
      • Adding a Device
      • Adding a Tape Library
      • Adding a Tape Library Device
    • Media
      • Adding a Media Pool
      • Adding Media Volumes
    • Tape Libraries
      • Tape Library Deployment
      • Tape Library Setup
      • Manual Tape Library Installation
      • Tape Library Verification
      • Manual Tape Library Configuration
      • Setting up LTO Tape Drives for Hardware Encryption
      • Assigning and Unassigning Media to/from Tape Library Slots
    • User Configuration
      • Configure Administrators Window
    • Other Components of the DPX Suite
    • Updating DPX
      • Command Line Update
      • Online Autoupdate Method
      • Offline Autoupdate Method
  • Backup
    • Introduction and Backup Types
    • File Backup
      • Creating a File Backup Job
        • Job Source Options for File Backup
        • Job Destination Options for File Backup
        • Other Job Options for File Backup
      • Editing a File Backup Job
      • Scheduling a File Backup Job
    • Block Backup
      • Prerequisites
      • Creating a Block Backup Job
        • Job Options for Block Backup
      • Editing a Block Backup Job
      • Scheduling a Block Backup Job
      • Forcing a Base Backup
      • Backing up System State
      • Backing up System Table
    • Application Backup
      • Microsoft SQL Server Backup
        • Creating a Microsoft SQL Server Backup Job
      • Microsoft Exchange Server Backup
        • Creating a Microsoft Exchange Server Backup Job
      • Microsoft SharePoint Server Backup
        • Creating a Microsoft SharePoint Server Backup Job
      • Oracle Database Backup
        • Creating an Oracle Database Backup Job
      • SAP HANA Backup
        • Running SAP HANA Backup Job
      • OpenText GroupWise Backup
        • Creating a GroupWise Backup Job
    • Bare Metal Recovery (BMR) Backup
      • Creating a BMR Backup Job
    • Catalog Backup
      • General Considerations
      • Creating a Catalog Backup Job
        • Job Options for Catalog Backup
      • Editing a Catalog Backup Job
      • Scheduling a Catalog Backup Job
    • NDMP Backup (desktop interface only)
      • Prerequisites
      • Creating an NDMP Backup Job
        • Job Source Options for NDMP Backup
        • Job Destination Options for NDMP Backup
        • Other Job Options for NDMP Backup
      • Editing an NDMP Backup Job
      • Scheduling an NDMP Backup Job
    • Image Backup (desktop interface only)
      • Creating an Image Backup Job
      • Editing an Image Backup Job
      • Scheduling an Image Backup Job
    • Agentless Backup for VMware and Hyper-V
      • Agentless Backup for VMware
        • Agentless Backup for VMware Complements Block Data Protection
        • Agentless VMware Backup Architecture and Data Flow
        • Environmental Requirements for Agentless VMware Backup
        • Best Practices for Agentless VMware Backup
        • Creating an Agentless VMware Backup Job
          • Job Source Options for Agentless VMware Backup
          • Other Job Options for Agentless VMware Backup
        • Editing an Agentless VMware Backup Job
        • Scheduling a VMware Backup Job
        • Application-Consistent Protection
        • Architecture and Data Flow
      • Agentless Backup for Microsoft Hyper-V
        • Creating a Hyper-V Backup Job
        • Editing a Hyper-V Backup Job
        • Scheduling a Hyper-V Backup Job
    • Condense
      • Starting a Condense Job
      • Scheduling a Condense Job (desktop interface only)
    • File Exclusion Rules
    • Pre-Scripts and Post-Scripts
    • Differential and Incremental Backups
    • Archive
      • Creating an Archive Job for Block Backup
      • Creating an Agentless VMware Archive Job
  • Restore
    • Introduction and Restore Modes
    • Restore Modes in the Web Interface
      • Agentless File Restore
      • Full VM Restore for VMware
      • Full VM Restore for Hyper-V
      • Instant VM Restore
      • Agent-Based File Restore
        • Advanced Job Options
      • Instant Access
      • Virtualization
      • Application Restore
        • Microsoft SQL Server Restore
        • Microsoft Exchange Server Restore
        • Microsoft Sharepoint Server Restore
        • Oracle Database Restore
        • SAP HANA Restore
        • OpenText GroupWise Restore
      • Restoring files protected by file backup jobs
        • Job Options for Restoring files protected by file backup jobs
    • Restore Modes in the Desktop Interface
      • File Restore
        • Creating a File Restore Job
      • Image Restore
        • Creating an Image Restore Job
      • NDMP Restore
        • Creating an NDMP Restore Job
      • Block Restore
        • Creating a Block Restore Job
        • Specifying Mount Points
        • Restoring Block Data with Instant Access
        • Restoring BMR Data with Virtualization
      • Agentless VMware Restore
        • Creating an Agentless VMware Restore Job
          • Agentless VMware Restore Job Operations
        • Rapid Return to Production (RRP)
      • Tape Restore
        • Creating a Tape Restore Job
      • Application Restore
      • Scheduling a Restore Job in the Desktop Interface
        • Previewing Scheduled Jobs in the Desktop Interface
      • Restore Job Source Options
    • Catalog Restore
      • Creating a Catalog Restore Job
    • Bare Metal Recovery (BMR) Restore
    • Recovering Archived Backups
      • Recovering a VMware Archive
  • Storage
    • Backup Destinations
    • Tape Storage
    • vStor
    • Disk Directory
    • NetApp
    • OSS
    • Cloud Storage
      • Registering AWS S3 Cloud Storage
      • Registering a Generic Cloud Storage
  • Web Interface
    • Log-in Page
    • Dashboard
    • Job Monitor
    • Job Manager
    • Schedule Overview
    • Reports
      • Reports Templates
    • Nodes
    • Devices & Pools
    • Events
    • Configuring Enterprise Information
  • Desktop Interface
    • Connect to DPX Window
    • Main Window
    • Common Menu Bar Options
    • Function Tabs Desktop Interface
      • Backup Tab
      • Restore Tab
      • Monitor Jobs Tab
      • Control Devices Tab
      • Reports Tab
      • Catalog Tab
      • Copy Tab
      • Manage Tapes Tab
      • Configure Tab
      • [Legacy] Analytics Tab
    • Common Function Window Tasks
    • Configuring Parameters
    • Configuring the Enterprises
      • Editing an Enterprise Configuration
    • Configuring Devices
  • BARE METAL RECOVERY
    • Bare Metal Recovery Overview
    • Bare Metal Recovery for Windows
    • Bare Metal Recovery for Linux
    • Recovery from a Replicated or Alternate Data Resource
  • Miscellaneous
    • Configuring Keyrings
      • Adding a Keyring
      • Adding a Key
    • Getting Node Information
    • SNMP Interface
    • Troubleshooting
      • Troubleshooting Installation of the Catalogic DPX Client on UNIX and UNIX-like Systems
    • Technical Support
    • Terminology
    • Acronyms
    • Default Ports
    • Managing Licenses
Powered by GitBook
On this page
  • Installing DPX Hyper-V Agent on the Microsoft Hyper-V Host
  • Installing with Wizard
  • Installing via Powershell

Was this helpful?

Export as PDF
  1. Installation and Configuration

DPX Hyper-V Agent

Last updated 9 months ago

Was this helpful?

The DPX Hyper-V Agent is designed to facilitate efficient backup and recovery operations for virtual machines hosted on Microsoft Hyper-V servers. By integrating seamlessly with the Hyper-V environment, it provides robust data protection capabilities, including full VM backups and application-consistent snapshots. The agent ensures minimal disruption to running virtual machines while delivering reliable and quick restore options to meet diverse recovery requirements.

Installing DPX Hyper-V Agent on the Microsoft Hyper-V Host

Installing with Wizard

Before you back up any data from your Hyper-V VMs, you need to install the DPX Backup Agent on the host machine to enable agentless access to all VMs under this host.

  1. From your Hyper-V host, go to Catalogic website. On the DPX 4.10 product page, under Software Download, find the Microsoft Hyper-V Agent installer and download it on your Hyper-V host machine.

  1. Run the installer and go through the wizard steps.

  1. In the Welcome step, click Next.

  1. In the License Agreement step, read the entire License Agreement carefully. You must accept the terms to continue. Click Next.

  1. In the Installation Directory step, specify the directory where the DPX Hyper-V Agent will be installed. The default directory is usually C:\Program Files\DPX\Hyper-V Agent. Click Next.

  1. Leave default parameters and click Next.

  1. Specify the Username and Password of an account with Domain Administrator Privileges on the Hyper-V Host. If the agent is installed on a cluster environment, this must be a domain account (user needs to have remote access between the nodes in a cluster). For a standalone machine, a local administrator account is fine. The Authorization Key is used for secure communication with the agent.

Note. The Authorization Key established in this step will be required when adding Hyper-V as a node in DPX and for further communication with the node. Ensure it is kept safe and at hand.

Click Next.

  1. Review the details in the Summary screen and click Next.

  1. The wizard is now ready to install the DPX Hyper-V Agent on your computer. Click Next to begin the installation.

  1. The installation process will take a few minutes.

  1. Click Finish to complete the process and exit the wizard. If the View Readme File box is checked, the readme file will be displayed in a separate window.

Upon successful installation, the DPX Hyper-V Agent service should be up and running on your Hyper-V host:

Important. Particular attention must be paid when providing credentials for the Hyper-V host, as the Installation wizard does not verify the credentials. As a result, even though the installation may seem successful, invalid credentials will prevent the DPX Hyper-V Agent service from installing, thus making the Hyper-V host unusable.

You should also be able to see a new firewall rule added for inbound traffic:

After successfully installing DPX Hyper-V Agent on the Hyper-V host, proceed with Adding a Configured Hyper-V Host as a DPX Node.

Installing via Powershell

If you prefer to install the Hyper-V Agent without using the Wizard and without any output, you can do it via powershell. The Hyper-V Agent installer requires the following parameters:

  • --mode

  • --password (Note: this is the authorization key)

  • --adminUsername

  • --adminPassword

& '.\DPX Hyper-V Agent-1.0-win-x64-installer.exe' --mode unattended --password 'secret' --adminUsername 'DOMAIN-NAME\user' --adminPass 'domainP@ss'

The installer also accepts the following optional parameters:

  • --port – port number (default: 50881)

  • --installDir – custom installation directory (default: C:\Program Files\DPX\Hyper-V Agent)

  • --firewallRuleName – custom name for firewall rule added by the installer (default: DPX Hyper-V Agent)

Here is an example with all required and optional parameters:

& '.\DPX Hyper-V Agent-1.0-win-x64-installer.exe' --mode unattended --password 'secret' --adminUsername 'DOMAIN-NAME\user' --adminPass 'domainP@ss' --port 12345 --installDir "C:\custom\installation\directory" --firewallRuleName "Custom rule name" --unattendedmodeui minimal

If an additional parameter --unattendedmodeui minimal is used, a small dialog with a progress bar will be shown during the entire installation process.

When the installation is completed, you can add the Hyper-V as a node to DPX Master Server.

See also. For more information, see .

MySupport
Adding Hyper-V Nodes