Peer Knowledge Base
Peer Knowledge Base
Breadcrumbs

Dell Unity Legacy Configuration Guide


Last Updated

28 August 2025




Overview

Legacy guide notice

This guide covers the legacy PeerGFS integration method for Dell Unity.   Starting with PeerGFS 6.3, Unity supports a CEE over HTTP integration. If you run Dell Unity OE 5.x or later—or if you need NFS or multi-protocol workloads—use the current Dell Unity Configuration Guide.  This guide does not cover those scenarios.

This guide steps you through configuring your environment to work with a Dell EMC storage platform in preparation for installing Peer Software solutions. The last section of this guide provides troubleshooting information.  During the configuration process, you will be installing and configuring software on the server that will host Peer Software solutions.  This server is hereafter referred to as the CEE server.  The software you will be installing and configuring includes:

  • CEE (Common Event Enabler) framework – Required to receive real-time notifications from Dell EMC storage platforms.

  • .NET Framework – Core Windows software needed to run the CEE framework.

  • RabbitMQ Server – Message broker required by Peer Software solutions to receive real-time notifications from CEE.

  • Erlang – Required by Rabbit MQ Server.

Requirements

  • Your Dell Unity storage device must be running Unity Operating Environment 4.2 or later.

  • Local administrator rights are required for most of the installation and configuration tasks.

  • See

    Dell Unity Prerequisites

    for other requirements.

Terminology

  • CEE server – A Windows server hosting CEE framework and your Peer Software solutions.

  • Common AntiVirus Agent (CAVA) – A software service that provides anti-virus and event-publishing services for Dell storage platforms.

  • Common Event Enabler (CEE) framework – A Dell software product required to obtain real-time event notifications from a Unity storage platform.  Used to be called Celerra Event Enabler.

  • Common Event Publishing Agent (CEPA) – A software service that provides event publishing services for Dell storage platforms.

  • NAS Server – A Dell Unity storage server that uses the SMB, NFS, or FTP/SFTP protocols to catalog, organize, and transfer files within designated file system shares.

  • SMB/CIFS – The Server Message Block (SMB) Protocol is a network file-sharing protocol; it supersedes Common Internet File System (CIFS), an earlier protocol.  SMB is used in this document to refer to both protocols.

  • Unity – All-Flash and Hybrid Flash unified storage platforms.

  • Unisphere – A web-based application for managing the Unity platform.

Configuration Tasks

Task 1. Confirming Configuration Readiness

  1. Ensure that the Dell Unity prerequisites are met for the Peer Software solution you will be using.

  2. If your storage platform (e.g., Unity and VNX) requires licensing for the Common Event Enabler (CEE) framework, ensure that CEE is licensed.

  3. Ensure that the Unity storage device is already configured to serve data via SMB.  You should be able to access an SMB share from a Windows client BEFORE attempting to continue.

  4. Ensure that the date and time on the Unity storage device are synchronized with any associated domains and the CEE server.

Task 2. Installing the .NET Framework on the CEE Server

  1. Run Windows PowerShell as an administrator.

  2. Enter the following command to install .NET Framework v3.5:

    Install-WindowsFeature Net-Framework-Core

    After the installation is complete, the results are displayed in the PowerShell window.

    Task 2 - PowerShell window.png

  3. Close the PowerShell window.

