EMC Storage Integrator for Windows · EMC Storage Integrator for Windows Technical Notes 8 While SPM enables ESI users to provision storage, it recognizes that the storage administrator

UNIFIED STORAGE SOLUTIONS

EMC Storage Integrator for Windows

Technical Notes

July 2011

EMC Storage Integrator for Windows Technical Notes 2

Copyright © 2011 EMC Corporation. All Rights Reserved.

EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

The information in this publication is provided “as is.” EMC Corporation makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose.

Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.

All trademarks used herein are the property of their respective owners.

Part Number 300-012-822

3 EMC Storage Integrator for Windows Technical Notes

Table of contents

Introduction .......................................................................................................................... 5

About this Document ............................................................................................................ 6

Purpose ........................................................................................................................................... 6

Scope .............................................................................................................................................. 6

Audience ......................................................................................................................................... 6

EMC Symmetrix Adapter for ESI .............................................................................................. 7

Storage Pool Management ............................................................................................................... 7

Storage Type .................................................................................................................................... 7

Virtualization Domain ...................................................................................................................... 8

SMC server ....................................................................................................................................... 8

Using SPM with ESI .......................................................................................................................... 8

Prerequisites .................................................................................................................................... 8

Supported operations ...................................................................................................................... 8

Setting up SPM with ESI ................................................................................................................... 9

Add user roles .................................................................................................................................. 9

Export configuration ....................................................................................................................... 11

Register ESI host with SMC ............................................................................................................. 12

Create thin pools............................................................................................................................ 14

Create a masking view ................................................................................................................... 15

Add StorageAdmin – Virtualization Domain role ............................................................................. 19

Create storage types ...................................................................................................................... 20

Create Virtualization Domains ........................................................................................................ 22

Add storage to Virtualization Domains ........................................................................................... 24

Add storage system ....................................................................................................................... 26


SharePoint Adapter for ESI .................................................................................................. 29

Prerequisites .................................................................................................................................. 29

Installation .................................................................................................................................... 29

Features ......................................................................................................................................... 29

Starting ESI .................................................................................................................................... 30

Add a SharePoint farm ................................................................................................................... 30

Create a SharePoint web application .............................................................................................. 32

Remove SharePoint farms .............................................................................................................. 36

Configure remote SQL Server .......................................................................................................... 36

Login mode ............................................................................................................................... 36

SQL Server settings ................................................................................................................... 37

Firewall settings ........................................................................................................................ 37

Verifying the connection ............................................................................................................ 37

Troubleshooting ESI ............................................................................................................ 38


Introduction The EMC® Storage Integrator (ESI) for Windows Zip file contains the following setup installers that enable users to install the individual features of ESI:

ESI.Core.Setup.<platform>.exe

ESI.VNX.Adapters.Setup.<platform>.exe

ESI.SharePoint.Adapters.Setup.x64msi

ESI.Symmetrix.Adapters.Setup.<platform>.msi

ESI.VNXe.Adapters.Setup.<platform>.msi

Note: ESI is available for x64 and x86 platforms. However, the SharePoint Adapter is available only for the x64 platform.

The core components need to be installed first, followed by other adapters in any order.

This technical note provides detailed information about storage provisioning in ESI using the EMC Symmetrix® and Microsoft SharePoint Adapters.


About this Document

The EMC Storage Integrator for Windows Zip file contains multiple setup installers that enable users to install the individual features of ESI. This technical note provides information about the Symmetrix and SharePoint Adapters in ESI.

This document provides information about the Symmetrix and SharePoint Adapters in ESI.

This document is intended for users who are familiar with EMC Symmetrix and Microsoft SharePoint. Users should also have at least rudimentary knowledge of EMC storage systems and their terminology.

Purpose

Scope

Audience


EMC Symmetrix Adapter for ESI

The EMC Symmetrix Adapter in ESI depends on Storage Pool Management (SPM) to provision storage. SPM is integrated with Symmetrix Management Console (SMC). This section describes how to set up the SPM environment to work with the Symmetrix Adapter in ESI.

Storage administrators can create a Virtualization Domain that corresponds to an ESI instance with physical pooled storage by using the SPM feature in SMC. This pooled storage resource enables the ESI user to allocate the storage resources.

While SPM enables ESI users to provision storage, it recognizes that the storage administrator still owns and controls the array, and as such must be able to set boundaries around what storage each user can provision. These boundaries are defined by a Virtualization Domain.

SPM introduces two new concepts:

Storage Type

Virtualization Domain

These concepts are critical to understand storage provisioning in ESI using Symmetrix Adapter.

