N1 Service Provisioning System 4.1 User's Guide

Chapter 4 Hosts

Hosts are physical computer systems connected to your network that provide content to the rest of the network for various purposes.

A host is a machine that serves as either a deployment target, deployment intermediary (Local Distributor), or a deployment source (Gold Server).

There are two types of hosts- Physical and Virtual hosts. This section discusses the following topics:

Working with Hosts

Hosts Introduction

A host is an entity (typically a server) on which you install a component. You manage hosts by defining them. To define a host you must enter them into the host repository (or host database), assign them host types, and specify the configuration variables needed to manage each particular host. Within the N1 Service Provisioning System software there are two major groupings of hosts, physical and virtual.

Physical Hosts

A physical host represents a server in your network. Once the host is defined, information about that host is stored in the host database and can be selected as a target for deployment.

There are two functional roles for physical hosts. A physical host can be configured with a Remote Agent and acted upon directly by a Master Server or a Local Distributor. Additionally, a host can be configured as a Local Distributor and act as a software distributor.

Virtual Hosts

A virtual host is a host that is only a source for deployment, such as an instance of an application server. Multiple virtual hosts can exist on a single physical machine. Every virtual host has a parent host, which can be either a physical host or another virtual host. Virtual hosts can be nested arbitrarily, although the outermost parent host must be a physical host.

It can be helpful to think of virtual hosts as containers for sets of related components.

In this example, there are two physical hosts, Host 1 and Host 2. There are five virtual hosts: Servers 1, 2, 3, and 4, and the Admin Server.

Virtual hosts are useful for maintaining multiple instances of an application on a single physical host. They establish a clear distinction between physical machines and the applications running on them. This distinction is especially useful when managing multiple applications that must interact with one another to function.

If your installation requires you to use an administrative server to install and configure hosts, the N1 Service Provisioning System software allows you to define execution plans that specify a virtual or physical host.

Preparing a Host

Before the N1 Service Provisioning System software can work with a physical host, a Remote Agent must be installed on the physical host and the physical host must be prepared. The provisioning software prepares a host by installing OS-specific utilities on the host's Remote Agent. The HTML user interface gives you the option of preparing host when you save its definition. You can also select hosts listed on the Hosts page and prepare them by running the prepare command. The Hosts page identifies hosts that haven't been prepared, yet, by highlighting them in yellow.

Once a host has been prepared, you can perform operations with it, such as running comparisons and performing installations.

Overview of Managing Hosts

Managing a host involves these steps:

Installing a Remote Agent on the host. You can install a Remote Agent either by:
- Running the installer.
- Running the Remote Agent Remote Installer script to install a set of Remote Agents.
Defining the host. You define a host either by:
- Entering the host's data on the Hosts > Detail page and saving the host.
- Running the hdb.h.add command.
  
  Note –
  Once you have completed these first two steps, you can add the host to a host set or query the host with a host search. However, you cannot run plans or perform comparisons on the host until it is prepared.
Preparing the host. You prepare the host either by:
- Leaving the “Prepare Host” check box selected when you save the host with the HTML user interface.
- Selecting the host on the Hosts page and running the “Prepare” command.
  
  Note –
  Once you have prepared the host, you can run plans and perform comparisons on it.

Locked and Unlocked Hosts

When the N1 Service Provisioning System software performs an operation on a host, it locks the host, preventing other plans from operating on it at the same time. Locking a host ensures that one operation, such as an installation, does not undo or overwrite the effects of another. It ensures that the provisioning software can accurately determine the status of a host at any time.

The provisioning software manages the lock automatically. You never need to explicitly lock or unlock a host yourself. However, if the provisioning software indicates that a host is locked, you should wait until its status changes before you try to run a new plan on it.

Hosts and IP Addresses

Each host defined in the N1 Service Provisioning System software must have a unique IP address. You cannot define two hosts, even with different names, that share the same IP address. This restriction helps ensure that one user's work, which might be accessing an address through one host name, doesn't interfere with another user's work, which might be using a different host name to access the same address.

The Hosts User Interface

The Hosts Setup Page

The Hosts Setup page allows you to easily access the three most common tasks; creating hosts, creating hosts sets, and creating host searches. You can access these major areas of function from either the main work area of the Hosts Setup page or from the left hand menu bar once Hosts Setup is selected.

The Hosts Page

The Hosts page allows you to view a list of the hosts and some basic information about them and to create hosts. The top row of the Hosts Page is used to create new hosts. The rows that follow lists the hosts and displays basic information about each host. The Hosts Page has the following fields.

