load server

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

Synopsis

• Install a Solaris OS profile on one or more servers:

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

• Install a Red Hat OS Linux or SUSE Linux profile on one or more servers:

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

• Install OS updates on one or more servers:

  load server server[,server...] update update[,update...]

• Install a firmware update on one or more servers:

  load server server[,server...] 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 server. 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 single IP address, or a range of IP addresses or subnet mask if you are installing more than one server. Specify a range of IP addresses as follows: ip-address-ip-address Example: 10.0.0.1–10.0.0.3

• feature feature – Add management features to the provisionable server 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; otherwise, the update fails.

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

• 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 single IP address, or a range of IP addresses or a subnet mask if you are installing more than one server. 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.

• server – The management name of a provisionable server.

• 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.

Installation Attributes

The following attributes are temporarily used to install one or more servers. Some attributes can be specified only when installing a single server. The N1 System Manager provides default values for all the attributes that are not single-server specific.

• bootgateway bootgateway – (Linux only) A gateway used to install the server.

• boothostname boothostname – (Single server and Linux only) A host name used to install the server.

• bootnameserver bootnameserver – (Linux only) A name server used to install the server.

• bootnetmask bootnetmask – (Linux only) A netmask used to install the server.

• bootnetworkdevice bootnetworkdevice – (Single server only) The server's provisioning network interface is used to install the server. Valid Solaris values are bge0 (default), bge1, bge2, and bge3. Valid Linux values are eth0 (default), eth1, eth2, eth3, and eth4.

• bootpath bootpath – (Single server, Solaris x86 only) The server's provisioning boot device used to install the server. This attribute supersedes the bootnetworkdevice value, if specified. Valid values are:

  • /pci@0,0/pci1022,7450@a/pci17c2,10@2 – Sun Fire V20z, bge0 (default)

  • /pci@0,0/pci1022,7450@a/pci17c2,10@3 – Sun Fire V20z, bge1

  • /pci@0,0/pci1022,7450@a/pci17c2,20@2 – Sun Fire V40z, bge0 (default)

  • /pci@0,0/pci1022,7450@a/pci17c2,20@3 – Sun Fire V40z, bge1

  • /pci@0,0/pci1022,7450@1/pci8086,1011@1 – Sun Fire X4000 series, bge0 (default)

  • /pci@0,0/pci1022,7450@1/pci8086,1011@1,1 – Sun Fire X4000 series, bge1

  • /pci@0,0/pci1022,7450@1/pci8086,1011@2 – Sun Fire X4000 series, bge2

  • /pci@0,0/pci1022,7450@1/pci8086,1011@2,1 – Sun Fire X4000 series, bge3

  • /pci@0,0/pci108e,5348@a – Sun Fire X2100, bge0 (default)

• console console – (Single server only) The device name for the server's system console, which may be used to monitor the installation. Default is ttys0 (Linux) and ttya (Solaris).

• consolebaud consolebaud – (Single server only) The baud rate for the server's system console. Default is 9600.

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

Server Configuration Attributes

The following attributes are used to configure the server's network information during the installation. Some attributes can be specified only when installing a single server. The N1 System Manager provides default values for all the attributes that are not single-server specific.

• domainname domainname – (Solaris only) A domain assigned to the installed server. 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 server.

• hostname hostname – (Single server only) A host name assigned to the installed server.

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

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

• networkdevice networkdevice – (Single server and Linux only) The server's provisioning network interface after the server is installed. Default is eth0.