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'