(Check Box): Marks a host for inclusion when one of the actions are clicked in the Actions for Checked Hosts area. When you initiate one of the Actions for Checked Hosts processes all hosts that are checked will acted upon.
Host: A user definable text string that names the host object. By default, the hosts are listed in alphabetical order by host name. You can change the sort order between ascending and descending by clicking on one of the sort arrows that are in the Hosts header area. The white arrow indicates the sort order. MS, LD, RA, Virtual Identifies the host as either a Master Server (MS), Local Distributor (LD), Resource Agent (RA), or a Virtual Host (Virtual). You can sort the host list by the items in this column by clicking on one of the sort arrows in the header area for this column.
Host Type: A user definable attribute used to categorize hosts. You can sort the host list by the items in this column by clicking on one of the sort arrows in the header area for this column. For more information see Working With Host Types.
OS: Displays the operating system installed on the host. Possible options are any of the supported Windows or UNIX operation systems. This attribute is set at the time the host is created and can not be changed.
Version: Displays the revision level of the host's operating system. This attribute is set at the time the host is created and can not be changed.
Description: An optional user defined text string that describes the host object. This attribute is not used by the provisioning software but can provide meaningful information to the user.
Action: Links that take you to other hosts related pages to either create a new host, view more information about a specific host, view the history of the host, or view the installed components for a specific host.
(Colored Bar): This is a vertical colored bar located to the left of the check box for a given host. It indicates that the host is not prepared. The N1 Service Provisioning System software can not manage a host unless it is first prepared.
Actions for Checked Hosts: From this area you can either prepare or delete the hosts that are checked.

The Host Details Page

The Hosts Details page allows you to view host information and attributes. This page is organized into several general informational and functional sections. The first section addresses the host name, host type, operating system, and attributes. The second section addresses using the Remote Agent on the host. The next section addresses using a host as a Master Server. The next section addresses using a host as a Local Distributor. The next section addresses host relationships. The last section indicates if the host is hidden or not. The Hosts page has the following fields.

General Information

First section of the Hosts Details Page.

Host

A user definable text string that names the host object. This attribute is set at the time the host is created and can be changed using the Hosts Details page by clicking the edit button.

Description

An optional user defined text string that describes the host object. This attribute is not used by the provisioning software, but can provide meaningful information to the user. This attribute is set at the time the host is created, and can be changed using the Hosts Details page by clicking the edit button.

OS

Displays the operating system installed on the host. Possible options are any of the supported Windows or UNIX operation systems. This attribute is set at the time the host is created and can not be changed.

OS Version

Displays the revision level of the host's operating system. This attribute is set at the time the host is created and can not be changed.

Locked Status

Indicates whether the host is locked or not. This is controlled by the provisioning software and cannot be changed by the user.

Last Prepared

Displays the date the host was last prepared or that the host is not prepared yet.

Host Type

Displays the host types.

For more information on host types see Working With Host Types.

For more information on Physical Hosts see Physical Hosts and for Virtual Hosts see Virtual Hosts.

Attributes

A user-definable object that can control some aspect of a deployment. For example, you can define an attribute calling it port and set its default value to 1020. This can then be used to configure the communication port for an application. This attribute is set at the time the host Type is created.

This area contains three fields that displays information about the host attributes.

Attribute - Displays the Attribute name.
Default Value - Displays the default value for the attribute.
Attribute Value - Displays the actual value for the attribute. If this value is different from the default value the background color is different from the rest of the values.

Remote Agent on this Physical Host

This section of the Hosts Details Page displays information regarding the Remote Agent installed on the host.

Connection Type

Displays the communication protocols. For more information, see Network Protocols.

IP Address or Name

Displays the IP Address or IP Host Name for the host. This must match the IP address for the host.

Port

Specifies the user definable port number used for network communication. This must match the port number set during the Remote Agent software installation.

Parent Type

Displays the parent type for the Remote Agent. The Parent Type field is a pull down menu allowing you to choose the Host Type. The options are Master Server and Local Distributor.

Parent Host

Displays the parent host name for the Remote Agent. This defines source host for a deployment.

Advanced Parameters

Displays the XML code used for advance molding. For more information an advanced modelling contact your Sun service provider.

View Connection & Configuration & log...

This is a button that brings up a popup window that displays three separate types of information depending on which button is selected on the popup window.

Connection - Displays host connection information.
Configuration - Displays host configuration information.
Log - Displays host connection log.

Prepare Remote Agent...

This is a button that prepares the Remote Agent on the host. A popup window displays the status of this process while it is running.

Update Remote Agent...

This is a button that updates the Remote Agent on the host. A popup window displays the status of this process while it is running.

This Physical Host is a Master Server

This section displays IP address and port number, if the Master Server software is installed on the host.

IP Address or Name: Displays the IP Address or IP Host Name for the host. This must match the IP address for the host.
Port: Specifies the user definable port number used for network communication. This must match the port number set during the Remote Agent software installation.

Local Distributor on this Physical Host

This section of the Hosts Details Page displays information regarding the Local Distributor if, the software is installed on the host.