Task 3. Installing CEE Framework on the CEE Server

  1. If any versions of CEE framework software earlier than v8.6 (including stand-alone CAVA or CEPA) are already installed on the CEE server, uninstall them before continuing.

  2. Download and stage the 64-bit CEE framework installer on the CEE server.

    1. If deploying for use with Isilon, we require v8.7.0 of the CEE framework.  To obtain one of these versions, please contact Dell EMC technical support or your Peer Software technical contact.

    2. If deploying for use with Unity or VNX, we support v8.9.1 of the CEE framework. CEE v8.9.1 can be found here: https://dl.dell.com/downloads/DL81214_Common-Event-Enabler-8.9.1.0-for-Windows---32-and-64-bit.iso.  Note that this download requires a Dell EMC support login.

  3. Install the CEE framework software:

    1. Run the CEE framework installer as an administrator.
      The Welcome page of the CEE Install wizard appears.

    2. Click Next.
      The License Agreement page appears.

    3. Accept the terms of the license agreement, and then click Next.
      The Customer Information page appears.

    4. Enter your user name and organization, select Anyone who uses this computer (all users), and then click Next.
      The Setup Type page appears.

    5. Select Complete, and then click Next.
      The Symantec SAV for NAS page appears.

      Task 3 - Symantec SAV for NAS.png

    6. Ensure that the Work with Symantec SAV for NAS/Protection Engine checkbox is not selected, and then click Next.
      The Ready to Install the Program page appears.

    7. Click Install.
      When the installation is complete, the InstallShield Wizard Completed page appears.

    8. Click Finish.
      A dialog prompting you to restart the system appears.
      Task 3 - Restart System dialog.png

    9. Click No. You will restart the system later.

Task 4. Configuring CEE on the CEE Server

  1. Modify the registry value to instruct CEE framework to send events to RabbitMQ:

    1. Open the Registry Editor as an administrator.

    2. Navigate to the following location: HKEY_LOCAL_MACHINE > Software > EMC > CEE > CEPP > CQM > Configuration.

      Task 4 - Registry Editor.png

    3. Double-click the Enabled registry key.
      The Edit DWORD (32-bit) Value dialog appears.

    4. Change the number in Value data to 0, and then click OK.

      Task 4 - Edit DWORD Value dialog.png

    5. Close the Registry Editor.

  2. Set the login credentials for the EMC CAVA service.  The credentials should be the same as the ones you will use for the Peer Software service.

    1. Open the Windows Services manager as an administrator.

    2. Find the service named EMC CAVA.

      Task 4 - Find EMC CAVA Service.png

    3. Double-click EMC CAVA.
      The EMC CAVA Properties (Local Computer) dialog appears.

    4. Click the Log On tab.
      Task 4 - EMC CAVA Properties dialog.png

    5. Enter the account name and password, and then click OK.
      A Services dialog appears, confirming that log-on rights have been granted.

    6. Click OK.

  3. Restart the EMC CAVA service:Select the EMC CAVA service.Click the Restart link.  (If the service is not already running, click the Start link instead.)Close the Services manager window.

Task 5. Installing Erlang on the CEE Server

  1. Download and stage the 64-bit Erlang installer on the CEE server.

    1. If deploying for use with Isilon, we require v20.3 of Erlang.  Erlang v20.3 can be found here: https://erlang.org/download/otp_win64_20.3.exe.

    2. If deploying for use with Unity or VNX, we support v25.x versions of Erlang (such as v25.2).  Erlang v25.2 can be found here: https://github.com/erlang/otp/releases/download/OTP-25.2/otp_win64_25.2.exe

  2. Install the Erlang software:

    1. Run the Erlang installer as an administrator.
      The Erlang Setup wizard appears.  The Choose Components page is displayed.

    2. Do not make any changes to the default selections.

      Task 5 - Choose Components page.png

    3. Click Next.
      The Choose Installation Location page appears.

    4. Accept the default location by clicking Next.
      The Choose Start Menu Folder page appears.

    5. Do not make any changes to the default location.

    6. Click Install.
      If the system does not have the correct C++ runtime installed, the Microsoft Visual C++ installer dialog appears.
      Continue with Step 2g if the dialog appears; otherwise, skip to step 2i.

    7. Click the checkbox to agree to the license terms and condition, and then click Install.
      After the Visual C++ installation is completed, the dialog displays a message confirming the success of the installation.

    8. Click Close to close the confirmation dialog.
      The Erlang Setup wizard displays a status dialog while installing Erlang.

    9. Click Close when the installation has completed.

