SnapManager 8.0 for Microsoft SharePoint Installation Guide

Transcription

1 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide GC

2 Contents Preface... 4 Supported Features... 4 Websites... 4 Getting Information, Help, and Service... 5 Before You Call... 5 Using the Documentation... 5 Hardware Service and Support... 5 Firmware Updates... 6 How to Send Your Comments... 6 Overview... 7 Preparing to Install SnapManager for SharePoint... 9 SnapManager for SharePoint Network Configuration Requirements... 9 SnapManager for SharePoint Manager System Requirements SnapManager for SharePoint Agent System Requirements Overview of SnapManager for SharePoint Manager Service, Agent Service, and Control Service...24 Determining Storage Space Needs Installing SnapManager for SharePoint...28 Required Permissions for SnapManager for SharePoint Products Installing SnapManager for SharePoint...34 Unattended Installation SnapManager for SharePoint Manager Unattended Installation - SnapManager for SharePoint Agent Accessing the SnapManager for SharePoint GUI Internet Explorer Setup for SnapManager for SharePoint Logging In to SnapManager for SharePoint SnapManager for SharePoint Manager and Agent Maintenance Using the SnapManager for SharePoint Manager/Agent Configuration Tool Using the SnapManager for SharePoint Manager/Agent Restart Service Tool IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

3 Using the SnapManager for SharePoint Manager/Agent Uninstallation Wizard Upgrading SnapManager for SharePoint Uninstalling SnapManager for SharePoint Uninstalling SnapManager for SharePoint Manager Uninstalling SnapManager for SharePoint Agent Advanced Configuration Modify the Port Used by SnapManager for SharePoint Storage Manager and Connector Troubleshooting SnapManager for SharePoint Installation The Installed SnapManager for SharePoint Agents Cannot be Displayed in the Manager Interface Other Issues Accessing Hot Key Mode SnapManager for SharePoint Home Page Copyright and trademark information Trademark information IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 3

4 Preface Supported Features IBM System Storage N series storage systems are driven by NetApp Data ONTAP software. Some features described in the product software documentation are neither offered nor supported by IBM. Please contact your local IBM representative or reseller for further details. Information about supported features can also be found on the N series support Website (accessed and navigated as described in Websites). Websites IBM maintains pages on the World Wide Web where you can get the latest technical information and download device drivers and updates. The following Web pages provide N series information: A listing of currently available N series products and features can be found at the following Web page: The IBM System Storage N series support Website requires users to register in order to obtain access to N series support content on the Web. To understand how the N series support Web content is organized and navigated, and to access the N series support Website, refer to the following publicly accessible Web page: This Web page also provides links to AutoSupport information as well as other important N series product resources. IBM System Storage N series products attach to a variety of servers and operating systems. To determine the latest supported attachments, go to the IBM N series interoperability matrix at the following Web page: For the latest N series hardware product documentation, including planning, installation and setup, and hardware monitoring, service and diagnostics, see the IBM N series Information Center at the following Web page: publib.boulder.ibm.com/infocenter/nasinfo/nseries/index.jsp 4 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

5 Getting Information, Help, and Service If you need help, service, or technical assistance or just want more information about IBM products, you will find a wide variety of sources available from IBM to assist you. This section contains information about where to go for additional information about IBM and IBM products, what to do if you experience a problem with your IBM N series product, and whom to call for service, if it is necessary. Before You Call Before you call, make sure you have taken these steps to try to solve the problem yourself: Check all cables to make sure they are connected. Check the power switches to make sure the system is turned on. Use the troubleshooting information in your system documentation and use the diagnostic tools that come with your system. Refer to the N series support Website (accessed and navigated as described in Websites) for information on known problems and limitations. Using the Documentation The latest versions of N series software documentation, including Data ONTAP and other software products, are available on the N series support Website (accessed and navigated as described in Websites). Current N series hardware product documentation is shipped with your hardware product in printed documents or as PDF files on a documentation CD. For the latest N series hardware product documentation PDFs, go to the N series support Website. Hardware documentation, including planning, installation and setup, and hardware monitoring, service, and diagnostics, is also provided in an IBM N series Information Center at the following Web page: publib.boulder.ibm.com/infocenter/nasinfo/nseries/index.jsp Hardware Service and Support You can receive hardware service through IBM Integrated Technology Services. Visit the following Web page for support telephone numbers: IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 5

6 Firmware Updates IBM N series product firmware is embedded in Data ONTAP. As with all devices, ensure that you run the latest level of firmware. Any firmware updates are posted to the N series support Website (accessed and navigated as described in Websites). *Note: If you do not see new firmware updates on the N series support Website, you are running the latest level of firmware. Verify that the latest level of firmware is installed on your machine before contacting IBM for technical support. How to Send Your Comments Your feedback helps us to provide the most accurate and high-quality information. If you have comments or suggestions for improving this document, please send them by to starpubs@us.ibm.com. Be sure to include the following: Exact publication title Publication form number (for example, GC ) Page, table, or illustration numbers A detailed description of any information that should be changed 6 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

7 Overview SnapManager for SharePoint is an enterprise-strength backup, recovery, and data management solution for SharePoint Foundation 2010 and SharePoint Server 2010 (all current and future service packs), as well as SharePoint Foundation 2013 and SharePoint Server Operating on IBM s latest distributed software platform, SnapManager for SharePoint is accessible from anywhere in the network through Internet Explorer (other browsers are supported), and can monitor multiple SharePoint environments across a network. SnapManager for SharePoint Manager s main features include the following: The ability to centrally manage SharePoint backup and recovery jobs including scheduling, monitoring, reporting (logging and notifications), user account management, and software Agent management across multiple SharePoint farms from a single accessible-from-anywhere Web interface Fast backup speeds leveraging N series Snapshot backups, as well as real- time granular restore of items, item versions, lists, libraries, sites, and site collections directly onto the production server or an alternate location Backup coverage of all SharePoint 2010 and 2013 databases Backup of SharePoint search index files Backup of various SharePoint component settings including SharePoint and third-party solutions, IIS settings on Web front-end servers, SharePoint Global Search settings, and InfoPath Forms Services SnapMirror replication for backups of SharePoint databases and search indexes, Storage Manager BLOB data and Connector BLOB data, and verification of SnapMirror destination targets SnapVault data set backup for backups of: SharePoint databases and search indexes, Storage Manager BLOB data and Connector BLOB data, and verification of SnapVault targets Configure multiple schedules for different restore granularity levels in a single backup plan Separately schedule verification jobs apart from backup or restore jobs Separately schedule granular indexing jobs apart from backup jobs Ability to browse and restore individual items from backup directly without generating an index at backup time Different retention settings for the same backup components in multiple plans IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 7

8 Extend contents from the primary SQL content database storage to more affordable file system based locations (for example, CIFS devices) leveraging RBS Archiving and end-user-initiated archiving can delete historical contents (from items to site collections), or move them based on fully customizable business rules or an ondemand basis with tiered storage management and the support of backup and recovery Connector can attach any N series CIFS Share to SharePoint, taking advantage of all SharePoint content management and presentation features without any ingestion of content into the SharePoint content database Integration with N series SnapLock technology Integration with N series ASUP system for streamlined support Integration with SCOM (Microsoft System Center Operations Manager) event log Support to backup and restore FAST Search Server Farms In addition, SnapManager for SharePoint offers the option to evaluate various DocAve products for 90 days, including Migration, Granular Backup and Restore, Administration, Compliance products, and Report Center. 8 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

9 Preparing to Install SnapManager for SharePoint Both SnapManager for SharePoint Manager and SnapManager for SharePoint Agents must be installed in order to run SnapManager for SharePoint. This section describes the tasks that you must complete before installing SnapManager for SharePoint. SnapManager for SharePoint Network Configuration Requirements Refer to the table below for the default ports that are used by SnapManager for SharePoint. The same configuration applies to both IPv4 and IPv6. *Note: It is recommended that you use the default settings unless a known conflict with an existing port exists. When customizing the ports, make sure that the ports you are using are available. *Note: Host-based antivirus applications can block these ports by default. Ensure that the antivirus on the host is not configured to block these ports. Port Usage Must be Enabled On Web Site Port Used to access SnapManager for SharePoint Control Service. Control Service Port Used for communicating with other SnapManager for SharePoint services. SnapManager for SharePoint Control Server Media Service Port Used for communicating with other SnapManager for SharePoint services Media Service Data Port Used for transmitting data between SnapManager for SharePoint and the storage device Report Service Port Used for communicating with other SMSP services (only if running an evaluation version of DocAve Report Center) SnapManager for SharePoint Agent Port Used for communicating with other SnapManager for SharePoint services Port used by SnapManager for SharePoint Storage Manager and Connector processes to transmit the data required by the enabled EBS/RBS provider Port used by DocAve Real-time Replicator to inform Replicator processes of the real-time actions captured in SharePoint. SnapManager for SharePoint Media Server SnapManager for SharePoint Media Server DocAve Report Server SnapManager for SharePoint Agent Server N/A N/A IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 9

10 14007 The proxy port to use when updating SnapManager for SharePoint Control service by applying SnapManager for SharePoint updates in Update Manager. SnapManager for SharePoint Control Server Except for local ports and 14006, all of the other ports must be able to be accessed through the firewall software installed on the corresponding machines. *Note: If there are multiple SnapManager for SharePoint services installed on the same server, make sure all of the required ports are enabled on that server. For example, if the Windows Firewall is enabled on the servers which have installed SnapManager for SharePoint, you must make sure the 14000, 14001, 14002, and ports are allowed in the Inbound Rules on the corresponding servers. *Note: The port numbers may vary according to the settings configured when installing SnapManager for SharePoint in your environments. In this example, the default ports are used. 1. Use Remote Desktop to go to the server where SnapManager for SharePoint Timer Service is installed. 2. Navigate to Start > Administrative Tools > Windows Firewall with Advanced Security. 3. Right-click Inbound Rules under Windows Firewall with Advanced Security on Local Computer and click New Rule. Figure 1: Creating a new rule 10 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

11 4. In Rule Type step, select Port to configure the inbound rule for the ports used by SnapManager for SharePoint Timer Service. Figure 2: Selecting the Port option 5. Click Next. 6. In Protocol and Ports step, specify the rule to be applied to TCP, and then select Specific local ports option. Enter in the textbox. Figure 3: Entering in the Specific local ports field IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 11

12 7. Click Next. 8. In Action step, select the Allow the connection option to allow the connection to the port Figure 4: Allowing the connection 9. Click Next. 10. In Profile step, keep the default selection, which is selecting all three options. Figure 5: Applying rule to all three selections 11. Click Next. 12 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

13 12. In Name step, enter the Name and an optional Description for this inbound rule. Figure 6: Naming the inbound rule 13. Click Finish to finish creating the inbound rule. 14. Repeat the same steps on all of the other servers that have SnapManager for SharePoint installed and have enabled the Windows Firewall. *Note: To automate the configuration process of the Inbound Rules, it is recommended that you use the netsh advfirewall firewall commands. For detailed instructions on using these commands, refer to: Microsoft TechNet Library: Netsh AdvFirewall Firewall Commands IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 13

14 SnapManager for SharePoint Manager System Requirements SnapManager for SharePoint Manager consists of three services: Control Service, Media Service, and Report Service (only if running an evaluation version of DocAve Report Center). They can be run on the same server as your SnapManager for SharePoint Agent or split across several servers. For more information on SnapManager for SharePoint Manager services, see the Installing SnapManager for SharePoint section of this guide. While it is possible to have the SnapManager for SharePoint Manager and SnapManager for SharePoint Agent on a single server, it is not recommended. For the best performance, install the Manager s services across multiple servers, and ensure that the Manager is installed on servers NOT hosting IIS/SharePoint services. In addition, install only the necessary Agents on the Agent servers. Refer to these tables for the system requirements of each SnapManager for SharePoint Manager service: System Requirements for Control Service Installation System Requirements for Media Service Installation 14 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

15 System Requirements for Report Service Installation (only if running an evaluation of DocAve Report Center) *Note: If all Manager services are installed on the same server (or with a built-in database), all of the system requirements mentioned in the System Requirements for Control Service Installation section must be met. Refer to the following table for the recommended configuration requirements to ensure your SnapManager for SharePoint Manager runs smoothly. Installation Scenarios Single Server with Control Service, Media Service, Report Service Single Server with Control Service, Media Service, Report Service using Built-in Database Processor Available Physical Memory Available Disk Space 64-bit, 4 cores 4 GB 60 GB for system drive 64-bit, 4 cores 6 GB 80 GB for system drive IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 15

16 System Requirements for Control Service Installation Rules Operating System Edition: Number of CPU Cores Windows Server 2008 SP2 Available Physical Memory Windows Server 2008 R2 SP1 Available Disk Space Windows Server 2012.NET Framework Version.NET Framework Features Requirements Recommended: 2 or greater Required: 256 MB Recommended: 2 GB or greater Required: 1 GB.NET Framework 3.5 SP1 or above (.NET Framework must be installed) For Windows Server 2008 SP2 and Windows Server 2008 R2 SP1: The Windows features, including WCF Activation, HTTP Activation, and Non-HTTP Activation must be installed. For Windows Server 2012: The Windows features, including.net Framework 3.5.1, HTTP Activation, Non-HTTP Activation, WCF Services, and TCP Port Sharing must be installed. Net.Tcp Port Sharing Service Net.Tcp Port Sharing Service is started Windows Process Activation Service World Wide Web Publishing Service Web Server (IIS) Role Windows Process Activation Service is started Process Model,.NET Environment and Configuration APIs are installed World Wide Web Publishing Service is started Windows features installed: Web Server Common HTTP Features (Static Content, Default Document) For Windows Server 2008 SP2 and Windows Server 2008 R2 SP1: Application Development (ASP.NET,.NET Extensibility, ISAPI Extensions and ISAPI Filters) For Windows Server 2012: Application Development (ASP.NET 3.5,.NET Extensibility 3.5, ISAPI Extensions and ISAPI Filters) 16 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

17 Rules Requirements Management Tools (IIS Management Console, IIS 6 Management Compatibility and IIS 6 Metabase Compatibility) IIS Service IIS Admin Service is started. PowerShell Version PowerShell 2.0 or above *Note: SnapManager for SharePoint supports Hyper-V and ESX virtualization systems. Refer to the N series interoperability matrix Website (accessed and navigated as described in Websites) for more information regarding which versions of virtualization platforms are supported. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 17