Connection Type: Displays the communication protocols. For more information, see Network Protocols.
IP Address or Name: Displays the IP Address or IP Host Name for the host. This must match the IP address for the host.

Port: Specifies the user definable port number used for network communication. This must match the port number set during the Remote Agent software installation.
Parent Type: Displays the parent type for the Remote Agent. The Parent Type field is a pull down menu allowing you to choose the Host Type. The options are Master Server and Local Distributor.

Parent Host: Displays the parent host name for the Remote Agent. This defines source host for a deployment.
Advanced Parameters: Displays the XML code used for advance molding. For more information an advanced modelling contact your Sun service provider.
Host Relationships: This section of the Hosts Details Page displays membership in Host Set(s), and lists any virtual hosts on this host. The following two items relate to this area.
Member of Host Sets: Displays the host sets that this host is a member. There are two links that allow you to either add this host to more host sets or remove this host from host sets.
Virtual Host Children: Lists any virtual hosts on this host.

Other

This is the last section of the Hosts Details Page and allows the user to hide or view a host.

The Host Edit Page

The Hosts Edit page allows you to view and change host information and attributes. This page is organized into several general informational and functional sections. The first section addresses the host name, host type, operating system, and attributes. The second section addresses using the Remote Agent on the host. The next section addresses using a host as a Master Server. The next section addresses using a host as a Local Distributor. The next section addresses host relationships. The next section indicates if the host is hidden or not. The last section indicates if the host is to be updated. The Hosts Edit page has the following fields.

General Information

First section of the Hosts Edit Page.

Host

A user definable text string that names the host object.

Description

An optional user defined text string that describes the host object. This attribute is not used by the provisioning software, but can provide meaningful information to the user.

OS

Displays the operating system installed on the host. Possible options are any of the supported Windows or UNIX operation systems.

OS Version

Displays the revision level of the host's operating system.

Locked Status

Indicates whether the host is locked or not. This is controlled by the provisioning software and cannot be changed by the user.

Last Prepared

Displays the date the host was last prepared or that the host is not prepared yet.

Host Type

A pull down menu the allows you to select one of the user defined host types. For more information on host types see Working With Host Types. Along with one of the user definable hosts type, you must select one of the two radio buttons that indicate whether this is a Physical Host (the default) or a Virtual Host.

For more information on Physical Hosts see Physical Hosts, and for Virtual Hosts see Virtual Hosts.

Attributes

This area contains three fields that displays information about the host attributes.

Attribute - Displays the Attribute name.
Default Value - Displays the default value for the attribute.
Attribute Value - Displays the actual value for the attribute. If this value is different from the default value, the background color is different from the background color of the default values.

Include Remote Agent on this Physical Host

This section of the Hosts Edit Page includes a check box that indicates if the Remote Agent is to be prepared at this time. Once the check box is selected the following items apply. The Remote Agent software must already be installed on the host before it cam be prepared using this section.

Connection Type: A pull down menu to select one of the supported communication protocols. For more information, see Network Protocols.
IP Address or Name: Identifies the IP address to allow a network connection to the host. A host name may also be used if using a host name is supported.
Port: Specifies the user definable port number used for network communication.
Parent Type: A pull down menu that allows you to select the parent type of the deployment source. This is typically either the Master Server or a Local Distributor.
Parent Host: A pull down menu that allows you to select the host name of the source for deployments. The pull down menu lists all the currently defined hosts.
Advanced Parameters: Displays the XML code used for advance modeling. For more information on advanced modeling, contact your Sun service provider.

Include Local Distributor on this Physical Host

This section of the Hosts Edit Page includes a check box that indicates if the Local Distributor is to be prepared at this time. Once the check box is selected the following items apply.

Connection Type: See “Connection Type” above.
IP Address or Name: See “IP Address or Name” above.
Port: See “Port” above.
Test Connection: See “Test Connection” above.
Parent Type: See “Parent Type” above.
Parent Host: See “Parent Host” above.
Advanced Parameters: See “Advanced Parameters” above.

This Physical Host is a Master Server

This section displays IP address and port number if the Master Server software is installed on the host.

IP Address or Name: Displays the IP Address or IP Host Name for the host. This must match the IP address for the host.
Port: Specifies the user definable port number used for network communication. This must match the port number set during the Remote Agent software installation.

Host Relationships

This section of the Hosts Edit Page displays membership in Host Set(s) and lists any virtual hosts on this host. The following two items relate to this area.

Member of Host Sets: Displays the host sets that this host is a member. There are two links that allow you to either add this host to more host sets or remove this host from host sets.
Virtual Host Children: Lists any virtual hosts on this host.

Other

The next section of the Hosts Edit Page allows you to hide or view a host.

Options

This is the last section of the Hosts Edit Page and allows you to update the host with the most recent updates.

