Skip to main content

March 25, 2025

Import Configuration Data into Omnissa Horizon Connection Server

You can restore configuration data of a Horizon Connection Server instance by importing a backup copy of the data stored in an LDIF file.

You use the vdmimport command to import the data from the LDIF file to the Horizon LDAP repository in the Horizon Connection Server instance.

If you backed up your Horizon LDAP configuration by using Omnissa Horizon Console or the default vdmexport command, the exported LDIF file is encrypted. You must decrypt the LDIF file before you can import it.

If the exported LDIF file is in plain text format, you do not have to decrypt the file.

Note: Do not import an LDIF file in cleansed format, which is plain text with passwords and other sensitive data removed. If you do, critical configuration information will be missing from the restored Horizon LDAP repository.

For information about backing up the Horizon LDAP repository, see Backing Up Horizon Connection Server Data.

Prerequisites

  • Locate the vdmimport command executable file installed with Horizon Connection Server in the default path.

    C:\Program Files\View\Server\tools\bin

  • Log in to a Horizon Connection Server instance as a user with the Administrators role.

  • Verify that you know the data recovery password. If a password reminder was configured, you can display the reminder by running the vdmimport command without the password option.

Procedure

  1. Uninstall all instances of Horizon Connection Server.

    Uninstall both Horizon Connection Server and AD LDS Instance VDMDS.

  2. Install one instance of Horizon Connection Server.

  3. Stop the Horizon Connection Server instance by stopping the Windows service Horizon Connection Server.

  4. Click Start > Command Prompt.

  5. Decrypt the encrypted LDIF file.

    At the command prompt, type the vdmimport command. Specify the -d option, the -p option with the data recovery password, and the -f option with an existing encrypted LDIF file followed by a name for the decrypted LDIF file. For example:

    vdmimport -d -p mypassword 
    -f MyEncryptedexport.LDF > MyDecryptedexport.LDF
    

    If you do not remember your data recovery password, type the command without the -p option. The utility displays the password reminder and prompts you to enter the password.

  6. Import the decrypted LDIF file to restore the Horizon LDAP configuration.

    Specify the -f option with the decrypted LDIF file. For example:

    vdmimport -f MyDecryptedexport.LDF
    
  7. Uninstall Horizon Connection Server.

    Uninstall only the package Horizon Connection Server.

  8. Reinstall Horizon Connection Server.

  9. Log in to Horizon Console and validate that the configuration is correct.

  10. Reinstall the replica server instances.

Results

The vdmimport command updates the Horizon LDAP repository in Horizon Connection Server with the configuration data from the LDIF file. For more information about the vdmimport command, see the Horizon Installation and Upgrade document.

Note: Make sure that the configuration that is being restored matches the virtual machines that are known to vCenter Server.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…