Product Documentation

Load AD and ConfigMgr Data Wizard

Jun 15, 2016

You use the Load AD and ConfigMgr Data wizard to import Active Directory (AD) and System Center Configuration Manager data into AppDNA. The wizard has a number of pages that lead you through the process. The options on each page are documented under separate headings below.

To open the Load AD and ConfigMgr Data wizard:

  • From the menus, choose Configure > AD & ConfigMgr > Load Data.

Load Type

The Load Type page is the first page in the wizard. (However, if you navigate away from the wizard while you are part way through an operation, the next time you enter the wizard it takes you back to where you were. If necessary, click Previous to return to this page.)

On this page you choose what type of load you want to perform. The options are:

Active Directory (AD) – Select this option to do a direct load of Active Directory data. This means that the data is extracted and loaded into AppDNA in one operation.

System Center Configuration Manager (ConfigMgr) – Select this option to do a direct load of Configuration Manager data. This means that the data is extracted from Configuration Manager and loaded it into AppDNA in one operation.

Indirect – Select this option if you want to extract the data from Configuration Manager or Active Directory (or both) on a different machine – for example, on the Configuration Manager server or Active Directory domain controller. This is useful when you do not have the correct credentials to run the extraction yourself. Use this option to download a .zip file (which contains the extraction tool, synchronization data, and documentation) that you can send, for example, to the Configuration Manager administrator. He or she runs the tool and sends the results back to you. Then you use this option again to load the results into AppDNA.

Click Next to continue to the next page.

AD Connection Details

You use the AD Connection Details page to identify the Active Directory domain controller and the credentials to use to connect to it. This page only appears the first time you use the wizard to do a direct load of Active Directory data. If you need to change the details when you subsequently use the wizard, you can do this in Active Directory settings.

The options are:

  • Domain controller – Enter the name of the Active Directory domain or leave this blank to automatically use the domain to which the AppDNA machine is connected.
  • Username – Specify the user name to use to connect to the Active Directory domain. Alternatively, leave this blank to use the credentials of the logged on Windows user account. Whether specified or not, the user must be a valid user of the domain.
  • Password – If you specified a user name above, enter its password here.

Click Next to continue to the next page.

Organizational Units (OUs)

The Organizational Units (OUs) page displays the OUs in the selected domain. (If the wizard did not open the AD Connection Details page and you want to change the domain, click the Previous button, and then enter the new domain name in Active Directory settings before continuing.)

Select the OUs that you want to extract to load into AppDNA. Typically you want to select the OUs to which applications have been deployed through AD, or that contain the users and devices to which applications have been deployed through Configuration Manager.

By default, when you select an OU, the wizard automatically selects any sub-OUs. Similarly, if you clear an OU's check box, by default the wizard automatically clears the check boxes for any sub-OUs. To change this behavior, clear the Automatically select nested OUs check box.

Click Next to continue to the next page.

ConfigMgr Connection Details

You use the ConfigMgr Connection Details page to identify the Configuration Manager server and site and the credentials to use to connect to them. This page only appears the first time you use the wizard to do a direct load of Configuration Manager data. If you need to change the details when you subsequently use the wizard, you can do this in Configuration Manager settings.

The options are:

  • Server – Enter the Configuration Manager server hostname or IP address.
  • Site – Enter the Configuration Manager Site Code.
  • Username – Leave this blank to use the credentials of the logged on Windows user account or specify the user name to use to connect to the Configuration Manager server. Typically this is a domain-qualified user name of the form: domain\username.

    You must leave the Username and Password boxes blank if you are running the extraction on the Configuration Manager server.

  • Password – If you specified a user name above, enter its password here.

Click Next to continue to the next page.

Extraction Mode

The Extraction Mode page applies to the extraction of Configuration Manager data only. The options are:

  • Standard – Select this option if you want to automatically extract all of the relevant changes since the last time you loaded Configuration Manager data.
  • Advanced – Select this option if you want to manually select the applications and packages to load into AppDNA.
Important: Citrix recommends that you use the Advanced option the first time you extract data from a large Configuration Manager site, and then extract the applications and/or packages in batches of, for example, 1,000 applications and 1,000 packages. (In this context, a large Configuration Manager site is one that has a total of more than 5,000 packages and applications, and/or more than 50,000 users or computers.)

Click Next to continue to the next page.

Advanced Selection

When you choose the Advanced extraction mode, you use the Advanced Selection page to select the applications and/or packages that you want to extract from the selected Configuration Manager site for loading into AppDNA. (If the wizard did not open the ConfigMgr Connection Details page and you want to change the server and site combination, click the Previous button to return to the Load Type page, and then enter the new domain name in Configuration Manager settings before continuing.)

Note: Citrix recommends that you select no more than a total of 2,000 applications and packages for extraction at the same time.

For detailed documentation of the features in this page, see ConfigMgr Advanced Selection.

Click Next to continue to the next page.

Indirect Load

The Indirect Load page outlines the steps involved in using the Indirect Load approach. There are three steps:

Step 1 – Click the Download button to download a .zip file that contains the extraction tool, synchronization data, and documentation.

Step 2 – Send the .zip file that you downloaded in Step 1 to the Active Directory or Configuration Manager administrator. The administrator then runs the tool to extract the data from Configuration Manager or Active Directory, or both. Documentation for running the tool is available in the .zip file. After the extraction is complete, the administrator sends the .sgz file(s) that the tool generates back to you.

Step 3 – Click Browse to select the .sgz file generated in Step 2, and then click Next to load the results into AppDNA.

Summary

The Summary page provides a summary of the items that have been selected for loading into AppDNA. Check the details and then click Next to start the extraction process. Depending on how much data you are extracting, this can take a considerable amount of time (several hours, for example).

Progress

The Progress page provides information about the status of the extraction and loading of the selected items into AppDNA.