How To View Hosts

Steps

In the left-hand navigation menu, click hosts Setup.

The HTML user interface displays the Hosts Setup page, which allows you to access the three most common tasks; creating hosts, creating hosts sets, and creating host searches.

In the Hosts Setup page, click hosts.

The HTML user interface displays the Hosts page, which displays a list of hosts.

How To View a Host's Configuration

Steps

In the left-hand navigation menu, click hosts Setup.

The HTML user interface displays the Hosts Setup page, which allows you to access the three most common tasks; creating hosts, creating hosts sets, and creating host searches.

In the Hosts Setup page, click hosts.

The HTML user interface displays the Hosts page, which displays a list of hosts.

Find the row listing the host you're interested in, and click details.

The HTML user interface displays a Host Details page for the host. The Host Details page presents the configuration details of the host.

How To Create Hosts

Steps

In the left-hand navigation menu, click hosts Setup.

The HTML user interface displays the Hosts Setup page, which allows you to access the three most common tasks; creating hosts, creating hosts sets, and creating host searches.

In the Hosts Setup page, click hosts.

The HTML user interface displays the Hosts page, which displays a list of hosts.

In the top row of the table listing hosts, do the following:
1. Enter a name for the new host in the Host text box
2. Use the pull-down menu to select a host type for the host
3. Enter a brief description of the new host in the Description text box
4. Click create
The HTML user interface displays the Hosts Edit page for the new host.

Use the controls on the Hosts Edit page to configure the new host.
1. In the host type field, use the pull-down menu to select the host type
2. Click the appropriate button to indicate whether this is a physical host or a virtual host. For information about physical hosts and virtual hosts, see Physical Hosts and Virtual Hosts
3. If the host type you selected has attributes associated with it, the Hosts Edit page lists the attributes, along with their default values, in the attribute table. To assign a non-default value to an attribute, enter the value in the attribute column for the attribute row describing the attribute
4. Click the check box that indicates which type of provisioning software application you want to install on this host
5. Configure the connection type, network address, and parent information to correspond to the configuration values you provided the N1 Service Provisioning System software installer when you installed the provisioning software application on this host
  
  Note –
  See N1 Service Provisioning System 4.1 Installation Guide for information on configuring SSL and SSH network connections.
6. To add this host to a host set, click add to host sets... in the hosts relationships area of the page. In the popup window, select the host set you want to add this host to.

Click save.

The HTML user interface displays the Hosts page, which now lists the new host.

How To Edit Hosts

Steps

In the left-hand navigation menu, click hosts Setup.

The HTML user interface displays the Hosts Setup page, which allows you to access the three most common tasks; creating hosts, creating hosts sets, and creating host searches.

In the Hosts Setup page, click hosts.

The HTML user interface displays the Hosts page, which displays a list of hosts.

Find the row listing the host you're interested in, and click details.

The HTML user interface displays a Host Details page for the host. The Host Details page presents the configuration details of the host.

On the Hosts Details page click the Edit button located near the bottom of the page.

Use the controls on the Host Edit page to modify the host's configuration.

When you have finished your modifications, click save.

How To Hide a Host

Steps

In the left-hand navigation menu, click hosts Setup.

The HTML user interface displays the Hosts Setup page, which allows you to access the three most common tasks; creating hosts, creating hosts sets, and creating host searches.

In the Hosts Setup page, click hosts.

The HTML user interface displays the Hosts page, which displays a list of hosts.

Find the row listing the host you're interested in, and click details.

The HTML user interface displays a Host Details page for the host. The Host Details page presents the configuration details of the host.

Click the check box labeled hidden at the bottom of the page.

Click save.

How To Show a Hidden Host

If the Hosts page is not showing hidden hosts, do the following:

Steps

In the left-hand navigation menu, click hosts Setup.

The HTML user interface displays the Hosts Setup page, which allows you to access the three most common tasks; creating hosts, creating hosts sets, and creating host searches.

In the Hosts Setup page, click hosts.

The HTML user interface displays the Hosts page, which displays a list of hosts.

In the upper right corner of the Hosts page, click the check box labeled show hidden hosts.

The HTML user interface updates the Hosts page, which now lists hidden hosts as well as displayed hosts.

Note –
The HTML user interface indicates that a host is hidden by placing a vertical colored bar just to the left of the check box.

Find the row listing the host you want to view, and click details.

The HTML user interface displays a Host Details page for the host. The Host Details page presents the configuration details of the host.

To display the host, so that it always shows up, find the row describing the host you want to hide. Click details.

The HTML user interface displays a Host Details page for the host.

Click the check box labeled hidden at the bottom of the page, so that the box is no longer selected.

Click save.

Summary of CLI Commands for Hosts

The hdb.h commands manage target hosts: physical and virtual hosts whose applications you are managing with the provisioning software.

