4.15 Recovering a Development Environment

If environment files are moved or deleted without using the features of NDI, those environments enter an invalid state. While in this state, no additional installations or modifications may occur. NDI provides two options to recover these environments, depending on the circumstances that created the invalid state. This state is indicated by the addition of an icon to the environment list and the modification of the Manage menu button to a Fix menu button. When an environment is in this state, two options are provided. You may attempt to recover the environment or remove the environment from NDI completely without deleting any software packages. In rare cases, NDI will need to delete the environment instead. The following instructions assume that you will attempt to recover the environment.

To recover an environment, 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 Recover Missing Environment from the list.
  5. Select a recovery option. Both options are described in separate sections below.

Search This System

This option should be used if the environment being recovered has been moved to another location on the development system and has a valid index file. This process links the missing files with NDI, but does not install or modify any installed software.

  1. Enter the system location of the environment into the Location field or select a folder with the browse button. All folders below the entered location are searched for environments not associated with NDI. Then click Search.



  2. A list of environment indexes without association to NDI is displayed. If no environments are found and error is displayed instead.



  3. Select the index to associate with the environment selected to start the recovery process from the list and click Recover.
  4. The environment is linked with NDI.

Rebuild From Archive

This option should be used if the environment being recovered was deleted or otherwise removed from the development system. This process installs the most recent state of the environment as recorded by NDI. In this case, external modifications to the environment will not be preserved.

  1. Enter a name and location where the environment will be recovered. This name and location do not need to be need to be the same as the environment name and location before recovery. Click Next.



  2. The next screen displays the packages that are recorded as part of the environment being recovered. Ensure that there is enough space to install these packages in the indicated directory. Click Install All to begin the installation process.



  3. The environment rebuilds in the location indicated.

 


CONFIDENTIAL