18 Required Application Pool Settings The following application pool settings are required by SnapManager for SharePoint Control Service Installation regardless if you choose to use an existing application pool or create a new one. If you choose to create a new application pool, SnapManager for SharePoint will automatically configure these settings. It is not recommended that you use an existing application pool. However, if you choose to use an existing application pool, you must configure the application pool as follows: IIS Version IIS Setting Value Note Advanced Settings > General >.NET Framework Version v2.0 / v4.0 No Managed Code is not supported. Advanced Settings > General > Enable 32-bit Applications False False is required since SnapManager for SharePoint must load some thirdparty.dlls which are 64-bit ones. IIS7 Advanced Settings > General > Managed Pipeline Mode Integrated / Classic It is not supported to use Classic together with.net Framework v4.0. Process Model > Load User Profile True True is required by SnapManager for SharePoint SSO, and False is not supported. Advanced Settings > General > Start Automatically True / False True is strongly recommended because if you set the value to False, the application pool requires manual starting up. 18 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

19 Required Application Pool Account Permissions The application pool account (which can be any specified domain account) for connecting an existing IIS Web site or creating a new IIS Web site must have the following Local System Permissions. The specified application pool account will be granted full control permission to the following groups and folders automatically during SnapManager for SharePoint Manager installation. Member of the following local groups: IIS_WPG (for IIS 6) or IIS_IUSRS (for IIS 7 and IIS 8) Full control to HKEY_LOCAL_MACHINE\SOFTWARE\IBM\SnapManager for SharePoint 8 Full control to SnapManager for SharePoint Manager folder Member of the Performance Monitor Users group Full control to SnapManager for SharePoint Certificate private keys You can add the application pool account to the local Administrators group to meet the required permissions. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 19

20 System Requirements for Media Service Installation Rules Operating System Edition: Number of CPU Cores Windows Server 2008 SP2 Available Physical Memory Windows Server 2008 R2 SP1 Available Disk Space Windows Server 2012.NET Framework Version.NET Framework Features Net.Tcp Port Sharing Service PowerShell Version Requirements Recommended: 2 or greater Required: 128MB Recommended: 1 GB or greater Required: 1 GB.NET Framework 3.5 SP1 or above (.NET Framework must be installed) For Windows Server 2008 SP2 and Windows Server 2008 R2 SP1: The Windows features, including WCF Activation, HTTP Activation and Non-HTTP Activation are installed. For Windows Server 2012: The Windows features, including.net Framework 3.5.1, HTTP Activation, Non-HTTP Activation, WCF Services, and TCP Port Sharing must be installed. Net.Tcp Port Sharing Service is started PowerShell 2.0 or above 20 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

21 System Requirements for Report Service Installation (Only if running an evaluation of DocAve Report Center) Rules Operating System Edition: Number of CPU Cores Windows Server 2008 SP2 Available Physical Memory Windows Server 2008 R2 SP1 Available Disk Space Windows Server 2012.NET Framework Version.Net Framework Features Net.Tcp Port Sharing Service PowerShell Version Requirements Recommended: 2 or greater Required: 128MB Recommended: 1 GB or greater Required: 1 GB.NET Framework 3.5 SP1 or above (.NET Framework must be installed) For Windows Server 2008 SP2 and Windows Server 2008 R2 SP1: The Windows features, including WCF Activation, HTTP Activation and Non-HTTP Activation are installed. For Windows Server 2012: The Windows features, including.net Framework 3.5.1, HTTP Activation, Non-HTTP Activation, WCF Services, and TCP Port Sharing must be installed. Net.Tcp Port Sharing Service is started PowerShell 2.0 or above IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 21

22 SnapManager for SharePoint Agent System Requirements SnapManager for SharePoint Agent has one service, the SnapManager for SharePoint Agent Service. A SnapManager for SharePoint Agent communicates with SharePoint based on the commands it receives from the SnapManager for SharePoint Manager s Control Service. Multiple Agent setups provide redundancy as well as scalability for large environments by allowing you to specify different accounts for different farms where multiple farms exist. The SnapManager for SharePoint Agent can be installed on different machines according to the role of the machine and the SnapManager for SharePoint modules and functionalities you wish to use. For more information on where to install the SnapManager for SharePoint Agents, refer to Where to Install SnapManager for SharePoint Agents. *Note: The use of system resources on a server increases when the installed Agent is performing actions. This may affect server performance. However, if the Agent installed on a server is not being used, the use of system resources is very low and, therefore, the effect on server performance is negligible. Refer to the N series interoperability matrix Website (accessed and navigated as described in Websites) for more information regarding which versions of IBM N series and Microsoft software can be used with SMSP. System Requirements for Agent Service Installation Rules Operating System Edition: Number of CPU Cores Windows Server 2008 SP2 Available Physical Memory Windows Server 2008 R2 SP1 Available Disk Space Windows Server 2012.NET Framework Version.Net Framework Features Net.Tcp Port Sharing Service PowerShell Version Requirements Recommended: 2 or greater Required: 256MB Recommended: 2 GB or greater Required: 1 GB or above.net Framework 3.5 SP1 or above For Windows Server 2008 SP2 and Windows Server 2008 R2 SP1: Windows.NET Framework must be installed. For Windows Server 2012: The Windows features, including WCF Services and TCP Port Sharing must be installed. Net.Tcp Port Sharing Service is started PowerShell 2.0 or above 22 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

23 SQL Server Requirements for SnapManager for SharePoint Databases Databases Control Database Report Database Auditor Database Stub Database SQL Server Edition For SnapManager 8.0 for SharePoint and later versions: Microsoft SQL Server 2005 Microsoft SQL Server 2008 Microsoft SQL Server 2008 R2 Microsoft SQL Server 2012 SharePoint Environment Requirements SnapManager 8 for SharePoint Agents can be installed and used in the following SharePoint environments: Microsoft SharePoint Server 2010 Microsoft SharePoint Foundation 2010 Microsoft SharePoint Server 2010 with SP1 Microsoft SharePoint Foundation 2010 with SP1 Microsoft SharePoint Server 2013 Microsoft SharePoint Foundation 2013 *Note: The all-in-one installation of SharePoint on 64-bit operating systems uses the complete installation option, which installs everything including the SQL Server on a single machine. If you are using the SharePoint Stand-alone installation that uses the built-in SQL Server 2008 Express database (for SharePoint 2013, it is the built-in SQL Server 2008 R2 SP1 Express database), the Web application that uses the pre-defined Network Service account as the application pool security account is not supported by SnapManager for SharePoint since local users may be used to manage certain SharePoint components. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 23

24 Overview of SnapManager for SharePoint Manager Service, Agent Service, and Control Service After installing all of the services including SnapManager for SharePoint Manager Services and SnapManager for SharePoint Agent Service properly, you are able to manage your SharePoint data via the SnapManager for SharePoint platform. The Control Service receives the request from SnapManager for SharePoint Manager, and then sends the request to Agent Services, which retrieve data from SharePoint. Agent Services transfer the SharePoint data to Media Services, where the data is integrated into a format that can only be identified by SnapManager for SharePoint. This data is then sent to the specified destination. Agent Services also retrieves data via the Media Service when transferring or restoring data to SharePoint. The Report Service records all of these actions (only if running an evaluation version of DocAve Report Center). The information is then used by SnapManager for SharePoint when generating reports. SnapManager for SharePoint Control Service and SnapManager for SharePoint Agent Service are required for all of the SnapManager for SharePoint products. SnapManager for SharePoint Media Service is required for the following SnapManager for SharePoint products: Platform Backup and Restore Archive Manager 24 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

25 Determining Storage Space Needs The required storage space for content databases, indexes, and other storage requirements are unique to each SharePoint environment and must be estimated for each individual environment. You can assess the general volume size requirements for SnapManager for SharePoint in the same way as SnapManager for Microsoft SQL Server. For more information, see the section assessing volume size in the SnapManager for Microsoft SQL Server Installation and Administration Guide. You can find the guide on the IBM N series support Website (accessed and navigated as described in Websites). The general guidelines for sizing IBM N series volumes, storage devices, content databases, and indexes are described in the following table: Component Value Description Recommended Maximum Content Database Size 200 GB (SharePoint2010 and SharePoint 2013) This is not an absolute maximum size but a general recommendation for performance and scalability. Refer to the link below for the detailed information from Microsoft: For SharePoint 2010: Microsoft TechNet Library: Storage and SQL Server capacity planning and configuration (SharePoint Server 2010) For SharePoint 2013: Microsoft TechNet Library: Software boundaries and limits for SharePoint 2013 Maximum Number of Content Databases per Storage Device 500 This is not an absolute maximum value, but it is not recommended that you exceed this limitation. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 25

26 Maximum Number of Content Databases per Volume 100 Every database located on an N series volume could potentially be backed up in a single backup operation. In this case, the SQL Server must still be able to manage all of the databases while they are being backed up. Each database that is being backed up requires SQL Server resources. A typical SQL Server might not be able to manage any more than 100 databases. See the SnapManager for Microsoft SQL Server Installation and Administration Guide for more information. The recommendations in the following rows are based on the information found in the following Microsoft articles: For SharePoint 2010: Microsoft TechNet Library: Performance and capacity technical case studies (SharePoint Server 2010) For SharePoint 2013: Microsoft TechNet Library: Capacity management and sizing overview for SharePoint Server 2013 Database Log Files Disk space needs for log files vary based on log settings and the number of databases. Recommended Maximum Configuration Database Size 1.5 GB Most configuration databases do not grow larger than this size. This is an estimated maximum size, not a boundary. 26 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

27 Recommended Formula for Estimating Content Database Size Requirements Estimate the initial volume of content that will be stored in content databases. In SharePoint 2010 environment: The formula to use is Database size = ((D x V) x S) + (10 KB (L + (V x D))) D stands for number of documents. V stands for number of non-current versions. S stands for average size of documents. L stands for list items. The value of 10 KB in the formula is a constant that roughly estimates the amount of metadata required by SharePoint Server If your system requires significant use of metadata, you can increase this constant. Calculating Future Growth Data Storage Needs For SharePoint 2010 environment, refer to Microsoft TechNet Library: Performance and capacity technical case studies (SharePoint Server 2010) Content Index Server Recommended LUN Size Archive Index Server Recommended LUN Size In SharePoint 2010 environment, refer to Microsoft TechNet Library: Storage and SQL Server capacity planning and configuration (SharePoint Server 2010) Typically, archive indexes require 512 bytes per archived item. If full text index is enabled, add in the estimation of the content index server from above. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 27

28 Installing SnapManager for SharePoint The SnapManager for SharePoint Installation chapter provides you the following information: Required permissions Order of installation (install Manager first, then Agents) System requirements (minimum standards to proceed with the installation) System recommendations (recommended standards for improved performance) Required Permissions for SnapManager for SharePoint Products Refer to the sections below for the permissions required to take full advantage of all products functionality. Archive Manager Permissions To install and use Archive Manager properly, ensure that the Agent account has the following permissions. 1. Local System Permissions: User is a member of local Administrator group. *Note: The Local Administrator permission is required to deploy any Archive Manager solution. 2. SharePoint Permissions: These permissions must be manually configured prior to using SnapManager for SharePoint Archive Manager; they are not automatically configured. User is a member of the Farm Administrators group. Since Archive Manager works across farms and on all SharePoint settings and configurations, this account is needed in order to provide the best and most complete quality of service. Full Control to all zones of all Web applications via User Policy for Web Applications User Profile Service Application permissions for SharePoint 2010: o o o Use Personal Features Create Personal Site Use Social Features User Profile Service Application permissions for SharePoint 2013: o o Create Personal Site (required for personal storage, newsfeed, and followed content) Follow People and Edit Profile 28 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

29 o Use Tags and Notes Managed Metadata Service Term Store Administrator Business Data Connectivity Service Full Control Search Service Full Control 3. SQL Permissions: These permissions must be manually configured prior to using SnapManager for SharePoint Archive Manager; they are not automatically configured. Database Role of db_owner for all of the databases related to SharePoint, including Content Databases, Config Database, and Central Admin Database Database Role of db_creator and Security Admin to SQL Server (this permission is only required when you choose to create the Archiver Database using the Windows Authentication method, because the Agent Account will be used to create the Archiver Database) *Note: If you choose to use SQL Authentication when creating the Archiver Database, make sure the user specified also has db_creator and Security Admin database roles to SQL Server. Storage Manager Permissions The following permissions are required for the Storage Manager Agent account; they ensure proper functionality of Storage Manager. 1. Local System Permissions: These permissions are automatically configured by SMSP during installation. If there are no strict limitations within your organization on the permissions that can be applied, you can simply add the Agent Account to the local Administrators group to apply all of the required permissions. 2. SharePoint Permissions User is a member of the Farm Administrators group. Since Storage Manager works across farms and on all SharePoint settings and configurations, this account is needed in order to provide the best and most complete quality of service Full Control to all zones of all Web applications via User Policy for Web Applications 3. SQL Permissions Database Role of db_owner for all of the databases related with SharePoint, including content databases, stub databases, SharePoint configuration database and Central Administration content database Database Role of db_creator to SQL Server since SnapManager for SharePoint must create a stub database before performing any Storage Manager job. Local System Permissions 1. User is a member of the following local groups: IIS_WPG (for IIS 6.0) or IIS_IUSRS (for IIS 7.0) IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 29

30 Performance Monitor Users SMSP Users o o o Full Control to the Registry of HKEY_LOCAL_MACHINE\SOFTWARE\IBM\SnapManager for SharePoint 8 Full Control to the Registry of HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\EventLog Full Control to the Communication Certificate o Permission of Log on as a batch job (it can be found within Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > User Rights Assignment) o Full Control Permission of SMSP Agent installation directory 2. Full Control to GAC in order to install Provider dll into GAC. 3. Full Control to Microsoft SQL Remote Blob Storage folder to reconfigure maintainer configuration file. Connector Permissions Refer to the information below for Connector permissions. Agent Account Permissions To install and use Connector properly, ensure that the Agent account has the following permissions: 1. Local System Permissions: User is a member of local Administrator group. 2. SharePoint Permissions: These permissions must be manually configured prior to using SnapManager for SharePoint Connector; they are not automatically configured. User is a member of the Farm Administrators group. Since Connector works across farms and on all SharePoint settings and configurations, this account is needed to provide the best and most complete quality of service. Full Control to all zones of all Web applications via User Policy for Web Applications. 3. SQL Permissions: These permissions must be manually configured prior to using SnapManager for SharePoint Connector; they are not automatically configured. Member has a Database Role of db_owner for all of the databases related to SharePoint, including Content Databases, Config Database, and Central Admin Database. Member has a Database Role of db_owner for all of the SnapManager for SharePoint stub databases. Member has a Database Role of db_creator to SQL Server since it must create a stub database before performing any Connector job. 30 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

31 File Share Permissions Ensure that the user account used by the Connector library to access the file share has the following minimum required permissions: NTFS Permission Needed? Reason Needed Full control No Traverse folder/execute File Yes Connector traverses the folder in order to access the data within subdirectories. It also needs to be able to open the file directly from the folder. List Directory/Read Data Yes Connector must list all contents within the folder in order to display them within SharePoint. It also needs to read the data in order to provide the binaries via SharePoint. Read Attributes Yes SharePoint has a promotion and demotion feature that reads Office file attributes and then uses them as column data. Read Extended Attributes Yes Office files have extended attributes as well as custom attributes that are used in SharePoint promotion and demotion processes. Create Files/Write Data Yes This permission is needed to create files within the file share when they are created within SharePoint. Create Directories/Append Data Yes This permission is required to create folders within the file share when they are created in SharePoint. Connector creates hidden folders within the file share in order to store version history and prevent other libraries from connecting to the same file share. Write Attributes Yes When SharePoint demotes column information into Office files, the file attributes need to be written to. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 31