Table 4–1 Summary of hdb.h Commands


Command	Description
hdb.h.add	Adds a new host.
hdb.h.del	Deletes a host
hdb.h.la	Lists all hosts.
hdb.h.lo	Retrieves information about a host.
hdb.h.lq	Queries for matching hosts.
hdb.h.mod	Modifies an existing host.

The net commands listed below perform networking tasks related to hosts.

Table 4–2 Summary of net Commands


Command	Description
net.gencfg	Generates the Transport Config file for a provisioning software application.
net.ping	Checks connectivity to a Remote Agent or Local Distributor by executing the TCP/IP ping command.
net.traceroute	Uses the IP traceroute utility to find the route to a Remote Agent or Distributor

Working With Host Types

A host type is a user definable classification for hosts based on some combination of attributes, such as function, location, or configuration. By assigning each host a host type, you make it easier to group hosts by their most important characteristics. For example, you can define a host type for the hosts that are used as Web servers, another host type for hosts that are used for database servers, and so on. The Web server host type might include attributes such as Location, WebServer_User, WebServer_Group, HTTP_Port, and HTTPS_Port. The database server host type might include attributes such as Location, DB_Directory, DB_InstanceName, DB_Port, and DB_SecurePort.

Host types also enable you to set configuration values dynamically when a data center operation is performed. For example, you could define a host type for Web servers, and this host type could include an HTTP port variable. When you run an installation on hosts with this host type, your installation plan could automatically set the HTTP port variable for each host.

Every host you manage with the provisioning software will be assigned a host type–either the default host type, crhost, or a host type that you have defined. Each host may only have one host type.

The Default Host Type

The N1 Service Provisioning System software includes a default host type: crhost. By default, all hosts are assigned this host type. The crhost type includes two attributes:

host name
description

There are no default values for these attributes. The values must be specified for each host when you define the host. The crhost host type cannot be modified or deleted.

Host Type Attributes

A host type is distinguished by its name and its attributes. An attribute is a name-value pair. Each attribute may have a default value.

For example, you might define a host type, production_web_hosts, for production servers running a Web application. The table below describes an example of such a host type.

Table 4–3 Host Type Attributes Examples


Attribute Name	Default Value	Comment
name	None.	The name of the host. This attribute is inherited from the `crhost` host type.
description	None.	A description of the host. This attribute is inherited from the `crhost` host type.
location	San Francisco	The name of the data center where the host is located. In this example, an organization has most of its servers in a data center in San Francisco. So, the user has made this the default value.
host_role	web	An identifier for the role this host plays in the Data Center. By default, this variable is assigned the value web, indicating the host acts as a web server.
web_port	80	The number of the port through which users will access this Web application. Because this variable is listed in the host type, it is accessible to plans, command lines, and Web pages and it can be configured dynamically.

Host attributes must begin with a letter and cannot include spaces.

Adding new attributes to the host type results in the attributes and their defaults being added to every host of that type. Removing attributes from a host type permanently deletes those attributes from every host of that type. Attributes cannot be renamed; they can only be deleted and re-added with a new name, which results in the attribute value being reset to the default on all hosts of that type.

When you define a host (an individual target machine), you can selectively override the values of attributes specified by the host's host type. Default values that are not overwritten will be applied to the host.

The Host Types User Interface

The Host Types object is accessed by clicking on the Administration link in the left-hand navigation menu.

The Hosts Types Page

The Host Types Page allows you to view a list of host types and create a host type.

You can sort the host types list by clicking on one of the sort arrows in the header area host types column. Click either the ascending or descending arrow to select the desired sort order.

The Host Types Page has the following fields.

(Check Box): Marks a host type for inclusion when host types are deleted.
Host Type: A user definable text string that names the host types object.
Description: An optional user defined text string that describes the host type object. This attribute is not used by the provisioning software but can provide meaningful information to the user.
Action: Links that take you to other host type related pages to either create a host type, view more information about a specific host type, or find a specific host type.
Actions for Checked Host Types: Permanently deletes all checked host types.

The Hosts Types Details Page

The Host Types Details Page allows you to view and change a specific host type's information and attributes.

The Host Types Details Page has the following fields.

Host Type

A user definable text string that names the host types object.

Description

An optional user defined text string that describes the host type object. This attribute is not used by the provisioning software but can provide meaningful information to the user.

Attributes

This area contains two fields that displays information about the host attributes.

Attribute - Displays the Attribute name.
Default Value - Displays the default value for the attribute.

Other

Allows you to hide or display the host type.

How To View Host Types List

Steps

In the left-hand navigation menu, click Administrative.

The HTML user interface displays the Administrative page.

In the Administrative page, click Host Types.

The HTML user interface displays the Host types page.

How To Viewing Host Types Details

Steps

In the left-hand navigation menu, click Administrative.

