EMC Celerra Network Server

Release 6.0

Using Celerra Event Enabler

P/N 300-009-995 REV A01

EMC Corporation Corporate Headquarters: Hopkinton, MA 01748-9103 1-508-435-1000 www.EMC.com

Copyright 2010 - EMC Corporation. All rights reserved. Published September 2010 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 regulatory document for your product line, go to the Technical Documentation and Advisories section on EMC Powerlink. For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarks used herein are the property of their respective owners. Corporate Headquarters: Hopkinton, MA 01748-9103

Using Celerra Event Enabler 6.0

Contents

Preface.....................................................................................................5 Chapter 1: Introduction...........................................................................7

Overview..................................................................................................................8 System requirements...............................................................................................9 Restrictions...............................................................................................................9 Related information..............................................................................................10

Chapter 2: Installing..............................................................................13
Install Celerra Event Enabler...............................................................................14 Complete the CEE installation for Windows Server........................................17 Uninstall Celerra Event Enabler..........................................................................18

Chapter 3: Third-Party Consumer Applications..................................19

Overview................................................................................................................20 Set up consumer application access....................................................................22

Chapter 4: Troubleshooting..................................................................23
EMC E-Lab Interoperability Navigator..............................................................24 Error messages.......................................................................................................24 EMC Training and Professional Services...........................................................24

Glossary..................................................................................................27 Index.......................................................................................................31

Using Celerra Event Enabler 6.0

Contents

Using Celerra Event Enabler 6.0

Preface

As part of an effort to improve and enhance the performance and capabilities of its product lines, EMC periodically releases revisions of its hardware and software. Therefore, some functions described in this document may not be supported by all versions of the software or hardware currently in use. For the most up-to-date information on product features, refer to your product release notes. If a product does not function properly or does not function as described in this document, please contact your EMC representative.

Using Celerra Event Enabler 6.0

Preface

Special notice conventions EMC uses the following conventions for special notices:
CAUTION: A caution contains information essential to avoid data loss or damage to the system or equipment.

Important: An important note contains information essential to operation of the software.

Note: A note presents information that is important, but not hazard-related.

Hint: A note that provides suggested advice to users, often involving follow-on activity for a particular action.

Where to get help EMC support, product, and licensing information can be obtained as follows: Product information For documentation, release notes, software updates, or for information about EMC products, licensing, and service, go to the EMC Powerlink website (registration required) at http://Powerlink.EMC.com. Troubleshooting Go to Powerlink, search for Celerra Tools, and select Celerra Troubleshooting from the navigation panel on the left. Technical support For technical support, go to EMC Customer Service on Powerlink. After logging in to the Powerlink website, go to Support Request Support. To open a service request through Powerlink, you must have a valid support agreement. Contact your EMC Customer Support Representative for details about obtaining a valid support agreement or to answer any questions about your account.
Note: Do not request a specific support representative unless one has already been assigned to your particular system problem.

Your comments Your suggestions will help us continue to improve the accuracy, organization, and overall quality of the user publications. Please send your opinion of this document to:
techpubcomments@EMC.com

Using Celerra Event Enabler 6.0

1 Introduction

The EMC Celerra Event Enabler (CEE) framework is used to provide a working environment for the following facilities:

EMC Celerra AntiVirus Agent (CAVA) EMC Celerra Event Publishing Agent (CEPA)

CAVA is the EMC-provided agent running on a Windows server that communicates with a standard antivirus engine to scan CIFS files stored on a Celerra Network Server. CEPA is the EMC-provided agent running on a Windows server that provides external applications with notification and optional control of changes made by CIFS and NFS clients in file systems on the Celerra Network Server in real time. While the Celerra Event Enabler framework includes both CAVA and CEPA, they can run independently of each other or run together. This document is part of the Celerra Network Server documentation set, and is intended for use by customers who wish to use consumer applications (such as for quotas or content type) to manage content stored on Celerra file systems. Topics included are:

Overview on page 8 System requirements on page 9 Restrictions on page 9 Related information on page 10

Using Celerra Event Enabler 6.0

Introduction

Overview
The EMC Celerra Event Enabler framework contains the following facilities:

Celerra AntiVirus Agent Celerra Event Publishing Agent

Celerra AntiVirus Agent The EMC Celerra AntiVirus Agent (CAVA) provides an antivirus solution to clients using a Celerra Network Server. It uses industry-standard Common Internet File System (CIFS) protocols in a Microsoft Windows Server domain. CAVA uses third-party antivirus software to identify and eliminate known viruses before they infect files on the storage system. Using Celerra AntiVirus Agent contains information about using CAVA.

Celerra Event Publishing Agent The EMC Celerra Event Publishing Agent (CEPA) is a mechanism whereby applications can register to receive event notification and context from Celerra. CEPA delivers to the consuming application both event notification and associated context (file/directory metadata needed to make a business policy decision) in one message. Using Celerra Event Publishing Agent contains information about using CEPA.

Using Celerra Event Enabler 6.0

Introduction

System requirements
Table 1 on page 9 describes the Celerra Network Server software, hardware, network, and storage configurations.
Table 1. System requirements Software Windows Server or any Windows operating system compatible with the vendors consumer application software. Two kits are available:

EMC_CEE_Pack_Win32_xxxx for installation on Windows 32-bit operating systems EMC_CEE_Pack_x64_xxxx for installation on Windows 64-bit operating systems

where xxxx = software version number You cannot install both a 32-bit and a 64-bit version of the software on the same machine. Note: Running CEE in the Windows on Windows (WOW) environment on a 64-bit platform is not supported. Search the EMC E-Lab Interoperability Navigator for consumer applications supported when using Celerra Event Enabler. Hardware A workstation with:

600-megahertz Pentium III-compatible or faster. 512 megabytes of RAM. 80 megabytes of free disk space.

Network

The Windows network must contain a domain controller with Active Directory and DNS enabled. Data Movers on the Celerra Network Server must be configured with the CIFS protocol. You cannot use a Virtual Data Mover for the CIFS protocol. Configuring Celerra for the Windows Environment provides more information on configuring the CIFS protocol.

Storage

No specific storage requirements.

Restrictions
The following is a known limitation at the time of publication.
Note: The Celerra Network Server Release Notes contain the most up-to-date information on product issues.

System requirements

Introduction

CEE and Windows 64-bit operating systems In order to run CEE on Windows 64-bit operating systems, the Celerra-to-CEE communications must be over Microsoft Remote Procedure Call (MS-RPC). The version of CEE that runs on Windows 64-bit operating systems is supported with Celerra version 5.6.45 or later and CEE version 4.5.0.4 or later.

CAVA/CEPA servers Each Data Mover should have a CAVA pool consisting of a minimum of two CAVA servers specified in the Data Movers viruschecker.conf file, or a CEPA pool consisting of a minimum of two CEPA servers specified in the Data Movers cepp.conf file.

Related information
After the Celerra Event Enabler is installed, refer to the following documents for instructions on using the software:

Using Celerra Event Publishing Agent Using Celerra AntiVirus Agent

Specific information related to the features and functionality described in this document is included in:

Celerra Network Server Command Reference Manual Online Celerra man pages Celerra Network Server Parameters Guide

EMC Celerra Network Server Documentation on Powerlink The complete set of EMC Celerra customer publications is available on the EMC Powerlink website at http://Powerlink.EMC.com. After logging in to Powerlink, click Support, and locate the link for the specific product technical documentation required.

Celerra Support Demos Celerra Support Demos are available on Powerlink. Use these instructional videos to learn how to perform a variety of Celerra configuration and management tasks. After logging in to Powerlink, click Support. Then click the link for the specific product required. Click Tools. Locate the link for the video that you require.

10

Using Celerra Event Enabler 6.0

Introduction

