Blueprint Management › Browse Servers to Locate Blueprint Elements

Browse Servers to Locate Blueprint Elements

You can use the Browse button while creating or editing Blueprints to do the following on managed Windows servers:

• Find files and directories.
• Find registry keys, values, and data.
• Add found elements to the Blueprint.

The Browse button is located in the following locations when creating Blueprints in the Blueprint Wizard, or editing them in either the Tree View or Tab View on the Blueprint Details page:

• Discovery Methods page (wizard step 2)
  • File Indicators, Add New Search Options
  • File Indicators, Add New File and Add New Directory
  • Registry Indicators, \HKEY_LOCAL_MACHINE Search Options
  • Registry Indicators, \HKEY_LOCAL_MACHINE Add New Registry Value/Key
• Management page (wizard step 4)
  • File Management, $(Root) File Management Options
  • File Management, $(Root) Add Directory
  • File Management, $(Root) Add File
  • File Filters and Attributes, $(Root)
  • File Filters and Attributes, $(Root) Add Directory
  • File Filters and Attributes, $(Root) Add File
  • Registry Management, $(RegistryRoot), Registry Management Options
  • Registry Management, $(RegistryRoot), Add Key
  • Registry Management, $(RegistryRoot), Add Value
  • Registry Filters and Attributes, $(RegistryRoot)
  • Registry Filters and Attributes, $(RegistryRoot), Add Key
  • Registry Filters and Attributes, $(RegistryRoot), Add Value
• Configuration page (wizard step 6)
  • File Parsing, $(Root)

You can create or edit Blueprints in either of the following views:

• Tab View (this includes the creation Wizard)
• Tree View

If you are creating or editing a Blueprint from the Tab View, clicking the Browse button opens the Browse Server dialog set to either File Browser or Registry Browser depending on which page you click Browse. For example, if you are on the Registry Management page, and click Browse, the Browse Server dialog appears set to Registry Browser. If you are on the File Management page, and click Browse, the Browse Server dialog appears set to File Browser. In the Tab View, the Browse utility is in the context of whichever tab was selected. If you click Browse on a File Management tab, you can only add that type of element.

If you are using the Tree View, the Browse Server dialog appears with two tabs: File and Registry. In the Tree View, Browse is global; you can add any type of element.

To locate and add files, directories, and symbolic links using Browse

1. Click Browse in any of the previously mentioned locations.

   The Browse Servers dialog appears.

2. Select a server to browse from the Server drop-down list.

   Servers are listed in alphabetical order by name. By default, the Server field shows the first server in the drop-down list.

3. Click Test Connectivity to ensure communications with the selected server.

   A message confirms the connection.

4. (Tree View only) Ensure the File Browser tab is selected.

   If the server selected in the Server field is a Windows server, two tabs are displayed: File and Registry.

5. In the File Search Directory field, either enter a path to the file or directory or leave the field blank to use the default root path (/ or \), then click Browse.

   All items found in the specified File Search Directory appear in a tree view.

6. Narrow your search to a directory displayed in the tree:
   1. Select a directory.
   2. Click Set Search to narrow your search to the selected directory.

      The selected directory appears in the File Search Directory field and on top of the tree.

   3. Click Set Root.

      The selected directory becomes the root and appears in the Component Files Root and on top of the tree.

7. Navigate the tree and select an element you want to add to the Blueprint, then do one of the following:
   • If the element is located in the File Structure Class folder, click Parse.

     The contents of the file are parsed into component-specific attributes and parameters that define the contents of file.

     The attributes and parameters are added to the Blueprint and are highlighted in yellow. Elements highlighted in yellow have been added using the Browse Servers option and have not been saved.

   • If the element is located in any other folder, click Blueprint.

     The Blueprint dialog appears. Select one or more of the options that specify how the element is referenced in the Blueprint. The following options vary depending on the selected element: Indicators, Managed Files, Filters, and Configuration Files.

     The selected element is added to the Blueprint and highlighted in yellow. Elements highlighted in yellow have not been saved.

8. Click Close.

   The Browse dialog closes.

9. Click Save for each highlighted element.

   The Blueprint is updated.

To find registry keys, values, and data using Browse

1. Click Browse in any of the previously mentioned locations.

   The Browse Servers dialog appears.

2. Select a server to browse from the Server drop-down list.

   Servers are listed in alphabetical order by name. By default, the Server drop-down list shows the first server in the list.

3. Click Test to ensure Agent communications with the selected server.

   A message confirms the connection.

4. (Tree View only) Click the Registry Browser tab.

   If the server selected in the Server field is a Windows server, two tabs appear: File Browser and Registry Browser.

5. Enter a root key in the Registry Search Key field, or leave the field blank to use the default key (\HKEY_LOCAL_MACHINE), then click Browse.

   All items found in the specified Registry Search Key are displayed in a tree view.

6. Narrow your search to a registry key displayed in the tree as follows:
   1. Select a registry key.
   2. Click Set Search.

      The selected registry key becomes the Registry Search Key in the browser's tree view display.

   3. Click Set Root.

      The selected directory becomes the Component Registry Root in the browser's tree view display.

7. Navigate the tree and select an element you want to add to the Blueprint, then click Blueprint.

   The Blueprint dialog appears.

8. Select one or more of the options that specify how the element is referenced in the Blueprint. The following options vary depending on the selected element: Search Options, Indicators, Managed Registry, Filters, and Configuration Files.

   The selected element is added to the Blueprint and highlighted in yellow. Elements highlighted in yellow have not been saved.

9. Click Close.

   The Browse dialog closes.

10. Click Save for each highlighted element.

    The Blueprint is updated.