Deploying Storage Foundation for Databases (SFDB) tools ...

Veritas™ Storage FoundationApplication Note: DeployingStorage Foundation forDatabases (SFDB) tools withOracle Enterprise Manager

Veritas Storage Foundation™ Application Note:Deploying Storage Foundation for Databases (SFDB)Tools with Oracle Enterprise Manager

The software described in this book is furnished under a license agreement andmay be usedonly in accordance with the terms of the agreement.

Product version: 5.1 SP1

Document version: 5.1SP1.1

Legal NoticeCopyright © 2011 Symantec Corporation. All rights reserved.

Symantec, the Symantec logo, Veritas, Veritas Storage Foundation, CommandCentral,NetBackup, Enterprise Vault, and LiveUpdate are trademarks or registered trademarks ofSymantec corporation or its affiliates in the U.S. and other countries. Other names may betrademarks of their respective owners.

The product described in this document is distributed under licenses restricting its use,copying, distribution, and decompilation/reverse engineering. No part of this documentmay be reproduced in any form by any means without prior written authorization ofSymantec Corporation and its licensors, if any.

THEDOCUMENTATIONISPROVIDED"ASIS"ANDALLEXPRESSORIMPLIEDCONDITIONS,REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TOBELEGALLYINVALID.SYMANTECCORPORATIONSHALLNOTBELIABLEFORINCIDENTALOR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING,PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE INFORMATION CONTAINEDIN THIS DOCUMENTATION IS SUBJECT TO CHANGE WITHOUT NOTICE.

The Licensed Software andDocumentation are deemed to be commercial computer softwareas defined in FAR12.212 and subject to restricted rights as defined in FARSection 52.227-19"Commercial Computer Software - Restricted Rights" and DFARS 227.7202, "Rights inCommercial Computer Software or Commercial Computer Software Documentation", asapplicable, and any successor regulations. Any use, modification, reproduction release,performance, display or disclosure of the Licensed Software andDocumentation by theU.S.Government shall be solely in accordance with the terms of this Agreement.

Symantec Corporation350 Ellis StreetMountain View, CA 94043

http://www.symantec.com

http://www.symantec.com

Technical SupportSymantec Technical Support maintains support centers globally. TechnicalSupport’s primary role is to respond to specific queries about product featuresand functionality. TheTechnical Support group also creates content for our onlineKnowledge Base. The Technical Support group works collaboratively with theother functional areas within Symantec to answer your questions in a timelyfashion. For example, theTechnical Support groupworkswithProductEngineeringand Symantec Security Response to provide alerting services and virus definitionupdates.

Symantec’s support offerings include the following:

■ A range of support options that give you the flexibility to select the rightamount of service for any size organization

■ Telephone and/or Web-based support that provides rapid response andup-to-the-minute information

■ Upgrade assurance that delivers software upgrades

■ Global support purchased on a regional business hours or 24 hours a day, 7days a week basis

■ Premium service offerings that include Account Management Services

For information about Symantec’s support offerings, you can visit our Web siteat the following URL:

www.symantec.com/business/support/index.jsp

All support services will be delivered in accordance with your support agreementand the then-current enterprise technical support policy.

Contacting Technical SupportCustomers with a current support agreement may access Technical Supportinformation at the following URL:

www.symantec.com/business/support/contact_techsupp_static.jsp

Before contacting Technical Support, make sure you have satisfied the systemrequirements that are listed in your product documentation. Also, you should beat the computer onwhich theproblemoccurred, in case it is necessary to replicatethe problem.

When you contact Technical Support, please have the following informationavailable:

■ Product release level

http://www.symantec.com/business/support/index.jsp

http://www.symantec.com/business/support/contact_techsupp_static.jsp

■ Hardware information

■ Available memory, disk space, and NIC information

■ Operating system

■ Version and patch level

■ Network topology

■ Router, gateway, and IP address information

■ Problem description:

■ Error messages and log files

■ Troubleshooting that was performed before contacting Symantec

■ Recent software configuration changes and network changes

Licensing and registrationIf yourSymantecproduct requires registrationor a licensekey, access our technicalsupport Web page at the following URL:

www.symantec.com/business/support/

Customer serviceCustomer service information is available at the following URL:

www.symantec.com/business/support/

Customer Service is available to assist with non-technical questions, such as thefollowing types of issues:

■ Questions regarding product licensing or serialization

■ Product registration updates, such as address or name changes

■ General product information (features, language availability, local dealers)

■ Latest information about product updates and upgrades

■ Information about upgrade assurance and support contracts

■ Information about the Symantec Buying Programs

■ Advice about Symantec's technical support options

■ Nontechnical presales questions

■ Issues that are related to CD-ROMs or manuals

http://www.symantec.com/business/support/

http://www.symantec.com/business/support/

Support agreement resourcesIf youwant to contact Symantec regarding an existing support agreement, pleasecontact the support agreement administration team for your region as follows:

[email protected] and Japan

[email protected], Middle-East, and Africa

[email protected] America and Latin America

DocumentationYour feedback on product documentation is important to us. Send suggestionsfor improvements and reports on errors or omissions. Include the title anddocument version (located on the second page), and chapter and section titles ofthe text on which you are reporting. Send feedback to:

[email protected]

About Symantec ConnectSymantec Connect is the peer-to-peer technical community site for Symantec’senterprise customers. Participants can connect and share informationwith otherproduct users, including creating forum posts, articles, videos, downloads, blogsand suggesting ideas, as well as interact with Symantec product teams andTechnical Support. Content is rated by the community, and members receivereward points for their contributions.

http://www.symantec.com/connect/storage-management

mailto:[email protected]




http://www.symantec.com/connect/storage-management

Deploying StorageFoundation for Databases(SFDB) tools with OracleEnterprise Manager

This document includes the following topics:

■ About Symantec Plug-ins for Oracle Enterprise Manager

■ Requirements for Symantec Plug-in support for OEM

■ Deploying the Storage Foundation Plug-in for OEM

■ Deploying the Veritas Cluster Server Plug-in for Oracle Enterprise Manager

■ Adding instances for monitoring in the VCS Plug-in for OEM

■ Adding instances for monitoring in the Storage Foundation Plug-in for OEM

■ Viewing Storage Foundation Plug-in for OEM reports

■ Viewing Veritas Cluster Server Plug-in for OEM reports

■ Troubleshooting Symantec Plug-ins for OEM

About Symantec Plug-ins for Oracle EnterpriseManager

The Veritas Storage Foundation (SF) and Veritas Cluster Server (VCS) Plug-insfor Oracle EnterpriseManager (OEM) enable you to view Storage Foundation and

VCS objects through the OEM interface. The Symantec Plug-ins extendOEMGridControl to add support formanagingSymantec’s storage stackandRACextensions.

The Storage Foundation Plug-in enables you to view the following through theOEM interface:

■ VxFS properties

■ VxVM volume information

■ LUN information for database objects such as tablespace, redo logs, controlfile,datafiles

The Veritas Cluster Server Plug-in enables you to do the following through theOEM interface:

■ Monitor Veritas Cluster Server

■ Raise alerts and violations based on resource state

Requirements for Symantec Plug-in support for OEMStorage Foundation and High Availability product requirements are included in:

■ Veritas Storage Foundation™ Release Notes

■ Veritas Storage Foundation™ for Cluster File System Release Notes

■ Veritas Storage Foundation™ª for Oracle RAC Release Notes

■ Veritas Cluster Server™ª Release Notes

For Storage Foundation for Databases (SFDB) tools requirements:

See “Requirements for Storage Foundation forDatabases (SFDB) tools” onpage 9.

Hardware requirements for Symantec Plug-in support for OEMThere are no specific hardware requirements or limitations for theOEMPlug-ins.Consult the installation requirements in the documentation for your StorageFoundation product.

Software requirements for Symantec Plug-in support for OEMAll Storage Foundation Enterprise products on UNIX support the StorageFoundation Plug-in. All VCS products on UNIX support the VCS Plug-in.

The Storage Foundation Plugin supports the following Oracle database versions:

■ Oracle 10gR2

Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerRequirements for Symantec Plug-in support for OEM

8

■ Oracle 11gR1