Celerra wizards Celerra wizards can be used to perform setup and configuration tasks. Using Wizards to Configure Celerra provides an overview of the steps required to configure a Celerra Network Server by using the Set Up Celerra wizard.

Use of the term Windows Server As the CEE implementation for Celerra is the same for Windows Server 2003 and Windows Server 2008, the term Windows Server is used in the document to depict both these operating systems.

Related information

11

Introduction

12

Using Celerra Event Enabler 6.0

2 Installing

Topics to install the Celerra Event Enabler framework include:

Install Celerra Event Enabler on page 14 Complete the CEE installation for Windows Server on page 17 Uninstall Celerra Event Enabler on page 18

Using Celerra Event Enabler 6.0

13

Installing

Install Celerra Event Enabler

Before you begin 1. Synchronize date/time stamps on Celerra File Systems and domain servers by running the following command:
server_date server_# -timesvc start ntp <domain controller ip>

2. Table 2 on page 14 provides information that is needed before installing the Celerra Event Enabler framework software. Fill in the information pertinent to your company.
Table 2. Installation prerequisites Prerequisite Your company's data

User account with local administrator privileges to Account name: set up a CEPA account on domain server where Account password: Celerra Event Enabler will be installed.This information is required for Install Celerra Event Enabler on page 14. Windows server available where Celerra Event En- IP address: abler will be installed. This information is required for Install Celerra Event Enabler on page 14. Windows domain server Domain name: IP address: CIFS server configured for use with the Windows domain server Celerra File Systems IP address:

File System names:

Procedure 1. Log in to the domain as an administrator. 2. If the Windows Server where you want to install the Celerra Event Enabler software already has CAVA software earlier than version 5.6 installed, you must uninstall it before installing the Celerra Event Enabler software: a. From the Windows taskbar, click Start and select Settings Control Panel. b. Double-click Add or Remove Programs. c. Select EMC CAVA from the list. d. Click Change/Remove.

14

Using Celerra Event Enabler 6.0

Installing

The CAVA software will be removed from the Windows server. 3. Insert the Celerra Event Enabler software distribution CD into the CD drive of the Windows server where you want to install the Celerra Event Enabler software. If Windows Autorun is enabled and the InstallShield Wizard window appears, skip to step 8; otherwise, go to step 4. 4. From the Windows taskbar, click Start and select Run. The Run dialog box appears. 5. From the Run dialog box: a. Click Browse to locate the EMC_CEE_Pack executable file on the Celerra Event Enabler CD. b. Select the EMC_CEE_Pack executable file for either the 32-bit (_Win32) or the 64-bit (_x64) version of the software. c. Click OK to start the InstallShield Wizard. The Welcome to the InstallShield Wizard for EMC Celerra Event Enabler Framework Package window appears:

If you have the most current version of InstallShield, the License Agreement window appears. Skip to step 9. If you do not have the most current version of InstallShield, you are prompted to install it. Go to step 6.

6. Click Next. The Location to Save Files window appears. 7. Click Next.
Note: Do not change the location of the temporary directory.

The Extracting Files process runs and returns to the Welcome to the InstallShield Wizard window. 8. Click Next. The License Agreement window appears. 9. Click I accept the terms in the license agreement, and click Next. The Customer Information window appears. 10. Type a username and organization, and click Next. The Setup Type window appears. 11. Select Complete, and click Next. The Symantec SAV for NAS window appears. 12. If you are using Symantec antivirus software, select Work with Symantec SAV for NAS and the option for the SAV version you are using; otherwise, click Next. The Ready to Install the Program window appears.

Install Celerra Event Enabler

15

Installing

13. Click Install. After the program is installed, the InstallShield Wizard Completed window appears. 14. Click Finish. The EMC Celerra Event Enabler Installer Information window appears and prompts you to restart the server. 15. Click No. You will restart the computer during the next procedure. Go to Complete the CEE installation for Windows Server on page 17 to finish the Celerra Event Enabler installation.

16