32 Write Extended Attributes Yes Office files have extended attributes, as well as custom attributes, that are used in SharePoint promotion and demotion processes. Delete Subdirectories and Files Yes In order to synchronize deletion within SharePoint into the file share, this permission is needed. Delete No Since Connector does not delete the root folder that is connected to, this permission is not needed. Read Permissions Yes* *This permission is needed only when loading NTFS permission information from the file share into a Connector library. Change Permissions No Since Connector does not change permission information within the file share, this permission is not needed. Take Ownership No Since Connector does not attempt to take ownership of a file or folder, this permission is not needed. Platform Backup and Restore Permissions To install and use Platform Backup and Restore properly, certain permissions ensure that the Agent account has the following permissions. Agent Account configured on the SharePoint Agents included in the Agent group: 1. Local System Permissions: User is a member of local Administrator group. 2. SharePoint Permissions: This permission must be manually configured prior to using SnapManager for SharePoint Platform Backup and Restore; it is not automatically configured. Member of the Farm Administrators group *Note: For SharePoint 2013, the Platform Granular Restore requires the Agent account to have Full Control of all zones of the Web application. When restoring the backed up SharePoint 2010 or SharePoint 2013 personal site, the Agent account used to run the Platform Granular Restore job must also have the following permissions: Full control to the User Profile Service Application related to the Web application where the personal site resides Security account of the application pool used by the Web application where the personal site resides 32 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

33 3. SQL Permissions: These permissions must be manually configured prior to using SnapManager for SharePoint Platform Backup and Restore; they are not automatically configured. Database Role of db_owner for all of the databases related with SharePoint, including SharePoint configuration database, and Central Administration content database Database Role of db_owner for all of the content databases, and service application databases included in the backup plan Database Role of db_owner for the destination content databases Database Role of public, db_creator, and Security Admin to SQL Server Database permission of View server state to SQL Server Database permission of Alter Any Database and View Any Definition to the SQL server Database permission of Control server to SQL Server (this permission is only required when you are using the AlwaysOn Availability Groups feature in SQL Server 2012, and this permission must be configured on all SQL instances inside the AlwaysOn Availability Group) Agent Account configured on the Index Server Member of the local Administrators group in the local system Agent Account configured on the FAST Search Server 1. Local System Permissions 2. SQL Server Member of the following local groups: o o Administrators FASTSearchAdministrators (this permission is only required for the Agent Account configured on the FAST Search Administration server) Database Role of public to SQL Server (this permission is only required for the Agent Account configured on the FAST Search Administration server) Agent Account configured on the SQL Server 1. Local System Permissions: 2. SQL Server: Member of the local administrator Database role of db_owner for master database. Database role of db_owner for all of the databases included in the backup plan. Database role of Process Admin permission to SQL server Database permission of View Server State to the SQL server. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 33

34 Database permission of Control server to SQL Server (this permission is only required when you are using the AlwaysOn Availability Groups feature in SQL Server 2012, and this permission must be configured on all SQL instances inside the AlwaysOn Availability Group) *Note: The user who backed up and restores the certificate encrypted by TDE must have the server role of securityadmin. The user who restored the SQL logins must have the server role of securityadmin. Solution Manager Permissions In order to use the SMSP Solution Manager, make sure that you have the following permissions: Member of local Administrators group Member of Farm Administrators group Database Role of db_owner for all of the databases related to SharePoint, including Content Databases, Config Database, and Central Admin Database Full control of all zones of all Web applications via User Policy for Web Applications in your SharePoint permissions. Installing SnapManager for SharePoint The SnapManager for SharePoint Installation Wizard is there to guide you through the installation process. By following the steps below, you will have SnapManager for SharePoint up and running on your environment very quickly. In order to complete the installation successfully, a local administrator must be used to run the Installation Wizard. *Note: Install SnapManager for SharePoint in the following order: 1. Install the SnapManager for SharePoint Manager with the Manager Installation Wizard. 2. Install the SnapManager for SharePoint Agents with the Agent Installation Wizard. 3. Log in to SnapManager for SharePoint to make sure the Manager and Agent are able to communicate with each other properly. Refer to the N series interoperability matrix Website (accessed and navigated as described in Websites) for more information regarding which versions of IBM N series and Microsoft software can be used with SMSP. 34 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

35 Installing SnapManager for SharePoint Manager Make sure the system requirements are met before starting installation for SnapManager for SharePoint Manager. For more information, refer to the System Requirements for Control Service Installation and System Requirements for Media Service Installation sections of this guide. *Note: When running the Manager Installation Wizard on a server running Windows Server 2008/Windows Server 2008 R2/Windows Server 2012, make sure the Server Manager is not being used to add or remove Windows features during the rule scanning. Otherwise, the scanning result will be affected. SnapManager for SharePoint Manager can be installed on the following environments. Windows Server 2008 SP2 Windows Server 2008 R2 SP1 Windows Server 2012 Follow the steps below to install SnapManager for SharePoint Manager. 1. Download the Manager installation application by requesting a demo version from the IBM N series support Website (accessed and navigated as described in Websites) or by contacting an IBM representative for a demo version of this software. 2. Save this application to a location on your system (for example, C:\temp). Double-click the saved application. 3. After the welcome screen appears, click Next. 4. SnapManager for SharePoint overview page appears. Click Next. 5. Enter your name and the organization into the provided fields. Click Next. 6. Carefully review the SnapManager for SharePoint License Agreement. After you have read the agreement, check the I accept the terms in the license agreement checkbox, and click Next. *Note: You can navigate to the Manager installation path \SMSP8\Manager\lic\ to check all of the demo license agreements with different versions. 7. Choose whether to install the additional modules Connector, Archive Manager, and Storage Manager as a set. 8. Choose whether to install and evaluate other AvePoint DocAve products Migration, Administration, Governance, Compliance, Replication, Content and Deployment Management, Reporting and Auditing. 9. The License Agreement appears if you choose to install and evaluate other products in the previous step. Carefully review the License Agreement. After you have read the agreement, check the I accept the terms in the license agreement checkbox, and click Next. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 35

36 10. Click the Browse button. Select the location for the Manager installation. By default, the installation location is C:\Program Files\IBM\SMSP8. Click Next. 36 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

37 11. Install the services: Figure 7: Selecting services to install Control Service Manage all SnapManager for SharePoint operations and achieve the Web-based SnapManager for SharePoint platform, allowing users to interact with the software. All Agents can communicate with the manager by Control Service, so it is imperative that the machine you install the Control Service on is accessible by all Agent machines. This service can be run on a server cluster to ensure high availability (HA); if the Control Service were to go down, a standby service installed on the server cluster would be enabled by an administrator. For more information, refer to the SnapManager for SharePoint Control Service section of this guide. Media Service Performs assistant jobs such as managing the retention rules and managing the backup job data. This service can be installed on multiple machines. Using multiple Media Services allows for HA and load-balanced access to the CIFS Share data storage locations. Report Service (only if running an evaluation of DocAve Report Center) Report Service manages all SharePoint data collection and management, monitors SharePoint activities and returns the data to the Control Service for processing. This must be configured with the associated SQL databases and SQL Report Services. This service is critical for using the Report Center module. This service is disabled if you do not select to evaluate other products. *Note: The Report service can be installed on multiple servers and can be load balanced. However, all of the Report services must share the same Report Database and Auditor Database. 12. Click Next. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 37

38 13. SnapManager for SharePoint will perform a brief pre-scan of the environment to ensure that all rules meet the requirements. The status for each rule will be listed in the Status column. Click the hyperlink of the status, the detailed information about the scan result will be listed in the popup window. You may click Details to view detailed information on all requirements. Figure 8: Scanning for Installation Rules 14. If any rules have failed the pre-scan, update your environment to meet the requirements, then click the Rescan button to check your environment again. After all rules pass, click Next. 38 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

39 15. Set up the Control Service Configuration: Figure 9: Configuring Control Service installation a. Control Service Host Specify the current machine s hostname, IP address, or fully qualified domain name (FQDN). The Control Service manages internal configuration data, user access control, scheduling, and job monitoring. b. IIS Web Site Settings Configure the IIS Web site settings for the Control Service. You can select to use an existing IIS Web site or create a new IIS Web site. The IIS Web site is used to access SnapManager for SharePoint Manager. o o Use an existing IIS web site Select an existing IIS Web site from the drop-down list, and if necessary, you can adjust the Web Site Port used to access the SnapManager for SharePoint Control Service. Create a new IIS web site Enter the Web site name and create a new IIS Web site for the Control Service. The default Web Site Port used to access SnapManager for SharePoint Control Service is 14000, you do not need to change it unless a known port conflict exists. o Web Site Port Control Service communication port. The default port is c. Application Pool Settings Configure the IIS application pool settings for the corresponding Web site. You can select to use an existing application pool or create a new application pool. The application pool is used to handle the requests sent to the corresponding Web site. The following settings can be configured: o Use an existing application pool (not recommended) This option is not recommended, as using an existing application pool may causes issues with other applications. Select an existing application pool from the drop-down list. If IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 39

40 o you choose to use an existing application pool, the Application Pool Account settings are grayed out and cannot be changed. Create a new application pool Enter the application pool name and application pool account settings to create a new IIS application pool for the corresponding Web site. 16. Click Next to continue to configure the database settings for Control Service. 17. Select MS SQL or Built-in Database (SQL Express) from the Database Type drop-down menu to configure the database. Figure 10: Control service configuration page For the MS SQL database, the following information must be configured: a. Database Server The MS SQL Server name. b. Control Service Database Name Enter a database name for the Control Service, if the database does not exist, it will be created in the provided MS SQL Server. c. Database Credentials Select the credential for this Control Service database. o Windows Authentication (the default option) Use this method when you want the user identity to be confirmed by Windows. The specified account must have permission to access the SQL Server machine where you want to create the Control Service database. The user specified here must also have the following permission on the machine where SnapManager for SharePoint Manager will be installed: Log on as a batch job (which can be found in Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > User Rights Assignment). 40 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

41 o SQL Authentication SQL Server will confirm the user identity itself according to the specified account and password. The specified account must have the following permission: DB Owner of the existing SnapManager for SharePoint control database or DB Creator of the newly created SnapManager for SharePoint control database. d. Passphrase Settings Enter the passphrase you want to use for protecting SnapManager for SharePoint Manager data. The passphrase you enter here will be required during Agent installation. o o If you choose to create a new control database, enter a passphrase that will be used to protect SnapManager for SharePoint Manager data. If you select the Clear text password option, the entered passphrase displays in clear text, and it will be displayed on the Complete interface. If you do not select the Clear text password option, the entered passphrase will be displayed in encrypted text, and it will not be displayed on the Complete interface. If you choose to use an existing Control database, enter the corresponding passphrase for this specified Control database. e. Advanced Database Settings You can choose to associate the SnapManager for SharePoint Control database with a specific failover SQL Server that is used in conjunction with SQL Server database mirroring. *Note: A built-in database (SQL Express) only supports an all-in-one installation. After the Manager installation completes, it cannot be changed using the Change function. *Note: 32-bit operating systems do not support use of built-in databases when installing SnapManager for SharePoint. 18. Click Next. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 41

42 19. Set up the Media Service Configuration for data management. Figure 11: Configuring Media Service installation 20. Click Next. a. Media Service Host Specify the current machine s hostname or IP address. The Media Service manages backup job data (for example, job metadata and backup index from Data Protection). b. Media Service Port Used for communicating with the other SnapManager for SharePoint services. The default port is c. Media Service Data Port Transmit the data between SnapManager for SharePoint and the storage device. The default port is d. Control Service Host (This field will be hidden when you choose to install the Control Service in Services Installation step) The hostname or IP address of the machine where Control Service is installed. e. Control Service Port (This field will be hidden when you choose to install the Control Service in Services Installation step) The port number for the Control Service entered above. *Note: The Control Service Host and Control Service Port must be consistent across all SnapManager for SharePoint Manager Services in order to properly function. 21. Set up the Report Service Configuration (only if running an evaluation of DocAve Report Center) 42 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

43 a. Report Service Host The hostname or IP address of the machine where Report Service is installed. b. Report Service Port The port number for Report Service. The default port is c. Control Service Host (This field will be hidden when you choose to install the Control Service in Services Installation step) The hostname or IP address of the machine where Control Service is installed. d. Control Service Port (This field will be hidden when you choose to install the Control Service in Services Installation step) The port number for the Control Service entered above. *Note: The Control Service Host and Control Service Port must be consistent across all SnapManager for SharePoint manager services in order to properly function. 22. Click Next to continue to configure the database settings for Report Service. 23. For the report service database (only if running an evaluation of DocAve Report Center), you can select to use the previous database settings or configure it yourself: Use the previous database settings If you select this option, the previous database settings for Control database will be used for the Report database. 24. To set a database for report service only, the following information must be configured. Select the database type from the drop-down list; only MS SQL can be selected. a. Database Server The MS SQL Server name. b. Report Service Database Name Enter a database name for the Report Service, if the database does not exist, it will be created in the provided MS SQL Server. c. Database Credentials Select the credential for this report service database. o o Windows Authentication (the default option) Use this method when you want the user identity to be confirmed by Windows. The specified account must have the permission of accessing the SQL Server machine where you want to create the report service database. The user specified here must also have the following permission on the machine where SnapManager for SharePoint Manager will be installed: Log on as a batch job (which can be found in Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > User Rights Assignment). SQL Authentication SQL Server will confirm the user identity itself according to the specified account and password. The specified account must have the following permission: DB Owner of the existing DocAve report service database or DB Creator of the newly created DocAve report service database. d. Advanced Database Settings You can choose to associate the SnapManager for SharePoint Report database with a specific failover SQL Server that is used in conjunction with SQL Server database mirroring. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 43

