HP Storage Essentials SRM Enterprise Edition 6.0 Application Integration Software for SAP ACC version A.02.
Legal and notice information © Copyright 2002-2008 Hewlett-Packard Development Company, L.P. Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Contents About This Guide . . . . . . . . . . . . . . Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 To remove a previous version of the Application Integration Software for SAP ACC . . . . 24 5 Interprocess Communications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Communication Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OpenSSH Installation and Configuration . . . .
Figures 1 2 3 4 5 6 7 8 9 10 Components to create a virtualized application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Virtual SAP instance on physical server HostA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 SAP instance is moved from HostA to HostB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Architecture for SAP Adaptive Computing Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi
Tables 1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
viii
About This Guide This guide provides information about the implementation of the HP Storage Essentials Storage Resource Management (SRM) Enterprise Edition Application Integration Software for SAP Adaptive Computing Controller. The Application Integration Software is available with HP Storage Essentials Storage Resource Management (SRM) to enable and integrate with the Adaptive Computing Controller from SAP when using SAN attached storage on HP StorageWorks arrays.
Document Conventions and Symbols Document conventions Table 1 Convention Element Medium blue text: Figure 1 Cross-reference links and e-mail addresses Medium blue, underlined text (http://www.hp.
TIP: Provides helpful hints and shortcuts. HP Technical Support Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support/.
xii
1 SAP Adaptive Computing Overview This chapter describes the following: • SAP ACC Overview, page 2 • Application Integration Software for SAP ACC, page 9 With the increasing complexity and inflexibility of the traditional SAP® environment, it has become necessary to rethink the way that a SAP environment is managed.
SAP ACC Overview The following section provides some basic background on the structure and functionality of the SAP Adaptive Computing Controller (SAP ACC). For more detailed information, refer to the documentation provided by SAP on this subject. It is available at http://service.sap.com/adaptive. This URL requires you to provide an SAP S-user ID.
storage resources that are associated with that instance. This allows HP Storage Essentials SRM to Present or Un-present this storage from any host in the SAN. In the following figure, the virtual SAP instance is running on physical server HostA. The SAP Instance has two SAN-attached storage devices mapped from the storage array to the server.
The following figure shows the status of the landscape after the service relocation is completed. Figure 3 SAP instance is moved from HostA to HostB The SAP ACC gives the SAP administrator the power and flexibility to stop, start, or relocate any SAP instance to any system in the landscape when needed and based on what resources are available. SAP ACC Components SAP developed the ACC as a system management-like application based on the J2EE engine of the Web application server.
The following is a high level diagram of the SAP ACC Architecture. Figure 4 Architecture for SAP Adaptive Computing Controller The ACC station or Control node consists of the NetWeaver 7.1 Java Engine and the Adaptive Computing Controller software. The ACC software communicates with the System Landscape Directory (SLD) to derive a list of Managed Nodes installed in the SAP Landscape.
providing the necessary integration modules.
The following figure provides an overview of the SAP ACC integration library, the functions implemented, and the available vendor integration point. Figure 5 Overview of the SAP ACC library Keep in mind the following about Figure 5, “Overview of the SAP ACC library,” on page 7: • The platform-specific modules are provided by each platform hardware/operating system support team.
NOTE: Platform specific libraries are required to install or convert a SAP installation to a virtual landscape. These libraries enable virtual IP addresses on the Managed Nodes. Virtualized Data Adaptive Computing also implements the concept of virtualizing the application data into a single group of data devices (Storage Resources) that can be moved between physical Managed Nodes.
Figure 6 Relationship between physical storage and file systems for HP-UX systems Operating system disk management utilities allow you to combine or subdivide the physical devices into custom-sized file systems, each with a specific mount point on the host. To successfully move physical resources between systems, without impacting other applications, make sure that the physical drives and all associated objects belong only to the SAP instance identified by the SRID.
• HP Storage Essentials SRM Enterprise Edition, page 10 • Active Host Management Interface, page 10 • Application Integration Software, page 10 HP Storage Essentials SRM Enterprise Edition The HP Storage Essentials SRM Enterprise Edition product suite provides an integrated array management functionality for storage provisioning and Managed Node management. The Application Integration Software for SAP ACC is built on the HP Storage Essentials SRM API functions.
2 Creating an Adaptive Landscape This chapter describes the following: • SAP Virtual Landscape, page 11 • Configuring the SAP ACC Landscape, page 12 • Configuring the SAP Instance, page 13 How you create your adaptive landscape will depend on your environment. Consider the following: • For new SAP installations, the landscape should be designed and implemented with virtualization in mind, even if you do not plan to utilize virtualization at this stage.
NOTE: Always use the latest support pack recommended by SAP. This release supports SAP ACC version 7.1. SAP Netweaver 7.1 is a component of SAP ACC version 7.1. Configuring the SAP ACC Landscape The following steps describe the high-level actions necessary to configure the SAP ACC landscape. For more detailed instructions, consult the SAP documentation for installing and configuring SAP adaptive computing. To configure the SAP ACC landscape 1. Set up the SAP ACC 7.
Configuring the SAP Instance Using the SAP ACC interface, you must define the appropriate Storage Vendor integration module to be used for each Adaptive enabled SAP instance. The following shows you what the SAP ACC interface looks like: Figure 7 Configuring the Storage Integration in the SAP ACC Interface To configure the Storage integration in the SAP ACC interface 1. Select the Configuration link on the left side of the dialog. 2. Select the appropriate SAP Instance in the upper panel. 3. Click Edit.
14 Creating an Adaptive Landscape
3 Install HP Storage Essentials SRM and HP SIM This chapter describes the following: • User Account, page 15 • Storage System Considerations, page 16 IMPORTANT: Refer to the release notes to determine which versions of HP Storage Essentials Storage Resource Management (SRM) and HP Systems Insight Manager (SIM) are supported. Prior to installing the Application Integration Software for SAP ACC, HP Storage Essentials SRM and HP SIM must be installed and configured.
NOTE: When you create custom users, they must belong to the Storage Administrator role or Domain Administrator role. Only users assigned to the Storage Administrator role or Domain Administrator role can access the Application Integration Software for SAP ACC.
specific port in the array and present all adaptive enabled physical storage to that host group. It creates this special host group to ensure that a physical storage device will always have at least one presentation to a host group. The Reserved-Group will be created when the first storage resource for a storage array is defined in the Application Integration Software. NOTE: The HP StorageWorks XP array has a limit for the number of physical devices that can be assigned per host group and per port.
18 Install HP Storage Essentials SRM and HP SIM
4 Install the Application Integration Software for SAP ACC This chapter describes the following: • Requirements, page 19 • New Installation, page 19 • Upgrade Installation, page 22 • Uninstall, page 24 Requirements The Application Integration Software for SAP ACC is dependent on the prior successful installation of the following software components on the same server: • HP Storage Essentials SRM Enterprise Edition software • HP System Insight Manager • The HP Storage Essentials SRM/SIM Connector The Applic
NOTE: If setup.exe is run from a shared drive, a warning message might appear asking for confirmation if the application is safe to run. Click OK to start the installation process. The HP SE SAP ACC Integration Installation window opens. NOTE: If the HP SE SAP ACC Integration Installation window does not open after clicking setup.exe, and instead, an error message is displayed stating "To run this application, you first must install one of the following versions of the .
5. Read and accept the license agreement. 6. Click Next. The Choose Destination Location window opens. 7. Accept the default location or click Change to select another folder location. The default location to install the Application Integration Software for SAP ACC is %SystemDrive%\Program File\HP\SE_SAP_ACC_Integration NOTE: It is recommended that you use the default installation location. 8. Click Next. The Ready to Install the Program window opens. 9. Click Install to begin the installation.
The user name and password settings for HP Storage Essentials SRM and HP Systems Insight Management allow the Application Integration Software for SAP ACC to communicate with HP Storage Essentials SRM and HP System Insight Management so that storage movement operations can be performed. If you do not know the user name and password settings for HP Storage Essentials SRM and HP Systems Insight Manager, ask your system administrator to enter this information. 10.
NOTE: If the HP SE SAP ACC Integration Installation window does not open after clicking setup.exe, and instead an error message is displayed stating "To run this application, you first must install one of the following versions of the .NET framework:", the user must uninstall any prior version of HP SE SAP ACC Integration Software. The uninstall procedure is described in Uninstall, page 24. After completing the uninstall process, the user must proceed to step 4 below.
IMPORTANT: Verify that the AppStorManager service has been started. The AppStorManager service runs HP Storage Essentials SRM. To allow user login and other normal operations, the Application Integration Software for SAP ACC depends on the AppStorManager service running. The AppStorManager service is not part of the Application Integration Software for SAP ACC. Uninstall The following procedure explains how to remove the Application Integration Software for SAP ACC.
5 Interprocess Communications This chapter describes the following: • Communication Methods, page 25 • OpenSSH Installation and Configuration, page 26 Communication Methods The Adaptive Computing Integration Software uses different communication methods to enable all the different components to communicate with each other. For successful implementation, it is necessary to understand the communication methods and the dependencies between the products.
5. HP SE API: Used by HP Integration Software for SAP ACC (uses API to call native HP SE provisioning operations for HP storage arrays) to perform storage management. OpenSSH Installation and Configuration Secure Shell (OpenSSH) is used for communication between HP SIM and the Managed Nodes. The following is a high level sequence for installing and configuring OpenSSH in the adaptive landscape.
User Guide 27
28 Interprocess Communications
6 Install the Integration Library on Managed Nodes This chapter describes the following: • Installing the Storage Specific Integration Library on Managed Nodes, page 29 • Uninstalling the Storage Specific Integration Library on Managed Nodes, page 30 The HP Storage Essentials SRM SAP ACC Integration Software contains a feature that installs/updates and uninstalls the storage specific integration library on the Managed Nodes.
3. Click the Integration Library tab. An "Opening page…" message is displayed at the bottom of the Internet Explorer window prior to displaying the Integration Library page. This tab lists the hosts discovered in HP Storage Essentials SRM, along with the operating system on which each host is running. The Integration Library version is unknown for all hosts, until a specific library version is distributed to that host.
The Uninstall Integration Library window opens. This window confirms the version number of the Integration Library that is about to be uninstalled on the selected host. 3. Click Finish to confirm that you want to uninstall the library. If the process completes successfully, Unknown is displayed in the Integration Library Version field for that host.
32 Install the Integration Library on Managed Nodes
7 Storage Resource Information This chapter provides information about the following: • Adding a Storage Resource Identifier, page 33 • Viewing Resource Information, page 38 • Removing a Storage Resource, page 38 Adding a Storage Resource Identifier The HP Storage Essentials SRM SAP ACC Integration Software saves the Storage Resource Identifiers (SRIDs) in the Integration Software’s database. Actual file system and physical devices are obtained from the host that has the Storage Resource(s) active.
After successful authentication, the HP Storage Essentials SRM SAP ACC integration Main Menu opens. On the Storage Resources tab, the list of Storage Resources is displayed. This list is empty the first time you add a resource. 3. Click Add to add a Storage Resource. The Add Storage Resource window opens. 4. In the Add Storage Resource window, specify the following: • Storage Resource Name: Enter the Storage Resource ID.
Figure 9 Associating physical storage to the storage resource 6. Select all mount points belonging to the SAP instance. Multiple file systems can be selected. A file system can only belong to one Storage Resource at any time. If the file system is already defined in a Storage Resource (resource name is listed in the Storage Resource Name column of display), it is not possible to select this resource again. NOTE: Collecting the selected server’s file systems and storage data may take some time. 7.
• Host Group Name: The Application Integration Software creates a host group with the default name SAP ACC Reserved on the array port (next field) and assigns all the physical devices used in the Adaptive Computing environment to this group. You can re-name the host group name used for the reserved port, either when defining the port in this dialog box, or in the Program Properties tab on the Main Menu. A new or existent group name can be used.
NOTE: This process can take some time, due to storage provisioning to the reserve pool. After successful completion of adding a Storage Resource, the HP Storage Essentials SRM SAP ACC Integration Software returns to the Main Menu and the newly added Storage Resource is displayed in the table of configured Storage Resources. Figure 10 Storage resource information displayed in Main Menu The Status column displays the current status of this storage.
NOTE: The HP SAP ACC Integration Software displays the last known status for the resource. NOTE: If mounting or dismounting a resource is interrupted prior to completion, the status may be displayed as Dismounting or Mounting. Viewing Resource Information After adding a storage resource to a Managed Node using the HP Storage Essentials SRM Application Software for SAP ACC, it is possible to see detailed information about that storage resource. To view resource information 1.
reserved group. In this case, the physical devices are no longer presented to any port on the array, and it is considered to be available to other applications. Check this box if the resource is not mounted and this is what you want to occur when removing the resource. Otherwise, if the data on the devices is important to you, first mount the resource on a Managed Node using the SAP ACC interface, before deleting the resource.
40 Storage Resource Information
8 Application Logs The log files for all storage operations are located on the HP Storage Essentials SRM server under%SystemDrive%\Program File\HP\SE SAP ACC Integration\logs folder. The log files can also be accessed from the Main Menu of the Application Integration Software GUI.
3. To see more details about an event, select the check box next to the event description and then click Properties. The Application Log Detail window opens. 4. Click Finish to close the detail window.
9 Program Properties This chapter describes the following: • Changing the User Name and Password Used for Communicating with HP Storage Essentials SRM, page 43 • Changing the Reserved-Group Assignment, page 43 You can use the Program Properties tab on the Main Menu to perform these tasks as described in the following sections.
NOTE: The concept of a Reserved-Group only applies to Hp StorageWorks XP arrays. To change the Reserved-Group assignment for a specific array: 1. Click the Program Properties tab from the Main Menu. 2. On the Program Properties tab under the Reserved-Group Assignment pane, select the storage array to be modified. 3. Click Properties. The Modify Reserved-Group Assignment window opens.
10 Operational Details This chapter describes the following: • Operational Information, page 45 • Location of Important Log Files, page 49 • Common Issues, page 49 Operational Information The movement of the application is initiated and controlled from the SAP ACC interface. The administrator has a choice of five operations: prepare, start, unprepare, stop, or relocate a resource, where relocate is a combination of the other four operations on one Managed Node.
Figure 11: Flow diagram of operational details This flow diagram can also be used to trace any issues and to determine which log file to look at for failure events. 1. Lock Managed Node. This is an SAP ACC operation to lock any other ACC operations for the specific Managed Node, to ensure that only one operation will be performed on any node at any time. If some other node is already performing an operation, the new request will be put on hold until the previous operation completes.
3. SAP ACC verifies the “sapacosprep.exe” installation and version by running the following command: sapacosprep -a diag The following is the typical output for this command: INFO, OSP-0191, Running SAPACOSPrep diagnostics INFO, OSP-0193, SAPACOSPrep information: program version: 1.0.6 (compiled at: Apr 6 2008, systemid: 274 (HP (IA-64) with HP-UX), relno: 7100, patchno: 99, intno: 20020600); partner API version: 1 INFO, OSP-0195, Library information: HPUX platform module; library version: 1.1.
This is an internal check from the Integration core service to ensure that the Managed Node is accessible and configured in the Application Integration Software. If the Managed Node is not accessible, a potential problem can be that the Hostagent service is not running. Another potential issue can be that the Managed Node is indicated as missing in HP Storage Essentials SRM.
The Application Integration Software for SAP ACC has one very important change in operation when handling a prepare (attach) operation. When receiving a prepare request, the Application Integration Software must first determine if the physical storage associated with this request is already presented to any Managed Node.
• If the SAP ACC process does not perform the “sapacosprep storage Library function AcDetachSr/AcAttachSr” operation, make sure that storage resource for this instance is configured as type “SR” and that Partner ID field is set to HP. • Ensure that the “sapacosprep -a diag” call does recognize the HP Library. For HP-UX, there are two HP Libraries, libsapacosprep_hp.sl and libsapacosprep_hp.so.
1. Optionally schedule a Run Discovery Data Collection operation to refresh all HP Storage Essentials SRM element data. This operation should be scheduled to run at off-peak hours when SAP ACC Integration is not being used. 2. Perform a manual Run Discovery Data Collection operation after any manual changes on the storage array or Managed Nodes. Failed Mount Operation with HP-UX Hosts If a mount or dismount operation fails to complete for any reason (for example, array locked by another user, etc.
52 Operational Details
Index A E adaptive landscape creating 11 adding Storage Resource Identifier 33 administrator account 15 Application Integration Software checking installation 23 installing 19 overview 1 requirements 19 application logs 41 audience ix authorized reseller, HP xi event management 41 C changing connection information for HP Storage Essentials SRM 43 reserved group assignments 43 checking installation 23 CIM ix common issues 49 components 4 configuring SAP instance 13 SAP landscape 12 conventions document x
mx.
