A.43 create ServerPool

Creates a server pool.

Syntax

create ServerPool virtualIP=value 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 | CURRENT_SERVER } ] [ policyMode= { OFF | DRS | DPM } ] [ policyCpuEnable= { Yes | No } ] [ policyPeriod=value ] [ policyCpuThreshold=value ] name=value [ description=value ]

Description

This command creates a server pool.

Options

The following table shows the available options for this command.

Option	Description
`virtualIP=value`	The virtual IP address for the server pool.
`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.
`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` \| `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 `0` and `99`.
`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.

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.58 Creating a clustered server pool

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

Example A.59 Creating an unclustered server pool

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