44 25. Click Next to continue to configure the Auditor database settings for Report Service. 26. For the Auditor database (only if running an evaluation of DocAve Report Center), you can select to use the previous database settings or configure it by yourself. Use the previous database settings If you select this option, the previous database settings for the Report database will be used for the Auditor database. 27. To set an auditor database for report service only, the following information must be configured. Select the database type from the drop-down list; only MS SQL can be selected. 28. Click Next. a. Database Server The MS SQL Server name. *Note: It is recommended creating the DocAve Auditor database on a different SQL Server other than the SQL Server which stores the SharePoint databases. If you put the DocAve Auditor database and SharePoint database on the same SQL Server, as the SharePoint Auditor data grows, large amount of disk space of the SQL Server machine will be occupied when DocAve Compliance Reports fetches data from SharePoint Auditor database and stores it to DocAve Auditor database. Thus the response of both SQL Server and SharePoint will become slow. b. Auditor Database Name Enter a database name for the Auditor database, if the database does not exist, it will be created in the provided MS SQL Server. c. Database Credentials Select the credential for this Auditor database. o o Windows Authentication (the default option) Use this method when you want the user identity to be confirmed by Windows. The specified account must have the permission of accessing the SQL Server machine where you want to create the auditor database. The user specified here must also have the following permission on the machine where SnapManager for SharePoint Manager will be installed: Log on as a batch job (which can be found in Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > User Rights Assignment). SQL Authentication SQL Server will confirm the user identity itself according to the specified account and password. The specified account must have the following permission: DB Owner of the existing DocAve auditor database or DB Creator of the newly created DocAve auditor database. d. Advanced Database Settings You can choose to associate the DocAve Auditor database with a specific failover SQL Server that is used in conjunction with SQL Server database mirroring. 29. Set up the Advanced Configuration. SSL Certification Specify the method for encrypting information and providing authentication for SnapManager for SharePoint: 44 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

45 Built-in Certificate Uses the certificate provided by SnapManager for SharePoint. No additional configuration is necessary. User-defined Certificate Enabling this option allows you to select a certificate from your local machine. Use the current machine s Certificate Authentication server to check whether the certificate is revoked; filter the certificates to display only certificates that are not revoked. 30. Click Next. 31. In the Ready to install SnapManager for SharePoint Manager page, all of the information configured in the previous steps is listed. Click Install to begin the installation. Click Back to change any of the previous settings. Click Cancel to abandon all configurations and exit the installation wizard. 32. When the Manager installation is completed, the Manager Passphrase you specified to protect SnapManager for SharePoint Manager data will be displayed on the Install Completed page. Save this passphrase as you need to enter it for the Agent installation. 33. After the installation is complete, click Finish to exit the installation wizard. SnapManager for SharePoint Control Service HA SnapManager for SharePoint Control Service HA can be achieved by installing SnapManager for SharePoint Control Service on multiple servers using the same Control Service database. If you install SnapManager for SharePoint Control Service on multiple servers within the same Windows Network Load Balanced cluster (a recommended practice), HA of SnapManager for SharePoint Control Service will be automatically performed by Windows operating system. Before using the SnapManager for SharePoint Control Service HA in this case, make sure the following requirements are met: o o o Enter the hostname or IP address of each individual server when installing SnapManager for SharePoint Control Service on the corresponding server. Use the Network Load Balanced cluster public IP address when installing other SnapManager for SharePoint Manager services. Use the Network Load Balanced cluster hostname and public IP address when accessing SnapManager for SharePoint. If you installed SnapManager for SharePoint Control Service on several separated servers, you must register the Agents and Media Service to the Control Service you want to access SnapManager for SharePoint with. Should that Control Service be unavailable, you must reregister the Agents and Media Service to another Control Service in order to continue to access SnapManager for SharePoint. *Note: A Report Location must be configured in Job Monitor before you can use the Log Manager and Job Monitor with SnapManager for SharePoint Control Service HA. Otherwise, each server where Control Service is installed will retain its own log for just the jobs carried out by the Control Service IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 45

46 installed on the server. For more information, refer to the SnapManager for SharePoint Job Monitor User s Guide. Installing SnapManager for SharePoint Agents Make sure the system requirements are met before starting the SnapManager for SharePoint Agent installation. For more information, refer to the System Requirements for Agent Service Installation section of this guide. Make sure that the SnapManager for SharePoint Manager services (Control Service, Media Service, and Report Service, if any) have started before installing the SnapManager for SharePoint Agents. SnapManager for SharePoint Agent can be installed on the following common Windows environments. Windows Server 2008 SP2 Windows Server 2008 R2 SP1 Windows Server 2012 Where to Install SnapManager for SharePoint Agents Refer to the table below for detailed information on where to install SnapManager for SharePoint and DocAve Agents. The specified locations to install the Agents are the basic requirements to enable all of the functions and configurations of each product. *Note: Platform Backup and Restore, Connector, Archive Manager, Storage Manager, and Connector all use SnapManager for SharePoint Agent types. All other products use DocAve Agent types. Product Suites Product Detailed Places to Install SnapManager for SharePoint Agents Data Protection Platform Backup & Restore SnapManager for SharePoint Agent must be installed on the following servers: The SharePoint Central Administration server The Search Service Application server where you want to back up the components of the specified Search Service Application The SharePoint Foundation (Help) Search server where you want to back up the components of the SharePoint Foundation (Help) Search Each SharePoint server where you want to back up the following objects: IIS Settings, SharePoint Hive, Global Assembly Cache, Custom Features, 46 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

47 Product Suites Product Detailed Places to Install SnapManager for SharePoint Agents SharePoint Site Definitions and Extra File System Folders Each FAST Search server where you want to back up the FAST Search server settings The server with Microsoft SQL Server installed Each node of Microsoft SQL Cluster (Each replica of the Microsoft SQL AlwaysOn Availability Groups if you are using SQL Server 2012) Storage Optimization Real-time/Scheduled Storage Manager (in RBS environment) SnapManager for SharePoint Agents must be installed on all of the front-end Web servers. SnapManager for SharePoint Agent must be installed on the server which installs the Office Web App service. Office Web App service includes Word Viewing Service Application, PowerPoint Service Application and Excel Calculation Services. If you installed the Microsoft SQL Server Reporting Services Add-in for Microsoft SharePoint technologies, and generated stubs for the Report Builder Model, you must install SnapManager for SharePoint Agent on the server which installs the add-in. Real-time/Scheduled Storage Manager (in EBS environment) SnapManager for SharePoint Agents must be installed on the SharePoint Central Administration server and all of the front-end Web servers. SnapManager for SharePoint Agent must be installed on the server which installs the Office Web App service. Office Web App service includes Word Viewing Service Application, PowerPoint Service Application and Excel Calculation Services. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 47

48 Product Suites Product Detailed Places to Install SnapManager for SharePoint Agents If you have installed the Microsoft SQL Server Reporting Services Add-in for Microsoft SharePoint technologies, and generated stubs for the Report Builder Model, you must install SnapManager for SharePoint Agent on the server that installs the add-in. Connector (in RBS environment) SnapManager for SharePoint Agents must be installed on all of the Frontend Web servers. SnapManager for SharePoint Agent must be installed on the server which installs the Office Web App service. Office Web App service includes Word Viewing Service Application, PowerPoint Service Application and Excel Calculation Services. If you have installed the Microsoft SQL Server Reporting Services Add-in for Microsoft SharePoint technologies, and generated stubs for the Report Builder Model, you must install SnapManager for SharePoint Agent on the server which installs the add-in. Connector (in EBS environment) SnapManager for SharePoint Agents must be installed on the SharePoint Central Administration server and all of the Front-end Web servers. SnapManager for SharePoint Agent must be installed on the server which installs the Office Web App service. Office Web App service includes Word Viewing Service Application, PowerPoint Service Application and Excel Calculation Services. If you have installed the Microsoft SQL Server Reporting Services Add-in for Microsoft SharePoint technologies, and generated stubs for the Report Builder 48 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

49 Product Suites Product Detailed Places to Install SnapManager for SharePoint Agents Model, you must install SnapManager for SharePoint Agent on the server which installs the add-in. Archive Manager SnapManager for SharePoint Agent must be installed on at least one of the Front-end Web servers. Agent Installation After the Manager s services have started, follow the steps below to install the SnapManager for SharePoint Agent. 1. Download the Agent installation application by requesting a demo version from the IBM N series support Website (accessed and navigated as described in Websites) or by contacting an IBM representative for a demo version of this software. 2. Save this application to a location on your system (for example, C:\temp). Double-click the saved application. 3. From the welcome screen, click Next. 4. Enter your name and organization into the provided fields. 5. Click Next. 6. Carefully review the SnapManager for SharePoint License Agreement. 7. After you have read the terms in the license agreement, check the I accept the terms in the license agreement checkbox and click Next. *Note: You can navigate to the Agent installation path \SMSP8\Agent\lic\ to check all of the demo license agreements with different versions. 8. Click the Browse button. Select the location for the Agent installation. By default, the installation location is C:\Program Files\IBM\SMSP8. Click Next. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 49

50 9. SnapManager for SharePoint will perform a brief pre-scan of the environment to ensure that all rules meet the requirements. The status for each rule will be listed in the Status column. Click the hyperlink of the status, the detailed information about the scan result will be listed in the popup window. Figure 12: Scanning for Agent installation rules 10. Click Details and you can view the detailed information of all of the requirements. 11. Update your environment to meet the requirements if there are some rules checked that failed. Click the Rescan button to check your environment again. 12. After all rules pass, click Next. 50 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

51 13. Prior to setting up the Communication Configuration between the Agent host and the Control Service host, you must ensure the following requirements are met: The Control service has been installed on a specific machine which can communicate with the current server. The current server s Internet Explorer browser is not using a proxy server. Figure 13: Configuring Agent communication a. SnapManager for SharePoint Agent Host Specify the current server s hostname, IP address, or fully qualified domain name (FQDN). b. SnapManager for SharePoint Agent Port The port specified here is used by the Manager or other Agents for communication. The default port number is c. Control Service Host The hostname or IP address of the machine where the Control Service is installed. d. Control Service Port This is the port used for communication with Control Service and should match the information provided during the Manager configuration. The default port number is e. SSL Certification Specify the SSL Certification used for the specified SnapManager for SharePoint Manager. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 51

52 14. Click Next. 15. Set up the Agent Configuration: a. Agent Authentication Specify the Manager Passphrase specified when configuring the SnapManager for SharePoint Manager installation. If you forget the passphrase, you can view it by navigating to SnapManager for SharePoint > Control Panel > System Settings > System Options > Security Settings. For more information, refer to the SnapManager for SharePoint Control Panel User s Guide. b. Agent Account Specify the Agent account under which the Agent activities are performed. For detailed information on the permissions required for each SnapManager for SharePoint product, refer to Required Permissions for SnapManager for SharePoint Products. Below are the ideal account permissions for all SnapManager for SharePoint products. Local System Permissions The specified Agent Account will be granted Full control permission to the following groups and folders during SnapManager for SharePoint Agent installation. Member of the following groups: o IIS_WPG (for IIS 6) or IIS_IUSRS (for IIS 7 and IIS 8) o o Performance Monitor Users SnapManager for SharePoint Users (the group is created by SnapManager for SharePoint automatically and has the following permissions) SharePoint Permissions Full control to the Registry of HKEY_LOCAL_MACHINE\SOFTWARE\IBM\SnapManager for SharePoint 8. Full control to the Registry of HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\eventlog. Full control to the Communication Certificate. Permission of Log on as a batch job (it can be found within Control Panel\Administrative Tools\Local Security Policy\Security Settings\Local Policies\User Rights Assignment) Full control permission of SnapManager for SharePoint Agent installation directory o o o Member of the Farm Administrators group Full Control permission to all zones of all Web applications via User Policy for Web Applications User Profile Service Application permissions: 52 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

53 Use Personal Features Create Personal Site Use Social Features o o o Managed Metadata Service: Term Store Administrator Business Data Connectivity Service: Full Control Search Service: Full Control SQL Server Permissions o o Database Role of db_owner for all of the databases related with SharePoint, including content databases, SharePoint configuration database and Central Admin database. Database Role of dbcreator and Security Admin to SQL Server. 16. Click Next. 17. In the Ready to install SnapManager for SharePoint Agent page, review the customer information you defined then 18. Click Install to begin the installation. Click Back to change any of the previous settings. Click Cancel to abandon all configurations and exit the installation wizard. 19. After the installation is complete, click Finish to exit the installation wizard. SnapManager for SharePoint is now installed and configured. After you have completed the product installation, you can begin to configure logical and physical devices needed to store backup data. Skipping Environment Scanning *Note: It is not recommended that you skip environment scanning. SnapManager for SharePoint provides a method to skip environment scanning during Manager installation and Agent installation. Make sure that all system requirements are met if you want to skip environment scanning. Otherwise, it is not guaranteed that SnapManager for SharePoint will work properly after installation. Skipping Environment Scanning for SnapManager for SharePoint Manager Follow the instructions below to skip environment scanning for SnapManager for SharePoint Manager. 1. In the command-line interface (CLI), change the directory to the extracted SnapManager for SharePoint Manager package where the Setup.exe file resides. 2. Enter the following command to skip environment scanning. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 53

54 To skip system information scanning during SnapManager for SharePoint Manager installation, enter the following command to launch the Manager installation program: Setup.exe -SkipRuleChecking To skip SQL Server version scanning during SnapManager for SharePoint Manager installation, enter the following command to launch the Manager installation program: Setup.exe -SkipSQLChecking To skip both system information scanning and SQL Server version scanning during SnapManager for SharePoint Manager installation, enter the following command to launch the Manager installation program: Setup.exe -SkipRuleChecking -SkipSQLChecking The scan status of each requirement displays Skip in the Installation Rule Scanning step during Manager installation. Skipping Environment Scanning for SnapManager for SharePoint Agent Follow the instructions below to skip environment scanning for SnapManager for SharePoint Agent. 1. In the Command Line Interface, change the directory to the extracted SnapManager for SharePoint Agent package where the Setup.exe file resides. 2. To skip system information scanning during SnapManager for SharePoint Agent installation, enter the following command to launch the Agent installation program: Setup.exe - SkipRuleChecking The scan status of each requirement displays Skip in the Installation Rule Scanning step during Agent installation. Unattended Installation SnapManager for SharePoint Manager Make sure the system requirements are met before starting the SnapManager for SharePoint Manager unattended installation. For more information, refer to the SnapManager for SharePoint Manager System Requirements section of this guide. In the Command Prompt, execute the following unpack command to get all of the files required by the SMSP Manager unattended installation: Path of the SMSP Manager installation EXE file unpack Path where you want to store the extracted files of the SMSP Manager installation EXE file For example, execute the following command in the Command Prompt: C:\Users\SMSP\Desktop\Manager_serial_number unpack C:\Users\SMSP\Desktop\Extracted_Manager_Installation_Package 54 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

