A.45 create ServerPool

Creates a server pool.

Syntax

create ServerPool clusterEnable= { Yes | No } [ clusterTimeout= value ] [ fileSystem=value ] [ physicalDisk=value ] [ keymapName= { en-us | ar | da | de | de-ch | en-gb | es | et | fi | fo | fr | fr-be | fr-ca | fr-ch | hr | hu | is | it | ja | lt | lv | mk | nl | nl-be | No | pl | pt | pt-br | ru | sl | sv | th | tr } ] [ migrateUsingSsl= { Yes | No } ] [ startPolicy= { BEST_SERVER | BALANCE_SERVER | CURRENT_SERVER } ] [ policyMode= { OFF | DRS | DPM } ] [ policyCpuEnable= { Yes | No } ] [ policyPeriod=value ] [ policyCpuThreshold=value ] name=value [ description=value ] [ virtualIP=value ]

Description

This command creates a server pool.

Options

The following table shows the available options for this command.

Option

Description

clusterEnable= { Yes | No }

Whether to enable a clustered server pool. If this parameter is not included, the default is No, so the server pool is not clustered. If this parameter is set to Yes, you must also include either the fileSystem or physicalDisk option to provide a location for the server pool file system.

clusterTimeout= value

Set the timeout value for the cluster in seconds. value is an integer between 30 and 300.

SPARC-based server pools do not recognise the cluster timeout parameter. Setting this value for a server pool consisting of SPARC servers has no effect and the parameter is ignored by the Oracle VM Agent for SPARC.

fileSystem=value

The file system to use for the server pool file system. Note that if you specify the name as the value for the file system, and the name is specified in quotes, any forward slashes in the name must be escaped using additional forward slashes. This is illustrated in the examples for this command.

physicalDisk=value

The physical disk to use for the server pool file system.

Note

You cannot create a server pool file system on a local physical disk as the server pool file system needs to be accessible by all Oracle VM Servers in the server pool.

keymapName= { en-us | ar | da | de | de-ch | en-gb | es | et | fi | fo | fr | fr-be | fr-ca | fr-ch | hr | hu | is | it | ja | lt | lv | mk | nl | nl-be | No | pl | pt | pt-br | ru | sl | sv | th | tr }

The key mapping to be used when connecting to a virtual machine's console.

migrateUsingSsl= { Yes | No }

Whether to enable secure migration of virtual machines using SSL.

startPolicy= { BEST_SERVER | BALANCE_SERVER | CURRENT_SERVER }

The policy by which virtual machines are located when created in the server pool. If none is provided, the CURRENT_SERVER option is used by default.

policyMode= { OFF | DRS | DPM }

Set the policy to use for the server pool.

policyCpuEnable= { Yes | No }

Set whether to enable the policy set in the policyMode option for the server pool.

policyPeriod=value

The time period for the policy job to run. This sets the policy job to run every n minutes, for example, 10 sets the policy job to run every 10 minutes. value can be an integer between 2 and 60.

policyCpuThreshold=value

The maximum amount of CPU percentage usage allowed before the policy must be enacted. value can be an integer between 25 and 99.

[ virtualIP=value ]

An optional virtual IP address for the server pool. This is a deprecated parameter. Only specify a virtual IP address for a server pool if you intend to add Oracle VM Servers running a version of the software from prior to a 3.4 release.

name=value

A name to identify the server pool.

description=value

Optional description for the server pool. value is a maximum of 4,000 characters.

To set an empty description, use description="".

Note

Any create command only creates a single instance of an object, and therefore only accepts a single object instance as an attribute. Providing more than one object of the same attribute type as a parameter always results in the last attribute value taking precedence.

Examples

Example A.60 Creating a clustered server pool

OVM> create ServerPool clusterEnable=Yes \
  filesystem="nfs on 10.172.76.125://mnt//vol1//poolfs01" name=MyServerPool \
  description='Clustered server pool'

Example A.61 Creating an unclustered server pool

OVM> create ServerPool clusterEnable=No name=MyServerPool \
  description='Unclustered server pool'

See Also