SSH Tectia

Advanced Host Search

Managed hosts can be searched using a selection of search criteria in the advanced host search section.

To search for managed hosts:

  1. Select Hosts → Advanced host search.

  2. Select a group in which to perform the search.

  3. Select zero or more types of search criteria (hostname, IP address and so on) on which to filter by selecting their corresponding checkboxes. Hosts in the search result need to match each selected type of criteria.

    • Hostnames: Enter a list of patterns that the hostname should match. A pattern can be a full or partial hostname, where an asterisk (*) can be used as a wildcard to match any string. Multiple patterns are separated by spaces. For example, the pattern *dre* will match the host andrew.ny.us.example.com, and *dre* *arl* will match both andrew.ny.us.example.com and barley.ny.us.example.com because there are two patterns separated by space.

    • IP address: Enter a value in one of the following formats:

      • Single IP address: n.n.n.n, for example 192.168.0.1

      • Range of IP addresses: n.n.n.n-n.n.n.n, for example 192.168.1.1-192.168.2.255

      • Class of IP addresses: n.n.n.n/n, for example 192.168.0.0/16

      Hosts will need to have an IP address exactly as specified, within the range, or in the class to match.

    • Connected status: Select Connected for hosts whose Management Agents are currently connected, and Disconnected for hosts that are not connected.

    • Last Connected: Select this option to search for hosts that have not been connected for a given period. Define the period (as days) in the Host not seen in field.

    • Server status: Select Running for hosts on which SSH Tectia Server is running, and Not running for hosts on which it is not running.

    • Managed software: Select one or more SSH Tectia products of which the host should have at least one installed. The version field can be left empty, in which case any version will match. If a version number in format n.n.n (for example 6.1.0) is entered, only that version of the installed product will match. A range of versions in format n.n.n-n.n.n (for example 5.3.0-6.1.0) will cause any product with a version within that range to match.

    • Configuration changes: Select Changes for hosts with managed configurations that have been locally modified, and No changes for hosts with no local modifications.

    • Operating system: Select one or more operating systems of which the host's operating system should be one. Optionally, you can specify also a version that must match as an exact substring.

    • Job: Select a previously started software install/uninstall or certificate enrollment job that the host should have been part of. If Failed hosts only is selected, only those hosts are matched that have not been able to complete the job successfully.

  4. Click Search. The search results are shown in the list on the right.

  5. You can save the search results in a host set. Define a name in the Save as field and click Save. The host set is saved under the Hostlists entry in the tree view.

    Advanced host search view

    Figure 7.7. Advanced host search view

  6. Optionally, you can start an operation on the hosts in the search result by selecting the Operations check box:

    • Software: Install or uninstall software on the selected hosts.

    • Grouping: Move the selected hosts to a group or delete the selected hosts. Select the group from the drop-down menu.

    • Distribution Grouping: Move the selected hosts to a group related to a Distribution Server. Select the Distribution Server from the drop-down menu.

    Only operations for which the currently logged in user has permissions are shown.