Task 6. Installing and Configuring RabbitMQ Server on the CEE Server

  1. Download and stage the 64-bit RabbitMQ Server installer on the CEE server.

    1. If deploying for use with Isilon, we require v3.7.4 of RabbitMQ.  RabbitMQ v3.7.4 can be found here: https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.7.4/rabbitmq-server-3.7.4.exe.

    2. If deploying for use with Unity or VNX, we support v3.11.x versions of RabbitMQ (such as v3.11.10). RabbitMQ v3.11.10 can be found here: https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.11.10/rabbitmq-server-3.11.10.exe.

  2. Install the RabbitMQ Server software:

    1. Run the RabbitMQ Server installer as an administrator.
      The RabbitMQ Server Setup wizard appears.  The Choose Components page is displayed.

    2. Do not make any changes to the default selections.

      Task 6 - Choose Components page.png

    3. Click Next.
      The Choose Install Location page appears.

    4. Accept the default location by clicking Install.
      The Setup wizard displays a status dialog while installing RabbitMQ Server.

    5. Click Next when the installation is complete.

    6. Click Finish to close the setup wizard.

  3. Enable the RabbitMQ Server management plugin:

    1. Open a command prompt as an administrator.

    2. In the command prompt window, change to the directory that the RabbitMQ Server is installed (typically C:\Program Files\RabbitMQ Server\rabbitmq_server-X.X.X\sbin, where X.X.X is the version number).

    3. Enter the following command in the command prompt window:

      rabbitmq-plugins enable rabbitmq_management

      The command prompt window displays confirmations that the plug-ins have been configured and enabled.

      Task 6 - Confirm plug-in configured.png

    4. Close the command prompt window.

  4. Restart the RabbitMQ service:

    1. Reopen the Services manager as an administrator.

    2. Select the Rabbit MQ service.

    3. Click the Restart link.

      Task 6 - Restart RabbitMQ Service.png

    4. Close the Services manager.

  5. Enable the RabbitMQ Server to receive messages:

    1. Open Notepad as an administrator.

    2. Open the file MsgSys.xml in Notepad.
      This file should be located in the installation directory of CEE framework (for example, C:\Program Files\EMC\CEE).

      Tip

      To locate the MsgSys.xml file, change the file filter drop-down list from Text Document (.txt)* to All Files; otherwise, only text files will be displayed in the Open dialog.

      Task 6 - Locate MsgSys XML file.png

      The MsgSys.xml file is displayed in a Notepad window.

      Task 6 - Display MsgSys XML file.png

    3. Make the following changes to the file:

      1. Find the following line:

        <MsgBus enabled="0">

        and set MsgBus enabled to "1".

      2. Find the following line and set Host name to "localhost" :

        <Host name="" port="5672" username="guest" password="guest"> 

        The file now appears as follows:

        Task 6 - Edit MsgSys XML file.png

    4. Save your changes to MsgSys.xml, and then close the file.

  6. Ensure that the RabbitMQ Service is installed and running:

    1. Reopen the Services manager as an administrator.

    2. Find the service named RabbitMQ.

    3. Confirm that the service is running.

      Task 6 - Confirm RabbitMQ Service running.png

    4. Close the Services manager.

Task 7. Configuring the Unity Storage Device

