load server

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

Description

N1 Grid Engine (N1GE) is the only application that can be provisioned with this release of N1 System Manager.

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]] [unix-installation-attributes] [unix-configuration-attributes]

• Install a Red Hat Linux or SUSE Linux OS 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]] [unix-installation-attributes] [unix-configuration-attributes]

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

  load server server[,server...] osprofile osprofile networktype networktype [ip ip] [windows-installation-attributes]

• Configure one or more servers as diskless clients:

  load server server[,server...] osprofile osprofile bootip bootip [diskless-client-installation-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]

• Install the N1GE application on one or more servers:

  load server server[,server...] applicationprofile applicationprofile type n1ge hosttype [hosttype]

Parameters

• agentssh – Specify the SSH credentials used for the management features on the server, including OS monitoring. The SSH user must have root access on the server. The agentssh format is a user name/password pair for SSH credentials: ssh-username/ssh-password. You can type a question mark (?) if you do not want the password to display in the command line. Once you issue the command, you are prompted for the user name/password.

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

• agentsnmpv3 – Specify the SNMP Version 3 credentials used for OS monitoring on the server. The agentsnmpv3 format is a user name/password pair: snmpv3-username/snmpv3-password. You can type a question mark (?) if you do not want the password to display in the command line. Once you issue the command, you are prompted for the user name/password.

• applicationprofile – The name of an application profile.

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

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

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

• hosttype – The type of N1 Grid Engine host to install. Valid values are:

  • compute – Compute host (also called execution host)

  • master – Master host

  • submit – Submit host (also called access host)

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

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

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

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

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

UNIX 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 – The server's provisioning network interface 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. Note that when installing the Red Hat 4 OS on Sun Fire X2100 servers, the bootnetworkdevice value must be set to eth1. The default value does not work for this situation.

• 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 – 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 – The baud rate for the server's system console. Default is 9600.

• installprotocol installprotocol – The protocol used to install the server. The HTTP protocol is typically faster. Valid values are http (default) and nfs.

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

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

• manualnetboot manualnetboot – Specify whether to enable manual netboot. Enabling manual netboot allows you to control the netboot process, which is required as part of the bootstrapping process to provision an OS on a server. A manual netboot is required for OS-based or manually discovered servers, since the N1 System Manager is not able to automatically netboot these systems. Valid values are true and false (default).

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

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

• networkdevice networkdevice – (Linux only) The server's provisioning network interface after the server is installed. Default is eth0. Note that when installing the Red Hat 4 OS on Sun Fire X2100 servers, the networkdevice value must be set to eth1. The default value does not work for this situation.

WINDOWS INSTALLATION ATTRIBUTES

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

• manualnetboot manualnetboot – Specify whether to enable manual netboot. Enabling manual netboot allows you to control the netboot process, which is required as part of the bootstrapping process to provision an OS on a server. A manual netboot is required for OS-based or manually discovered servers, since the N1 System Manager is not able to automatically netboot these systems. Valid values are true and false (default).

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

• productkey productkey – Use this product key value instead of the value specified in the OS profile.

DISKLESS CLIENT INSTALLATION ATTRIBUTES

• 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 – The server's provisioning network interface 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. Note that when installing the Red Hat 4 OS on Sun Fire X2100 servers, the bootnetworkdevice value must be set to eth1. The default value does not work for this situation.

• console console – 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 – The baud rate for the server's system console. Default is 9600.

• nfsroot nfsroot – The location of the NFS root, such as 10.0.0.115:/my_roots/sol_a. You can specify a comma-separated list of paths, or you can specify a range of paths as follows: 10.1.10.1:/diskless/home/1–40. When specifying a range of paths, the nfsroot directory names must be numbers. This attribute is not required for initrd-based diskless clients.