The HTML user interface displays the Administrative page.

In the Administrative page, click Host Types.

The HTML user interface displays the Host types page.

Find the row listing the Host type you're interested in, and click details.

The HTML user interface displays a Host Types Details page for the Host Type.

How To Create a Host Type

Steps

In the left-hand navigation menu, click Administrative.

The HTML user interface displays the Administrative page.

In the Administrative page, click Host Types.

The HTML user interface displays the Host types page.

In the top row of the table on the Host Types page, enter a name and brief description for the new host type, and click create.

The HTML user interface displays a Host Types Details page for the new host type.

For each attribute you want to assign to the host type, do the following:
1. In the attributes table, enter a name for the attribute in the attribute column.
2. If you would like to assign the attribute a default value, enter a default value for the attribute in the default value column.
3. In the action column, click add.

If you want to hide the host type, click the check box labeled hidden.

To save the host type, click save.

How To Edit a Host Type

Steps

In the left-hand navigation menu, click Administrative.

The HTML user interface displays the Administrative page.

In the Administrative page, click Host Types.

The HTML user interface displays the Host types page.

Find the row listing the Host type you're interested in, and click details.

The HTML user interface displays a Host Types Details page for the Host Type.

For each attribute you want to change, do the following:
1. In the Host Type field, enter a new name.
2. In the Description field, enter a new description.
3. In the attributes table, enter a name for a new attribute in the attribute column.
4. If you would like to assign the attribute a default value, enter a default value for the attribute in the default value column.
5. In the action column, click add.
6. You either move up, move down, or delete existing attributes.

If you want to hide the host type, click the check box labeled hidden.

To save the host type, click save.

Summary of CLI Commands for Host Types

Table 4–4 lists the CLI commands you can use when managing host types. For more information on CLI commands, see N1 Service Provisioning System 4.1 Reference Guide.

Table 4–4 CLI Commands for Managing Host Types (hdb.ht).


Task	CLI Command
hdb.ht.la	List all host types
hdb.ht.del	Deletes a host type.
hdb.ht.lo	Retrieve information about a host type
hdb.ht.add	Add a host type
hdb.ht.mod	Modify a host type

Working with Host Sets

A host set is a logical grouping of hosts. A host set can include any of the following:

one or more hosts (referenced by name)
one or more host searches (which adds all the hosts found by the host searches to the host set)
one or more other host sets

When you define a host set to include a host search, the host search is performed and the resulting list of hosts determined whenever the provisioning software acts upon the host set. For example, when the provisioning software uses the host set as a target for an installation or a comparison. Host sets based on host searches enable the provisioning software to group hosts based on their actual configurations at run time. They enable you to be sure you really have found all the hosts that match the search criteria, rather than having to try to remember which hosts are configured a certain way.

Host sets enable you to perform operations on groups of hosts. For example, to install new IIS global filter settings on all the hosts in the Chicago data center, on a host named barolo2, and on all the servers running the application SalesExpress, you would define a host set to include:

the host barolo2
a host search for all the hosts in the Chicago data center (using a host type attribute you have already defined, such as location)
a host search for all the hosts that are running the application SalesExpress

A host can appear in a host set only once. If, in the previous example, the two host searches happened both to retrieve the same hosts (hosts that were both in Chicago and configured to run SalesExpress), each of these hosts would appear in the host set just once.

Platform Host Sets

The N1 Service Provisioning System software includes a hierarchy of nested host sets that are based on the OS platforms of hosts. The top host set is any, which includes hosts running any of the supported OS platforms.

The Host Sets User Interface

The Host Sets Page

The Hosts Sets page allows you to view and create host sets. Host Sets are user definable categories that are used to group hosts together. These Host Sets are used with host searches and plans to facilitate identifying and displaying selecting groups of hosts.

You can sort the host sets list by clicking on one of the sort arrows in the header area host sets column. Click either the ascending or descending arrow to select the desired sort order.

The Host Sets Page has the following fields.

(Check Box): Marks a host set for inclusion when host sets are deleted.
Host Set: A user definable text string that names the host set object.
Description: An optional user defined text string that describes the host set object. This attribute is not used by the provisioning software but can provide meaningful information to the user.
Action: Links that take you to other host sets related pages to either create a host set, view more information about a specific host set, or find a specific host set.
Actions for Checked Host Types: Permanently deletes all checked host sets.

The Host Sets Detail Page

The Host Sets Details Page allows you to view and change a specific Host Sets' information and attributes.

The Host Sets Details Page has the following fields.

Top Area

This section of the Host Sets Details page allows you to assign a host set name and description.

Host Set

A user definable text string that names the host set object.

Description

An optional user defined text string that describes the host set object. This attribute is not used by the provisioning software but can provide meaningful information to the user.

Member of Set

