cdr define region
The cdr define region command creates a region that contains a subset of the servers in a grid.
Syntax
- 1 See Connect Option.
| 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