cdr define region

The cdr define region command creates a region that contains a subset of the servers in a grid.

Syntax


1  cdr define region?  %Connect Option  (1)   --grid = grid_name  region_name +   server_group
Notes:
Element Purpose Restrictions Syntax
grid_name Name of the grid. Must be the name of a defined grid. Long Identifiers
region_name Name of the region. Must be unique among region names, grid names, and replicate set names. Long Identifiers
server_group Name of a database server group to add to the region. Must be the name of a defined grid server. Long Identifiers

The following table describes the cdr define region option.

Long Form Short Form Meaning
--grid -g Specifies the grid that contains the servers to include in the region.

Usage

Use the cdr define region command to define a region of a grid. You can use a region name in a grid query to limit the servers on which the query is run. Regions contain servers from a single grid. You can define multiple regions for the same grid. Regions can overlap or be contained by another region. You can create an unlimited number of regions in a grid.

You cannot change a region. If you want to add or remove a grid server from a region, delete and re-create the region. Delete the region by running the cdr delete region command. Re-create the region with a different set of grid servers by running the cdr define region command.

Return codes

A return code of 0 indicates that the command was successful.

If the command is not successful, one of the following error codes is returned: 5, 227.

For information about these error codes, see Return Codes for the cdr Utility.

Examples

The following command creates a region that contains two servers and is named northwest. The region is created in the grid named mygrid1.

cdr define region --grid=mygrid1 northwest server_or server_wa