■ Oracle 11gR2

■ Oracle 10gR2 RAC



Requirements for Storage Foundation for Databases (SFDB) toolsProduct requirements are included in:

■ Veritas Storage Foundation™ Release Notes

■ Veritas Storage Foundation™ for Cluster File System Release Notes

■ Veritas Storage Foundation™ for Oracle RAC Release Notes

The hardware compatibility list contains information about supported hardwareand is updated regularly. For the latest information on supported hardware visitthe following URL:

http://entsupport.symantec.com/docs/330441

For the most current information on Storage Foundation products and singleinstance Oracle versions supported, see:


For the most current information on Storage Foundation for Oracle RAC andOracle RAC versions supported, see:


Review the current Oracle documentation to confirm the compatibility of yourhardware and software.

Prerequisites for Symantec Plug-in support for OEMThe following prerequisites must be met before you can deploy the Plug-in:

■ Oracle Enterprise Manager Grid Control 10g Release 2 or higher system andAgent

■ The Symantec Plug-in can only be deployed on UNIX Enterprise ManagerAgents

■ Access must be granted to run plug in as Oracle user for the VCS plugin

9Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerRequirements for Symantec Plug-in support for OEM




Supported configurations for Symantec Plug-in support for OEMSymantec Plug-ins for OEM are supported for the following configurations:

■ Storage Foundation with single-instance Oracle

■ Storage Foundation HA with single-instance Oracle

■ Storage Foundation for Cluster File System with single-instance Oracle

■ Storage Foundation for Cluster File System HA with single-instance Oracle

■ Storage Foundation for Cluster File System with Oracle RAC database

■ Storage Foundation for Cluster File System HA with Oracle RAC database

■ Storage Foundation for Oracle RAC, with multiple-instance Oracle

The Storage Foundation Plug-in for OEM does not support:

■ Non-VxFS file systems

■ Non-VxVM volumes

■ SmartTier for Oracle

■ Volume or plex rename

■ Clone databases created from either checkpoints or snapshots

■ RAW datafiles

Deploying the Storage Foundation Plug-in for OEMFollow these steps to deploy the Storage FoundationPlug-in forOracle EnterpriseManager (OEM). The Storage Foundation and VCS Plug-ins can be deployedconcurrently or independently.

To deploy the Storage Foundation Plug-in for OEM

1 Get the symantec_storage.jar file from /opt/VRTSdbed/.dba directory ordownload it from the following Web site.

http://www.symantec.com/connect/downloads/plug-ins-oracle-enterprise-manager-oem

2 Log in to Enterprise Manager Grid Control as a Super Administrator.

3 Select the Setup link in the upper right corner of theGrid ControlHomepage,then click the Management Plug-ins link on the left side of the Setup page.

4 Select Import.

5 Select Browse and select the Plug-in archive.

6 Select List Archive to list the Plug-ins from the selected archive.

Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerDeploying the Storage Foundation Plug-in for OEM

10


7 Choose the Storage Foundation Plug-in for Oracle Enterprise Manager:

■ Select symantec_storage.

■ Click OK to confirm your choice.

8 Verify that you have set preferred credentials on all agents where you wantto deploy the Plug-in.

9 In the Management Plug-ins page, click the icon in the Deploy column forthe Symantec Storage Foundation Plug-in. The Deploy Management Plug-inwizard appears.

10 ClickAddAgents, then select one ormore agents towhich youwant to deploythe Plug-in. The wizard reappears and displays the agent you selected.

11 Click Next, then click Finish.

If you see an error message indicating that the preferred credential is not set up,go to the Preferences page and add the preferred credentials for the Agent targettype.

Deploying theVeritasCluster ServerPlug-in forOracleEnterprise Manager

After you ensure that the prerequisites are met, follow these steps to deploy theVeritas Cluster Server Plug-in forOracle EnterpriseManager (OEM). TheVCSandStorage Foundation Plug-ins can be deployed concurrently or independently.

To deploy the VCS Plug-in for OEM

1 Get the vcs.jar file from /opt/VRTSvcs/rac/oem/vcs.jar directory or downloadfrom the following Web site.


