How to Create or Edit Host Searches

You can generate a dynamic list of hosts according to specified criteria. You might want to edit a host search when your criteria changes.

This procedure describes how to create or edit host searches by using the browser interface. You can also create or edit host searches by using the following commands.

• hdb.hr.add – Creates a host search.

• hdb.hr.mod – Edits a host search.

For a detailed description of these commands, see Chapter 7, hdb: CLI Commands for Managing Hosts, in N1 Grid Service Provisioning System 5.0 Command-Line Interface Reference Manual.

Before You Begin

To create or edit a host search, you must belong to a user group that has Create, Edit, Delete permission on hosts.

Steps

1. Go to the Host Searches page.

   For more information about navigating to the Host Searches page, see How to View Host Searches.

2. Create a host search or display the Details page for an existing host search.

   • If you are creating a host search, in the top row of the Host Searches table, type a name and a brief description for the new host search and click Create.

   • If you are editing an existing host search, find the row listing the desired host search and click Details.

     A Details page for the host search is displayed. This page displays the search criteria for the host search.

3. Add an attribute value as a search criterion.

   1. Use the menu in the attribute column to select an attribute to be added to the search.

      This menu will list any attributes you have defined as part of host types, as well as standard attributes.

   2. Use the menu in the Comparison column to select either Equals or Contains.

   3. In the Value column of the table, type the value of the attribute that you plan to search against.

      The search value can include the wildcard patterns . and *.

   4. In the Action column of the table, click Add to add this attribute-comparison-value criterion to the search.

      You can add as many of these criteria as you like.

4. Indicate whether the search should look only for physical hosts, only for virtual hosts, or for both.

5. Indicate whether the search should be limited to hosts running a specific provisioning system application: the Master Server, a Local Distributor, or a Remote Agent.

6. (Optional) To view the list of hosts that match the criteria you have defined so far, click Refresh Listing.

7. When you have defined your host search, click Save.

   The Host Searches page lists the new or modified host search.