Using Celerra Event Enabler 6.0

Installing

Complete the CEE installation for Windows Server

1. From the Windows taskbar, click Start Settings Control Panel Administrative Tools Services. 2. Double-click EMC CAVA in the Service list. The EMC CAVA Properties window appears. 3. From the EMC CAVA Properties window, click Log On. 4. Select This account, and click Browse. The Select User window appears. 5. Click Locations. The Locations window appears. 6. Navigate to the domain where the account for the administrative user who has the rights to set up a CEPA server account exists, select the domain location, and click OK. The Select User window now contains the location. 7. Click Advanced. 8. Click Find Now. 9. Select the user account that was created to manage CEPA services from the list, and click OK. 10. For this user account, type the accounts password in both the Password and Confirm password fields. 11. Click OK. The following message appears:
The new logon name will not take effect until you stop and restart the service.

12. Click OK. 13. Restart the computer. 14. If you will be using the CEPA facility, go to Chapter 3 that explains how to set up Celerra Event Enabler for remote access to a third-party consumer application.

Complete the CEE installation for Windows Server

17

Installing

Uninstall Celerra Event Enabler

1. From the Windows taskbar, click Start Settings Control Panel Add or Remove Programs. 2. Select Celerra Event Enabler Framework. 3. Click Remove. 4. Close the Add or Remove Programs window. 5. Close the Control Panel window.

18

Using Celerra Event Enabler 6.0

3 Third-Party Consumer Applications

Topics to set up access to a third-party vendors application, which is used for managing content stored on Celerra file systems, and topics to allow communication with the Celerra Event Enabler include:

Overview on page 20 Set up consumer application access on page 22

Using Celerra Event Enabler 6.0

19

Third-Party Consumer Applications

Overview
A third-party consumer application can reside either on the same local Windows computer where the Celerra Event Enabler is installed, or on another remote computer that is in the same domain as the Windows computer where the Celerra Event Enabler is installed. The Windows computers that have Celerra Event Enabler installed but do not also have the consumer applications installed will route events to the appropriate computer where the registered consumer application resides. When both the consumer application and the Celerra Event Enabler are installed on the local computer, communication between the applications occurs through local RPC (LRPC). When the consumer application is installed on a remote computer in the same domain, communication between the applications occurs through Microsoft RPC. The consumer application registers through the CEPA API on the Celerra Event Enabler computer and specifies which events it will receive. Table 3 on page 20 lists the event types you can specify for a response from the consumer application. You determine the events for which you want to be notified, based on the consumer application used.
Table 3. Event descriptions Value OpenFileNoAccess Definition Protocol

Sends a notification when a file is opened for a CIFS change other than read or write access (for example, read or write attributes on the file) Sends a notification when a file is opened for read access Sends a notification when a file is opened for write access Sends a notification when a directory is opened CIFS

OpenFileRead

OpenFileWrite

CIFS

OpenDir FileRead

CIFS

Sends a notification when a file read is received over NFS NFS Sends a notification when a file write is received over NFS NFS Sends a notification when a file is created CIFS NFS

FileWrite

CreateFile

20

Using Celerra Event Enabler 6.0

Third-Party Consumer Applications

Table 3. Event descriptions (continued) Value CreateDir Definition Sends a notification when a directory is created Protocol CIFS NFS DeleteFile Sends a notification when a file is deleted CIFS NFS DeleteDir Sends a notification when a directory is deleted CIFS NFS CloseModified Sends a notification when a file is modified before closing CIFS

CloseUnmodified

Sends a notification when a file is not modified before CIFS closing Sends a notification when a directory is closed Sends a notification when a file is renamed CIFS CIFS NFS

CloseDir RenameFile

RenameDir

Sends a notification when a directory is renamed

CIFS NFS

SetAclFile

Sends a notification when the security descriptor (ACL) on a file is modified Sends a notification when the security descriptor (ACL) on a directory is modified

CIFS

SetAclDir

CIFS

SetSecFile