55 Generating the Installation Answer File for SnapManager for SharePoint Manager The Answer file is an XML file that provides configuration information required for the unattended installation. Before performing the unattended installation, the Answer file must be generated using the SnapManager for SharePoint Setup Manager. Navigate to the \UnattendedInstall\SetupManager folder inside the unzipped Manager installation package, and double click SetupManager.exe to run it. You will be guided through the following steps. 1. After being presented with the welcome screen, click Next. 2. SnapManager for SharePoint overview page appears. Click Next. 3. Select Create a new answer file for SnapManager for SharePoint Manager to create a new Answer file for SnapManager for SharePoint Manager. Modify an existing answer file Select this option to reuse an existing Answer file. If this is selected, the path field will be enabled. Enter the full path of the answer file is or click Browse to browse for an Answer file. For example, C:\AnswerFile.xml *Note: It is recommended that you create a generic Answer file so that it can be reused later with modification. 4. Click Next. 5. Carefully review the SnapManager for SharePoint License Agreement. 6. After you have read the terms in the license agreement, check the I accept the terms in the license agreement. checkbox to agree to the terms. Click Next. 7. Enter your name and the organization into the provided field. Click Next to continue the configuration. Click Back to go back to the previous interface. 8. Choose whether to install additional modules Connector, Archive Manager, and Storage Manager as a set. 9. Choose whether to install and evaluate other products Migration, Administration, Governance, Compliance, Replication, Content and Deployment Management, Reporting and Auditing. 10. The License Agreement appears if you choose to install and evaluate other products in the previous step. Carefully review the License Agreement. After you have read the agreement, check the I accept the terms in the license agreement checkbox, and click Next. 11. Set up the installation location using the following conditions. a. Default directory The SnapManager for SharePoint Manager will be installed to the default installation location on the specified destination server, which is \Program Files\IBM\SMSP8\Manager. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 55

56 b. Customized directory If you select this option, enter a customized path in the Installation Path field where you wish to install the SnapManager for SharePoint Manager on the destination server. o Use the default directory if your customized directory is invalid Enable this option to install SnapManager for SharePoint Manager to the default directory should the path you defined for customized directory be invalid. For example, if the drive indicated by the path you specified does not exist on the destination server. 12. Select the SnapManager for SharePoint Manager services you want to install. There are three services you can install. 13. Click Next. a. Control Service Manages all SnapManager for SharePoint operations and achieve the Web-based SnapManager for SharePoint platform, allowing users to interact with the software. All Agents communicate with the manager via the Control Service, so it is imperative that the machine you install the Control Service on is accessible by all Agent machines. This service can be run on a Windows Network Load Balanced cluster to ensure HA; if the Control Service is unavailable, a standby service in the cluster would be enabled by an administrator. For more information, refer to the SnapManager for SharePoint Control Service section of this guide. b. Media Service Performs assistant jobs such as managing the retention rules and managing the backup job data. This service can be installed on multiple machines. Using multiple Media Services allows for HA and load-balanced access to the data storage locations. c. Report Service (only if running an evaluation of DocAve Report Center) Report Service manages all SharePoint data collection and management, monitor SharePoint activities and return the data to the Control Service for processing. This must be configured with the associated SQL databases and SQL Report Services. This service is critical for using the DocAve Report Center module. Report Service is disabled if you do not select to evaluate AvePoint products. *Note: SnapManager for SharePoint Report service can be installed on multiple servers and can be load balanced. However, all Report services must share the same Report Database and Auditor Database. 14. Set up the Control Service Configuration: a. IIS Web Site Settings Configure the IIS Web site settings for the Control Service. The IIS Web site is used to access SnapManager for SharePoint Manager. o IIS web site Enter the Web site name and create a new IIS Web site for the Control Service. The default Web Site Port used to access SnapManager for SharePoint Control Service is 14000; you do not need to change it unless a 56 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

57 known port conflict exists. Note that the Web site name will only be checked during installation. o Web Site Port Control Service communication port. The default port is b. Application Pool Settings Configure the IIS application pool settings for the corresponding Web site. The application pool is used to handle the requests sent to the corresponding Web site. o o Application pool Enter the application pool name for the corresponding Web site. Application Pool Account Enter an application pool account to be the administrator of the specified application pool, and the corresponding password. *Note: The application pool account for connecting an existing IIS Web site or creating a new IIS Web site must have the following Local System Permissions: Member of the following local group: IIS_WPG (for IIS 6) or IIS_IUSRS (for IIS 7 and IIS 8) Full control to HKEY_LOCAL_MACHINE\SOFTWARE\IBM\SnapManager for SharePoint 8 Full control to SnapManager for SharePoint Manager folder Member of the Performance Monitor Users group Full control to SnapManager for SharePoint Certificate private keys You can add the application pool account to the local Administrators group to meet the required permissions. 15. Click Next to continue to configure the database settings for the Control Service. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 57

58 16. Configure a database for storing the relevant data of Control Service. Figure 14: Control service configuration page a. Database Type Only MS SQL Server is supported to serve as the database server for Control Service. b. Database Server Enter the MS SQL Server name. c. Control Service Database Name Enter a database name for the Control Service; if the database does not exist, it will be created in the provided MS SQL Server. d. Database Credentials Select the credential for this Control Service database. o Windows Authentication (the default option) Use this method when you want the user identity to be confirmed by Windows. The specified account must have the necessary permission to access the SQL Server machine where you want to create the Control Service database. The user specified here must also have the following permission on the machine where SnapManager for SharePoint Manager will be installed: Log on as a batch job (which can be found in Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > User Rights Assignment). 58 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

59 17. Click Next. o SQL Authentication SQL Server will confirm the user identity itself according to the specified account and password. The specified account must have the following permission: DB Owner of the existing SnapManager for SharePoint control database or DB Creator of the newly created SnapManager for SharePoint control database. e. Passphrase Settings Enter the passphrase you want to use for protecting SnapManager for SharePoint Manager data. f. Advanced Database Settings You can choose to associate the SnapManager for SharePoint Control database with a specific failover SQL Server that is used in conjunction with SQL Server database mirroring. 18. Set up the Media Service Configuration. 19. Click Next. a. Media Service Port Used for communicating with the other SnapManager for SharePoint services. The default port is b. Media Service Data Port Transmit the data between SnapManager for SharePoint and the storage device. The default port is c. Use a random port number if the specified one is being used Enable this option to have the SnapManager for SharePoint Manager installation program generate a random port if the Media Service Port or Media Service Data Port you specified is being used by other applications. 20. Set up the Report Service Configuration (only if running an evaluation of DocAve Report Center). a. Report Service Port The port number for Report Service. The default port is b. Use a random port number if the specified one is being used If enable this option, SnapManager for SharePoint Manager installation program will generate a random port if the specified Report Service Port is being used by other applications. 21. Click Next to continue to configure the database settings for Report Service. 22. For the report service database (only if running an evaluation of DocAve Report Center), you can select to use the previous database settings or configure it yourself. a. Use the previous database settings If you select this option, the previous database settings for Control database will be used for the report database. To set a database for report service only, the following information must be configured. a. Database Type Only MS SQL Server is supported to serve as the database server for Report Service. b. Database Server Enter the MS SQL Server name. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 59

60 c. Report Service Database Name Enter a database name for the Report Service, if the database does not exist, it will be created in the provided MS SQL Server. d. Database Credentials Select the credential for this Control Service database. o o Windows Authentication (the default option) Use this method when you want the user identity to be confirmed by Windows. The specified account must have the necessary permission to access the SQL Server machine where you want to create the report service database. The user specified here must also have the following permission on the machine where SnapManager for SharePoint Manager will be installed: Log on as a batch job (which can be found in Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > User Rights Assignment). SQL Authentication SQL Server will confirm the user identity itself according to the specified account and password. The specified account must have the following permission: DB Owner of the existing DocAve report service database or DB Creator of the newly created DocAve report service database. e. Advanced Database Settings You can choose to associate the SnapManager for SharePoint Report database with a specific failover SQL Server that is used in conjunction with SQL Server database mirroring. 23. Click Next to continue to configure the Auditor database settings for the Report Service. 24. For the Auditor database (only if running an evaluation of DocAve Report Center), you can select to use the previous database settings or configure it yourself. a. Use the previous database settings If you select this option, the previous database server for Control Service will be used for the auditor database. To set an auditor database for report service only, the following information must be configured. a. Database Type Only MS SQL Server is supported to serve as the database server for Report Service. b. Database Server Enter the MS SQL Server name. *Note: It is recommended to create the DocAve Auditor database on a different SQL Server than the SQL Server that stores the SharePoint databases. Since Auditor Controller retrieves data from the SharePoint Auditor database, if you have DocAve Auditor Controller retrieving data on a frequent schedule, as the amount of data in the SharePoint Auditor database grows, a large amount of disk space will be taken up on the SQL Server machine. This can cause performance issues for both the SQL Server and SharePoint. c. Auditor Database Name Enter a database name for the Auditor database, if the database does not exist, it will be created in the provided MS SQL Server. 60 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

61 d. Database Credentials Select the credential for this Auditor database. o o Windows Authentication (the default option) Use this method when you want the user identity to be confirmed by Windows. The specified account must have the necessary permissions to access the SQL Server machine where you want to create the auditor database. The user specified here must also have the following permission on the machine where SnapManager for SharePoint Manager will be installed: Log on as a batch job (which can be found in Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > User Rights Assignment). SQL Authentication SQL Server will confirm the user identity itself according to the specified account and password. The specified account must have the following permission: DB Owner of the existing DocAve 6 auditor database or DB Creator of the newly created DocAve 6 auditor database. e. Advanced Database Settings You can choose to associate the DocAve Auditor database with a specific failover SQL Server that is used in conjunction with SQL Server database mirroring. 25. After all of the required information has been configured, click Save and specify the path you want to save the Answer file to. You can also modify the Answer file s name in the pop-up window. Performing the SnapManager for SharePoint Manager Unattended Installation See the instructions below for information on performing the SnapManager for SharePoint unattended installation. Import the UnattendedInstallation.dll File Before performing the SnapManager for SharePoint Manager unattended installation, the UnattendedInstallation.dll file must be imported into Windows PowerShell using either of the two methods below. *Note: If the UnattendedInstallation.dll file does not import successfully, use the Set-ExecutionPolicy command to set the execution policy to Unrestricted, RemoteSigned, or AllSigned in Windows PowerShell, and then perform the import again using either of the two methods below. To manually import the UnattendedInstallation.dll file, complete the steps below. 1. Click Start on the server with the unzipped Manager installation package residing in, and find Windows PowerShell. Right click on it, and select Run as administrator to run it. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 61

62 2. Change the current directory to the \UnattendedInstall\PowerShellModules folder inside the unzipped Manager installation package. Figure 15: Changing directory in PowerShell 3. Enter the following command, and press Enter to import the UnattendedInstallation.dll file: Import-Module \UnattendedInstall\PowerShellModules\UnattendedInstallation.dll Figure 16: Importing UnattendedInstallation.dll file *Note: The warning message displayed in the screen above is caused by some terminologies in the UnattendedInstallation.dll file violating Windows PowerShell s naming convention. It has no effect on file importing. The UnattendedInstallation.dll file is imported successfully. To automatically import the UnattendedInstallation.dll file: 1. Navigate to the \UnattendedInstall\PowerShellModules folder inside the unzipped Manager installation package 2. Right click on the UnattendedInstallationLauncher.bat file, and select Run as administrator to run it. Now that you have imported the UnattendedInstallation.dll file, you can use the commands in the following sections to check your environment, perform the manager installation and configure settings. See the sections below for information on SnapManager for SharePoint unattended installation command parameters. Environment Checking Command Before executing SnapManager for SharePoint Manager installation command, you can use the Check- ManagerEnvironment command to check whether the destination server you want to install SnapManager for SharePoint Manager meets the SnapManager for SharePoint Manager System Requirements. 62 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

63 *Note: The Check-ManagerEnvironment command is not available when the destination machine uses Windows Server 2008 R2 Server Core Operating System. For example: Check-ManagerEnvironment -TargetName Username IBM SMSP -Password Password - CheckEnvironmentFilePath C:\SMSP_Manager\SMSP.dat -AnswerFilePath "C:\AnswerFile.xml"- ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where you want to install the SnapManager for SharePoint Manager. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where you want to install the SnapManager for SharePoint Manager. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -CheckEnvironmentFilePath Required The local path of the SnapManager for SharePoint.dat file that is residing in the unzipped IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 63

64 Parameter Type Description SnapManager for SharePoint Manager installation package. The path must be detailed to the name of the data file. For example, C:\SMSP_Manager\ SnapManager for SharePoint.dat. -AnswerFilePath Required The local path where you saved the Answer file. The path must be detailed to the name of the Answer file. For example, C:\AnswerFileManager.xml. -RemoteTempPath Required A local path on the destination machine that the SnapManager for SharePoint Manager is installed to. The format of the path is: C:\temp. The path will be used to store the temporary files generated during the SnapManager for SharePoint Manager unattended installation. The temporary files will be deleted as soon as the unattended installation finishes. -ProductType Required This parameter is used to identify the product you are installing. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the environment checking logs will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Manager is installed. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the 64 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

65 Parameter Type Description source machine to receive the data from the destination machine. This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. Installation Command The SnapManager for SharePoint Manager Unattended Installation command for installing SnapManager for SharePoint Manager remotely is Install-DAManager. For example: Install-DAManager -TargetName Username IBM\SMSP -Password Password - PackageFilesFolder "C:\SMSP_Manager" -AnswerFilePath "C:\AnswerFile.xml" -RemoteTempPath C:\TempFolder -ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where you want to install the SnapManager for SharePoint Manager. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where you want to install the SnapManager for SharePoint Manager. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 65

66 Parameter Type Description permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -PackageFilesFolder Required The local path on the machine where you run the command. The specified path stores the unzipped SnapManager for SharePoint Manager installation package (Manager ZIP file). The format of the path is: C:\package. Quote the path if it contains any special character or space. -AnswerFilePath Required The local path where you saved the Answer file. The path must be detailed to the name of the Answer file. For example, C:\AnswerFile.xml. -RemoteTempPath Required A local path on the destination machine that the SnapManager for SharePoint Manager is installed to. The format of the path is: C:\temp. The path will be used to store the temporary files generated during the SnapManager for SharePoint Manager unattended installation. The temporary files will be deleted as soon as the unattended installation finishes. -ProductType Required This parameter is used to identify the product you are installing from other AvePoint s products. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the logs of the unattended installation will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination 66 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

67 Parameter Type Description machine that the SnapManager for SharePoint Manager is installed. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. Getting Configuration Information Command Use the Get-DAManagerConfigInfo command to retrieve the configuration information of SnapManager for SharePoint Manager remotely. You can also retrieve the configuration information of the Manager installed locally through the use of the installation wizard. Below is an example of the Get-DAManagerConfigInfo command: Get-DAManagerConfigInfo -TargetName Username IBM\SMSP -Password Password - ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where has SnapManager for SharePoint Manager installed. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where has SnapManager for SharePoint Manager installed. The format of the username is: domain\username. The permissions of the user specified here are as follows: IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 67

68 Parameter Type Description If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -ProductType Required This parameter is used to identify the product you are installing. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the configuration information logs will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -AnswerFilePath Optional This is an optional parameter. If used, the configuration information you get by the Get- DAManagerConfigInfo command will be exported to the.xml file in the specified path. Only the.xml file is supported by this parameter. The content format of the generated.xml file is the same as the Manager Answer File. The path specified in this parameter must be detailed to the name of the log file. For example, C:\ManagerConfigInfor.xml. There must be no.xml file with the same name existing in the specified path. 68 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