A Storage Type is a label that the ESI user utilizes to select the required storage. It is defined by a storage administrator during SPM configuration and is used by the ESI user when provisioning storage.

The storage administrator defines the types of storage available to the ESI user in one of the following ways:

Using any already defined Fully Automated Storage Tiering (FAST) tier.

Creating a custom type: Custom types are created by selecting the properties of the physical storage:

Disk type (SATA, Fibre Channel (FC), Flash drives)

Disk speed (7,200, 10,000, 15,000)

RAID configuration (RAID6 (14+2), RAID6 (6+2), RAID5 (7+1), RAID5 (3+1))

The storage administrator can also use the storage type to describe the storage. For example, RAID 6 (6+2), 10,000 RPM, and FC storage can be called “Silver” and RAID 6 (14+2), 15,000 RPM, and FC storage can be called “Gold”, and so on.

Storage Pool Management

Storage Type


While SPM enables ESI users to provision storage, it recognizes that the storage administrator still owns and controls the array, and must be able to set boundaries around what storage each user can provision. These boundaries are defined by a Virtualization Domain.

The Virtualization Domain represents an ESI host corresponding to a Symmetrix array. It contains information such as the machine GUID about the ESI host. It also contains other information needed to provision storage to the ESI host, such as the masking views to use, and the physical storage (thin pools) from which ESI users will actually provision their storage. Note the following key points with respect to Virtualization Domains:

One ESI host can have multiple Virtualization Domains, as long as there is only one Virtualization Domain for each Symmetrix array.

Clusters and hosts managed by the same ESI can be associated with different Virtualization Domains if they are connected to different Symmetrix arrays.

The name of a Virtualization Domain should be the name of the ESI host without extension as it is in the configuration file. If the names do not match exactly, creating the Virtualization Domain will fail. This also means that there could be multiple Virtualization Domains with the same name in the same SMC server, but each corresponding to a different Symmetrix array.

Multiple thin pools can be added to the same Virtualization Domain, as long as they are from the same array and are different storage types. Therefore, it would be possible for a Virtualization Domain to have 50 GB of gold storage, 200 GB of silver storage, and 400 GB of bronze storage.

The SMC server is the server component of the EMC element manager for the Symmetrix array. It enables a storage administrator to control one or more Symmetrix arrays through its browser-based graphical user interface (GUI). The SMC GUI is a client front end to the SMC server. It is accessible through a web browser. The SMC server stores the SPM data and performs SPM functions as requested by the system administrator through the SMC GUI, and the ESI users through the ESI GUI. A single SMC server can support multiple ESI hosts.

When the user opens the ESI GUI, the Symmetrix Adapter will be loaded if it is installed. The Symmetrix Adapter uses the SPM Client API to communicate with the SMC/SPM Server to provide the storage provisioning functionality. In this release of ESI, the recommended best practice is to use one instance of SPM server per instance of ESI.

The Symmetrix Adapter in ESI requires SMC to provision storage. The minimum supported version of SMC is 7.3. SMC can be installed either on the same host where ESI is installed or can be installed on a different host.

The Symmetrix Adapter in ESI supports Create Disk and Delete Disk operations for a host or a cluster, and provides the ability to change the drive letter and the path after the disk is created. To provision a LUN for a host or a cluster, the Symmetrix array has to either be locally connected to the host or to cluster member nodes.

Virtualization Domain

SMC server

Using SPM with ESI

Prerequisites

Supported operations


This section explains how to set up an SPM environment to work with the Symmetrix Adapter in ESI and how to use SPM to provision storage for hosts and clusters managed by ESI. SPM is integrated with SMC.

The first step in setting up the SPM is to install the SMC. After installation, open the following web site on the server where SMC is installed:

http://localhost:7070/sem

Use username smc and password smc to login to SMC for the first time.

To provision storage through SPM, complete the following steps:

1. Add user roles

2. Export

3. Register ESI host with SMC

4. Create thin pools

5. Create a masking view

6. Add StorageAdmin – Virtualization Domain role

7. Create storage types

8. Create Virtualization Domains

9. Add storage to Virtualization Domains

Then, complete the following steps in ESI:

1. Add storage system

2. Error! Reference source not found.

In SMC, roles are used to determine the operations that the users can perform on the array or on a component within an array. A user with an Administrator role can create or delete an SMC account and assign roles. An Administrator user must be defined before using Virtualization Domains. A user must have the StorageAdmin role to set up the SPM environment.

After logging in initially with the SMC account (username ‘smc’ and password ‘smc’), create an SMC account with the Administrator role.

Setting up SPM with ESI

Add user roles


To add a StorageAdmin role, complete the following steps:

1. In the Tasks view in SMC, select Administration > Security > Manage Roles.

Figure 1. EMC Symmetrix Management Console

The Manage Roles dialog box appears.

Figure 2. Manage Roles


2. Click Add.

The Add Role dialog box appears.

3. Specify the role details:

a. In the Symmetrix ID list box, select a Symmetrix.

b. In the Role list box, select StorageAdmin.

c. In the Name field, enter a name for the StorageAdmin role

d. In the Type list box, select User.

e. Click Apply.

The StorageAdmin role is created.

Figure 3. Add Role

The Export Configuration report helps storage administrators to create a Virtualization Domain. The ESI user must add hosts and clusters to ESI before doing Export Configuration.

To export the configuration, complete the following steps:

1. Open the ESI GUI on the host where ESI is installed.

2. Highlight EMC Storage Integrator in the left pane.

3. In the Actions pane, click Export Configuration.

A report containing the following information is generated:

Name of the ESI host

Fibre Channel port information for hosts and clusters managed by the ESI host

Note: The report can be in either text or xml format. The report will help Storage Administrators to create masking views later. The ESI user must add hosts and clusters to ESI before doing Export Configuration. The Add Host and Add Cluster actions are available in the Action pane. These actions are also available when the user right clicks Hosts or Host Clusters in the left pane.

Export configuration


Figure 4. ESI GUI

Figure 5. Exported configuration information

The ESI host must be registered as a trusted client with the SMC server. Only users with Administrator or SecurityAdmin role can perform this operation.

Users who plan to launch SMC from their respective hosts must be assigned a role in SMC that will enable them to manage the Symmetrix array from SMC. For ESI users, the Add StorageAdmin – Virtualization Domain role must be assigned within SMC.

Register ESI host with SMC


To register an ESI host with the SMC Server, complete the following steps:

1. From the Tasks view in SMC, go to Administration > Link and Launch > Manage Launch Clients.

The Manage Launch Clients – Client Registration dialog box appears.

2. Click Add.

Figure 6. Manage Launch Clients – Client Registration

The Manage Launch Clients – Add Client dialog box appears.

3. Specify the client information to register the client with SMC:

a. In the Client Type list box, select SPM.

b. In the Client-ID field, type the client ID

c. In the Password field, type the client password.

d. In the Confirm Password field, re-type the client password

e. Click OK.

The client is registered with SMC.

Figure 7. Manage Launch Clients – Add Client


Figure 8. Client registered with SMC

Thin pools contain data devices of the same emulation and same configuration.

To create a thin pool, complete the following steps:

1. Right-click the Symmetrix ID in SMC.

2. Select Device Pool Management > Create Device Pool.

The Device Pool Management – Create Device Pool dialog box appears.

3. Specify the device pool information:

a. In the Pool Name field, type a pool name.

b. In the Pool Type list box, select Thin.

c. In the Emulation list box, select FBA.

d. In the Available list, select one or more devices and click Add to add them to the pool.

e. Select Enable New Pool Member.

Note: Select this checkbox to enable capacities. Otherwise, the thin pool cannot be added to the Virtualization Domain. If this checkbox is not selected initially at the time of creating thin pools, right-click the thin pool after it is created and choose Device Pool Management > Enable All Pool Members.

Create thin pools


f. Click OK.

Figure 9. Device Pool Management – Create Device Pool

The next step is to create a masking view for each of the clusters and standalone hosts managed by the ESI host to which LUNs will be provisioned. Each masking view should include the following:

A storage group that contains at least a single device.

A port group whose ports are in the same zone as the ports in the clusters and standalone hosts.

An initiator group that contains all the WWNs for each FC port on each server in the cluster or standalone server, regardless of whether the port is in use or zoned in the array. SPM supports cascaded initiator groups. Therefore, if the cluster server ports are in multiple initiator groups, you can create a single initiator group.

Create a masking view


To create a storage group, complete the following steps:

1. Right-click the Symmetrix ID in SMC.

2. Select Device Masking and Mapping Storage Groups Maintenance Create Storage Group.

The Storage Group Management – Create dialog box appears.

3. Specify the storage group information:

a. In the Storage Group Name field, type a name for the storage group.

b. In the Device Source Type list box, select Symmetrix.

c. In the Available Devices list, select one or more devices and click Add.

d. Click OK.

Figure 10. Storage Group Management – Create


4. To create a port group, right-click the Symmetrix ID in SMC. Select Device Masking and Mapping > Port Groups Maintenance > Create Port Group.

The Port Group Management – Create dialog box appears.

5. Specify the port group information:

a. In the Port Group Name field, type a name for the Port Group.

b. In the Available Ports list, select the required ports, and click Add.