This section of the Host Sets Details page allows you to assign membership in one or more host sets. The fields in this section are grouped into three columns, Member Type, Name, and action.

Member type

Lists the type of objects that can be included in this host set. The objects included are Host, Hosts Set, and Host Search.

Host - Allows you to assign individual hosts to this host set.
Host Set - Allows you to make this host set a member of other host sets.
Host Search - Displays the Attribute name.
Current Member Hosts - Displays a list of the hosts that are a member of this host set.

Other

Allows you to either hide or display the host set.

How To View Host Sets

Steps

In the left-hand navigation menu, click Host Setup.

The HTML user interface displays the Host Setup page.

In the Host Setup page, click Host Sets.

The HTML user interface displays the Host Sets page. By default, this page lists all the unhidden Host Sets. To include the hidden Host Sets click the checkbox in the upper right hand corner of the page.

Find the row listing the host set you are interested in, and click details.

The HTML user interface displays the Host Set Details page for the host set. This page will list the host set's member criteria and the hosts that currently match this criteria and are included in the host set.

How To Create Host Sets

Steps

In the left-hand navigation menu, click Host Setup.

The HTML user interface displays the Host Setup page.

In the Host Setup page, click Host Sets.

The HTML user interface displays the Host Sets page. By default, this page lists all the unhidden Host Sets. To include the hidden Host Sets click the checkbox in the upper right hand corner of the page.

In the top row of the table listing host sets, enter a name and a brief description for the host set you want to create. In the action column of this row, click create.

The HTML user interface displays a Host Set Details page for the new host set. This page includes:
- a text field listing the name for the host set
- a text field listing the description for the host set
- a table labeled members of set which includes controls for defining selection criteria for the host set
- a display field labeled current member hosts that lists the hosts that meet the criteria of the host set as it is currently defined.

Use the controls on this page to define the host set. Each time you add a host, host set, or host search to the host set, The HTML user interface displays this page and updates the list of hosts in the host set.
- To add a host by name, enter its name in the name field, and click add.
- To add a host based on its configuration attributes, click select from list. In the Select Hosts from List popup window, define a host search that selects the hosts you want, and then click return selected hosts to main window.
- To include another host set within this host set, select the other host set's name from the host set pull down menu, and click add set.
- To include the hosts found by a host search, select the host search from the host search pull-down menu, and click add search.
- To highlight the hosts in the host set that match a criterion you have defined, click the highlight link in the row listing that criterion.
- To remove a criterion from the host set configuration, click the remove link in the row listing that criterion.
- To hide the host set, click the check box labeled hidden.

Click the save button at the bottom of the page.

How To Edit Host Sets

Steps

In the left-hand navigation menu, click Host Setup.

The HTML user interface displays the Host Setup page.

In the Host Setup page, click Host Sets.

The HTML user interface displays the Host Sets page. By default, this page lists all the unhidden Host Sets. To include the hidden Host Sets click the checkbox in the upper right hand corner of the page.

Find the row listing the host set you are interested in, and click details.

The HTML user interface displays a Host Set Details page for the host set. This page will list the host set's member criteria and the hosts that currently match this criteria and are included in the host set.

Use the controls on this page to define the host set. Each time you add a host, host set, or host search to the host set, The HTML user interface displays this page and updates the list of hosts in the host set.
- To add a host by name, enter its name in the name field, and click add.
- To add a host based on its configuration attributes, click select from list. In the Select Hosts from List popup window, define a host search that selects the hosts you want, and then click return selected hosts to main window.
- To include another host set within this host set, select the other host set's name from the host set pull down menu, and click add set.
- To include the hosts found by a host search, select the host search from the host search pull-down menu, and click add search.
- To highlight the hosts in the host set that match a criterion you have defined, click the highlight link in the row listing that criterion.
- To remove a criterion from the host set configuration, click the remove link in the row listing that criterion.
- To hide the host set, click the check box labeled hidden.

Click the save button at the bottom of the page.

Working With Host Searches

A host search is a query run on the repository that yields a list of hosts whose attributes match those specified in the query. You can use host searches to create lists of hosts that have the same host type, are running the same applications, are configured with the same subnet masks, and so on.

In Host Searches are objects with names and attributes. Therefore, when you create a host search, you assign it a name, a description, search parameters, and save it in the repository. Because host searches are objects and saved, you can invoke them later whenever you need to determine which hosts match the criteria described in the host search.

Invoking host searches provides you with up-to-the-moment information about host configurations. Which hosts are configured with a certain host type? With a certain application? Which have applications running on a specified port? Host searches enable to you generate lists of hosts meeting conditions like these.

By defining a host set (a group of hosts) to include the list of hosts returned by a specific host search, you can dynamically generate a list of hosts for use as targets based on the host configurations at run time.

Note –

For more information on host sets see Working with Host Sets.