69 Parameter Type Description -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Manager is installed. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 69

70 Configuring Configuration Information Command Use the Config-DAManagerConfigInfo command to modify the configuration information of SnapManager for SharePoint Manager remotely. You can also modify the configuration information of the Manager installed locally through the use of the installation wizard. For example: Config-DAManagerConfigInfo -TargetName Username IBM\SMSP -Password Password - UseControlServiceFailoverDatabse true -UseWindowsAuthenticationForControlServiceDatabase true - ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine that has the SnapManager for SharePoint Manager installed. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where you want to install the SnapManager for SharePoint Manager. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the 70 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

71 Parameter Type Description Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -ControlServiceHost Optional If the host or IP of the destination server that has Control Service installed is changed, use this parameter to change the host or IP of the Control Service to the new one. -WebsiteName Optional The name of the new website you want to use for the SnapManager for SharePoint Manager Control Service installed on the destination machine. You can use an existing IIS website or create a new IIS website. -WebsitePort Optional The new Web site port you want to use for the SnapManager for SharePoint Manager installed on the destination machine. -ApplicationPoolName Optional The name of the new application pool you want to use for the IIS Website for the Control Service. You can either use an existing application pool or create a new one. If you want to create a new application pool with this parameter, you must specify the username and password of the account to authenticate the application pool with the two parameters below. ApplicationPoolUsername Optional The username of the new account you want to use to authenticate the application pool specified above. *Note: If you create a new application pool with-applicationpoolname, ApplicationPoolUsername must be configured. ApplicationPoolPassword Optional The password of the account to authenticate the specified application pool. *Note: If you create a new application pool with-applicationpoolname, ApplicationPoolUsername must be configured. -ControlDatabaseServer Optional The new server you want to use for the IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 71

72 Parameter Type Description Control database. *Note: The specified server must have an existing database of the same type with the Control database. And you must configure the passphrase for the new Control database with ControlPassphrase. -ControlDatabaseName Optional The new database you want to use as the Control database. *Note: The specified database must be an existing database of the same type with the Control database. And you must configure the passphrase for the new Control database with ControlPassphrase. -ControlPassphrase Optional The passphrase for the Control database specified above. *Note: If ControlDatabaseServer or ControlDatabaseName is used, - ControlPassphrase must be configured. -UseControlFailoverDatabase Optional Enable the failover database server function for the Control database. If the Control database on the destination machine is not associating a failover database server, set the value of this parameter to True allows you to specify a failover database server in the following parameter. -ControlFailoverDatabase Optional The failover SQL Server you want to associate to the Control database. - UseWindowsAuthenticationForControl Database Optional Using this parameter to change the authentication of the Control Service database between Windows Authentication and SQL Authentication. If the current authentication being used in the destination Control Service database is Windows Authentication, you can set the value of this parameter to False to change the authentication to SQL Authentication, and vice versa. -ControlDatabaseUsername Optional The new account you want to use to authenticate the Control Service database on the destination machine. *Note: If the parameter 72 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

73 Parameter Type Description UseWindowsAuthenticationForControlD atabase is used, ControlDatabaseUsername must be configured. -ControlDatabasePassword Optional The password of the user specified above. *Note: If the parameter UseWindowsAuthenticationForControlD atabase is used, ControlDatabasePassword must be configured. Quote the password if it contains any special character or space. -MediaServiceHost Optional If the host or IP of the destination server that has Media Service installed is changed, use this parameter to change the host or IP of the Media Service to the new one. -MediaServicePort Optional The new port you want to use for the Media Service. -MediaServiceDataPort Optional The new data port you want to use for the Media Service. -MediaControlServiceHost Optional If the host of the Control Service that the Media Service is registered in is changed, use this parameter to change the host of the Control Service to the new one. -MediaControlServicePort Optional If the port of the Control Service that the Media Service is registered in is changed, use this parameter to change the port of the Control Service to the new one. -ReportServiceHost (Only if running an evaluation of DocAve Report Center) -ReportServicePort (Only if running an evaluation version of DocAve Report Center) -ReportControlServiceHost (Only if running an evaluation version of DocAve Report Center) Optional Optional Optional If the host or IP of the destination server that has Report Service installed is changed, use this parameter to change the host or IP of the Report Service to the new one. The new port you want to use for the Report Service. If the host of the Control Service that the Report Service is registered in is changed, use this parameter to change the host of the Control Service to the new one. -ReportDatabaseServer Optional The new server you want to use for the Report database. *Note: The specified server must have an existing database of the same type with the Report database. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 73

74 Parameter Type Description -ReportDatabaseName Optional The new database you want to use as the Report database. *Note: The specified database must be an existing database of the same type with the Report database. -ReportControlServicePort (Only if running an evaluation version of DocAve Report Center) -UseReportFailoverDatabase (Only if running an evaluation version of DocAve Report Center) -ReportFailoverDatabase (Only if running an evaluation version of DocAve Report Center) - UseWindowsAuthenticationForReport Database (Only if running an evaluation version of DocAve Report Center) -ReportDatabaseUsername (Only if running an evaluation version of DocAve Report Center) -ReportDatabasePassword (Only if running an evaluation version of DocAve Report Center) Optional Optional Optional Optional Optional Optional If the port of the Control Service that the Report Service is registered in is changed, use this parameter to change the port of the Control Service to the new one. Enable the failover database server function for the Report database. If the Report database on the destination machine is not associating a failover database server, set the value of this parameter to True allows you to specify a failover database server in the following parameter. The failover SQL Server you want to associate to the Report database. *Note: if the parameter UseReportFailoverDatabase is used, ReportFailoverDatabase must be configured. Using this parameter to change the authentication of the Report Service database between Windows Authentication and SQL Authentication. If the current authentication being used in the destination Report Service database is Windows Authentication, you can set the value of this parameter to False to change the authentication to SQL Authentication, and vice versa. The new account you want to use to authenticate the Report Service database on the destination machine. *Note: If the parameter UseWindowsAuthenticationForReportSe rvicedatabase is used, the ReportDatabaseUsername must be configured. The password of the user specified above. *Note: If the parameter UseWindowsAuthenticationForReportSe 74 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

75 Parameter Type Description rvicedatabase is used, the ReportDatabasePassword must be configured. Quote the password if it contains any special character or space. -AuditorDatabaseServer Optional The new server you want to use for the Auditor database. *Note: The specified server must have an existing database of the same type with the Auditor database. -AuditorDatabaseName Optional The new database you want to use as the Auditor database. *Note: The specified database must be an existing database of the same type with the Auditor database. -UseAuditorFailoverDatabase (Only if running an evaluation version of DocAve Report Center) -AuditorFailoverDatabase (Only if running an evaluation version of DocAve Report Center) - UseWindowsAuthenticationForAuditor Database (Only if running an evaluation version of DocAve Report Center) -AuditorDatabaseUsername (Only if running an evaluation version of DocAve Report Center) Optional Optional Optional Optional Enable the failover database server function for the Auditor database. If the Auditor database on the destination machine is not associating a failover database server, set the value of this parameter to True allows you to specify a failover database server in the following parameter. The failover SQL Server you want to associate to the Auditor database. *Note: If the parameter UseAuditorFailoverDatabase is used, the AuditorFailoverDatabase must be configured. Using this parameter to change the authentication of the Auditor database between Windows Authentication and SQL Authentication. If the current authentication being used in the destination Auditor database is Windows Authentication, you can set the value of this parameter to False to change the authentication to SQL Authentication, and vice versa. The new account you want to use to authenticate the Auditor database on the destination machine. *Note: If the parameter UseWindowsAuthenticationForAuditorD atabase is used, the IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 75

76 Parameter Type Description AuditorDatabaseUsername must be configured. -AuditorDatabasePassword (Only if running an evaluation version of DocAve Report Center) Optional The password of the user specified above. Quote the password if it contains any special character or space. *Note: If the parameter UseWindowsAuthenticationForAuditorD atabase is used, the AuditorDatabasePassword must be configured. -ProductType Required This parameter is used to identify the product you are installing from other AvePoint s products. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the configuration information logs will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Manager is installed. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. 76 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

77 Parameter Type Description This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. Verifying Configuration Information Command Use the Verify-DAManagerConfigInfo command to verify the configuration information you want to use for SnapManager for SharePoint Manager is valid or not remotely. You can also verify the configuration information of the Manager installed locally through the use of the installation wizard. *Note: The Verify-DAManagerConfigInfo command is not available when the destination machine uses Windows Server 2008 R2 Server Core Operating System. Below is an example of the Verify-DAManagerConfigInfo command: Verify -DAManagerConfigInfo -TargetName Username IBM\SMSP -Password Password - UseControlServiceFailoverDatabse true -UseWindowsAuthenticationForControlServiceDatabase true - ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where has the SnapManager for SharePoint Manager installed. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where you want to install the SnapManager for SharePoint Manager. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 77

78 Parameter Type Description administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -ControlServiceHost Optional The Control Service host or IP you want to verify for the destination machine. -WebsiteName Optional The name of the new website you want to verify for the SnapManager for SharePoint Manager Control Service installed on the destination machine. You can verify an existing IIS website or a new IIS website needed to be created. -WebsitePort Optional The Web site port you want to verify for the SnapManager for SharePoint Manager installed on the destination machine. -ApplicationPoolName Optional The name of the new application pool you want to verify for the IIS website for the Control Service. You can either verify an existing application pool or a new one to be created. If you want to verify a new application pool to be created, you must specify the username and password of the account to authenticate the application pool with the two parameters below. -ApplicationPoolUsername Optional The username of the new account you want to verify to authenticate the application pool specified above. *Note: If you want to verify a new application pool to be created with- ApplicationPoolName, 78 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

79 Parameter Type Description ApplicationPoolUsername must be configured. ApplicationPoolPassword Optional The password of the account to authenticate the specified application pool. *Note: If you want to verify a new application pool to be created with- ApplicationPoolName, ApplicationPoolUsername must be configured. -ControlDatabaseServer Optional The new server you want to verify for the Control database. *Note: The specified server must have an existing database of the same type with the Control database. And you must configure the passphrase for the new Control database with ControlPassphrase. -ControlDatabaseName Optional The new database you want to verify as the Control database. *Note: The specified database must be an existing database of the same type with the Control database. And you must configure the passphrase for the new Control database with ControlPassphrase. -ControlPassphrase Optional The passphrase for the Control database specified above. *Note: If ControlDatabaseServer or ControlDatabaseName is used, - ControlPassphrase must be configured. -UseControlFailoverDatabase Optional Set True or False as the value of this parameter and verify whether you can specify a failover SQL Server for the Control database. -ControlFailoverDatabase Optional Set the host or IP address of the failover SQL Server as the value of this parameter and verify whether the specified SQL Server is available. - UseWindowsAuthenticationForControl Database Optional Set True or False as the value of this parameter and verify whether you can use Windows Authentication for the Control database. -ControlDatabaseUsername Optional Verifying the account you want to use to authenticate the Control Service database on the destination machine. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 79

80 Parameter Type Description -ControlDatabasePassword Optional Verifying the password for the specified account above. Quote the password if it contains any special character or space. -MediaServiceHost Optional The Media Service host or IP you want to verify for the destination machine. -MediaServicePort Optional The Media Service port you want to verify for the SnapManager for SharePoint Manager installed on the destination machine. -MediaServiceDataPort Optional The Media Service data port you want to verify for the SnapManager for SharePoint Manager installed on the destination machine. -MediaControlServiceHost Optional Verifying the host or IP of the Control Service that the Media Service is registered in. -MediaControlServicePort Optional Verifying the port of the Control Service that the Media Service is registered in. -ReportServiceHost (Only if running an evaluation version of DocAve Report Center) -ReportServicePort (Only if running an evaluation version of DocAve Report Center) -ReportControlServiceHost (Only if running an evaluation version of DocAve Report Center) -ReportControlServicePort (Only if running an evaluation version of DocAve Report Center) Optional Optional Optional Optional The Report Service host or IP you want to verify for the destination machine. The Report Service port you want to verify for the DocAve Manager installed on the destination machine. Verifying the host or IP of the Control Service that the Report Service is registered in. Verifying the port of the Control Service that the Report Service is registered in. -ReportDatabaseServer Optional The new server you want to verify for the Report database. *Note: The specified server must have an existing database of the same type with the Report database. -ReportDatabaseName Optional The new database you want to verify as the Report database. *Note: The specified database must be an existing database of the same type with the Report database. -UseReportFailoverDatabase (Only if running an evaluation version of DocAve Report Center) Optional Set True or False as the value of this parameter and verify whether you can specify a failover SQL Server for the Report database. 80 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

81 Parameter Type Description -ReportFailoverDatabase (Only if running an evaluation version of DocAve Report Center) Optional Set the host or IP address of the failover SQL Server as the value of this parameter and verify whether the specified SQL Server is available. - UseWindowsAuthenticationForReportD atabase (Only if running an evaluation version of DocAve Report Center) -ReportDatabaseUsername (Only if running an evaluation version of DocAve Report Center) -ReportDatabasePassword (Only if running an evaluation version of DocAve Report Center) Optional Optional Optional Set True or False as the value of this parameter and verify whether you can use Windows Authentication for the Report database. Verifying the account you want to use to authenticate the Report Service database on the destination machine. Verifying the password for the specified account above. Quote the password if it contains any special character or space. -AuditorDatabaseServer Optional The new server you want to verify for the Auditor database. *Note: The specified server must have an existing database of the same type with the Auditor database. -AuditorDatabaseName Optional The new database you want to verify as the Auditor database. *Note: The specified database must be an existing database of the same type with the Auditor database. -UseAuditorFailoverDatabase (Only if running an evaluation version of DocAve Report Center) -AuditorFailoverDatabase (Only if running an evaluation version of DocAve Report Center) - UseWindowsAuthenticationForAuditor Database (Only if running an evaluation version of DocAve Report Center) -AuditorDatabaseUsername (Only if running an evaluation version of DocAve Report Center) -AuditorDatabasePassword (Only if running an evaluation version of DocAve Report Center) Optional Optional Optional Optional Optional Set True or False as the value of this parameter and verify whether you can specify a failover SQL Server for the Auditor database. Set the host or IP address of the failover SQL Server as the value of this parameter and verify whether the specified SQL Server is available. Set True or False as the value of this parameter and verify whether you can use Windows Authentication for the Auditor database. Verifying the account you want to use to authenticate the Auditor Service database on the destination machine. Verifying the password for the specified account above. Quote the password if it contains any special character or space. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 81

82 Parameter Type Description -ProductType Required This parameter is used to identify the product you are installing. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the verifying configuration log information will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Manager is installed. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. 82 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