2 Log in to Enterprise Manager Grid Control as SYSMAN User.

3 Select the Setup link in the upper right corner of theGrid ControlHomepage,then click the Management Plug-ins link on the left side of the Setup page.

4 Select Import.

5 Select Browse and select the Plug-in archive.

6 Select List Archive to list the Plug-ins from the selected archive.

7 Choose the VCS Plug-in for Oracle Enterprise Manager:

■ Select VCS.

■ Click OK to confirm your choice.

11Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerDeploying the Veritas Cluster Server Plug-in for Oracle Enterprise Manager


8 Verify that you have set preferred credentials on all agents where you wantto deploy the Plug-in.

9 In the Management Plug-ins page, click the icon in the Deploy column forthe Symantec Foundation Plug-in. The Deploy Management Plug-in wizarddisplays.

10 ClickAddAgents, then select one ormore agents towhich youwant to deploythe Plug-in. The wizard reappears and displays the agent you selected.

11 Click Next, then click Finish.

If you see an error message indicating that the preferred credential is not set up,go to the Preferences page and add the preferred credentials for the Agent targettype.

Adding instances for monitoring in the VCS Plug-infor OEM

Follow these steps to add the Plug-in target toGrid Control for centralmonitoringand management.

To add an instance for monitoring Veritas Cluster Server

1 On the Targets tab, select the target to be monitored.

For example: see Figure 1-2 below.

2 Select Veritas Cluster Server and click Go.

3 Add a name for the target type: VCS.

Figure 1-1 Select target for monitoring

Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerAdding instances for monitoring in the VCS Plug-in for OEM

12

Figure 1-2 Select target type

Figure 1-3 Add target name

Adding instances for monitoring in the StorageFoundation Plug-in for OEM

Follow these steps to add the Plug-in target toGrid Control for centralmonitoringand management.

To add an instance for monitoring in the Storage Foundation Plug-in for OEM(symantec_storage)

1 In the Agent home page, select the symantec_storage target type from theAdd drop-down list, then click GO. The Add Symantec Storage page appearsas below.

2 Add the requested information for:

■ Machine name

■ Port

■ ORACLE_HOME

13Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerAdding instances for monitoring in the Storage Foundation Plug-in for OEM

■ SID

■ USERNAME

■ password for SID

3 Click OK to confirm.

TheStorageFoundationPlug-inhomepagedisplays,whichmay take aminute.

Figure 1-4 Add Symantec Storage page

Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerAdding instances for monitoring in the Storage Foundation Plug-in for OEM

14

Figure 1-5 Storage Foundation Plug-in home page

Viewing Storage Foundation Plug-in for OEM reportsViewing reports in the Storage Foundation Plug-in for OEM

1 Before displaying reports in Oracle Enterprise Manager, run dbed_update.

2 In the Storage Foundation Plug-in home page, select the Reports page. TheReports overview page describes the database information on SymantecStorage software as shown below.

Hourly and daily volume statistics provide a graphical display of volume statistics(KB read/written) over a user-selectable time period. The volume statistics reportsare accessible from the Reports tab in Enterprise Manager. Database objects aremapped to the Symantec storage stack. Reports are categorized as:

■ Tablespace

■ Datafile

■ Controlfile

■ Redolog

■ File

■ Temp datafile

15Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerViewing Storage Foundation Plug-in for OEM reports

Figure 1-6 Reports overview page

On the Tablespace Report page, the tablespace name is mapped to VxFS mountpoint, mount properties with volume usage in readable form.

Figure 1-7 Tablespace report

Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerViewing Storage Foundation Plug-in for OEM reports

16

The Datafile report maps the datafile and its tablespace to Symantec volumes &file systems with detailed property information and the LUNs being used by thevolume containing the datafile.

Figure 1-8 Datafile report

The controlfile, tempfile, and redo log reports are similar to the Datafile Report.

Figure 1-9 Volume Statistics Daily Report

17Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerViewing Storage Foundation Plug-in for OEM reports

Figure 1-10 Volume Statistics Hourly Report

Viewing Veritas Cluster Server Plug-in for OEMreports