c. Click OK.

The Port Groups are created.

Figure 11. Port Group Management – Create

6. To create an initiator group, right-click the Symmetrix ID in SMC. Select Device Masking and Mapping > Initiator Groups Maintenance > Create Initiator Group.

The Initiator Group Management – Create dialog box appears.

7. Specify the initiator group information:

a. In the Initiator Group Name field, type the name for the Initiator Group.

b. In the Available Initiators list, select the required initiators and click Add.

c. Click OK.

The Initiator Group is created.


Figure 12. Initiator Group Management – Create

8. To create a masking view, right-click the Symmetrix ID in SMC. Select Device Masking and Mapping Masking Views Maintenance Create Masking View.

The Masking View Management – Create dialog box appears.

9. Verify the details, and click OK.

The masking view is created.

Figure 13. Masking View Management – Create


Users with Security Admin role can add a StorageAdmin – Virtualization Domain role to each thin pool and storage group. This will authorize ESI users to manage thin pools and storage groups that will be added to the Virtualization Domain.

To add the StorageAdmin – Virtualization Domain role, complete the following steps:

1. From the Tasks view in SMC, navigate to Administration > Security > Manage Roles.

The Manage Roles dialog box appears.

2. Click Add.

The Add Role dialog box appears.

3. Specify the role information:

a. In the Symmetrix ID list box, select the Symmetrix ID where the role will be added.

b. In the Role list box, select StorageAdmin – Virtualization Domain.

c. In the Virtualization Domain field, type a name for the Virtualization Domain.

d. The name of the Virtualization Domain must be the name of the ESI host without the extension. It must exactly match the value of the Admin Host Entry Name specified in the exported configuration file obtained from ESI. It is LAQA2062 as shown in Figure 5 on page 13.

e. In the Component Type field, select the type of component to which the ESI user will have access.

Note: Add both Thin Pool and Storage Type component types to the StorageAdmin – Virtualization Domain role.

f. In the Component Name field, type the name of the component, or click select to open a dialog box from which you can select the component.

Note: Storage group and thin pool names are case sensitive.

g. Click Apply.

Add StorageAdmin – Virtualization Domain role


h. Click OK.

The StorageAdmin – Virtualization Domain role is created.

Figure 14. Add Role

Users with StorageAdmin role can create a Storage Type from an existing Symmetrix tier or from a set of physical storage properties.

A Storage Type is a label for a particular type of storage that is defined by a storage administrator during SPM configuration, and used by an ESI user when provisioning storage. For example, instead of provisioning 50 GB of RAID-5 3+1 storage on 10,000 RPM FC drives, an ESI user can simply provision 50 GB of Silver or 50 GB of Tier2 storage.

To create a Storage Type, complete the following steps:

1. From the Tasks view in SMC, navigate to Operations > Virtualization Management > Manage Storage Types.

The Storage Type Manager dialog box appears.

Create storage types


Figure 15. Storage Type Manager

2. Click Create.

The Create Storage Type dialog box appears.

Storage Types can be created by using the attributes of an existing Symmetrix Tier or by creating a Custom Storage Type.

3. Select Symmetrix Tier, or Custom:

To create the Storage Type by using an existing Symmetrix tier:

a. Click Select.

b. Select a Symmetrix ID.

c. Select a tier.

d. Click OK.

The RAID Type and Disk Type fields are populated with attributes of the selected tier. These attributes cannot be edited.

To create a custom Storage Type:

a. In the Name field, type a name for the Storage Type.

Storage Type names must be unique from other Storage Types and cannot exceed 64 characters. Only alphanumeric characters and underscores (_) are allowed. Storage Type names are case-insensitive.

b. In the Description Field, type a description for the Storage Type.

c. In the RAID Type pane, select a RAID type for the Storage Type.

d. In the Disk Type pane, select a disk type for the Storage Type.


f. Click OK.

The Storage Type is created:

Figure 16. Create Storage Type

Virtualization Domains can be created with the masking views created earlier. A Virtualization Domain is a set of boundaries used to limit the physical Symmetrix storage (thin pools) in which an ESI user can create LUNs. Each thin pool contains storage of a particular type, defined by the Storage Types with which they are labeled. ESI users will view the storage using these Storage Types. User with StorageAdmin role can create Virtualization Domains by using the masking views created earlier.

The Virtualization Domain must have authorizations on the storage groups in the masking views that need to be assigned to it. To do this, add a StorageAdmin – Virtualization Domain role to each storage group.

Multiple Virtualization Domains can be created per Symmetrix array, but they must be assigned to different ESI hosts.

