4.16 Recovering a Failed Installation

Errors may occur during some installations, preventing the environment from installing correctly. In this case, the Installation Recovery feature of NDI saves the installation information and allows you to retry the process, among other options. If an environment installation fails, the environment is displayed in a failed state. This state is indicated in both the environment list with an icon and the modification of the Manage menu button to a Fix menu button. When an environment is in this state, three options are provided. You may retry the operation, where NDI will attempt to install only the packages that failed or were cancelled during the previous installation. You may additionally ignore the failed installation, making the environment usable in NDI as normal. In this case, no packages are installed. Finally, you may remove the environment from NDI completely without deleting any software packages. In rare cases, NDI will need to delete the environment instead.

To recover a failed installation, follow these steps.

  1. Start NDI and click Dev Environments.
  2. On the Dev Environments screen, find and select the environment from the environment list. An icon is displayed to the right of environments with failed installations.
  3. Open the Fix menu, located at the right side of the screen.



  4. Select the option with the desired outcome from the list.
      • Retry Failed Installs: When selected, NDI will attempt to restart the previous failed installation. Only packages that failed to install are installed with this option.
      • Dismiss Failed Installs: When selected, NDI will ignore the packages that failed to install correctly. No additional packages are installed with this option.
      • Remove From List: When selected, NDI will remove the environment from NDI, but will not uninstall packages. In rare cases of environment incompatibility, packages may be uninstalled instead.

 


CONFIDENTIAL