Sends a notification when a file security modification NFS is received over NFS Sends a notification when a directory security modi- NFS fication is received over NFS

SetSecDir

The Data Mover generates events for selected file system activity and sends them to a defined Windows server that has Celerra Event Enabler installed, which then communicates with the consumer application, requesting a response. Depending on the type of consumer application used, policies may be checked and the appropriate response sent to CEPA. If necessary, the appropriate response is sent to the user who performed the action.

Overview

21

Third-Party Consumer Applications

Set up consumer application access

1. Open a command window on the Windows Server where the consumer application is installed and type regedit. The Windows Registry Editor window appears. 2. Navigate to:
HKEY_LOCAL_MACHINE Software EMC Celerra Event Enabler CEPP <applica tion> Configuration

where:
<application>

= type of consumer application being used.

3. Double-click EndPoint. 4. If the consumer application is installed on the local computer, type <local where:
<local vendor> vendor>

= name of the vendor on the local computer

If the consumer application is installed on a remote computer, type <vendor>@<IPaddr>; <vendor>@<IPaddr>... where:
<vendor> <IPaddr>

= name of the vendor

= IP addresses of the remote computers where the consumer application is installed. When setting multiple remote computers, you must use a ; (semicolon) to separate the IP addresses. 5. Double-click Enable. 6. Type either 0 to disable or 1 to enable the CEPA functionality that supports the consumer application being used. 7. Restart the computer.
Note: Any time you modify the Celerra Event Enabler section of the Registry, except for Verbose and Debug, you need to restart the EMC CAVA service.

8. Using Celerra Event Publishing Agent provides information on how to use CEPA. Using Celerra AntiVirus Agent provides information on how to use CAVA.

22

Using Celerra Event Enabler 6.0

4 Troubleshooting

As part of an effort to continuously improve and enhance the performance and capabilities of its product lines, EMC periodically releases new versions of its hardware and software. Therefore, some functions described in this document may not be supported by all versions of the software or hardware currently in use. For the most up-to-date information on product features, refer to your product release notes. If a product does not function properly or does not function as described in this document, contact your EMC Customer Support Representative. Problem Resolution Roadmap for Celerra contains additional information about using Powerlink and resolving problems. Topics included are:

EMC E-Lab Interoperability Navigator on page 24 Error messages on page 24 EMC Training and Professional Services on page 24

Using Celerra Event Enabler 6.0

23

Troubleshooting

EMC E-Lab Interoperability Navigator

The EMC E-Lab Interoperability Navigator is a searchable, web-based application that provides access to EMC interoperability support matrices. It is available at http://Powerlink.EMC.com. After logging in to Powerlink, go to Support Interoperability and Product Lifecycle Information E-Lab Interoperability Navigator.

Error messages
All event, alert, and status messages provide detailed information and recommended actions to help you troubleshoot the situation. To view message details, use any of these methods:

Unisphere software:

Right-click an event, alert, or status message and select to view Event Details, Alert Details, or Status Details.

CLI:

Type nas_message -info <MessageID>, where <MessageID> is the message identification number.

Celerra Network Server Error Messages Guide:

Use this guide to locate information about messages that are in the earlier-release message format.

Powerlink:

Use the text from the error message's brief description or the message's ID to search the Knowledgebase on Powerlink. After logging in to Powerlink, go to Support Search Support.

EMC Training and Professional Services

EMC Customer Education courses help you learn how EMC storage products work together within your environment to maximize your entire infrastructure investment. EMC Customer Education features online and hands-on training in state-of-the-art labs conveniently located throughout the world. EMC customer training courses are developed and delivered by EMC experts. Go to EMC Powerlink at http://Powerlink.EMC.com for course and registration information.

24

Using Celerra Event Enabler 6.0

Troubleshooting

EMC Professional Services can help you implement your Celerra Network Server efficiently. Consultants evaluate your business, IT processes and technology, and recommend ways that you can leverage your information for the most benefit. From business plan to implementation, you get the experience and expertise that you need without straining your IT staff or hiring and training new personnel. Contact your EMC representative for more information.