Before using Virtualization Domains, create an Admin user role. Virtualization Domains can be created without defined authorizations. However, they will work only after authorizations are defined and the Admin user role is created.

Create Virtualization Domains


To create a Virtualization Domain, complete the following steps:

1. Expand the Symmetrix ID to reveal the Virtualization Domains folder in the navigation tree of SMC.

Figure 17. Right-click Virtualization Domains folder

2. Right-click the Virtualization Domains folder and select Virtualization Domain Management > Create Virtualization Domain.

The Virtualization Domain Management – Create Virtualization Domain dialog box appears.

Note: To create a Virtualization Domain for a Symmetrix array in the SMC server, the Symmetrix array must be locally connected to the SMC server if SMC uses local mode to connect to Solutions Enabler, or locally connected to the Solutions Enabler server if the remote mode is used.

3. Specify the Virtualization Domain information:

a. In the Virtualization Domain Name list box, select the StorageAdmin Virtualization Domain role to which the Virtualization Domain is to be assigned.

This should be the same as the ESI host name.

b. In the vCenter GUID field, type the ESI host ID to assign to the Virtualization Domain.

The ESI host ID is provided in the ESI Export Configuration report. In the example shown in Figure 5 on page 12, it is Machine GUID 83ac76f3-351e-4b44-89c3-6d333f99843b for the Admin Host Entry.

c. In the Maximum No. of LUNs field, specify the maximum number of LUNs the ESI user can provision in the Virtualization Domain.

d. In the Minimum LUN Size list box, specify the minimum LUN size the ESI user can provision in the Virtualization Domain.

e. In the Maximum LUN Size list box, specify the maximum LUN size the ESI user can provision in the Virtualization Domain.

This value must be less than or equal to 66980340 cylinders.


Note: Select Enforce Pre-Created LUNs if the ESI user can only create LUNs of the size and type specified in the pre-created LUN policy associated with the Virtualization Domain. This option is not currently supported by ESI.

f. In the Available list, select a masking view, and click Add.

Repeat this step for each masking view that must be assigned to the Virtualization Domain. Only one view can be assigned for each Cluster or standalone server that the storage in the Virtualization Domain will service.

Note: An initiator group cannot be attached to a Virtualization Domain multiple times. Therefore, as you move the masking views, any masking view in the Available area that shares an initiator group with a masking view in the Target area will be removed from the Available area.

Figure 18. Virtualization Domain Management – Create Virtualization Domain

Users with StorageAdmin role can add storage resources (thin pools or FAST VP policies) created earlier to the Virtualization Domains. By doing this, all or part of the storage resources will be made available for provisioning to ESI users. After a thin pool or FAST VP policy is added, the capacity assigned to the Virtualization Domain will be visible to the ESI user.

The Virtualization Domain must have authorizations on the thin pools that are being added to it. To do this, a StorageAdmin-Virtualization Domain role must be added to the thin pool.

The thin pool or FAST VP policy must have available enabled capacity.

Add storage to Virtualization Domains


To add a thin pool or FAST VP policy to a Virtualization Domain, complete the following steps:

1. Expand the Symmetrix ID in the navigation tree of SMC, and select Virtualization Domains folder.

The list of Virtualization Domains appears.

Figure 19. Add Storage Resource

2. Right-click the Virtualization Domain and select Virtualization Domain Management > Add Thin Pool.

The Virtualization Domain Management – Add Storage Resource dialog box appears.

3. Specify the storage resource information:

a. Select the Thin Pool or FAST VP Policy.

Note: If Thin Pool is selected, select a matching Storage Type to describe Thin Pool. This list will be empty if the devices in the selected Thin Pool do not match any of the defined Storage Types. In such a case, select another pool or create a matching Storage Type.

b. Select a storage resource from the list.

c. For Thin pools:

In the Capacity to Use (GB) field, specify how much of the Thin Pool’s capacity to allocate to the Virtualization Domain.

Possible values must be greater than or equal to the Minimum Capacity to Use and less than or equal to the Maximum Capacity to Use.

Note: The Minimum Capacity to Use field displays the minimum amount (zero) of the thin pool’s available capacity that can be added to a Virtualization Domain. The Maximum Capacity to Use field displays the maximum amount of the thin pool’s available capacity (capacity not being used by non-SPM thin devices, and not assigned to other Virtualization Domains) that can be added to a Virtualization Domain.


d. Click OK.

Figure 20. Virtualization Domain Management – Add Storage Resource

After setting up the SPM environment in SMC, the user can use the ESI GUI to register the SMC server.

1. In the ESI GUI, click Storage System > Add Storage System.

The Add Storage System wizard appears.

2. Specify the storage system information:

a. In the System Type field, select VMAX.

b. In the Friendly Name field, type a friendly name for the system to be used in ESI.

c. In the Storage ID field, type the ID of the VMAX system.

d. In the Spm Server Address field, type the hostname or IP address of an SMC server.

e. In the Spm Server Port field, type the secure (HTTPS) communication port configured for the SMC server by the Storage Administrator.

The value must be in the range of 1 to 65535.

f. In the Client ID field, type the client ID provided by the Storage Administrator.

This must not contain the ‘/’ character.

g. In the Password field, type the password supplied by the Storage Administrator along with the client ID.

h. In the Entry ID field, type the certificate name.

The certificate name is used to select a certificate from the Windows certificate store to ensure integrity of all messages with the SMC server. The value provided is used to retrieve a certificate from the certificate store. If

Add storage system


no certificate with this value exists, a self-signed certificate will be generated automatically. The certificate name must not contain a slash (/).

i. Select Bypass Server Certificate Validation.

j. Click Add.

Note: If this checkbox is selected, it means the user agrees to accept the messages sent from the SMC server. If the checkbox is not selected, communication with the SMC server will fail and the storage system will not be added to ESI.

The storage system is added.

Figure 21. Add Storage System

Figure 22. Add Storage System continued


After the EMC VMAX™ Storage System is added, it appears under Storage Systems in the left pane. In the middle pane, the Storage Pool tab shows the pools configured for this ESI host on the VMAX system.

Figure 23. VMAX storage system

The LUN tab shows all the LUNs on the VMAX system that are visible to the hosts and clusters managed by this ESI host.

Note: The LUN tab does not display all the LUNs on the array. It only shows LUNs that are mapped to the hosts and clusters in ESI.

To remove a storage system from ESI, use the Remove System option in the Actions pane.

Figure 24. Pools configured on VMAX


SharePoint Adapter for ESI

The SharePoint Adapter provides the means to navigate SharePoint farms, and enables users to provision storage on which Web Applications and Content Databases can be created. Using the SharePoint Adapter, users can enumerate the databases in a farm and map them to the underlying storage resources. A user can, then, use a provisioning wizard to prepare a LUN and provision a new database and Web Application.

The prerequisites to install the SharePoint Adapter in ESI are as follows:

Windows Server 2008 or Windows Server 2008 R2, 64-bit.

SQL Server 2008 or SQL Server 2008 R2, 64-bit.

Microsoft SharePoint Foundation 2010, server components. SharePoint Foundation Client is not supported.

Domain-based SharePoint Farm deployment. Clustered and standalone installations are not supported.

Note: SharePoint features are not supported on x86 platforms.

To install the SharePoint Adapter, complete the following steps:

1. Run ESI.Core.Setup.x64 to install the core components. All ESI features depend on these core components for their functionality.

2. Run ESI.SharePoint.Adapters.Setup.x64.

The SharePoint components enable ESI users to perform the following functions:

Connect to existing SharePoint Farms and enumerate farm information, including servers, Web Applications, Site Collections and Content Databases.

Create content database and storage for the database. Map content databases to storage.

Create a web application and map it to the newly created content database.

Provision a web application and its associated content database.

Prerequisites

Installation

Features


After ESI is installed correctly, an ‘EMC Storage Integrator’ link is added to Start > Applications > EMC. Click on that link to launch ESI.

The main screen of ESI is shown in the following figure.

Figure 25. ESI home page

To add a SharePoint farm, complete the following steps:

1. Select EMC Storage Integrator from the left pane. From the Actions pane or the center pane, click Add Application.

Or

Select Applications from the left pane, and click Add SharePoint Applications in the Actions pane.

The Applications dialog box appears.

2. Specify the application details:

a. In the Farm Friendly Name field, type a name to identify the farm.

b. Select Local Farm if ESI is running on the same server as the farm.

c. If ESI is not running on the same server as the farm, in the Server field, type the name of the server where the farm resides.

If Local Farm is unchecked and the server name matches the local server on which ESI is running, ESI assumes that a local farm is requested. In this case, all other information on this dialog, except the Friendly Name, is ignored.

Starting ESI

Add a SharePoint farm


d. If ESI is not running on the same server as the farm, in the Configuration Database field, type the name of the farm configuration database.

The farm server and configuration database can be obtained from SQL Server or SharePoint administration.

e. In the Password field, type the password for the SharePoint farm.

Use the same authentication mechanism that SharePoint uses to connect to SQL Server: Integrated Security if it is Windows Authentication, and a User Name and Password if it is SQL Authentication.

f. Click Add.

The farm is added to the list in the Applications window. However, ESI is not connected to the farm yet.

