EMC SourceOne for Microsoft SharePoint Storage Management ... · EMC SourceOne for Microsoft...
35
EMC ® SourceOne ™ for Microsoft SharePoint Storage Management Version 7.2 Administration Guide 302-000-970 REV 01
Transcript of EMC SourceOne for Microsoft SharePoint Storage Management ... · EMC SourceOne for Microsoft...
EMC® SourceOne™ for MicrosoftSharePoint Storage ManagementVersion 7.2
Administration Guide302-000-970
REV 01
Copyright © 2005-2015 . All rights reserved. Published in USA.
Published April 30, 2015
EMC believes the information in this publication is accurate as of its publication date. The information is subject to changewithout notice.
The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind withrespect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for aparticular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicablesoftware license.
EMC², EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and othercountries. All other trademarks used herein are the property of their respective owners.
For the most up-to-date regulatory document for your product line, go to EMC Online Support (https://support.emc.com).
EMC CorporationHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.EMC.com
2 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
5
Overview 9
Installation....................................................................................................10Deployment details....................................................................................... 10Feature details.............................................................................................. 10
Configuring Microsoft SharePoint RBS 11
Overview....................................................................................................... 12SourceOne RBS components.........................................................................12Configuration prerequisites........................................................................... 12
EMC SourceOne for Microsoft SharePoint Storage Managementinstallation...................................................................................... 13Account settings to access the Maintenance Service........................ 13
Configuration overview..................................................................................13Configuring Content Database Settings......................................................... 13
Configuration considerations........................................................... 13Storage root path considerations..................................................... 14Setting the root path to the provider store........................................ 14Specifying the Content Database details.......................................... 15Setting up a new store......................................................................16
Configuring the RBS Health Monitor.............................................................. 19Viewing Store status........................................................................ 20
Configuring the RBS Migration Service...........................................................21Adding a migration job.....................................................................22Viewing the migration status............................................................23
Configuring the RBS Maintenance Service..................................................... 24Viewing Maintenance summary........................................................24Configuring Maintenance activities for a content database...............24
Troubleshooting 29
Logging and performance..............................................................................30RBS log levels.................................................................................. 30Configuring SharePoint Trace Logs for RBS....................................... 30Performance counters...................................................................... 31
General troubleshooting................................................................................31Solution retraction status continues to display “Retracting”.............32Activating a feature fails after deploying a solution.......................... 32RBS Configuration links are not displayed........................................ 32Unexpected error on the Microsoft SharePoint 2010 server.............. 32Error message appears after activating SourceOne RBS Provider...... 33BLOBs are saved to Content Database instead of in a SourceOne RBSstore................................................................................................ 34
Preface
Chapter 1
Chapter 2
Chapter 3
CONTENTS
EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide 3
CONTENTS
4 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
Preface
As part of an effort to improve its product lines, EMC periodically releases revisions of itssoftware and hardware. Therefore, some functions described in this document might notbe supported by all versions of the software or hardware currently in use. The productrelease notes provide the most up-to-date information on product features.
Contact your EMC technical support professional if a product does not function properlyor does not function as described in this document.
Note
This document was accurate at publication time. Go to EMC Online Support (https://support.emc.com) to ensure that you are using the latest version of this document.
PurposeThis document describes how to administer and process Microsoft SharePoint content byusing the EMC® SourceOne™ software.
AudienceThis document is part of the EMC SourceOne for Microsoft SharePoint StorageManagement documentation set, and is intended for use by system administrators whoare processing Microsoft SharePoint content.
Revision historyThe following table presents the revision history of this document.
Table 1 Revision history
Revision Date Description
01 April 30, 2015 First release of the EMC SourceOne for MicrosoftSharePoint Storage Management 7.2 AdministrationGuide
Related documentationThe SourceOne documentation set includes the following publications:
EMC SourceOne Product Guides
l EMC SourceOne Products Compatibility Guide
l EMC SourceOne Security Configuration Guide
EMC SourceOne Email Management
l EMC SourceOne Email Management Installation Guide
l EMC SourceOne Email Management Administration Guide
l EMC SourceOne Email Management Release Notes
l EMC SourceOne Email Management Localized Product Release Notes
l EMC SourceOne Auditing and Reporting Installation and Administration Guide
l EMC SourceOne Management Pack for Microsoft System Center Operations Manager
l EMC SourceOne Search User Guide
EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide 5
l EMC SourceOne Disaster Recovery Solution Guide
EMC SourceOne Discovery Manager
l EMC SourceOne Discovery Manager Installation and Administration Guide
l EMC SourceOne Discovery Manager Desktop User Guide
l EMC SourceOne Discovery Manager Web Application User Guide
l EMC SourceOne Discovery Manager Release Notes
l EMC SourceOne Discovery Manager Localized Product Release Notes
l EMC SourceOne Discovery Manager Quick Reference Cards
EMC SourceOne for File Systems
l EMC SourceOne for File Systems Installation Guide
l EMC SourceOne for File Systems Administration Guide
l EMC SourceOne for File Systems Release Notes
EMC SourceOne Offline Access
l EMC SourceOne Offline Access Installation and Administration Guide
l EMC SourceOne Offline Access User Guide
l EMC SourceOne Offline Access Release Notes
EMC SourceOne for Microsoft SharePoint
l EMC SourceOne for Microsoft SharePoint Installation Guide
l EMC SourceOne for Microsoft SharePoint Administration Guide
l EMC SourceOne for Microsoft SharePoint Release Notes
l EMC SourceOne for Microsoft SharePoint Quick Reference Card
EMC SourceOne for Microsoft SharePoint Storage Management
l EMC SourceOne for Microsoft SharePoint Storage Management Installation Guide
l EMC SourceOne for Microsoft SharePoint Storage Management Administration Guide
l EMC SourceOne for Microsoft SharePoint Storage Management Release Notes
Special notice conventions used in this documentEMC uses the following conventions for special notices:
NOTICE
Addresses practices not related to personal injury.
Note
Presents information that is important, but not hazard-related.
Typographical conventionsEMC uses the following type style conventions in this document:
Bold Used for names of interface elements, such as names of buttons, fields,tab names, and menu paths (what the user specifically selects orclicks)
Italic Used for full titles of publications referenced in text
Monospace Used for:
Preface
6 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
l System code
l System output, such as an error message or script
l Pathnames, file names, prompts, and syntax
l Commands and options
Monospace italic Used for variables
Monospace bold Used for user input
[ ] Square brackets enclose optional values
| Vertical bar indicates alternate selections - the bar means “or”
{ } Braces enclose content that the user must specify, such as x or y or z
... Ellipses indicate non-essential information omitted from the example
Where to get helpEMC support, product, and licensing information can be obtained as follows:
Product informationFor documentation, release notes, software updates, or information about EMC products,go to EMC Online Support at https://support.emc.com.
Technical supportGo to EMC Online Support and click Service Center. You will see several options forcontacting EMC Technical Support. Note that to open a service request, you must have avalid support agreement. Contact your EMC sales representative for details aboutobtaining a valid support agreement or with questions about your account.
Online communitiesVisit EMC Community Network at https://community.emc.com for peer contacts,conversations, and content on product support and solutions. Interactively engage onlinewith customers, partners, and certified professionals for all EMC products.
Your commentsYour suggestions will help us continue to improve the accuracy, organization, and overallquality of the user publications. Send your opinions of this document to [email protected].
Preface
EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide 7
Preface
8 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
CHAPTER 1
Overview
This section provides an overview of EMC SourceOne for Microsoft SharePoint StorageManagement and includes the following topics:
l Installation............................................................................................................10l Deployment details............................................................................................... 10l Feature details...................................................................................................... 10
Overview 9
InstallationInstallation and deployment information for EMC SourceOne for Microsoft SharePointStorage Management is provided in the EMC SourceOne for Microsoft SharePoint StorageManagement Installation Guide.
Deployment detailsWhen deploying the SourceOne RBS software the following occurs.
l Installs the EMC SourceOne RBS Provider in the farm.
l Adds the full set of user interfaces to the Microsoft SharePoint Foundation 2010 orMicrosoft SharePoint Server 2010 Central Administration site.
All components for this product are installed on Microsoft SharePoint servers. Thisproduct does not require any components to be installed on EMC SourceOne servers.
Refer to the EMC SourceOne for Microsoft SharePoint Storage Management Installation Guidefor details on:
l Accounts and permissions
l System requirements
l Installation procedures
Feature detailsThis section lists the EMC SourceOne for SharePoint Storage Management features.
Content Database SettingsProvides configuration settings for storing BLOB content stored in the SharePoint 2010database in remote storage.
Migration ServiceMigrates BLOBs from External BLOB Storage (EBS), the SharePoint SQL database, oranother RBS store to the EMC SourceOne RBS store.
Maintenance ServicePerforms periodic garbage collection and other maintenance.
Health MonitorMonitors RBS storage for available free space and provides alerts based on configuredthresholds.
Enhanced EMC SourceOne Primary Administration siteAn updated EMC SourceOne primary administration site is provided which includes linksto RBS-specific configuration information.
Overview
10 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
CHAPTER 2
Configuring Microsoft SharePoint RBS
This section describes how to configure EMC SourceOne for Microsoft SharePoint StorageManagement and includes the following topics:
l Overview............................................................................................................... 12l SourceOne RBS components................................................................................. 12l Configuration prerequisites................................................................................... 12l Configuration overview..........................................................................................13l Configuring Content Database Settings................................................................. 13l Configuring the RBS Health Monitor.......................................................................19l Configuring the RBS Migration Service...................................................................21l Configuring the RBS Maintenance Service............................................................. 24
Configuring Microsoft SharePoint RBS 11
OverviewEMC SourceOne for Microsoft SharePoint Storage Management is an optional productwhich supports Remote BLOB Storage (RBS).
With EMC SourceOne for Microsoft SharePoint Storage Management, SharePoint usersaccess content stored in the RBS through SharePoint, as usual. The software providesstorage management, not archiving. RBS content is not indexed and retention is not setby EMC SourceOne.
EMC SourceOne for Microsoft SharePoint Storage Management:
l Is used to improve the SharePoint SQL Server performance by storing BLOBs onremote storage instead of the SharePoint SQL Server.
l Is intended for local use over a Local Area Network, not a Wide Area Network.
l Applies to a specific content database within a farm.
Note
To archive SharePoint content, you can use the EMC SourceOne for Microsoft SharePointproduct. Refer to the documentation that accompanies that product.
SourceOne RBS componentsThe following table describes the RBS components.
Table 2 RBS components
Components Description
RBS Provider Store the BLOB content in a remote storage.
Health Monitor Check the free space available in the storage provider.
Migration Service Migrate the following to EMC SourceOne RBS.
l BLOBs stored by third-party EBS
l BLOBs stored by EMC SourceOne EBS
l Existing BLOBs in content database
l BLOBs stored by third party RBS
Maintenance Service Perform periodic garbage collection and other maintenance tasks such asgarbage collection and consistency check for RBS.
Configuration prerequisitesBefore you configure RBS, ensure the prerequisites described in this section are met.
Configuring Microsoft SharePoint RBS
12 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
EMC SourceOne for Microsoft SharePoint Storage Management installationInstall and activate the EMC SourceOne for Microsoft SharePoint Storage Managementproduct. Installing the product provides the following.
l Support for the RBS features
l An updated EMC SourceOne administration site (.wsp) with RBS-specific links formanaging RBS features
Refer to the following documents for details:
l EMC SourceOne for Microsoft SharePoint Storage Management Installation Guide
l EMC SourceOne for Microsoft SharePoint Storage Management Release Notes
Account settings to access the Maintenance ServiceThe RBS provider uses the impersonation account to access the Maintenance Service.
Consider the following:
l The account is not used for accessing the content database.
l The application pool account of the Central Administration Web application typicallyhas sufficient privileges to access the Windows Task Scheduler on the otherSharePoint Web Front-End (WFE) servers.
Configuration overviewYou configure EMC SourceOne for Microsoft SharePoint Storage Management features byusing the EMC SourceOne administration site.
Perform the following steps to access the EMC SourceOne administration site.
Procedure
1. Open the SharePoint Central Administration website.
2. Click EMC SourceOne.
The page lists the following RBS services:
l Content Database Settings
l Health Monitor
l Migration Service
l Maintenance Service
Configuring Content Database SettingsThis section describes how to configure the Content Database settings.
Configuration considerationsBefore you configure EMC SourceOne RBS, consider the following.
l Ensure that installation is complete before enabling RBS
l Do not enable RBS until the following conditions are met:
Configuring Microsoft SharePoint RBS
EMC SourceOne for Microsoft SharePoint Storage Management installation 13
n RBS installation is complete on all SharePoint front-end servers
n The other RBS common settings are configured as described in this topic.
Note
If you enable RBS before it is installed on all SharePoint front-end servers, somefront-end servers might store BLOBs in the SQL Server and might not be able toretrieve externalized content.
l RBS configuration changes take effect immediately. The RBS Provider checks forconfiguration updates every 5 minutes.To force configuration changes
1. Restart IIS
2. Restart the SharePoint Timer service
l You cannot create a content database by using SQL authentication.
l Ensure that the following application are not RBS enabled:
n SharePoint Central Administration
n SharePoint Web Services
Note
The SharePoint Central Administration and SharePoint Web Services applications arenot intended to hold content or BLOBS. The Central Administration site is used by theSharePoint Administrator to manage the SharePoint environment. The SharePointWeb Services application is used for SharePoint programming such as internalfunctional calls.
Storage root path considerationsSpecify the farm-wide storage root path for the Storage Root Path.
All of the stores of different content databases or Web applications share the same farm-wide root path and if you use it, you do not need to specify a new storage location.
Note
Storage Root Path does not support content database-level root path.
Setting the root path to the provider storeThe RBS Content Database settings page lists all of the RBS and EBS provider stores thatare currently used.
Use this page to configure the root path to the provider stores. By configuring the rootpath here, you do not need to type a path each time you create a store.
Configuring Microsoft SharePoint RBS
14 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
Figure 1 Setting the root path to the store
Perform the following steps to set the root path to the provider stores.
Procedure
1. Specify the path; for example: \\servername\folder1.
All the provider stores you create are stored to this location on the server.
Note
Ensure that the path you specify is a network path which can be accessed from anyfront-end server on the network.
2. Click Apply.
3. To change the Web application whose content database you want to manage:
a. Select the Web Application drop-down.
b. Select Change Web Application to open a new page where you can select therequired Web application.
Figure 2 Select a Web Application
Specifying the Content Database detailsPerform the following steps to specify the content database settings.
Procedure
1. For the Activate/Deactivate Provider field:
a. Click the toggle button to activate or deactivate the EMC SourceOne RBS Provider.
b. Enable RBS so that BLOBs are remotely stored.
Configuring Microsoft SharePoint RBS
Specifying the Content Database details 15
Note
You cannot disable RBS if a store still available in the RBS store; you must deleteall stores before you deactivate RBS. To disable RBS, select Deactivate.
2. For the Minimum BLOB Size field, specify the minimum size of BLOBs to be remotelystored, in kilobytes (KB). You must enter an integer value between 0 and 4194304 KB.
Consider the following information when determining the minimum BLOB size:
l BLOBs with a size greater than or equal to the recommended value are saved tothe RBS store on the shared directory that you specify on the network.
l BLOBs that are smaller than recommended size are stored in the SharePoint SQLdatabase.
l The overhead of externalizing BLOBs that are too small may outweigh the benefits.
l Storing smaller BLOBs in the SharePoint SQL database reduces overhead relatedto external storage.
l SharePoint 2013 introduces a new technology called Shredded Storage, ShreddedStorage improves performance by breaking an individual BLOB into "shreddedBLOBS", that means when a file is upload to SharePoint 2013, it will be splits toseveral BLOBs.
l The Default FileWriteChunkSize is 64320 (around 62.8K), Administrator canchange it to a greater value by using the following command:
All Programs -> Microsoft SharePoint 2013 Products -> SharePoint 2013 Management Shell $webApp = Get-SPWebApplication http://webappurl $webApp.WebService.FileWriteChunkSize = 1073741824$webApp.WebService.Update()
3. For the Operation Retry Attempts field, specify the number of retry attempts to store aBLOB file to the RBS store.
When the EMC SourceOne RBS provider fails to retrieve the file, this settingdetermines how many times to automatically retry.
4. Click Apply to save the changes.
Setting up a new storeUse the following procedure to set up a new store. You can add as many stores as youneed.
Procedure
1. To add a new store, click Add New Store from the Content Database Details page. TheRBS Common Setting page displays.
Configuring Microsoft SharePoint RBS
16 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
Figure 3 Configuring a new store
2. For the Store Name field, specify a name for the content database where you want tostore the BLOB files.
Valid characters that you can use for the store name include the following:
l A to Z
l a to z
l 0 to 9
l underline
3. For the Storage Provider field, specify the storage provider. By default, the storageprovider is the file share or UNC path to the file share.
4. Specify the path to the storage provider:
a. Select the Specify Storage Path checkbox.
b. Type the pathname in the field. For example: \\store\path\EMCS1RBS\xyz\.If you do not specify a path, the parent root path automatically generates a storagepath.
c. Ensure that the location you specify is shared among the Web servers.
5. For the Pool Capacity field:
a. Specify the storage capacity of the RBS storage.
b. Specify how many BLOBs that a RBS pool (folder) can contain.
6. For the EMC Atmos Settings field, specify EMC Atmos settings here including thefollowing:
l URL
Configuring Microsoft SharePoint RBS
Setting up a new store 17
l Port
l Subtenant ID (this field could be empty if you want to connect to the main tenant)
l UID
l Shared Secret
7. For the Account Settings field:
a. Specify the username and the password of the impersonation account. Thesecredentials are used to access the RBS storage. The username and the passwordfields cannot be empty.
b. Click Test Storage to check that the specified credentials can access the RBSstorage.
Note
If you selected Atmos in Storage Provider section, this storage will be seen ascache storage, there will be two additional settings here.
c. For the Cache Expiration Period field, define the cache expiration days.
d. For the Pool Capacity field, define the max file count according to the file system.
8. Mark the Compression checkbox to enable compression for the BLOBs.
9. For the Encryption field, select an encryption algorithm to encrypt the BLOBs.
Configuring Microsoft SharePoint RBS
18 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
10.For the RBS Storage Quota section:
a. You can generate a warning message to preconfigured email recipients when freespace drops below one of the following values:
l Amount of free space is in megabytes (MB)
l Amount of free space is based on percentage (%)
b. Select the Send warning email if free space drops below checkbox to enable thisoption. When the free space drops below the specified level, a warning email isautomatically sent to the account you specify in the Notification settings.
c. Select the Write to Content Database if free space drops below checkbox toenable this option.
11.For the Notification field, specify one or more email addresses you want to notifywhen the RBS store space drops below the specified limit. Separate each addresswith a semicolon.
l You can customize the default email notification template on all farm servers byediting the following file:
%ProgramFiles%\Common Files\Microsoft Shared\Web ServerExtensions\14\TEMPLATE\LAYOUTS\ES1RBS\Xml\<localeid>\DefaultEmailTemplate.xslt
l Ensure that the outgoing SMTP server settings are configured by using the CentralAdministration > System Settings option.
12.Click OK to validate and save the changes.
13.If values are missing or invalid, then the following error message is displayed:
This page contains one or more errors. Fix the following before continuing.
14.Correct the values, then click OK.
Configuring the RBS Health MonitorUse the following procedure to configure SharePoint to periodically check the storagepath used by the SourceOne RBS provider for available free space.
If the available free space falls below the preconfigured limit (percentage of total diskspace or absolute disk space in megabytes), an alert is sent to a list of subscribers thatyou have specified.
Procedure
1. From the EMC SourceOne Settings page, click Health Monitor. The Health Monitorpage is displays.
Configuring Microsoft SharePoint RBS
Configuring the RBS Health Monitor 19
Figure 4 Scheduling Health Monitoring
2. For the Enable storage monitoring job section:
a. Select Enable storage monitoring job to periodically check on the storage for theavailable free space.
b. You can select a server from the drop-down list to run the monitor job
c. Select Any Server if you want SharePoint to select an idle server to run the job.
3. For the Time section:
a. Specify how often you want to run the storage check. You can set it in minutes,hours, or days.
b. Specify the time period you want to run the storage check.
Note
During the farm feature activation, Health Monitor is enabled and a default scheduleis automatically created for it.
4. Click Apply to save the changes.
Viewing Store statusThe Health Monitor page displays the store status. You can specify the types of stores forwhich you want to view the status.
Select the appropriate Web application from the Web application drop-down to view thestatus of the stores.The page displays the following status for all of the stores in a selected Web application:
l active
l read-only
You can view the following information:
l Web application name
l Content database name
l Store name
l Store location
l Free space
l Warnings and critical limits
Configuring Microsoft SharePoint RBS
20 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
l Current status of each store
File Share/UNC PathThis table describes the status icons for the File Share/UNC Path.
Table 3 Status symbols for File Share/UNC Path
Icon Status Description
Goodcondition
Connection to the remote storage is good and the free space is above theminimum file size limit.
Error Either the storage cannot be connected or the specified folder no longerexists.
Warning Connection to the remote storage is good, but the free space is below thewarning limit. If configured, a notification email is sent.
Critical Connection to the remote storage is good but the free space is below thecritical limit; the storage is running out of space. If configured, anotification email is sent.If this condition occurs, RBS is disabled, and BLOBs are saved to thecontent database instead.
AtmosThis table describes the status icons for Atmos.
Table 4 Status symbols for Atmos
Icon Status Description
Good condition The Atmos is connected, and the storage is good.
Error The storage cannot be connected or the specified folder no longer exists,although the Atmos can be connected.
Warning The Atmos cannot be connected.
Configuring the RBS Migration ServiceAfter an RBS store is activated, existing BLOB content can be migrated to the new RBSstore.
You can migrate the following content to an activated EMC SourceOne RBS store:
l BLOBs from EBS
l SQL database
l Another RBS store
You can migrate the contents in two ways:
l Whole content database migration
l Site collections selective migration
Configuring Microsoft SharePoint RBS
Configuring the RBS Migration Service 21
Note
One migration job can have multiple content databases associated with it but onecontent database can have only one migration job.
Use the Migration Jobs page to add a new migration job or view the progress of existingmigration jobs.
Adding a migration jobPerform the following steps to add a migration job.
Procedure
1. For a selected Web Application, select No Migration Job from the Filter by MigrationJobs drop-down.
2. Select the content database and then click Add Migration Job. The ConfigureMigration page displays
Figure 5 Migration scheduler
3. For the Direction section, select the target from the To drop-down list. The defaultoption is RBS.
The Direction section displays the content database or the EBS source that you haveselected to migrate.
4. For the Scheduler section, complete the following information:
a. From the Preferred Server for Timer Jobs drop-down list, select the server tomanage the schedule activities.
b. Set the start time and duration to run the migration.
Configuring Microsoft SharePoint RBS
22 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
Note
The and no later than option defines a range of time in which a migration job canstart. This option allows the SharePoint Timer service to schedule within a range oftime ensuring that all other timer jobs do not compete for resources at this time.This option is not a limit on when a migration job can run.
c. In the Time Limit field, specify how long you want this occurrence of migration torun, in minutes.
The time limit indicates that the job is stopped when the time reaches thespecified limit. For example, if the time limit is 60 minutes, and start time is 10:00PM, when time reaches 11:00 PM, the job is stopped, and the next day, themigration job will resume at 10:00 PM.
5. For the List of sites for migration section:
a. Select the list of sites that you want to consider for migration.
b. Select All, to migrate all of the listed sites.
6. For the Job Status Detail section, consider the following:
l This option is disabled when you create a migration job.
l For a content database which is currently in active migration, you can view thefollowing details:
n Name of the migration job
n Time when the migration has started
n The maximum time duration to run a migration job
n The last time a migration was run
n Content databases under migration
n Migration status
n Number of items that are migrated
7. Click OK to save the changes.
Viewing the migration statusThe Migration Jobs page displays the following settings as described in the followingtable for a selected migration job of a selected Web application.
Table 5 Migration summary
Setting Description
Content DatabaseName
Lists the Content databases that are scheduled for migration.
Job ID Displays the identification code for the migration job.
Server Displays the server that is selected to run the scheduled migration.
Status Displays the current status of the migration job. If a migration iscurrently enabled, status is Online.
Scheduled Start Time Displays the configured start time for the migration job.
Configuring Microsoft SharePoint RBS
Viewing the migration status 23
Table 5 Migration summary (continued)
Setting Description
Time Limit Displays the configured time limit for the migration job.
Progress Click Detail or the Detail icon to view the progress of the migration job.
Configuring the RBS Maintenance ServiceThe Maintenance Service performs garbage collection and a consistency check by usingWindows Task Scheduler. Each content database will have only one maintenance taskassociated with it and each maintenance task will have only one content databaseassociated with it.
Note
The Central Administration Pool Account must have necessary privileges to accessWindows Task Schedule of other SharePoint Web front-end servers.
Viewing Maintenance summaryThe Maintenance Service lists all the content databases that have SourceOne RBSenabled.
The Maintenance summary page displays the following details as described in thefollowing table.
Table 6 Maintenance summary
Setting Description
Content Database Name Lists the content databases that are scheduled for maintenance.
Web Application Name Displays the Web applications associated with the content databases.
Schedule Displays the time and frequency you have set to run the maintenance.
Status Displays the current status of the maintenance activity.
Server Name Displays the server you have set for the timer job.
Maintenance Action Lists the maintenance actions selected.
Result Provides a link to view the maintenance job results.
Last Run Time Displays the time when the maintenance activity was last run.
Action Allows you to remove or add the maintenance activity.
Configuring Maintenance activities for a content databaseThe BLOBS that are no longer referenced in SharePoint are called orphans. The RBSGarbage Collector deletes the orphan BLOBs from storage.
Use the Maintenance Configuration page to:
l Schedule the RBS garbage collection task for a selected content database.
Configuring Microsoft SharePoint RBS
24 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
l Specify the SharePoint front-end servers on which you want to run the garbagecollection task.
Use the following procedure to configure Maintenance activities for a content database.
Procedure
1. Update the Account section:
a. For the Enable the Maintenance task drop-down list, select the server on whichyou want to run the maintenance task.
b. For the User name field, specify the username of the account which has necessarypermissions to run the maintenance task on the selected server.
c. For the Password field, specify the password of the account which has necessarypermissions to run the maintenance task on the selected server.
d. Ensure that the account has the rights to create, remove, and run the Windowstasks on the selected server.
2. Update the Scheduler section:
a. Set the time to begin the maintenance job.
b. To set a time limit for this activity, select the Time Limit checkbox and the specifythe time in minutes.
Figure 6 Scheduling maintenance activities
3. Click Modify to configure database settings for maintenance. The Modify Setting pagedisplays.
Configuring Microsoft SharePoint RBS
Configuring Maintenance activities for a content database 25
Figure 7 Database settings for maintenance
4. Follow the on-screen instructions to configure the database settings for maintenanceas described in the following table:
Table 7 Garbage collection settings
Settings Description
Garbage CollectionTime Window
Specifies the minimum time that must pass between identifying a BLOBas having no references in the database and deleting the BLOB from thestore. This guarantees the availability of BLOBs for the specified time incase a backup is restored.
The default value is 30 days.
Orphan Scan Period Specifies the minimum amount of time that must pass between twoorphan cleanup garbage collection runs. The default value is 30 days.
Delete Scan Period Specifies the minimum amount of time that must pass between tworeference scan garbage collection runs. The default value is 30 days.
The format of the period is 'days dddd' or 'time hh:mm:ss'.
Delete PropagationBlobs Per Iteration
Specifies the number of BLOBs that can be checked in a singletransaction for the delete propagation garbage collection phase. Thisvalue can be used to control the trade-off between the overhead ofcreating and committing transactions and number of locks held. Thedefault value is 1000.
The value should be numeric.
Reference Scan BlobsPer Iteration
Specifies the number of BLOBs that can be checked in a singletransaction for the reference scan garbage collection phase. The defaultvalue is 1000.
The value should be numeric.
Configuring Microsoft SharePoint RBS
26 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
Table 7 Garbage collection settings (continued)
Settings Description
Reference Scan BlobsPer Work Unit
Specifies the number of BLOBs in a single work unit for the reference scanphase of garbage collection. This setting can be used to control taskgranularity.
The default value is 100000.
Orphan CleanupBlobs Per Iteration
Specifies the number of BLOBs that can be checked in a singletransaction for the orphan cleanup garbage collection phase.
The default value is 1000.
Orphan CleanupBlobs to EnumeratePer Iteration
Specifies the number of BLOBs to enumerate in a single call to the BLOBstore for orphan cleanup.
The default value is 1000.
Max ConsistencyIssues Found
Specifies the number of consistency issues of a single type that can befound before further checks will be cancelled.
The default value is 1000.
Max ConsistencyIssues Returned
Specifies the maximum number of consistency issues that will bereported by the maintainer.
The default value is 100.
Note
If multiple content databases are selected for scheduling, modifying settings modifiesactivities for each of them. If they have different values, you are prompted to confirm.
5. Click OK to save the changes and return to the Maintenance Configuration page.
6. Specify the maintenance tasks as described in the following table.
Table 8 Maintenance tasks
Settings Description
Garbage Collection Displays the garbage collection phases to perform. Check this to runor complete the garbage collection.
One or more sub options need to be checked.
Consistency Check Consider the following for consistency check:
l Action: Specifies the kind of consistency check to be performed.
l Type: Specifies the extent of the consistency check.
Maintenance on RBSinternal tables andindexes
Reorganizes the index and tables.
7. Click OK to save the changes.
Configuring Microsoft SharePoint RBS
Configuring Maintenance activities for a content database 27
8. After you successfully create a Maintenance Task, you can view the Windows TaskSchedule defined in Task Scheduler > Task Scheduler Library > EMC > SourceOne > RBS.
You can select to immediately run the selected schedule.
Configuring Microsoft SharePoint RBS
28 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
CHAPTER 3
Troubleshooting
This section describes how to troubleshoot the RBS features provided with EMCSourceOne for Microsoft SharePoint Storage Management and includes the followingtopics:
l Logging and performance......................................................................................30l General troubleshooting........................................................................................31
Troubleshooting 29
Logging and performanceThis section describes logging and performance information that you can monitor.
RBS log levelsRBS logs events of the following category into the SharePoint trace log.
l 1000—Information
l 2000—Warning
l 3000—Error
Configuring SharePoint Trace Logs for RBSTo configure the logging level for the SharePoint Trace Logs for RBS, perform thefollowing.
Procedure
1. At the SharePoint Central Administration website, select Monitoring > ConfigureDiagnostic Logging.
2. In the Event Throttling section, select EMC SourceOne SharePoint RBS. After the RBSfarm feature is activated, the trace category is created and appears.
Figure 8 RBS diagnostic logging
3. Specify the criticality of the events to report to the following logs:
l Event Log
l Trace Log
4. Click OK to save the changes.
5. Make a note of the location of the SharePoint Trace Log files, shown in the Path fieldin the Trace Log section.
6. You can use the ULS Viewer to monitor the real-time SharePoint Trace Log. You candownload the ULS Viewer from the Microsoft website.
Troubleshooting
30 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
Performance countersThe performance counter monitors the following.
l Provider Instance Initialized
l BLOBs Externalized
l BLOBs Retrieved
l Total Externalized Bytes
l Total Retrieved Bytes
l BLOBs Externalized Throughput Bytes/sec
l BLOBs Retrieved Throughput Bytes/sec
l BLOBs Externalized Time
l BLOBs Retrieved Time
l BLOBs Deleted
Perform the following steps to add performance counters for EMC SourceOne RBS.
Procedure
1. On the SharePoint server, select Start > Administrative Tools > Performance Monitor
2. Under Monitoring Tools, perform the following:
a. Select Performance Monitor.
b. Click the Add Counters icon.
3. Add EMC SourceOne RBS.
Figure 9 Performance counter
4. Click OK to save the changes.
General troubleshootingThis section describes general troubleshooting information.
Troubleshooting
Performance counters 31
Solution retraction status continues to display “Retracting”After you retract a solution, the status continues to display Retracting instead ofRetracted.
As a workaround, stop the SharePoint 2010 Timer service and restart it.
Activating a feature fails after deploying a solutionYou are not able to activate a feature after deploying a solution.
As a workaround, deploy the solution and wait for some time, then manually activate thefeature. The solution deployment requires some time because it is done through anasynchronous Timer Job.
RBS Configuration links are not displayedThe RBS configuration links are not displayed on the SourceOne Administration site.
As a workaround, manually activate the RBS Premium UI Farm feature.
Unexpected error on the Microsoft SharePoint 2010 serverYou encounter an error on the SharePoint 2010 server. To solve the problem, perform thesteps outlined in this section.
Figure 10 Unexpected error
Figure 11 Unknown error
Procedure
1. Turn Unknown Error to more detailed useful error message.
2. Open the web.config file on the Web application that you are accessing.
For example, if you are accessing http://server:80/, open the following file:
C:\Inetpub\wwwroot\wss\VirtualDirectories\80/web.config3. Perform the following:
Troubleshooting
32 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
l Set <SharePoint><SafeMode CallStack = “true” …>
l Set <system.web><customErrors mode=”Off” />
l Set <system.web><compilation debug=”true”>
4. Set <customErrors mode="Off" / for the following files:
l C:\Program Files\Common Files\Microsoft Shared\Web ServerExtensions\14\TEMPLATE\LAYOUTS\web.config for Content Webapplications.
l C:\Program Files\Common Files\Microsoft Shared\Web ServerExtensions\14\TEMPLATE\ADMIN\web.config for CentralAdministration.
5. After the unexpected error is resolved, ensure that these configuration entries arereverted to the original values.
The following detailed error description displays instead of meaningless UnexpectedError or Unknown Error messages.
Figure 12 Server error
Error message appears after activating SourceOne RBS ProviderAn error message appears as shown in the following figure when you activate SourceOneRBS Provider.
Figure 13 Activation error
To solve the problem activate again.
Troubleshooting
Error message appears after activating SourceOne RBS Provider 33
BLOBs are saved to Content Database instead of in a SourceOne RBS storeAlthough SourceOne RBS is created for a Content database, BLOBs are still being savedto the Content database.
To solve the problem set the active provider to the RBS store that you have created. RBSmigration does not work if the active provider is set to None.
Troubleshooting
34 EMC SourceOne for Microsoft SharePoint Storage Management 7.2 Administration Guide
© 2011 - 2013 EMC Corporation. All Rights Reserved. EMC believes the information in this publication is accurate as of its publication date. The information is subject to change
without
notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES NO
REPRESENTATIONS OR
WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND
SPECIFICALLY
DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.
EMC2, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United State and other
countries.
All other trademarks used herein are the property of their respective owners.
