NAME | SYNOPSIS | DESCRIPTION | SUBCOMMANDS | OPTIONS | EXTENDED DESCRIPTION | EXIT STATUS | ATTRIBUTES | SEE ALSO
Adding a data-replication disk device group.
geopg add-device-group protection-group-name device-group-name [--property property-setting] [--property...]Adding a resource group to a protection group.
geopg add-resource-group protection-group-name resource-groupCreating a protection group.
geopg create protection-group-name --partnership partnership-name --role local-role [--datarep-type data-replication-type ] [--property property-setting] [--property...]Deleting a protection group.
geopg delete protection-group-nameCreating a local configuration for a protection group that has already been created on the partner cluster.
geopg get [protection-group-name] --partnershippartnership-namePrinting the protection group configuration.
geopg list [protection-group-name] [...]Changing the configuration of a data-replication disk device group.
geopg modify-device-group protection-group-name --device-group device-group-name --property property-setting [--property...]Removing a a data-replication disk device group.
geopg remove-device-group --device-group device-group-nameRemoving resource groups from a protection group.
geopg remove-resource-group --rg-name resource-groupChanging the configuration of a protection group.
geopg set-prop protection- group-name --property property-setting [--property...]Activating a protection group.
geopg start protection-group-name --scope <local | global> [--nodatarep]Deactivating a protection group.
geopg stop protection-group-name --scope[[local]| [global]] [--only-datarep]Switching over the role of a protection group.
geopg switchover --primary new-primary-cluster-name {protection-group-name} [--force]Forcing a cluster to assume the primary role.
geopg takeover [--force] protection-group-nameResynchronizing a protection group.
geopg update protection-group-nameValidating a protection group.
geopg validate protection-group-namePrinting version information.
geopg --versionPrinting help information.
geopg --helpThe geopg command enables you to configure and maintain protection groups. You can perform the following tasks:
Configuring a protection group between clusters that participate in a partnership. This task includes the configuration of associated data replication parameters.
Adding or removing resource groups and data-replication disk device groups.
Adding, modifying, and removing data replication parameters that are associated with a protection group setting.
Retrieving the current configuration of a specific protection group or all defined protection groups.
Activating a protection group.
Deactivating a protection group.
Switching over the role of a protection group.
Taking over the primary role of a protection group.
Before you can create a protection group, the clusters that will be hosting the protection group must already be in a partnership.
To use the geopg command to create, modify, or delete a protection group, or a data-replication disk device group, you must be assigned the proper role-based access control (RBAC) rights profile.
If you have root access, you have permissions to perform any operation. If you do not have root access, the following RBAC rights apply:
Basic Solaris User. You can read information about Sun Cluster Geographic Edition entities by using commands such as geoadm list, geohb list, and geops list.
Geo Management. You can perform all the read operations that someone with Basic Solaris User access can perform. You can also perform administrative and configuration tasks such as geohb add, geopg switchover, geoadm start, and geoadm stop.
For more information, see the rbac(5) man page and “Sun Cluster Geographic Edition Software and RBAC” in Sun Cluster Geographic Edition System Administration Guide.
Subcommands specify the actions that are performed by the command. Only one subcommand is allowed on the command line.
The following subcommands are supported:
Enables a data-replication disk device group to be part of a protection group.
Enables an application resource group to be part of a protection group.
If the resource group you are adding is online, then the protection group must also be online before you add the resource group. The geopg add command fails when a protection group is offline and the resource group that is being added is online.
If a protection group has already been started at the time that you add a resource group that is offline, the resource group remains offline. To start the offline resource group, use the command geopg start.
Creates a protection group or creates a data-replication disk device group.
When you create a protection group, the management module updates the local configuration and notifies remote clusters of configuration changes.
Deletes a protection group.
Creates the local configuration for a protection group that has already been created on a partner cluster.
The configuration of an existing protection group gets propagated to the partner cluster that hosts the protection group if the partner clusters are connected. If you create a protection group while partner clusters are disconnected or before the partner has joined the partnership, you must use the geopg get command to propagate the configuration.
Displays the following information about the protection group:
Defined protection groups
Resource groups that are wrapped into protection groups
Operation status information
Modifies the properties of a data-replication disk device group.
Removes data-replication disk device groups from a protection group.
Removing a data-replication device group does not stop data replication or change the data-replication status for that data-replication device group.
Removes resource groups from a protection group.
Removing an application resource group does not change the application resource group to the Offline state.
Modifies the properties of a protection group.
Activates a protection group. After the subcommand is activated, the role of the protection group on a cluster is the role you assigned to the cluster when you configured the protection group.
You can activate a protection group on the following levels:
On all clusters where the protection group has been configured.
Only on the primary cluster of the protection group. The secondary cluster remains inactive.
Only on the secondary cluster of the protection group, after the primary cluster has been activated.
Activation of a protection group enables the following events to occur:
The protection group configuration can be validated.
Clusters can determine whether an operation has been completed.
Data replication can be started.
Protected applications can be started.
If the partner can be reached, the partner cluster can be notified of the protection group activation.
Deactivates a protection group. You can deactivate a protection group on the following levels:
On all clusters where the protection group has been configured.
On the primary cluster of the protection group only. The secondary cluster remains active.
On the secondary cluster of the protection group only, after the primary cluster has been deactivated.
Switches the assigned role of a cluster in the protection group.
Forces a cluster to become the PRIMARY cluster without considering the partner cluster state.
After successful completion of the geopg takeover command, reactivating the protection group on the secondary cluster might require data recovery and actions to synchronize data.
When possible, use the geopg switchover command instead of the geopg takeover command to coordinate between partner clusters to avoid loss of replicated data.
Use the geopg takeover command only in situations that require a new primary urgently. The situation must justify a loss of data and repairing and the time required to reactivate the protection group on the secondary cluster.
Resynchronizes the configuration information of the local protection group with the partner's configuration information.
Validates a protection group on the local cluster by performing a sanity check of the dynamic values.
The following options are supported:
Specifies that only the data replication should be deactivated, leaving the protection group active. If you do not use this option, the entire protection group is deactivated. To stop a protection group that has already had its data replication subsystem stopped, you must run the geopg stop command again and omit this option.
Specifies the data replication mechanism for data replication between the clusters of the protection group.
The data-rep-type must be one of the following strings:
Specifies that the data replication mechanism is Hitachi TrueCopy. This product works with Command and Control Interface RAID-Manager/Solaris Version 01-10-03/02, which requires Sun StorEdgeTM 9970/9980 Array or Hitachi Lightning 9900 Series storage hardware.
Specifies that the data replication mechanism is Sun Availability Suite Remote Mirror Release 3.2, with patches.
Specifies whether the command operates only on the local cluster (local) or on both clusters where the protection group has been configured (global).
Forces the command to perform the operation without asking the user for confirmation.
Specifies the name of the disk device group that is to be created.
Specifies the name of the cluster that is to be the primary cluster for the protection group.
Specifies that data replicaiton should not be used for this protection group. If this option is omitted, data replication starts at the same time as the protection group.
Specifies the role of the local cluster as either PRIMARY or SECONDARY when used with the create subcommand. You can change the role of a cluster by using the geopg switchover command.
Sets the properties of a protection group.
A protection group property is assigned a value by using a name=statement pair statement. You can set multiple properties one time by using multiple statements.
See the EXTENDED DESCRIPTION section for defined properties.
Specifies the name of the protection group. The create subcommand fails if the protection group that is specified with this option already exists. The modify subcommand fails if the specified protection group is not valid.
Specifies a comma-separated list of resource groups to add to the protection group when used with the add subcommand. The specified resource groups must already be defined.
The protection group must be online before you add a resource group. The geopg add command fails when a protection group is offline and the resource group that is being added is online.
If a protection group has already been started at the time that you add a resource group, the resource group remains offline. You must start the resource group manually by using the geopg start command.
Specifies the name of the partnership that includes the cluster on which this protection group can be activated.
Displays version information. This option stops interpretation of subsequent arguments.
Displays help information. This option stops interpretation of subsequent arguments.
The question mark might be interpreted as a special character by some shells. Use quotes (-"?") or an escape character to avoid pattern-matching.
The following tables list the properties. The values of these properties are assigned at creation. The property values, such as true and false, are not case sensitive. Specific information about when you can tune the properties is provided in the property description.
Describes the protection group when used in creating a protection group.
Optional property.
Type: string.
Default value: none.
Tuning recommendations: Assigned at creation and tunable at runtime.
Specifies the absolute path to the executable command to run when the primary cluster of the protection group changes. This path should be valid on all partner clusters that host the protection group.
Optional property.
Type: string.
Default value: none.
Tuning recommendations: Assigned at creation and tunable at runtime.
Specifies a string that follows system-defined arguments at the end of the command line when the role-change callback command runs.
Optional property.
Type: string.
Default value: none.
Tuning recommendations: Assigned at creation and tunable at runtime.
Specifies the timeout period for the protection group in seconds.
Used in creating a protection group only.
Optional property.
Type: Integer. A minimum value of at least 20 is required.
Default value: 200 seconds.
Tuning recommendations: Assigned at creation and tunable at runtime.
Lists the hostnames of the machines that can be primary for the replication mechanism. This list is comma delimited.
Optional property.
Type: string array.
Tuning recommendations: You can tune this property only when the protection group is offline.
Default value: empty.
Defines whether the volume sets that are defined in the file are enabled. Set to either True or False (case insensitive).
Optional property.
Type: Boolean.
Tuning recommendations: You cannot tune this property after it has been successfully validated during creation, replication, or synchronization.
Default value: False.
Defines the local logical hostname that is used for the replication of the disk device group. Do not use an underscore (_) character in the logical hostname.
Required property.
Type: string.
Tuning recommendations: You cannot tune this property after it has been successfully validated during creation, replication, or synchronization.
Default value: none.
Defines the remote logical hostname that is used for the replication of the disk device group.
Required property.
Type: string.
Tuning recommendations: You cannot tune this property after it has been successfully validated during creation, replication, or synchronization.
Default value: none.
Lists the disk device groups where the data is written. The list is comma delimited.
Optional property.
Type: string array.
Tuning recommendations: You can tune this property only when the protection group is offline.
Default value: empty.
Lists the hostnames of the machines that can be primary for the replication mechanism. This list is comma delimited.
Optional property.
Type: string array.
Tuning recommendations: You can tune this property at any time.
Default value: empty.
Defines the fence level that is used by the disk device group. The fence level determines the level of consistency among the primary and secondary volumes for that disk device group. Possible values are data, status, never, and async.
You can set this property to any valid Fence_level when the current pair state is SMPL.
Required property.
Type: enum.
Tuning recommendations: You can tune this property only when the protection group is offline. For a Hitachi TrueCopy device group, if the pair has already been created, this property can be set only to the current Fence_level of the pair. If you want to change the Fence_level of an already existing pair, modify it by using the Hitachi TrueCopy CCI commands first, then tune the property to the new Fence_level.
Default value: none.
The following exit values are returned:
The command executed successfully.
An error has occurred.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE |
ATTRIBUTE VALUE |
---|---|
Architecture |
SPARC |
Availability |
SUNWscgctl |
Interface Stability |
Evolving |
NAME | SYNOPSIS | DESCRIPTION | SUBCOMMANDS | OPTIONS | EXTENDED DESCRIPTION | EXIT STATUS | ATTRIBUTES | SEE ALSO