Figure 26. Add Application

g. Click the farm name to activate the connection.

When the storage farm is double clicked, two tabs are visible: Web Applications and Storage. Click the Web Applications tab to list the web applications in the farm. Click the + symbol to view two tables: one that maps a Web Application to its Site Collections, and one that maps Content Databases to Site Collections. Click the Storage tab to view the content databases that are mapped to the storage systems used by the farms.


To create a SharePoint web application after a SharePoint farm is added, complete the following steps:

1. Select the SharePoint farm from the left pane.

2. From the Actions pane, click New SharePoint Web Application.

The ESI SharePoint Provisioning Wizard appears.

3. Click Next.

Figure 27. ESI SharePoint wizard

Create a SharePoint web application


The Collecting SharePoint and Storage Information page appears

4. Specify the SharePoint and storage information:

a. In the Select a Farm list box, select the farm created in step 2 on page 30.

b. For a local farm, select New IIS Web Site and type a name.

c. If you do not wish to create a new Web Application, de-delect New IIS Web Site.

If this is a remote farm, new IIS Web Site information will be disabled. Future releases may provide the ability to provision Web Application remotely.

d. In the Capacity (GB) field, enter a capacity for the SharePoint storage LUN.

The database will have an initial size of 15 MB and will grow as needed.

e. In the Database Server list box, select a database server.

f. In the Database Name field, type the name of the database.

g. Specify a drive letter or mount path for the data file folder.

h. Specify a drive letter or mount path for the log file folder.

i. Click Next.

Figure 28. Collecting SharePoint and Storage Information


5. Specify the login information:

Refer to Table 1 for the appropriate security settings.

Table 1. Application pool and content database security settings

SQL installation Security setting

Windows Authentication Set content database security to Integrated Security.

SQL Authentication Use database username and password for content database security settings.

SQL Services running as specific user

Use Specific User for Application Pool Security Settings.

SQL Services running as Local System, Local Service or Network Service

Use the respective Application Pool Security Settings.

a. In the Login field, select the Application Pool.

b. In the User Name field, type the username for the application pool and configuration database.

c. In the Password field, type the password for the application pool and configuration database.

d. Select Integrated Security if SQL Server is configured for Windows Authentication.

If SQL Server is configured for SQL Authentication, in the Username and Password fields, type the username and password to access SQL Server.


e. Click Next.

a. Click Next.

Figure 29. Collecting Login Information

The Collecting Storage System Information page appears.

6. Specify the storage system information:

a. In the Storage System list box, select a storage system to host the SharePoint storage.

b. If there is a service node, select it from the Service Node list box.

c. In the Storage Pool (RAID Group) list, select a storage pool or RAID group to place the SharePoint LUN.


d. Click Next.

The Summary page appears.

e. Verify the details and click Next.

The Web Application is created.

Figure 30. Collecting Storage System Information page

To remove a SharePoint farm: 1. In the ESI window, select EMC Storage Integrator or Applications from the left

pane.

2. In the center pane, select the SharePoint farm.

3. In the Actions pane, click Remove System.

If you are using ESI to connect to a remote SharePoint farm, that is, the SQL Server and other servers in the farm are distinct from the machine on which ESI is running, complete the following steps:

Login mode

SQL Authentication: If the remote SQL server is configured for SQL Authentication, then fill the data as per the defined Error! Reference source not found.This should be simple, assuming that the machine running ESI is authenticated or trusted in the domain to which the farm belongs.

Windows Authentication: If the remote SQL server is configured for Windows Authentication, then it is possible that the user logged in to the ESI machine must be in the same domain as the one used by SQL Server.

Remove SharePoint farms

Configure remote SQL Server


Note: Only domain-based farm deployments are supported in ESI. That is, SharePoint servers, including SQL, are joined to a domain controller.

SQL Server settings

1. On the SQL Server machine, navigate to Start > All Programs > SQL Server 2008 > Configuration Tools > SQL Server Configuration Manager.

2. In the left side of the MMC console, expand SQL Server Network Configuration.

3. Click Protocols for <Name>. The ‘Name’ may be “MSSQLSERVER”, but it could be different, depending on your installation.

4. In the main MMC view, double click TCP/IP and make sure it is enabled.

5. In TCP/IP properties, click the IP Address tab and verify the following:

a. The IP address is correct. This may not be the case if this is a virtual environment.

b. The port number is 1433. If it is different, take a note of whatever port number SQL is using.

c. Click Apply and then OK.

d. Verify if TCP/IP is enabled under SQL Native Client in the left side of the MMC.

