SharePoint Settings

• Overview
• How to get here in the StoreGrid Web Console?
• SharePoint Settings
• Troubleshooting Tips
• Limitations

Overview

StoreGrid can be configured to backup the SharePoint site-collections available in the local machine. StoreGrid uses the internal backup utility (STSADM.EXE) to list the SharePoint site-collections present under a portal site and back them up.

Before configuring a SharePoint backup in StoreGrid, configure SharePoint settings with the correct values. StoreGrid will then list the portal sites and the site collections under them.

This section explains as how to configure the SharePoint settings for StoreGrid to list the Portal sites and the site collections under them in "Backup -> Plugin Backups -> Add SharePoint Site Backup" page.

How to get here in the StoreGrid Web Console?
 In the top menu, select: "Administration->Advanced Options" and click on the tab "SharePoint Settings" icon in the left hand side.

SharePoint Settings

In Windows, before a SharePoint backup is configured in StoreGrid, configure the SharePoint settings from "Administration -> Advanced Options" menu, "SharePoint Settings" icon in the left hand side. With the values entered in the SharePoint settings, StoreGrid will list the site collections and create a backup dump of the SharePoint site collections.

Path Settings(Tab)

• STSADM Tool Path [ STSADM.exe ]
  Enter the location of the STSADM.exe file in the local machine. StoreGrid uses only this tool to list and backup the site collections under a portal site.
  For WSS2.0/SPS2003, STSADM.exe file is normally present in the "C:/Program Files/Common Files/Microsoft Shared/web server extensions/60/BIN/" folder.
  For WSS3.0/MOSS2007, STSADM.exe file is normally present in the "C:/Program Files/Common Files/Microsoft Shared/web server extensions/12/BIN/" folder.
  
  Note: The exe file name "STSADM.exe" should not be appended to the path value.

• Temporary location to store the backup dumps
  Enter the location/directory path where the SharePoint site collection dumps should be stored temporarily before being uploaded to the backup server. Ensure to have enough disk space in the configured temporary location (where the backup dump has to be saved). Note that the backup dumps stored in the temporary location will be deleted once these dumps are transferred successfully to the remote backup server.

Portal Site Settings(Tab)

• Portal Site URL
  Enter the portal site URL that should be listed in the "Backup -> Plugin Backups -> Add SharePoint Site Backup" page. Once a portal site is added, the same will be listed in the table present below this 'Portal Site Settings' tab. Only the portal sites shown in the table below the 'Portal Site Settings' tab will be listed in the "Backup -> Plugin Backup -> Add SharePoint Site Backup" page. You can add any number of portal URLs that should be listed for a backup. In case, you wish to restrict a portal site URL from being listed, delete the portal site URL from the table below the 'Portal Site Settings' tab.

  NOTE: The list of portal sites in WSS2.0/SPS2003 can be obtained from SharePoint Central Administration -> SharePoint Portal Server [link in left column] -> Portal Site and Virtual Server Configuration [title] -> List and manage portal sites [link] page

  
  
  

Once these SharePoint settings are correctly configured and saved, the tree in the "Add SharePoint Site Backup" page will display the option to configure a SharePoint site-collection level backup. The Portal sites added through the tab Portal Site Settings will be listed in "Add SharePoint Site Backup" page. On clicking the "+" icon, the site-collections under that portal site will be listed. Select the sites you wish to backup.

Troubleshooting Tips

	SharePoint Sites not listed in the site selection tree in "Backup -> Plugin Backups -> Add SharePoint Site Backup" page.
Cause 1: This error is thrown if there is no portal site available to list [This normally occurs for WSS2.0/SPS2003 only and there will not be any issues for WSS3.0/MOSS2007] Solution 1: Enter a valid portal site URL and add to the list through the menu "Administration -> Advanced Options -> SharePoint Settings(Left Tab) -> Portal Site Settings(tab)". See whether the successfully added portal site is listed in the table below. Only the portal sites listed in this table will be listed in the "backup -> Plugin Backups -> Add SharePoint Site Backup" page. Refer the SharePoint Settings section for more details Cause 2: If the path of the STSADM.EXE provided in the "Administration -> Advanced Options -> SharePoint Settings(Left Tab) -> Path Settings (tab)" is incorrect or empty. Solution 2: Enter the exact path of the STSADM.EXE through the menu "Administration -> Advanced Options -> SharePoint Settings(Left Tab) -> Path Settings(tab)". For WSS2.0/SPS2003, normally found inside C:/Program Files/Common Files/Microsoft Shared/web server extensions/60/BIN folder. For WSS3.0/MOSS2007, normally found inside C:/Program Files/Common Files/Microsoft Shared/web server extensions/12/BIN folder. Refer the SharePoint Settings section for more details Cause 3 : SQL Server service is not running. Solution 3: Check if the SQL Server instance associated with the SharePoint farm is running. If the SQL Server service is stopped StoreGrid will not be able to list the site collections under a portal site.

	SharePoint portal sites are listed in "Add SharePoint Site Backup" page, but unable to list the site collections under a portal site when expanding the node of a portal site.
Cause 1 : No such portal site is existing (might have been deleted from SharePoint central admin) Solution 1: Check if the portal site that you are trying to list exists, valid and accessible via browser. Cause 2 : No valid site collection accessible via browser is available to list using STSADM.exe tool. Solution 2: Check if the portal site that you are trying to list has at least one valid, error free site collection under it which is accessible via web browser. Cause 3 : SQL Server service is not running. Solution 3: Check if the SQL Server instance associated with the SharePoint farm is running. If the SQL Server service is stopped StoreGrid will not be able to list the site collections under a portal site. Cause 4 : STSADM.EXE tool location invalid or not provided Solution 4: Check if the STSADM.EXE tool exists in the location that is given in "Administration -> Advanced Options -> SharePoint Settings(Left Tab)" page.

Limitations

1. For WSS2.0/SPS2003, only the sites added from 'SharePoint Settings' page will be listed in 'Add SharePoint Site Backup' Page.
2. Though the whole SharePoint Server or a whole portal site is selected for backup, only a site-collection level of backup will be done. Hence, to restore all the site-collections under a portal site, you need to restore the site-collections under that portal site one by one using STSADM.EXE.
3. StoreGrid should be run with Administrator privileges to list and backup SharePoint sites as STSADM.EXE can be run only with Administrator permissions.
4. If the dump path of the SharePoint backup exceeds 255 characters, dump process will fail. Hence, make sure, you have entered a shorter dump path to enable the dump to complete successfully.