83 Unattended Installation - SnapManager for SharePoint Agent The SnapManager for SharePoint Agent can be installed remotely using the unattended installation after the Manager s services have started. Make sure the system requirements are met before starting the SnapManager for SharePoint Agent unattended installation. For more information, refer to the System Requirements for Agent Service Installation section of this guide. For more information on where to install the SnapManager for SharePoint Agents, refer to Where to Install SnapManager for SharePoint Agents. In the Command Prompt, execute the following unpack command to get all of the files required by the SMSP Agent unattended installation: Path of the SMSP Agent installation EXE file unpack Path where you want to store the extracted files of the SMSP Agent installation EXE file For example, execute the following command in the Command Prompt: C:\Users\SMSP\Desktop\Agent_serial_number unpack C:\Users\SMSP\Desktop\Extracted_Agent_Installation_Package Generating the Installation Answer File for SnapManager for SharePoint Agent The Answer file is an XML file which provides configuration information required for the unattended installation. Before performing the unattended installation, the Answer file must be generated using the SnapManager for SharePoint Setup Manager. Navigate to the \UnattendedInstall\SetupManager folder inside the unzipped Manager installation package, and double click SetupManager.exe to run it. You will be guided through the following steps. 1. After being presented with the welcome screen, click Next. 2. SnapManager for SharePoint overview page appears. Click Next. 3. Select Create a new answer file for SnapManager for SharePoint Agent to create a new Answer file for SnapManager for SharePoint Agent Modify an existing answer file Select this option to reuse an existing Answer file. If this is selected, the path field will be enabled. Enter the full path of the answer file or click Browse to browse for an answer file. For example, C:\AnswerFile.xml. *Note: We recommend you create a generic Answer file so that it can be reused later with modification. 4. Click Next. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 83

84 5. Carefully review the SnapManager for SharePoint License Agreement. 6. After you have read the terms in the license agreement, click on the check-box to select I accept the terms in the license agreement. Click Next. 7. Enter your name and the organization into the provided field. Click Next to continue the configuration. Click Back to go back to the previous interface. 8. Set up the installation location using the following conditions. Default Directory The SnapManager for SharePoint Agent will be installed to the default installation location on the specified destination server, which is \Program Files\IBM\SMSP8\Agent. Customized Directory If select this option, the Installation Path field will be enabled, enter a customized path and the SnapManager for SharePoint Agent will be installed to the specified path on the destination server. o Use the default directory if your customized directory is invalid If this option is selected, the SnapManager for SharePoint Agent will be installed to the default directory when the customized directory is invalid. For example, the path you specified is on a drive which does not exist on the destination server. 9. Set up the Control Service Configuration: a. SnapManager for SharePoint Control Service Host The hostname or IP address of the machine where installed Control Service. b. SnapManager for SharePoint Control Service Port This is the port used for communication with Control Service and should match the information provided during the Manager configuration. The default port number is Set up the SnapManager for SharePoint Agent Port The port specified here is used by the Manager or other Agents for communication. The default port number is Use a random port number if the specified one is being used If select this option, SnapManager for SharePoint will use a random port number if the port you specified has already been used. This option is selected by default. 11. Set up the Agent Configuration: a. Manager Passphrase Enter the Manager Passphrase specified when configuring the SnapManager for SharePoint Manager installation answer file. b. SnapManager for SharePoint Agent Account Specify the username and password of the Agent account under which the Agent activities are performed. Refer to Agent Account Permissions for the detailed permissions required for this account. 12. Review the configuration, if the configuration is marked with, you must provide the required information before this Answer file can be saved. 13. After all of the required information has been configured, click Save, and specify the path you want to save the Answer file to. You can also modify the Answer file s name in the pop-up window. 84 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

85 Performing the SnapManager for SharePoint Agent Unattended Installation See the sections below for information on SnapManager for SharePoint Agent unattended installation. Import the UnattendedInstallation.dll File Before performing the SnapManager for SharePoint Agent unattended installation, the UnattendedInstallation.dll file must be imported into Windows PowerShell using either of the two methods below. *Note: If the UnattendedInstallation.dll file does not import successfully, use the Set-ExecutionPolicy command to set the execution policy to Unrestricted, RemoteSigned, or AllSigned in Windows PowerShell, and then perform the import again using either of the two methods below. To manually import the UnattendedInstallation.dll file, complete the steps below. 1. Click Start, and find Windows PowerShell. Right click on it, and select Run as administrator to run it. 2. Change the current directory to the \UnattendedInstall\PowerShellModules folder inside the unzipped Manager installation package. Figure 17: Changing the current directory in PowerShell 3. Enter the following command, and press Enter to import the UnattendedInstallation.dll file: Import-Module \UnattendedInstall\PowerShellModules\UnattendedInstallation.dll Figure 18: Changing the current directory in PowerShell *Note: The warning message displayed in the screen above is caused by some terminologies in the UnattendedInstallation.dll file violating Windows PowerShell s naming convention. It has no effect on file importing. The UnattendedInstallation.dll file is imported successfully. To automatically import the UnattendedInstallation.dll file IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 85

86 1. Navigate to the \UnattendedInstall\PowerShellModules folder inside the unzipped Manager installation package. 2. Right click on the UnattendedInstallationLauncher.bat file, and select Run as administrator to run it. Now that you have imported the UnattendedInstallation.dll file, you can use the commands in the following sections to check your environment, perform the Agent installation and configure settings. Commands and Command Parameters for SnapManager for SharePoint Agent Unattended Installation See the sections below for information on SnapManager for SharePoint Agent unattended installation command parameters. Environment Checking Command Before executing SnapManager for SharePoint Agent installation command, you can use the Check- AgentEnvironment command to check whether the destination server that you want to install SnapManager for SharePoint Agent on meets SnapManager for SharePoint Agent System Requirements. *Note: The Check-AgentEnvironment command is not available when the destination machine uses Windows Server 2008 R2 Server Core Operating System. Below is an example of the Check-AgentEnvironment command: Check-AgentEnvironment -TargetName Username IBM\SMSP -Password Password - CheckEnvironmentFile C:\SMSP_Agent\SMSP.dat -AnswerFilePath "C:\AnswerFileAgent.xml" - ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where you want to install the SnapManager for SharePoint Agent. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where you want to install the SnapManager for SharePoint Agent. The format of the username is: domain\username. The permissions of the user specified here are as 86 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

87 Parameter Type Description follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -CheckEnvironmentFilePath Required The local path of the SnapManager for SharePoint.dat file that is residing in the unzipped SnapManager for SharePoint Agent installation package. The path must be detailed to the name of the data file. For example, C:\SMSP_Agent\ SnapManager for SharePoint.dat. -AnswerFilePath Required The local path where you saved the Answer file. The path must be detailed to the name of the Answer file. For example, C:\AnswerFileAgent.xml. -RemoteTempPath Required A local path on the destination machine that the SnapManager for SharePoint Agent is installed to. The format of the path is: C:\temp. The path will be used to store the temporary files generated during the SnapManager for SharePoint Agent unattended installation. The temporary files will be deleted as soon as the unattended installation finishes. -ProductType Required This parameter is used to identify the product you are installing. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the environment checking logs will be saved to the.txt IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 87

88 Parameter Type Description file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Agent is installed. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. 88 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

89 Installation Command The SnapManager for SharePoint Agent Unattended Installation command for installing the SnapManager for SharePoint Agent remotely is Install-DAAgent. For example: Install-DAAgent -TargetName Username IBM\SMSP -Password Password - PackageFilesFolder "C:\SMSP_Agent" -AnswerFilePath "C:\AnswerFile.xml" -RemoteTempPath C:\TempFolder -ProductType IBM The detailed information of the parameters is listed below: Parameter Type Description -TargetName Required The name or IP address of the destination machine where you want to install the SnapManager for SharePoint Agent. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where you want to install the SnapManager for SharePoint Agent. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -PackageFilesFolder Required The local path on the machine where you run the IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 89

90 Parameter Type Description command. The specified path stores the unzipped SnapManager for SharePoint Agent installation package (Agent ZIP file). The format of the path is: C:\package. Quote the path if it contains any special character or space. -AnswerFilePath Required The local path where you saved the Answer file. The path must be detailed to the name of the Answer file. For example, C:\AnswerFile.xml. -RemoteTempPath Required A local path on the destination machine that the SnapManager for SharePoint Agent is installed to. The format of the path is: C:\temp. The path will be used to store the temporary files generated during the SnapManager for SharePoint Agent unattended installation. The temporary files will be deleted as soon as the unattended installation finishes. -ProductType Required This parameter is used to identify the product you are installing from other AvePoint s products. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the logs of the unattended installation will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -UseIPv6forCommunication Optional This is an optional parameter. It specifies the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Agent is installed to. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. This port and the destination 90 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

91 Parameter Type Description machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. Upgrade Command Use the Upgrade-DAAgent command to upgrade the previously installed SnapManager for SharePoint Agent to the latest version remotely. Below is an example of the Upgrade-DAAgent command: Upgrade-DAAgent -TargetName Username IBM\SMSP -Password Password - PackageFilesFolder "C:\SMSP_Agent" -RemoteTempPath C:\TempFolder -Passphrase Passphrase - ControlServiceHost ControlServicePort ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where the installed SnapManager for SharePoint Agent will be upgraded. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where you want to upgrade the installed SnapManager for SharePoint Agent to the latest version. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control permission to the path specified in RemoteTempPath IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 91

92 Parameter Type Description parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -PackageFilesFolder Required The local path on the machine where you run the command. The specified path stores the unzipped latest SnapManager for SharePoint Agent installation package (Agent ZIP file). The format of the path is: C:\package. Quote the path if it contains any special character or space. -RemoteTempPath Required A local path on the destination machine where the installed SnapManager for SharePoint Agent will be upgraded to the latest version. The format of the path is: C:\temp. The path will be used to store the temporary files generated during the SnapManager for SharePoint Agent unattended upgrade. The temporary files will be deleted as soon as the unattended upgrade finishes. -Passphrase Required The passphrase used to connect to the specified DocAve Control service. Quote the passphrase if it contains any special character or space. -ControlServiceHost Optional If the host name or IP address of the Control Service that connects the Agent installed on the destination machine is changed, use this parameter to change the host name or IP address of the Control Service to the new one. -ControlServicePort Optional If the port of the Control Service that connects the Agent installed on the destination machine is changed, use this parameter to change the port of the Control Service to the new one. -AgentHost Optional If the host name or IP address of the destination server that has Agent installed is changed, use this parameter to change the host name or IP address of the Agent to the new one. -AgentPort Optional The new Agent port you want to use for the SnapManager for SharePoint Agent installed on the destination machine. -AccountUsername Optional The name of the new Agent account that you want to use for the SnapManager for SharePoint Agent installed on the destination machine. -AccountPassword Optional The password of the new Agent account specified above. Quote the password if it contains any special character or 92 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

93 Parameter Type Description space. -UsePreviousConfiguration Optional Only input this parameter when you want to use the previous configuration of the former SnapManager for SharePoint Agent installed on the destination machine, and enter True as the value of this parameter when this parameter is used. -ProductType Required This parameter is used to identify the product you are upgrading. Enter IBM as the value of this parameter when you upgrade SnapManager for SharePoint Agent. -Log Optional This is an optional parameter. If used, the logs of configuring configuration information will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. Getting Configuration Information Command Use the Get-DAAgentConfigInfo command to retrieve the configuration information of SnapManager for SharePoint Agent remotely. You can also retrieve the configuration information of the Agents installed locally through the installation wizard. Below is an example of the Get-DAAgentConfigInfo command: Get-DAAgentConfigInfo -TargetName Username IBM\SMSP -Password Password - ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where has SnapManager for SharePoint Agent installed. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 93

94 Parameter Type Description destination machine where has SnapManager for SharePoint Agent installed. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -ProductType Required This parameter is used to identify the product you are installing. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the logs of getting configuration information will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -AnswerFilePath Optional This is an optional parameter. If used, the configuration information you get by the Get- DAAgentConfigInfo command will be exported to the.xml file in the specified path. Only the.xml file is supported by this parameter. The content format of the generated.xml file is the same as the Agent Answer File. 94 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

95 Parameter Type Description The path specified in this parameter must be detailed to the name of the log file. For example, C:\ManagerConfigInfor.xml. There must be no.xml file with the same name existing in the specified path. -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Agent is installed. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. Configuring Configuration Information Command Use the Config-DAAgentConfigInfo command to modify the configuration information of SnapManager for SharePoint Agent remotely. You can also modify the configuration information of the Agents installed locally through the use of the installation wizard. Below is an example of the Config-DAAgentConfigInfo command: Config-DAAgentConfigInfo -TargetName Username IBM\SMSP -Password Password - ControlServiceHost ControlServicePort AgentHost ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where has SnapManager for SharePoint Agent installed. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 95

96 Parameter Type Description local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where has SnapManager for SharePoint Agent installed. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. The user specified here must have the Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -ControlServiceHost Optional If the host name or IP address of the Control Service that connects the Agent installed on the destination machine is changed, use this parameter to change the host name or IP address of the Control Service to the new one. -ControlServicePort Optional If the port of the Control Service that connects the Agent installed on the destination machine is changed, use this parameter to change the port of the Control Service to the new one. -AgentHost Optional If the host name or IP address of the destination server that has Agent installed is changed, use this parameter to change the host name or IP address of the Agent to the new one. -AgentPort Optional The new Agent port you want to use for the SnapManager for SharePoint Agent installed on the destination machine. -SnapManager for SharePointPassphrase Optional If the passphrase of the SnapManager for SharePoint Manager that the Agent installed on the destination machine connects is changed, use this parameter to change the passphrase to the new one. 96 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

97 Parameter Type Description -ProductType Required This parameter is used to identify the product you are installing. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the logs of configuring configuration information will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Agent is installed. If an IPv6 address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 97

98 Verifying Configuration Information Command Use the Verify-DAAgentConfigInfo command to verify the configuration information you want to use for SnapManager for SharePoint Agent is valid or not remotely. You can also verify the configuration information of the Agents installed locally through the use of the installation wizard. *Note: The Verify-DAAgentConfigInfo command is not available when the destination machine uses Windows Server 2008 R2 Server Core Operating System. Below is an example of the Verify-DAAgentConfigInfo command: Verify -DAAgentConfigInfo -TargetName Username IBM\SMSP -Password Password - ControlServiceHost ControlServicePort AgentHost ProductType IBM This table contains detailed information for each of the parameters: Parameter Type Description -TargetName Required The name or IP address of the destination machine where has SnapManager for SharePoint Agent installed. *Note: If the hostname is used, ensure that the specified computer name can be resolved through the local Hosts file, by using Domain Name System (DNS) queries, or through NetBIOS name resolution techniques. -Username Required The username of the user who accessed the destination machine where has SnapManager for SharePoint Agent installed. The format of the username is: domain\username. The permissions of the user specified here are as follows: If the specified user is the local administrator of the destination machine, it can be used directly. Enter.\administrator for the Username parameter. If the specified user is from the domain which the destination machine belongs to, the domain user must be added to the Administrators group on the destination machine. 98 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

