Skip to main content

Dell Unity™ Family Unisphere® Command Line Interface User Guide

PDF

Change CEPA configuration settings

Modify the Events Publishing configuration. When you create a NAS server, an Events Publishing configuration object is automatically created with default values.

Format

/net/nas/event/config –server <value> set [-enabled {yes | no}] [-preEventPolicy {ignore | deny}] [-postEventPolicy {ignore | accumulate | guarantee | deny}] [-httpPort <value>] [-httpEnabled {yes | no}] [-username <value> {-passwd <value> | -passwdSecure}] [-heartbeat <value>] [-timeout <value>]

Object qualifier

Qualifier	Description
-server	Identifies the associated NAS server.

Action qualifiers

Qualifier	Description
-enabled	Identifies whether Events Publishing is enabled on the NAS Server. Valid values are: yes no (default)
-preEventPolicy	Identifies the policy applied when a pre-event notification fails. Valid values are: ignore (default) - indicates that when a pre-event notification fails, it is acknowledged as being successful. deny - indicates that when a pre-event notification fails, it is acknowledged with a 'denied' answer.
-postEventPolicy	Identifies the policy applied when a post-event notification fails. The policy is also applied to post-error events. Valid values are: ignore (default) - continue and tolerate lost events. accumulate - continue and use a persistence file as a circular event buffer for lost events. guarantee - continue and use a persistence file as a circular event buffer for lost events until the buffer is filled, and then deny access to file systems where Events Publishing is enabled. deny - on CEPA connectivity failure, deny access to file systems where Events Publishing is enabled.
-httpPort	HTTP port number used for connectivity to the CEPA server. The default value is 12228. The HTTP protocol is used to connect to CEPA servers. It is not protected by a username or password.
-httpEnabled	Specifies whether connecting to CEPA servers by using the HTTP protocol is enabled. When enabled, a connection by using HTTP is tried first. If HTTP is either disabled or the connection fails, then connection through the MS-RPC protocol is tried if all CEPA servers are defined by a fully-qualified domain name (FQDN). The SMB account of the NAS server in the Active Directory domain is used to make the connection by using MS-RPC. Valid values are (case insensitive): yes (default) no
-username	Name of a Windows user who is allowed to connect to CEPA servers. NOTE:To ensure that a secure connection (by using the Microsoft RPC protocol) is used, you must disable HTTP by setting -httpEnabled=no.
-passwd	Password of the Windows user defined by the username.
-passwdSecure	Specifies the password in secure mode. The user is prompted to specify the password.
-heartbeat	Time interval between scanning CEPA servers (in seconds) to detect their online or offline status. The default is 10 seconds. The range is from 1 through 120 seconds.
-timeout	Time in ms to determine whether a CEPA server is offline. The default is 1,000 ms. The range is from 50 ms through 5,000 ms.

Example

The following command enables Events Publishing and sets the post-event policy to accumulate.

uemcli /net/nas/event/config -server nas_1 set -enabled yes -postEventPolicy accumulate

Storage system address: 10.1.2.100
Storage system port: 443
HTTPS connection

Operation completed successfully.