The Host Search User Interface

The Hosts Search Page

The Hosts Search page allows you to view, create, and run host searches.

(Check Box): Marks a host search for inclusion when host search are deleted.
Host Search: A user definable text string that names the host search object.
Description: An optional user defined text string that describes the host search object. This attribute is not used by the provisioning software but can provide meaningful information to the user.
Action: Links that take you to other host search related pages to either create a host search, view more information about a specific host search, or find a specific host search.
Actions for Checked Host Types: Permanently deletes all checked host search.

The Hosts Search Details Page

The Hosts Search page allows you to view, create, and run host searches.

Top Area

This section of the Host Searches Details page allows you to edit host search information.

Host Search: A user definable text string that names the host search object.
Description: An optional user defined text string that describes the host search object. This attribute is not used by the provisioning software but can provide meaningful information to the user.

Search for Hosts Meeting ALL of the Following Conditions

This section defines the criteria for the search and displays the result. The search criteria fields are grouped into three columns labeled Attribute, Comparison, and Value.

Attribute: Contains a pull down menu and two other sets of criteria to set the parameters of a search. You can search by any of several attributes such as host name, host type, or domain name.

It is possible to define what to include as well as what to exclude.

Comparison: Allows you to set whether the search is to equal or contain the value set in the Value column.
Value: Allows you to specify wether the attribute either equals or contains a value.
Host: Allows you to limit a search to either physical host or virtual hosts.
Physical Host: Allows you to limit a search to hosts that are Master Servers, Local Distributors, or have a Remote Agent installed.
Current Found Hosts: Lists the result. of a search.
Other: Allows you to either hide or display the host search.

How To View Host Searches

Steps

In the left-hand navigation menu, click Host Setup.

The HTML user interface displays the Host Setup page.

In the Host Setup page, click Host Searches.

The HTML user interface displays the Host Searches page. By default, this page lists all the unhidden Host Searches. To include the hidden Host Searches click the checkbox in the upper right hand corner of the page.

Find the row listing the host set you are interested in, and click details.

The HTML user interface displays a Host Searches Details page.

How To Create Host Searches

Steps

In the left-hand navigation menu, click Host Setup.

The HTML user interface displays the Host Setup page.

In the Host Setup page, click Host Searches.

The HTML user interface displays the Host Searches page. By default, this page lists all the unhidden Host Searches. To include the hidden Host Searches click the checkbox in the upper right hand corner of the page.

In the top row of the Host Searches table, enter:
- a name for the new host search
- a brief description of the host search

Click create.

The HTML user interface displays the Host Searches Details page. This page will display the name and description you entered on the Host Searches page.

Use the controls on this page to define your host search.
- Use the pull-down 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 the following standard attributes:
  - host name
  - description
  - host type
  - ip address
  - parent
  - os
  - os version
  Once you have selected an attribute, use the pull-down menu in the comparison column to select either equals or contains.
  
  In the value column of the table, enter a string that the attribute should equal or contain.
  
  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.
- Use the check boxes labeled physical and virtual to indicate whether the search should look only for physical hosts, only for virtual hosts, or for both.
- Use the check boxes in the bottom row of the search criteria table to indicate whether the search should be limited to hosts running a specific provisioning software application: the Master Server, a Local Distributor, or a Remote Agent.
- To view the list of hosts that match the criteria you have defined so far, click refresh list.

When you have defined your host search, click save.

The HTML user interface saves the host search and displays the Host Searches page, which now lists the host search.

How To Edit a Host Searches

Steps

In the left-hand navigation menu, click Host Setup.

The HTML user interface displays the Host Setup page.

In the Host Setup page, click Host Searches.

The HTML user interface displays the Host Searches page. By default, this page lists all the unhidden Host Searches. To include the hidden Host Searches, click the checkbox in the upper right hand corner of the page.

Find the row listing the host Search you are interested in, and click details.

The HTML user interface displays a Host Searches Details page for the host Search. This page displays the search criteria for the host search.

Use the controls on this page to define the search parameters for the host search.
- Use the pull-down 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 the following standard attributes:
  - host name
  - description
  - host type
  - ip address
  - parent
  - os
  - os version
  Once you have selected an attribute, use the pull-down menu in the comparison column to select either equals or contains.
  
  In the value column of the table, enter a string that the attribute should equal or contain.
  
  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.
- Use the check boxes labeled physical and virtual to indicate whether the search should look only for physical hosts, only for virtual hosts, or for both.
- Use the check boxes in the bottom row of the search criteria table to indicate whether the search should be limited to hosts running a specific provisioning software application: the Master Server, a Local Distributor, or a Remote Agent.
- To view the list of hosts that match the criteria you have defined so far, click refresh listing

When you have defined your host search, click save.

The HTML user interface saves the host search and displays the Host Searches page, which now lists the host search.