EMC Training and Professional Services

25

Troubleshooting

26

Using Celerra Event Enabler 6.0

Glossary

A AV engine Third-party antivirus software running on a Windows Server that works with the Celerra AntiVirus Agent (CAVA). See also AV server, CAVA, VC client, and virus definition file. AV server Windows Server configured with the CAVA and a third-party antivirus engine. See also AV engine, CAVA, and VC client. C Celerra AntiVirus Agent (CAVA) Application developed by EMC that runs on a Windows Server and communicates with a standard antivirus engine to scan CIFS files stored on a Celerra Network Server. See also AV engine, AV server, and VC client. Celerra Event Enabler Framework that provides the working environment for the CAVA and CEPA facilities. Celerra Event Publishing Agent (CEPA) EMC-provided agent running on a Windows Server that provides details of events occurring on the Windows server. It can communicate with the Celerra Network Server to display a list of events that occurred. Celerra Network Server EMC network-attached storage (NAS) product line. CEPA API Mechanism used by consumer applications to register for, receive, and act on events taking place in the Celerra CIFS file systems.

Using Celerra Event Enabler 6.0

27

Glossary

CIFS service CIFS server process that is running on the Data Mover and presents shares on a network as well as on Microsoft Windows-based computers. command line interface (CLI) Interface for typing commands through the Control Station to perform tasks that include the management and configuration of the database and Data Movers and the monitoring of statistics for the Celerra cabinet components. Common Internet File System (CIFS) File-sharing protocol based on the Microsoft Server Message Block (SMB). It allows users to share file systems over the Internet and intranets. Control Station Hardware and software component of the Celerra Network Server that manages the system and provides the user interface to all Celerra components. D Data Mover In a Celerra Network Server, a cabinet component that is running its own operating system that retrieves data from a storage device and makes it available to a network client. This is also referred to as a blade. A Data Mover is sometimes internally referred to as DART since DART is the software that is running on the platform. N network file system (NFS) Network file system (NFS) is a network file system protocol that allows a user on a client computer to access files over a network as easily as if the network devices were attached to its local disks. V VC client See virus-checking client. Virtual Data Mover (VDM) Celerra software feature that enables users to administratively separate CIFS servers, replicate CIFS environments, and move CIFS servers from one Data Mover to another. virus definition file File containing information for a virus protection program that protects a computer from the newest, most destructive viruses. This file is sometimes referred to as a virus signature update file, a virus pattern update file, or a virus identity (IDE) file. See also AV engine, AV server, CAVA, and VC client. virus-checking client (VC client) Virus-checking agent component of the Celerra Network Server software that runs on the Data Mover.

28

Using Celerra Event Enabler 6.0

Glossary

See also AV engine, AV server, and CAVA.

Using Celerra Event Enabler 6.0

29

Glossary

30

Using Celerra Event Enabler 6.0

Index

A
access consumer application overview 20

install Celerra Event Enabler (continued) prerequisites 14

C
Celerra Event Enabler install 14 start service 17 uninstall 18 consumer application access overview 20 set up 22

M
messages, error 24 MS-RPC 10

N
network requirements 9

R
Registry Editor window 22 registry, EndPoint entry 22 related documentation 10 related information 10 requirements hardware 9 network 9 software 9 requirements, system 9

D
documentation, related 10

E
EMC E-Lab Navigator 24 EndPoint registry entry 22 error messages 24 event descriptions 20

H
hardware requirements 9

S
service, start 17 set up access to consumer application 22 software requirements 9

I
install Celerra Event Enabler 14

Using Celerra Event Enabler 6.0

31

Index

system requirements 9

uninstall Celerra Event Enabler 18

T
troubleshooting 23

W
Windows 64-bit operating systems 10 Windows Registry Editor window 22

32

Using Celerra Event Enabler 6.0