Description

This article describes the steps to change the configured container of an existing Microsoft Azure Blob Storage partition.

Steps

Changing the configured Microsoft Azure blob Container of an existing Microsoft Azure Blob Storage partition consists of the following steps:

Step 1:

Ensure that you have created the Microsoft Azure blob source container and destination container as per your business requirements. You must confirm that the new Microsoft Azure blob container is created with the existing settings and policy as the existing Microsoft Azure blob container attached to the Microsoft Azure Blob Storage partition. 

Step 2:

Configure replication on the Microsoft Azure Storage account with Microsoft Azure credentials. Ensure that all the files are replicated to the destination container before using the destination container on the Microsoft Azure Blob Storage partition.

Step 3:

Confirm that all the archived items have been backed up.

1. Open the SQL Server Management Studio. 
2. Run the following query: 
   USE [Vault Store Database Name] 
   SELECT COUNT(*) 
   FROM WatchFile 
3. If the count is 0, perform step 4. If the count is greater than 0, there are items left waiting either backup or indexing.

Step 4:

Set the vault store backup mode and then stop services on the Enterprise Vault server.

1. To set the backup mode: 
   1. Open the Administration Console. 
   2. In the left pane of the Administration Console, expand the Vault Store Group container. 
   3. Right-click the vault store group whose vault stores need to be placed in the backup mode, and click Set State > Set Backup Mode on all Vault Store. 
   4. For details, see Enterprise Vault backup mode. 
2. Stop all Enterprise Vault services. 

Step 5:

Confirm that all the archived files from the existing Microsoft Azure blob container are moved to the newly created Microsoft Azure blob container. Refer to the Microsoft Azure documentation for detailed instructions.

Step 6:

Update partition with the new container in the SQL Server.

1. Open SQL Server Management Studio. 
2. Expand Databases. 
3. Select EnterpriseVaultDirectory. 
4. Create a new SQL query. 
5. Copy-paste the following SQL query: 

   USE EnterpriseVaultDirectory 

   DECLARE @PartitionName    AS VARCHAR(200) 

   DECLARE @Container    AS VARCHAR(200) 

   DECLARE @StorageAccountName AS VARCHAR(200) 

    

   SET @PartitionName = 'VS Ptn10' 

   SET @Container = 'container name you want to setup' 

   SET @StorageAccountName = 'storage account name you want to setup'  

    

   SELECT settingValueText AS 'Previous Container' FROM ExtendedSetting 

   WHERE RootId = (SELECT PartitionEntryId FROM PartitionEntry WHERE PartitionName = @PartitionName) 

   AND settingTypeId = 2830 

    

   UPDATE ExtendedSetting SET settingValueText = @Container 

   WHERE RootId = (SELECT PartitionEntryId FROM PartitionEntry WHERE PartitionName = @PartitionName) 

   AND settingTypeId = 2830 

    

   SELECT settingValueText AS 'New Container' FROM ExtendedSetting 

   WHERE RootId = (SELECT PartitionEntryId FROM PartitionEntry WHERE PartitionName = @PartitionName) 

   AND settingTypeId = 2830 

    

   SELECT settingValueText AS 'Previous StorageAccount' FROM ExtendedSetting 

   WHERE RootId = (SELECT PartitionEntryId FROM PartitionEntry WHERE PartitionName = @PartitionName) 

   AND settingTypeId = 2820 

    

   UPDATE ExtendedSetting SET settingValueText = @StorageAccountName 

   WHERE RootId = (SELECT PartitionEntryId FROM PartitionEntry WHERE PartitionName = @PartitionName) 

   AND settingTypeId = 2820 

    

   SELECT settingValueText AS 'New StorageAccount' FROM ExtendedSetting 

   WHERE RootId = (SELECT PartitionEntryId FROM PartitionEntry WHERE PartitionName = @PartitionName) 

   AND settingTypeId = 2820

6. Replace @PartitionName and @Container variables in the above script. 
7. Execute the above SQL script. 
8. Verify that the container is changed for that partition. 
9. On replication tab change the option ‘replicate to cloud storage’ to ‘exit on cloud storage’ 
10. From Azure portal from object replication remove the rule added for the container 
11. Provide the newly set Azure storage account Access key in partition and click on Test. 
12. Repeat these steps for each partition that is being updated. 

Step 7:

Start Enterprise Vault services, confirm that the archived items can be opened, and clear the backup mode on the Enterprise Vault Server.

1. Start all Enterprise Vault services. 
2. Confirm that the archived items can be opened. 
3. Clear the backup mode. 
4. In the left pane of the Administration Console, expand the Vault Store Group container. 
5. Right-click the vault store group whose vault stores need to have the backup mode cleared, and then click Set State > Clear Backup Mode on all Vault Stores.  

For more information about Enterprise Vault backup mode, see How to verify backup mode for Enterprise Vault (EV) event log using Event ID messages.

Important Notes: 

• Make sure you add the removed replication rule under Object replication on the Azure portal while pointing the partition to previous container. 
• Change the replication from “replicated on the cloud storage” to “exist on the cloud storage”, as Microsoft does not support reverse replication. Else, users will get the error related with Storage File Watch and Storage Management under Window event viewer. 
• It will stop updating the information related to secured and unsecured items on Replication tab Details pop-up. 
• Your newly archived items to the destination container will not get replicated to the source container. 
• On the destination container, Azure admin can only configure the storage classes supported by Enterprise Vault.