Share via

Update-StorageGroupCopy (RTM)

  • Article

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

 

Applies to: Exchange Server 2007

Use the Update-StorageGroupCopy cmdlet to initiate or resynchronize replication for a specified Microsoft Exchange Server 2007 cluster continuous replication (CCR) or local continuous replication (LCR) database copy.

Syntax

Update-StorageGroupCopy -Identity <StorageGroupIdParameter> [-DeleteExistingFiles <SwitchParameter>] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-ManualResume <SwitchParameter>] [-TargetPath <LocalLongFullPath>]

Detailed Description

The Update-StorageGroupCopy cmdlet allows you to manually initiate or resynchronize replication for a CCR or LCR copy. The cmdlet automatically resumes replication to the storage group copy. If you choose to manually resume replication, you can run the cmdlet with the ManualResume parameter.

This operation should be performed in the following situations:

  • You have created a storage group copy in LCR that does not have a baseline database.

  • You have a corrupted database in the CCR or LCR copy.

  • You enabled an LCR copy remotely that previously was backed up and therefore does not have all the logs.

  • You have a CCR or LCR environment and need to get a new baseline database to the passive copy. This situation could be due to corruption, some configuration change, server loss, or invalid baseline database available on the passive copy.

  • You have run an offline defragmentation on the production database.

Note

If the target path is not specified, the command must be issued on the computer containing the copy.

Note

The command does not allow any backups (Volume Shadow Copy Service or legacy streaming backups) to be running on the same storage group.

Important

If communication is lost with the active copy, or it fails, the operation must be completely restarted.

Important

You must verify that there is sufficient space prior to initializing the cmdlet because there is no automatic check. Using the DeleteExistingFiles parameter requires space for two copies of the database on the target volume because the existing database is not deleted until a new database is successfully created.

Warning

The Update-StorageGroupCopy cmdlet may affect available network bandwidth and may have some effect on the production server's performance.

The Update-StorageGroupCopy cmdlet requires that no Exchange files exist in the target location when it is run, and that the storage group copy has replication activity suspended. Use the Suspend-StorageGroupCopy cmdlet to suspend the storage group copy. After the seed is successfully completed, replication to the storage group copy is automatically restarted unless the ManualResume parameter is specified.

To use the Update-StorageGroupCopy cmdlet on a computer that has a clustered mailbox server installed, the account you use must be delegated the Exchange Server Administrator role and local Administrators group for the target server. For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.StorageGroupIdParameter

The Identity parameter takes one of the following values:

  • GUID

  • Name of the storage group

Confirm

Optional

Boolean

The Confirm parameter causes the command to pause processing and requires the administrator to acknowledge what the command will do before processing continues. The default value is $true.

DeleteExistingFiles

Optional

System.Management.Automation.SwitchParameter

The DeleteExistingFiles parameter causes the command to remove the logs, checkpoint, and database files at the target location. It removes only the files that it checks for and fails if other files are present. No action is taken on other files at the target location. Therefore, if other files are present, you must manually remove them.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter can be used in the cmdlet to specify the fully qualified domain name (FQDN) of the domain controller that is used to access the storage group object.

Force

Optional

System.Management.Automation.SwitchParameter

The Force parameter can be used when the task is run programmatically and prompting for administrative input is inappropriate. If Force is not provided in the cmdlet, administrative input is prompted. If Force is provided in the cmdlet, but the value is omitted, its default value is $true.

ManualResume

Optional

System.Management.Automation.SwitchParameter

Use the ManualResume parameter when you do not want the Update-StorageGroupCopy cmdlet to automatically resume replication on the storage group copy. This parameter allows you to manually resume replication to the storage group copy.

TargetPath

Optional

Microsoft.Exchange.Data.LocalLongFullPath

The TargetPath parameter specifies the location for the database file. This is the directory that will contain the database. The last part of the path is determined by the source's base name.

WhatIf

Optional

Boolean

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, the administrator can view what changes would occur without having to apply any of those changes. The default value is $true.

Errors

Error Description

Update-StorageGroupCopy: Online database seeding error: MSExchangeIS (Information Store) is not online on '<CMSNameorServerName>'.

The task was unable to connect to the server due a communication issue.

Update-StorageGroupCopy: Online database seeding error: '<SGName>' is not suspended. The storage group must be suspended before seeding.

The storage group must be suspended before it can be seeded.

Update-StorageGroupCopy: This task must be run on the second copy's machine if the 'TargetPath' parameter is omitted.

This task must be run on the passive copy if the TargetPath parameter is omitted.

Update-StorageGroupCopy is unable to update the storage group copy because this task is only supported on servers running Exchange Server 2007. <ServerName> is not running Exchange Server 2007.

LCR and CCR are only supported in Exchange 2007.

Access denied. The account used to run this task does not have sufficient privileges to update storage group copy from <ServerName>. Please use an account that has been assigned the Exchange Server Admin role.

User does not have Exchange Server Administrator authority on the specified server.

<ServerName> or <StorageGroupName> does not exist.

The specified identity does not exist.

Update-StorageGroupCopy: Continuous replication is not configured on '<SGName>'.

CCR (when no second node):

Update-StorageGroupCopy: Continuous replication is not configured on '<SGName>'.

The storage group specified is not configured to support replication.

Database:

Update-StorageGroupCopy: Online database seeding error: Target database ('<thePath>') already exists. It must be removed.

Logs:

Update-StorageGroupCopy : Online database seeding error: Log files already exist at '<thePath>'. They must be removed.

Log files and a database were not deleted prior to running an update without a target path. Delete the log, database, checkpoint, and .jtx files in the target location or specify the -DeleteExistingFiles option.

Update-StorageGroupCopy: Online database seeding error: The database is not mounted.

Production database is not mounted. Mount the database, and reissue the task.

Specified path is not available.

The specified path is not available or writable.

Update-StorageGroupCopy: Online database seeding error: The database is currently being backed up.

Storage group <StorageGroupName> failed to seed at <DatabaseLocation>. Reason: Error Code (0x50d).

The source database already has a backup in progress.

Update-StorageGroupCopy: Online database seeding error: Communication failure; Exchange Information Store (MSExchangeIS) on '<ServerName>' is unavailable.

Lost communication with the source. The update was terminated.

Update-StorageGroupCopy: Online database seeding error: <ErrorCode>.

Seeding failed due to one of the following conditions:

  • Unspecified error

  • Invalid input or parameter

  • Out of RAM

  • Out of disk space

  • Failed to acquire process right

  • Seeding directory does not exist

  • Log files already exist

  • *.jtx files already exist

  • Storage group does not exist

Update-StorageGroupCopy: Failed to create the directory '<DirectoryPath>'. The error code is '<error code>'.

The action failed to create a directory required to host the database.

Example

The following example shows how to reseed the storage group named SG1 on Server1.

Update-StorageGroupCopy -Identity:Server1\SG1