The Veritas Cluster Server Plug-in uses the VCS commands to gather theinformation on the target server. Therefore, the Oracle user on the target servershould be authorized to use the VCS commands.

To authorize the Oracle user to use the VCS commands

1 On the target server, as a superuser, create a VCS user with guest privileges.

# hauser -add username -priv Guest

2 On the target server, as an Oracle user, authorize the Oracle user to use theVCS commands.

$ halogin username

To view the VCS Plug-in for OEM reports

1 On the Oracle Enterprise Manager home page, select the Targets tab.

2 Click on the host name for which you want to view the reports.

Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerViewing Veritas Cluster Server Plug-in for OEM reports

18

3 On the host details page, select Targets > VCS Plug-in Target Name.

Note: In the Targets table, to identify a VCS Plug-in target, look for the entryVeritas Cluster Server in the Type column.

4 On the VCS Plug-in page, select the Reports tab.

You can view the following information in the VCS Plug-in for OEM reports:

■ Cluster Information

■ Cluster Name

■ I/O Fencing Mode

■ Cluster Nodes

■ Node

■ Node ID

■ Database Instances

■ Resources

■ Service Group

■ SID

■ Oracle Home

■ Detailed Monitor

■ VCS-controlled Oracle Listeners

■ Listener

■ Node

■ VIP

■ Private Interconnects

■ Node

■ Private IP

■ Device

19Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerViewing Veritas Cluster Server Plug-in for OEM reports

Figure 1-11 Cluster Configuration report

To view the VCS Plug-in for OEM metrics

1 On the VCS Plug-in home page, select the Home tab.

2 Under Related Links, select All Metrics.

You can gather the following metrics in the VCS Plug-in for OEM:

■ CRS

■ CRS State

■ dbResource

■ Database State

■ Detailed Monitoring

■ SID

■ Oracle Home

■ Listeners

■ Listener State

■ VIP

Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerViewing Veritas Cluster Server Plug-in for OEM reports

20

■ lmxstat

■ rxPkts

■ txPkts

■ privnicAddress

■ Address

■ Device

■ VCS

■ Fencing Mode

■ VCS Nodes

■ Node State

■ Node ID

Figure 1-12 All Metrics page

Troubleshooting Symantec Plug-ins for OEMTo troubleshoot a Symantec OEM Plug-in problem, you must determine whichcomponent is causing the difficulty. It could be the agent or the OracleManagement Server (OMS).

To check the agent if the agent is running the the monitoring scripts

1 Go to the agent home directory.

2 Configure the agent to start the metric browser: editsysman/log/emd.properties and set enableMetricBrowser=true (it'scommented out by default).

21Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerTroubleshooting Symantec Plug-ins for OEM

3 While you have the file open, search for EMD_URL and make a note of it.

4 Make the agent re-read its config: ./bin/emctl reload agent.

5 From the EMD_URL, change /emd/main to /emd/browser/main and go tothat URL. You should see all the targets that this agent is monitoring,including the Symantec Storage target you've added.

6 Selecting any target will display the list of metrics. Selecting any metricdisplayed should run the correspondingmonitoring script and display a tableof results.

As long as the metric browser shows correct results, the agent is correctlyable to gather metrics.

To find an error in the monitoring scripts

1 If the metric browser doesn't show the correct results, look atsysman/log/emagent.{log,trc}. One of the files should tell you if you have, forexample, some error in the monitoring scripts.

2 The lines in the logs are tagged with target name and type. Search forsymantec to get to the problem more quickly.

3 The ./bin/emctl status agent showshowmuchdata the agent has yet to uploadto the OMS. If this value is not getting any smaller, the agent is unable toreach the OMS.

To find an error in the Oracle Management Server (OMS)

◆ Search theOMShomedirectory for similar logs in sysman/log/emoms.{log,trc}for troubleshooting the OMS.

To correct volume properties not displaying correctly

◆ Run dbed_update.

Deploying Storage Foundation for Databases (SFDB) tools with Oracle Enterprise ManagerTroubleshooting Symantec Plug-ins for OEM

22

Deploying Storage Foundation for Databases (SFDB) tools ...

Documents

Transcript of Deploying Storage Foundation for Databases (SFDB) tools ...