99 Parameter Type Description The user specified here must have the Full Control permission to the path specified in RemoteTempPath parameter. -Password Required The password of the user specified above. Quote the password if it contains any special character or space. -ControlServiceHost Optional Verifying the host name or IP address of the Control Service that you want the Agent installed on the destination machine to connect. -ControlServicePort Optional Verifying the port of the Control Service that you want the Agent installed on the destination machine to connect. -AgentHost Optional Verifying the host name or IP address that you want to use for the Agent installed on the destination machine. -AgentPort Optional Verifying the port that you want to use for the Agent installed on the destination machine. -SnapManager for SharePointPassphrase Optional Verifying the Manager passphrase that you want to use for the Agent installed on the destination machine. -ProductType Required This parameter is used to identify the product you are installing. Enter IBM as the value of this parameter when you install SnapManager for SharePoint products. -Log Optional This is an optional parameter. If used, the logs of verifying configuration information will be saved to the.txt file in the specified path. The generated log file is a text file. The path specified in this parameter must be detailed to the name of the log file. For example, C:\Log.txt. If the specified log file does not exist, it will be generated automatically. -UseIPv6forCommunication Optional This is an optional parameter used to specify the communication method between the machine where the command is run and the destination machine that the SnapManager for SharePoint Agent is installed. If an IPv6 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 99

100 Parameter Type Description address is entered in TargetName parameter, this parameter must be entered. *Note: When using this parameter, both the destination machine and the machine where you run this command must support IPv6. -ReceiveInfoPort Optional This is an optional parameter to specify a port for the source machine to receive the data from the destination machine. This port and the destination machine s IP are added to an inbound rule of the source machine s firewall so it allows all of the connections from the destination machine. We recommend you configure this parameter to ensure smooth communication between the source machine and the destination machine. Accessing the SnapManager for SharePoint GUI Following are the supported browsers and the requirement of the Silverlight version if you want to access SnapManager for SharePoint GUI in Windows Server 2008 R2 environment. Rules Silverlight Version 5.0 or above Internet Explorer IE 7 or above Google Chrome Mozilla Firefox Requirements SnapManager for SharePoint Manager can be accessed in the environment because it has USGCB (United States Government Configuration Baseline) security standards configured. Please visit the Web site for more information on USGCB. Internet Explorer Setup for SnapManager for SharePoint When first accessing SnapManager for SharePoint using Microsoft Internet Explorer (IE), certain initial security settings must be configured. Run SnapManager for SharePoint s server application found in the start menu on the machine running the SnapManager for SharePoint Control Service, and follow the steps below. 100 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

101 1. When you access SnapManager for SharePoint by IE, the Browser will display a security certificate prompt: Figure 19: Security certificate error screen 2. Select the option Continue to this website listed by the red bullet. 3. Click the Security Report icon next to the address URL. Figure 20: Security Report icon 4. Click View certificates in the pop-up. The Certificate window appears. Figure 21: View certificates icon IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 101

102 5. Click Install Certificate button to install SnapManager for SharePoint certificate. The name of this certificate is the same as the hostname of the server that has SnapManager for SharePoint Control Service installed. Figure 22: Install Certificate icon 6. Click Next to continue with the Certificate Import. 7. Select the Place all certificates in the following store option and click Browse to browse to Trusted Root Certification Authorities folder. Click OK to confirm the selection and click Next. Figure 23: Defining store location for all certificates 102 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

103 8. Click Finish to complete the certificate import. 9. Click OK in the prompt acknowledging the successful import. 10. Select temporarily allow popping up SnapManager for SharePoint or always allow in the security prompt. Figure 24: Selecting Temporarily Allow Pop-ups Now you can log into SnapManager for SharePoint from Internet Explorer. Logging In to SnapManager for SharePoint The SnapManager for SharePoint GUI can be launched from Web browsers within the same network as the SnapManager for SharePoint Manager. Refer to Accessing the SnapManager for SharePoint GUI section for the supported Web browsers. Connect to the interface using the IP/Hostname for the SnapManager for SharePoint Manager - Control Service, as well as the Control Service Port if it was changed. 1. Open an Internet Explorer window and enter: Where <machine> is the hostname or IP address of the machine running the SnapManager for SharePoint Control Service. If the default port number has been changed from 14000, enter the new port number. *Note: If the hostname of the machine running the SnapManager for SharePoint Control Service contains the underline (_), use the IP address of the corresponding machine to access SnapManager for SharePoint. 2. The SnapManager for SharePoint login screen pops up. Select Local System and enter the default login account information: 3. Click Login. Login ID: admin Password: admin *Note: When you log on SnapManager for SharePoint for the first time, it is strongly recommended backing up the SnapManager for SharePoint security keys for protection. For more information, refer to the SnapManager for SharePoint Control Panel User s Guide. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 103

104 You can also log on SnapManager for SharePoint using the integration with other authentication methods. For more information, refer to the SnapManager for SharePoint Control Panel User s Guide. SnapManager for SharePoint Manager and Agent Maintenance See below for additional information related to SnapManager for SharePoint Manager and Agent maintenance. Using the SnapManager for SharePoint Manager/Agent Configuration Tool If you want to modify the configuration of SnapManager for SharePoint Manager/Agent after the installation, open the Start Menu in Windows on the SnapManager for SharePoint Manager server, and navigate to All Programs > SnapManager 8 for SharePoint. Then open the SMSPS Tools > SMSP Agent Tools or SMSP Manager Tools folder. Click Agent Configuration Tool or Manager Configuration Tool. Figure 25: Agent configuration tool 104 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

105 Figure 26: Manager configuration tool Click on the items listed on the left part of the tool and you can modify the corresponding settings. Refer to Installing SnapManager for SharePoint Manager and Installing SnapManager for SharePoint Agents for detailed information on the settings. *Note: You can change the Control database/auditor database/report database to another existing Control database/auditor database/report database using the SnapManager for SharePoint Manager Configuration Tool. Note that the passphrase is required if you choose to change the Control database to another existing Control database. Using the SnapManager for SharePoint Manager/Agent Restart Service Tool If you want to restart the services of SnapManager for SharePoint Manager/Agent after the installation, open the Start Menu in Windows on the SnapManager for SharePoint Manager server and navigate to All Programs > SnapManager 8 for SharePoint. Then open the SMSPS Tools > SMSP Agent Tools or SMSP Manager Tools folder. Click Agent Restart Service Tool or Manager Restart Service Tool. You can check the status of the services in the tool interface. Select one service from the tool interface and you can perform the following actions. Start Start the selected services that have been stopped. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 105

106 Stop Stop the selected services. Restart Restart the selected services. Using the SnapManager for SharePoint Manager/Agent Uninstallation Wizard You can use either of the two methods below to access the uninstallation wizard of SnapManager for SharePoint Manager/Agent after the Manager/Agent has been installed. In order to complete the change/repair operations successfully, the Uninstallation Wizard must be run by a local administrator on the host where the Manager or Agent is installed. Method 1 Double-click the downloaded SnapManager for SharePoint Manager/Agent installation application and run it. *Note: This is the recommended method since it makes the most use of the installation application. Method 2 Open the Start Menu in Windows on the SnapManager for SharePoint Manager/Agent server and navigate to All Programs > SnapManager 8 for SharePoint. Open SMSP Manager Tools or SMSP Agent Tools folder. Click Manager Uninstall or Agent Uninstall. Now you can perform the operations introduced in the following two sections. Change the Manager Installation You can install/uninstall the specified Manager services by selecting the Change option in the SnapManager for SharePoint Manager uninstallation wizard. This option is very useful when you want to add new services onto the server or remove existing services from the server. After the Installation Rule Scanning, you will then be guided through the installation/uninstallation of the selected Manager services. Repair the Manager/Agent Installation You can attempt to repair the SnapManager for SharePoint Manager/Agent files in the event that they become corrupted. Select the Repair option in the SnapManager for SharePoint Manager/Agent uninstallation wizard. SnapManager for SharePoint will try to repair the corrupted files. Note the following limitations to the Repair function: If some crucial files have been lost or corrupted, the SnapManager for SharePoint installation cannot be repaired. 106 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

107 If you have cleared the temporary files after the first installation, you can only perform the repair using Method 1 above. If the register key HKEY_LOCAL_MACHINE > SOFTWARE > Microsoft > Windows > CurrentVersion > Uninstall > SMSP8Manager is corrupted, the repair function cannot be used. You must use Method 1 above to perform a new installation of SnapManager for SharePoint. Upgrading SnapManager for SharePoint When executing the Manager/Agent installation application on a server that has the previous version of SMSP 7 Manager/Agent installed, the Manager/Agent installation application will upgrade the previously installed SMSP 7 Manager/Agent to the latest version. Refer to Installing SnapManager for SharePoint for the detailed explanation on how to configure the settings appeared during the upgrade. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 107

108 Uninstalling SnapManager for SharePoint The SnapManager for SharePoint Uninstallation Wizard is there to guide you through this uninstallation process. By following the steps below, you will have SnapManager for SharePoint removed from your environment very quickly. In order to complete the uninstallation successfully, the Uninstallation Wizard must be run by a local administrator. Uninstalling SnapManager for SharePoint Manager In order to uninstall SnapManager for SharePoint Manager, please ensure the manager service being removed is not in use by another process. Uninstalling SnapManager for SharePoint Manager from the following Windows environments: Windows Server 2008 SP2 Windows Server 2008 R2 SP1 Windows Server 2012 Follow the steps below to uninstall SnapManager for SharePoint Manager. 1. Open the Start Menu in Windows on the SnapManager for SharePoint Manager server, and navigate to All Programs > SnapManager 8 for SharePoint. 2. Open SMSP Manager Tools folder. Click Manager Uninstall. 3. Select the Remove option. Click Next. 108 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

109 4. In the Ready to Remove SnapManager for SharePoint Manager page, configure the following option. Figure 27: Ready to Remove SnapManager for SharePoint Manager page Remove configuration file Select this option if you want to remove all of the folders and configuration files generated by the SnapManager for SharePoint Manager installation. *Note: The Logs folder will not be removed regardless of whether you select Remove configuration file option or not. 5. Click Remove to start the Manager uninstallation process. *Note: Removing SnapManager for SharePoint Manager will cause currently running jobs to fail and will stop currently running processes. 6. If the application pool created by SnapManager for SharePoint Manager installation is still useful, it will not be deleted during the Manager uninstallation. If the application pool created by SnapManager for SharePoint Manager installation is not used by any other applications, it will be deleted during the Manager uninstallation. 7. If you use Built-in database, you will be asked whether to delete the Built-in database while uninstalling SnapManager for SharePoint Manager. If you use SQL Server, the Manager uninstallation will not delete the Manager databases. 8. Click Finish to complete the uninstallation. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 109

110 *Note: After an uninstallation is in progress, it cannot be cancelled and the uninstallation interface cannot be closed. Uninstalling SnapManager for SharePoint Agent In order to uninstall SnapManager for SharePoint Agent, please ensure there are no current jobs running on the Agent. Uninstalling SnapManager for SharePoint Agent from the following Windows environments: Windows Server 2008 SP2 Windows Server 2008 R2 SP1 Windows Server 2012 Follow the steps below to uninstall SnapManager for SharePoint Agent. 1. Open the Start Menu in Windows on the SnapManager for SharePoint Agent server, and navigate to All Programs > SnapManager 8 for SharePoint. 2. Open the SMSP Agent Tools folder. Click Agent Uninstall. 3. Select the Remove option. Click Next. 4. In Ready to Remove SnapManager for SharePoint Agent page, configure the following options. Figure 28: Ready to Remove SnapManager for SharePoint Agent page 110 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

111 a. Disable EBS/RBS settings in SharePoint farm Select this option to disable the EBS/RBS settings in the SharePoint farm. If the EBS/RBS settings are disabled, the Storage Optimization stubs cannot be accessed. This option is selected by default. Uncheck this option if you want to reinstall the SnapManager for SharePoint Agent later. b. Remove configuration file Select this option if you want to remove all of the folders and configuration files generated by the SnapManager for SharePoint Agent installation. *Note: The Logs folder will not be removed regardless of whether you select Remove configuration file option or not. 5. Click Remove and the Agent uninstallation process starts. *Note: Removing SnapManager for SharePoint Agent will cause currently running jobs to fail and will stop currently running processes. Click View Details in the pop-up window to view detailed information about the running jobs and processes. 6. Click Finish to complete the uninstallation. *Note: After an uninstallation is in progress, it cannot be cancelled and the uninstallation interface cannot be closed. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 111

112 Advanced Configuration Modify the Port Used by SnapManager for SharePoint Storage Manager and Connector On a specified SnapManager for SharePoint Agent server, if the default port (14005) used by SnapManager for SharePoint Storage Manager and Connector is occupied, you can use the configuration file below to modify the port. For SharePoint 2010: \IBM\SMSP8\Agent\data\SP2010\Arch\AgentCommonStorageEnv.cfg For SharePoint 2013: \IBM\SMSP8\Agent\data\SP2013\Arch\AgentCommonStorageEnv.cfg Note that the following procedure requires an IIS reset. The detailed steps are as follows. 1. Navigate to the installation path of the specified SnapManager for SharePoint Agent. By default, the path is \IBM\SMSP8\Agent\data\SP2010\Arch for SharePoint 2010 and \IBM\SMSP8\Agent\data\SP2013\Arch\ for SharePoint Find the AgentCommonStorageEnv.cfg file and open it with Notepad. 3. Modify the value of StorageServicePort to an available port. 4. Save the configuration file. 5. Click Start and find the Command Prompt. 6. Right-click on it and click Run as administrator. 7. Enter iisreset in the popup Command Prompt, and press Enter to restart IIS. 8. Restart the SnapManager for SharePoint Agent service. For more information, refer to Using the SnapManager for SharePoint Manager/Agent Restart Service Tool. 112 IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide

113 Troubleshooting SnapManager for SharePoint Installation See below for SnapManager for SharePoint installation troubleshooting. The Installed SnapManager for SharePoint Agents Cannot be Displayed in the Manager Interface If both hostname and IP address are used to configure the Database server when installing SharePoint on the Web front-end servers, the SnapManager for SharePoint Agents installed on the servers may not be displayed in SnapManager 8 for SharePoint > Control Panel > System Settings > Monitor > Agent Monitor. After the SnapManager for SharePoint Agents have been installed on the Front-end Web servers successfully, refer to the detailed steps below to resolve this issue. 1. Remotely log on one Agent server which is displayed correctly in the Manager Interface. 2. Navigate to the installation path of SnapManager for SharePoint Agent, by default it is C:\Program Files\IBM\SMSP8\Agent\bin. 3. Find the configuration file named AgentCommonVCEnv.config. IBM System Storage N series SnapManager 8.0 for Microsoft SharePoint Installation Guide 113