It is now possible to create placeholder shortcuts through File System Archiving (FSA) on EMC Celerra devices from Enterprise Vault (EV) version 7 onwards. The Placeholder Service for Celerra devices runs on the EV server; it cannot be installed on file server (Celerra). EV Manuals up-to and including EV 2007 refer to entering the Domain Name System (DNS) name of the Celerra device when configuring the Celerra which is incorrect. These should read "Enter DataMover name".
* Data Movers of which there can be 2 to 15 (14 in total). These provide network connectivity, storage connectivity and run the Data Access in Real Time (DART) operating system for high performance. Data Movers contain the defined file systems and therefore when account privileges are applied to data movers they are automatically applied to the defined file systems. The data movers will be named server_x.
* Service workstation (Celerra Control Station) of which there can be two, are used for Administration capabilities.
* The Data Movers will then connect to either Symmetrix or Clariion Storage.
In versions 2007 and prior, these instructions are found in the Enterprise Vault Installation and Configuration Guide. In versions 8.0 and later, this has been corrected and can be found in the Setting Up File System Archiving Guide.
1. Log on to the Celerra Control Station or through utility's such as "putty" if enabled. The account used must have sufficient privileges to execute the following commands, please reference EMC documentation for details.
2. Add an account (A Celerra account) for EV to use for authentication on the Celerra device. The syntax is as follows:
server_user <server_x> -add -md5 -passwd <DataMover_user_name>
<server_x> is the name of the Data Mover
<DataMover_user_name> is the name of the account (A Celerra account) that EV needs to use for authentication. This user is a Data Mover user, not a domain user. A prompt for a "User ID" and "Group ID" may also occur. A suitable number is 1000 for both, unless this is in use elsewhere. The number must be unique and does not need to have "root" privileges. If prompted for a "Home Directory" just press Enter to continue and leave entry blank.
Adding file servers
3. Enable the file system for Celerra FileMover using this command syntax:
fs_dhsm -modify <fs_name> -state enabled
<fs_name> is the name of the file system on the Celerra. File system and Internet Protocol (IP) address are not directly linked. An IP address is associated with a Common Internet File System (CIFS) server. There can be more than one CIFS server mounted on a file system and a corresponding DNS record should exist for the IP address of the CIFS server being used. A useful command to discover what File Servers exist is "fs_dhsm -list" which will show all the file servers names and their Unique ID.
4. Configure the HTTP server on the Data Mover to accept Celerra FileMover
API connections using this command syntax:
server_http <server_x> -append dhsm -users <DataMover_user_name> -hosts <ip_address_policy_engine>
<server_x> is the name of the Data Mover
<DataMover_user_name> is the name of the Data Mover account that EV will use for authentication.
<ip_address_policy_engine> is the IP address of the computer that runs the FSA task that will process the Celerra device i.e. the EV Server.
This command will also test the connectivity between the Celerra and the EV server over http.
Then run the following command:
server_http <server_x> -service DHSM -start
This will ensure the connection is active.
5. Configure the HTTP connection to use for recall requests, using this command syntax:
fs_dhsm -connection <fs_name> -create -type http -secondary <ev_url> -user <user> -password <user_password> -cgi n
<fs_name> is the name of the Celerra file system.
<ev_url> is the URL of the Web Access application. The Celerra is case-sensitive, so this URL must use the correct case. If this is incorrect, data will not be reverted to placeholders and the error "NO_MATCHING_CONNECTION" will appear in the FSA Reports. To ensure this is correct open the EV Directory database in SQL and the SiteEntry table. This will contain the correct URL (only if single Enterprise Vault Server is in use) in the correct case that is required for the EV_URL. In the ComputerEntry table you will find the ComputerName that forms the first (hostname) portion of the URL. If you use any other name for this server, you'll get the same NO_MATCHING_CONNECTION error. For example, if the ComputerName field reads "EVFSAServer" (the DNS alias (CNAME Record) for the EV server in question), then the proper URL will be http://EVFSAServer/EnterpriseVault.
POST http://kcecifs3:5080/dhsm HTTP/1.1
Authorization: Digest username="evadmin",realm="DHSM_Authorization",nonce="1330597612",uri="/dhsm", algorithm="MD5",cnonce="7144d67fb4ecefd17fd77082a9cef1c1",nc=00000001,qop="auth",response="948745781710b595bb272d4916ba750e",opaque="89ea1aaa7a18a5232f2ab78178dfe466"
<user> is the Vault Service Account (VSA) that will have access to all archives from which files will be restored. This is typically entered as domain/user rather than the typical Windows form domain\user.
<user_password> is the password for the VSA.
Note: To modify the URL of the Web Access application so that it matches what is listed in the EV Directory database SiteEntry table, the following command can be used:
$ fs_dhsm -connection <fs_name> -modify <cid> -secondary \\new\urlpath
Note: You cannot include a TCP port number in the URL that you specify with the -secondary parameter. For example, if you use a non-default port such as port 85 for the Web Access application, you cannot specify it as follows:
If you attempt to do this, the fs_dhsm -connection command fails with a message similar to the following, and the archiving and recall of files on the Celerra will fail:
Error: The host name in the secondary url evserver.demo.local:85 is either missing or formatted incorrectly.
If you have configured the Web Access application to use a TCP port other than default port (port 80), you can use the following workaround to use the non-default port with the Celerra:
a. Create an IIS web site that uses the default TCP port, port 80.
b. Create a virtual directory named EnterpriseVault in the new web site, and set a redirection URL for this virtual directory to the original EnterpriseVault virtual directory on the non-default port.
c. Configure the Web Access application to use default TCP port 80 on the General tab of the Enterprise Vault Site properties.
d. Use the -httpPort parameter with the fs_dhsm -connection command to specify the non-default port, as follows:
fs_dhsm -connection <ufs_name> -create -type http -secondary <ev_url> -user <user> -password <user_password> -cgi n -httpPort <port_number>
fs_dhsm -connection fsa_fs -create -type http -secondary <http://EVServer.demo.local/EnterpriseVault> -user firstname.lastname@example.org <mailto:email@example.com> -password p4ssw0rd -cgi n -httpPort 85
To ensure the proper ev_url is specified, run the following on the Celerra device:
fs_dhsm -connection <file system name> -info
this should match the HTTP connection made from the vault server in question (an application like Fiddler- http://www.fiddlertool.com/fiddler/ can capture this communication).
NOTE: Multiple connections can be created on the Celerra device for the same EV server
6. When adding the FSA Server through the Vault Administration Console (VAC) and specifying the share, note that this must point to the root directory, not a specific folder, otherwise logging will fail. This is a restriction imposed by the Celerra device. Verify that the target Celerra share is a root directory by ensuring the target contains an etc folder and the dhsm.log.
1. To pipe out the log file from the Celerra device from the Managed Workstation use the following command which can provide detailed information on what is failing on the Celerra device if errors are received.
server_log server_x -a -s>logfilename.log
<server_x> is the name of the relevant Data Mover
2. To display the log file through the command window type
<server_x> is the name of the Data Mover
3. Applications like Fiddler- http://www.fiddlertool.com/fiddler/ can also be used to trap HTTP traffic to and from the Celerra device which can help identify issues.
4. To verify communications from the Celerra device to the EV server in question the following can be used:
telnet evserver/sitealias 80