The event publishing system on the Dell Unity storage device is responsible for sending event and client activity notifications to the Peer Software solutions.  You can configure the event notification settings on a Dell Unity storage device using their Unisphere web interface.  You must be an admin user of the Unity storage device to configure the settings.

  1. Open a browser window.

  2. Enter the IP address of the Unity storage device in the browser's address bar.

  3. Enter your user name and password, and then click OK.
    The Dashboard page of the Unisphere web application is displayed.

  4. Click the File link in the Storage section of the navigation pane on the left.
    The File Systems page that appears displays a list of the attached file systems.
    Configure Unity - 01.png

  5. For each file system you want to monitor, enable the storage device to track end-user activity on the file system:

    1. Double-click the name of the file server.
      The Properties dialog appears.

    2. Click the Advanced tab.

      Configure Unity - 02.png

    3. If not already selected, click the Enable SMB Events publishing checkbox.

    4. Click the Apply button, and then click the Close button.

    5. Repeat for each file system you want to monitor.

  6. Click the NAS Servers tab.
    A list of NAS servers is displayed.
    Configure Unity - 03.png

  7. Double-click the name of the NAS server you want to monitor.
    The Properties dialog appears.

    Configure Unity - 04.png

  8. Click the Protection & Events tab.

    Configure Unity - 05.png

  9. Click the Events Publishing link in the navigation pane on the left.
    The Event Publishing Pool is displayed.
    Configure Unity - 06.png

  10. If not already selected, select the Enable Common Event Publishing checkbox, and then click Apply.

  11. If there are no existing event pools, the New Event Pool dialog automatically appears.  If there are existing event pools, click the Add icon ( Configure Unity - 07.png  ) to open the New Event Pool dialog.
    Note:  One event pool must be dedicated to Peer Software solutions.  Only one CEPA server in the pool that is dedicated to use.   A maximum of three event pools are allowed per NAS server.
    Configure Unity - 08.png

  12. Click the Add button.
    The Add new server dialog appears.

    Configure Unity - 09.png

  13. Enter the name or IP address of the CEE server, and then click Add.
    The New Event Pool dialog reappears.  The server name or IP address is now listed in the CEPA Servers field.

  14. Click the Configure link for Post Events.
    The Configure Post Events dialog appears.

  15. Click Select all.
    All the checkboxes are selected.

  16. Deselect the CloseDir and OpenDir checkboxes.

    Configure Unity - 10.png

  17. Click OK.
    The New Event Pool dialog reappears.  The selected events are listed next to Post Events.
    Configure Unity - 11.png

  18. Click the Configure button in the lower right corner of the dialog.
    The configuration is applied, and the Properties dialog reappears.  The new event pool is now listed in the Event Publishing Pool section.

  19. Click the Apply button, and then click the Close button.
    Configure Unity - 12.png

Task 8. Installing and Configuring the Dell EMC Unity/VNX/VNXe NAS Management Tool

  1. Download the Dell EMC Unity/VNX/VNXe NAS Management tool.  You can download the software from Dell EMC's support site (requires a Dell EMC account):

    https://download.emc.com/downloads/DL48750_Unity-and-VNX-FileCifsMgmt.exe-8.1.9.157.exe

  2. Install the NAS Management tool software:

    1. Run the NAS Management installer as an administrator.
      The Unity VNX VNXe NAS Management Setup wizard appears.
      Install Unity Mgmt Tool - VNX Setup Wizard.png

    2. Click Next.
      The License Agreement page appears.
      Install Unity Mgmt Tool - License Agreement page.png

    3. Click Yes to accept the license agreement.
      A notification about installing the 32-bit version appears.
      Install Unity Mgmt Tool - Notification about installing 32-bit version.png

    4. Click OK.
      The Select Installation Folder page appears.
      Install Unity Mgmt Tool - Select Installation folder.png

    5. Click Next to accept the default location.
      The Select Features page appear.
      Install Unity Mgmt Tool - Select Features page.png

    6. Click Next to install all the features.
      The Start Copying Files page appears.
      Install Unity Mgmt Tool - Start Copying Files page.png

    7. Click Next to start the installation.

    8. Click Finish when the installation has completed.

  3. Open the EMC Unity/VNX/VNXe NAS Management console.

    1. Open the Control Panel and navigate to System and Security > Administrative Tools.

    2. Open EMC Unity VNX VNXe NAS Management as an administrator.

  4. Connect to all appropriate NAS servers:

    1. In the navigation pane, right-click the Data Mover/NAS Server Management folder, and then select Connect to Data Mover/NAS Server… from the shortcut menu.
      Install Unity Mgmt Tool - Data Mover-1.png

    2. In the Select Data Mover/NAS Server dialog that appears, select the appropriate VNX Data Mover or Unity NAS server, and then click OK.
      Install Unity Mgmt Tool - Data Mover-2.png

  5. Add the Peer Agent or PeerSync service account to the EMC Event Notification Bypass and EMC Virus Checking security policies:
    Navigate to the Data Mover/NAS Server Management > Data Mover/NAS Server Security Settings >User Rights Assignment folder.The list of user rights assignment settings appears in the details pane and includes their current setting and effective setting.In the details pane, right-click the EMC Event Notification Bypass policy, and then select Security from the shortcut menu.The Security Policy Setting dialog appears and lists users or groups that are already assigned to the selected user rights assignment. If no assignments exist, the list is blank.Click Add.The Select User or Groups dialog appears.In the Look in box, select the domain in which the Agent or PeerSync account is located.In the upper pane, select the Peer Agent or PeerSync service account, and then click Add.The account appears in the lower pane.Click OK.The account is now listed in the Security Policy Setting dialog.Click OK.The account is now assigned to the EMC Event Notification Bypass policy.Repeat Steps 5b-g for the EMC Virus Checking policy.Note: No testing should be performed with this service account once these settings are in place.

  6. Restart the EMC CAVA service:

    1. Reopen the Services manager as an administrator.

    2. Select the EMC CAVA service.

    3. Click the Restart link.

