load group

This command installs software on a group of provisionable servers, such as an OS distribution (through an OS profile), OS update, or firmware update.

Synopsis

• Install a Solaris OS profile on a group of servers:

  load group group osprofile osprofile ip ip networktype static [excludeserver server[,server...] [feature feature agentssh agentssh [agentsnmp agentsnmp] [agentsnmpv3 agentsnmpv3]] [server-configuration-attributes]

• Install a Red Hat Linux or SUSE Linux OS profile on a group of servers:

  load group group osprofile osprofile bootip bootip networktype networktype [ip ip] [excludeserver server[,server...] [feature feature agentssh agentssh [agentsnmp agentsnmp] [agentsnmpv3 agentsnmpv3]] [install-attributes] [server-configuration-attributes]

• Install an OS update on a group of servers:

  load group group update update[,update...]

• Install a firmware update on a group of servers:

  load group group firmware firmware [force]

Parameters

• agentssh – Specify the SSH credentials used for the management features on the provisionable server, including OS monitoring. The SSH user must have root access on the provisionable servers. The agentssh format is a user name/password pair for SSH credentials: ssh-username/ssh-password.

• agentsnmp – Specify the SNMP credentials used for OS monitoring on the provisionable server. The agentsnmp format is a read community string.

• agentsnmpv3 – Specify the SNMP Version 3 credentials used for OS monitoring on the provisionable server. The agentsnmpv3 format is a user name/password pair: snmpv3-username/snmpv3-password.

• bootip – (Linux only) The IP address for the server's provisioning network interface used to install the server, also known as the Provisioning IP. You can specify a range of IP addresses or a subnet mask. Specify a range of IP addresses as follows: ip-address-ip-address. Example: 10.0.0.1–10.0.0.3

• excludeserver – Exclude one or more servers from the installation. server is the management name of a provisionable server.

• feature feature – Add management features to the provisionable servers as part of the installation. The agentssh attribute must be specified with the feature attribute. The server's agentip is set automatically to the ip attribute value during the load process. Valid values are:

  • basemanagement – Add the base management feature, which is required for OS update deployment and remote commands.

  • osmonitor – Add the OS monitoring feature, which also includes the base management feature. The OS monitoring feature is required to monitor a server's OS resource health state. See the show server command for more details.

• firmware – The name of a firmware update. By default, the firmware update's model and vendor settings must match every provisionable server selected for installation. If the settings do not match, the update fails.

• force – Force the firmware update installation without server validation.

• group – The name of a server group.

• ip – The IP address assigned to the server's provisioning network interface after the server is installed. This IP address is automatically used as the bootip (Provisioning IP) when installing the Solaris operating system. This attribute is required only if networktype is set to static. You can specify a range of IP addresses or a subnet mask. Specify a range of IP addresses as follows: ip-address-ip-address (Example: 10.0.0.1–10.0.0.3).

• networktype – Specify how to assign an IP address to the server's provisioning network interface after the server is installed. Valid values are static or dhcp. If networktype is set to static, the ip attribute must be specified.

• osprofile – The name of an OS profile used to install the OS.

• update – The name of an OS update. If you specify more than one OS update, they must be the same OS type and ordered properly for any dependency issues. The OS updates will be installed in the order listed.

Install Attributes

The following attributes are temporarily used to boot and install the servers. The N1 System Manager provides default values for all of these attributes. These attributes are only required for a Red Hat Linux or SUSE Linux installation.

• bootgateway bootgateway – A gateway used to install the servers.

• bootnameserver bootnameserver – A name server used to install the servers.

• bootnetmask bootnetmask – A netmask used to install the servers.

Server Configuration Attributes

The following attributes are used to configure the server's network information during the installation. The N1 System Manager provides default values for all of these attributes.

• domainname domainname – (Solaris only) A domain assigned to the installed servers. If you do not specify this attribute, the management server domain will be used or sun.com.

• gateway gateway – A gateway assigned to the installed servers.

• kernelparameter kernelparameter – (Linux only) A parameter passed to the kernel during the install process.

• nameserver nameserver – A name server assigned to the installed servers.

• netmask netmask – A netmask assigned to the installed servers.