Firewall settings On the machine running SQL Server, which should be the same machine to which the above settings are applied, enable port 1433 in your firewall. If the port obtained was not 1433, then enable whatever port you took a note of while enabling TCP/IP.

Verifying the connection If you have a machine running SQL Server, other than the one we configured above, you can verify whether the configuration was done correctly as following:

1. Open SQL Server Management Studio.

2. On the small toolbar above the left pane, click Connect Object Explorer.

3. Fill in the appropriate details using the correct server name.

4. You should be able to connect to the remove server and browse the databases.

5. The verification can also be performed by using Visual Studio 2008:

a. In Server Explorer, click Connect to Database.

b. Fill in the dialog using the remote SQL server name or IP address.

c. Click Test Connection.


Troubleshooting ESI Table 2 provides troubleshooting information.

Table 2. Troubleshooting information

Platform Symptom details

Problem description

Prevention/resolution/workaround

Windows Failover Clusters

Failed to connect to a cluster or create/delete/ disconnect a cluster disk.

Healthy cluster is a requirement for this version of ESI. Cluster resource dependencies are not removed before delete or disconnect cluster disk

Make sure the cluster is healthy

Before deleting or disconnecting a cluster disk, remove disk resource dependencies.

VMAXe VMAXe is not listed in the AddStorageSystem Dialog.

While trying to add a VMAXe, this type of the storage system is not listed in the AddStorageSystem dialog.

VMAXe is scaled down version of VMAX. Select VMAX in the AddStorageSystem dialog.

VMAX Disk operations on VMAX may fail while the SPM virtualization domain is being modified.

During the virtual domain modification in progress the disk operation in ESI may fail.

Please wait until the virtualization domain modifications are complete.

VMAX In ESI host view, some disks from VMAX does not show the storage system and other details.

LUNs that are displayed in the ESI Storage System LUN list are not displayed in the ESI Storage System Storage Pool display for VMAX systems.

This is the expected behavior. Devices such as VMAX ACLX are not part of Storage Pools and as such will not be displayed in the Storage Pool view. In addition, devices may be visible to hosts that were not adopted into the Storage Pools. This can be verified from the SMC.

All storage platforms

Storage related data is not displayed in the host view, cluster view or share point view.

In a host view, cluster view or SharePoint view, values for Storage System Name, LUN Name, and storage related columns are empty.

Verify whether the corresponding storage systems are registered with ESI (under “Storage Systems” node). If not, register them. The registration is required because ESI shows storage related information for a disk/shared folder only when the corresponding storage systems are registered.

Storage System may be taking longer than the default timeout value of 60 seconds. In this case please set a higher timeout value( in seconds) in the following registry key:

Key: HKLM\SOFTWARE\EMC\WSI\Config

DWORD Value Name: DefaultOperationTimeout


Platform Symptom details

Problem description

Prevention/resolution/workaround

All supported platforms

In ESI, RMB click on a tree node will not show all the menu options.

In ESI, RMB click on a tree node will not show all the menu options.

This is the default behaviour of the Microsoft Management Console Framework. You need to select an item first before you do a right mouse button click to see the all the menu options.

SharePoint Failed to open the farm.

ESI SharePoint Adapter is not able to open a farm.

ESI uses SharePoint Foundation API. If the SharePoint components are installed, the machine running ESI must also have SharePoint Foundation API installed.

Server name or configuration database name may be wrong or misspelled. Verify the details and try again.

Authentication failure: The ESI server is not joined to or authenticated in the farm domain controller. Verify the domain settings and try again.

Network connection to the farm is unavailable. Verify the network connection is functioning and try again.

Wrong SQL server authentication method: Integrated Security used instead of SQL Authentication or vice versa. Verify the SQL server authentication method and try again.

SharePoint Share Point provisioning fails while creating the database.

Failed to create SQL server database while attempting to provision a web application.

Wrong SQL server authentication method: Integrated Security used instead of SQL Authentication or vice versa. Verify the SQL server authentication method and try again.

Wrong user name or password used. Verify the user name and password and try again.

Wrong login used. For example, SQL service is configured to run as ‘Network Service’. But, in the provisioning wizard, a specific user is specified. Verify the login and try again.

All supported platforms

User unable to see mounted CIFS shared folder on target host

Logoff/relogin can make active to reinitialize the shared folder view. Mapping drive of shared folder is specific for a user account which is not like lun/disk mounting belong the whole machine. And every user account can have different drive mapping for the same drive letter.

User can see the shared folder changes on the target host after logoff and relogin again.


Documents

EMC Storage Integrator for Windows · EMC Storage Integrator for Windows Technical Notes 8 While SPM enables ESI users to provision storage, it recognizes that the storage administrator