The setup of your Unity/VNX/VNXe storage device is now complete.

Troubleshooting

Error 0x800F0954 When Installing .NET Framework 3.5When installing .NET 3.5 on Windows Server 2019,  the following error may appear:The error 0x800f0954 refers to CBS_E_INVALID_WINDOWS_UPDATE_COUNT_WSUS, which indicates that your system may have been configured to use a WSUS server (on your domain network) to get updates instead of connecting to Windows Update servers directly.You need to reinstall the .NET package from a Server 2019 installation disk by following these steps:Attach the Windows Server 2019 installation disk to the server.Run the following command in an elevated command prompt. dism /online /enable-feature /featurename:NetFX3 /Source:H:\sources\sxs /LimitAccess where H:\ represents the drive letter of the attached Windows Server 2019 installation disk.

Error 1053 When Starting CAVA ServiceIf you get Error 1053 when you try to start the EMC CAVA service, ensure that the .NET 3.5 Framework is installed on the CEE server, and then restart the EMC CAVA service on the CEE server.

Starting RabbitMQ IssueIf you experience an issue with starting RabbitMQ, try the following steps:On the CEE server, open a command prompt as an administrator.Navigate to the directory where RabbitMQ Server is installed (typically C:\Program\Files\RabbitMQ Server\rabbitmq_server-X.X.X\bin, where X.X.X is the version number).Enter the following three commands: rabbitmq-service stoprabbitmq-service removerabbitmq-server start If the start command results in an error about an Erlang cookie, reset the HOMEDRIVE and HOMEPATH environment variables to a locally accessible folder (such as C:\Users\Public).  To set these environment variables:Open a command prompt as an administrator.When prompted to allow changes, click Yes.Enter the following commands in the command prompt window: set HOMEDRIVE=C:set HOMEPATH=/Users/Public Rerun the following command and verify that no Erlang cookie errors are encountered: rabbitmq-service start Use Ctrl+C to stop the RabbitMQ Server process.Delete the folder C:\Users\%Username%\AppData\Roaming\RabbitMQ.Enter the following commands in the command prompt window: rabbitmq-service installrabbitmq-service start Verify that the folder C:\Users\%Username%\AppData\Roaming\ was recreated and populated with db and log folders.

Technical Support

Peer Software Service Desk

USA               +1 703-763-7700

EMEA            +49 89 2620763-22

UK/IE            +44 20 777 098 22

Page: Achieving high availability for the PMC through active-passive configuration Page: Achieving high availability for the PMC through active-passive configuration (v4.7.0 - v5.1.1) Page: Achieving high availability for the PMC through active-passive configuration (v5.2 only) Page: Achieving high availability for the PMC through active-passive configuration (v6.0 and later) Page: Configuration Guides Page: Configure PeerSync to synchronize in a clustered environment Page: Configure the Agent installer to run unattended Page: Configure the PeerSync Listener installer to run unattended Page: Dell EMC Celerra | VNX | VNX 2 Configuration Guide Page: Dell PowerScale | EMC Isilon Configuration Guide Page: Dell PowerScale Syslog Configuration Guide Page: Dell PowerStore Configuration Guide Page: Dell Unity Configuration Guide Page: Dell Unity Legacy Configuration Guide Page: How do I install Health Checker on a remote server?