Professional Documents
Culture Documents
Emc Corporation: Hopkinton, Ma NAS Tech Support
Emc Corporation: Hopkinton, Ma NAS Tech Support
Introduction
Starting in EMCNAS 5.5.31.6 ConnectEMC Linux 2.0 replaces the Celerra CallHome configuration and
CallHome process.
ConnectHome Supports:
• EmailHome to EMC or an ESRS Gateway
• FTPCallHome to an ESRS Gateway
• CallHome via a modem to EMC
ConnectHome will continue to maintain Modem support and adds Email and FTP as two new additional
transport methods. Each transport mechanism, Modem, Email, and FTP supports multiple Primary and
optional multiple Secondary failover destinations. The ConnectEMC daemon stops after the first
successful transfer. ConnectEMC is part of the Event Messaging Architecture, EMA, developed by the
RAPiD software group for Windows and Linux.
PURPOSE OF CONNECTHOME
ConnectHome provides an outbound method to send event files by email, ftp, or a modem.
ConnectHome also provides an inbound service with the ability to set or modify the dial-in phone number,
the System Serial Number, the Site ID Number, and the ability to Enable or Disable dial-in capability.
EMCNAS FRESH INSTALLATIONS
A new install will not configure the transport portion of ConnectHome; the ConnectHome transport default
setting is none. All NAS installations of 5.5.31.6 and higher will implement the Celerra ConnectHome
feature. The ConnectHome feature must be configured with a selected Primary, and or Secondary, and or
Tertiary transport mechanism. The transport mechanism can be any combination of email or email using
an ESRS gateway or FTP using an ESRS gateway or a modem.
A valid Celerra Serial Number must be present for a “CallHome” to be correctly delivered. ConnectHome
can be configuration with CLI using /nas/sbin/nas_connecthome or with Celerra Manager from Celerra
Manager>Celerras>Support>ConnectHome tab.
EMCNAS UPGRADES
An EMCNAS Upgrade will convert the current CallHome configuration to the new ConnectHome format.
Errors will be noted in the NAS Upgrade log. Verify that the new configuration is correct using
/nas/sbin/nas_connecthome –info. An EMCNAS Upgrade will preserve the Modem phone numbers, the
Email SMTP server if configured in /etc/sendmail.cf; for FTP to an ESRS Gateway IP Address,
Username, and Password are preserved. The /nas/site/rsc5*_nas_event.cfg file is unloaded as part of the
EMCNAS upgrade and FTP transport enabled.
After the EMCNAS upgrade the appropriate version of /nas/site/rsc5*_nas_event.cfg must be loaded.
The EMCNAS upgrade path determines if the custom modem settings are not saved and must be
reentered.
• Upgrading from below 5.5.31.6 to 5.5.31.6 will not save any custom modem settings.
• Upgrading from below 5.5.32 to 5.5.32 will only save the ignore-dialtone modem setting.
• Upgrading from 5.5.32 to any later EMCNAS releases will save all the modem savings.
If /nas/sbin/ch_dd was used to setup pre-5.5.31 Celerras, the dial-out prefix, and primary and backup
phone numbers, will be preserved. EMCNAS Upgrades from 5.5.32.x or later will permanently preserve
any custom modem settings in a new /opt/connectemc/modem.cfg file that replaces the
/opt/connectemc/login.cmds file that is only present in 5.5.31.6.
Note: The modem settings ignore-dialtone and dial method tone or pulse must be reentered after an
upgrade to 5.5.31.6.
• EMCNAS 5.5.31.6 configure dial method and ignore-dialtone detection in the file
/opt/connectemc/login.cmds.
• EMCNAS 5.5.32.x and above configure dial method and ignore-dialtone detection in the file
/opt/connectemc/modem.cfg.
Note: Other modem-specific settings may be impacted. It is recommended that the callhome process be
tested after a NAS upgrade to ensure proper operation of the transport mechanism in use.
Documentation
Please use the platform-specific Celerra Network Server Setup Guide found on Powerlink as your primary
reference for resetting modem settings. Configuration information is also contained in the Celerra
Command Reference Manual.
• Celerra® Network Server Gateway Configuration Phase 1 and 2 Setup Guide
• Celerra® Network Server Integrated Configuration Phase 1 and 2 Setup Guide
• Celerra® Network Server COMMAND REFERENCE MANUAL
Note: The Man Pages for nas_connecthome are missing for 5.5.31.6 and will be present with the 5.5.32.x
release.
Configuration Examples
Resetting ignore-dialtone, Pulse, or Tone dialing for
EMCNAS 5.5.31.6:
Edit the following line in the file /opt/connectemc/login.cmds
set dial method auto set this paramater to "auto, tone or pulse “
set dial timeout 300
set dial ignore-dialtone on set this paramater if the phone system does not use a dial tone
EMCNAS 5.5.32.x:
Modify or create the file /opt/connectemc/modem.cfg:
set dial ignore-dialtone on set this paramater if the phone system does not use a dial tone
set dial method tone set this paramater to auto, tone or pulse
Configuration File Information
The location of the original Modem file after an EMCNAS Upgrade:
/var/sadm/pkg/emcnas/save
Modem Setting Files
Original Celerra CallHome modem settings file
/nas/sys/callhome.modem
New Celerra ConnectHome modem settings file, NAS 5.5.31.6 only
/opt/connectemc/login.cmds
Celerra ConnectHome modem settings file for NAS 5.5.32.x and above
/opt/connectemc/modem.cfg
Configuring Celerra ConnectHome as root user only
CLI interface
The CLI can clear, stop, or start the transport services.
Note: You must be Root user to edit the “Connect Home” page
ConnectHome CLI
# /nas/sbin/nas_connecthome
-info
| -test { -email_1 | -email_2 | -ftp_1 | -ftp_2 | -modem_1 | -modem_2 }
| -modify [ -modem_priority {Disabled | 1 | 2 | 3} ]
[ -modem_number <phone_number> ] [ -modem_bt_tymnet { yes | no } ]
[ -modem_number_2 <phone_number> ] [ -modem_bt_tymnet_2 { yes | no } ]
[ -ftp_priority {Disabled | 1 | 2 | 3} ] [ -ftp_ipport <ip_addr>[:<port>] ]
[ -ftp_user <username> ] [ -ftp_passwd [passwd] ]
[ -ftp_folder <path> ] [ -ftp_mode {active | passive} ]
[ -ftp_ipport_2 <ip_addr>[:<port>] ] [ -ftp_user_2 <username> ]
[ -ftp_passwd_2 [passwd] ] [ -ftp_folder_2 <path> ]
[ -ftp_mode_2 {active | passive} ] [ -email_priority {Disabled | 1 | 2 | 3} ]
[ -email_to {<email_addr>[,<email_addr>]} ] [ -email_subject <email_subject> ]
[ -email_server { <hostname> | <ip_addr>} ] [ -email_server_2 { <hostname> | <ip_addr>} ]
[ -dial_in_number <phone_number> ] [ -serial_number <serial_number> ]
[ -site_id <site_id> ] [ -encryption_enabled { yes | no } ]
# /nas/sbin/nas_connecthome -info
ConnectHome Configuration:
Encryption Enabled = yes
Dial In :
Enabled = yes
Modem phone number =
Site ID =
Serial number = APM00064000123
Email :
Priority = 1
Recipient Address(es) = BAR101@spark1.hosts.svt.dns
Subject = CallHome Alert Hammer3
Primary :
Email Server = spark1.hosts.svt.dns
Secondary :
Email Server =
FTP :
Priority = Disabled
Primary :
FTP Server =
FTP Port = 21
FTP User Name = onalert
FTP Password = **********
FTP Remote Folder = incoming
FTP Transfer Mode = active
Secondary :
FTP Server =
FTP Port = 21
FTP User Name = onalert
FTP Password = **********
FTP Remote Folder = incoming
FTP Transfer Mode = active
Modem :
Priority = Disabled
Primary :
Phone Number = 918005270941
BT Tymnet = no
Secondary :
Phone Number = 918006262452
BT Tymnet = no
Note: Process takes about 1 minute to stop, and XML CallHome files in /nas/log/ConnectHome are
removed.
# cat connecthome.config
This file is similar info as provided by /nas/sbin/nas_connecthome -info
dialInEnabled:yes
modemPhone:
siteID:s323
celerraSerial:APM00064001123
emailPriority:1
emailFrom:connectemc@emc.com
emailTo:BAR101@spark1.hosts.svt.dns
emailSubject:CallHome Alert
primaryEmailServer:spark1.hosts.svt.dns
secondaryEmailServer:
ftpPriority:Disabled
primaryFtpAddress:
primaryFtpPort:21
primaryFtpUserName:onalert
primaryFtpPassword:EMCCONNECT
primaryFtpFolder:incoming
primaryFtpTransferMode:active
secondaryFtpAddress:
secondaryFtpPort:21
secondaryFtpUserName:onalert
secondaryFtpPassword:EMCCONNECT
secondaryFtpFolder:incoming
secondaryFtpTransferMode:active
modemPriority:Disabled
primaryModemPhone:918005270941
primaryModemTymnet:no
secondaryModemPhone:918006262452
secondaryModemTymnet:no
encryptionEnabled:no
emailhome.config EmailHome header file
/nas/log/connecthome_log log of successful transfers and results of ConnectHome
tests
/nas/log/ConnectHome ConnectHome RSC xml event files
/nas/log/connectemc symbolic link to /nas/opt/connectemc/logs
[archive ConnectEMC ConnectEMC_email.log failed output]
/nas/opt/connectemc
callhome.ini The Modem initialization file
connectemc.pem The RSA private encryption key
login.cmds The Modem settings in 5.5.31.6 only [changes to modem.cfg file with
5.5.32.x]
connectemc A Symbolic link to /nas/sbin/connectemc executable
connectemc.sh This file sets the path to the libraries [/opt/connectemc/lib]
logs Various ConnectHome logs, see next section
rsapub1.key The Encryption key file.
connectemc.cer Certificate
curl-ca-bundle.crt
naslogger_conduit Logging
poll This directory containing ConnectHome xml files, but is a symbolic link to
/nas/log/ConnectHome
ConnectEMC_config.xml This file shows the type of transport service that is in
effect [Email, FTP, Modem]
<ConnectConfig Type="Email">
kermit The Symbolic link to /nas/sbin/kermit executable
ConnectEMC.ini General Configuration file on log format, log names, log sizes, log
archiving, log levels, polling, transport service configuration, archive options,
encryption, recycle parameters, etc.
lib
Queue
recycle The directory of failed callhomes that will be retried.
recycle.log The log of retried callhomes with projected retry times,
/nas/opt/connectemc/logs.
archive The directory which contains ConnectEMC.archive file of successful
callhomes by Time and Filename and xml contents.
Example:
# view /nas/opt/connectemc/logs/archive/ConnectEMC.archive
----------------------------------------------------------------------
-- Time : 21-10-2007 03:45:53.
-- Filename : /opt/connectemc/poll/RSC_APM00064001123_102107_034449696.xml.
-------------------------------output abridged--followed by contents of the RSC
xml file----
failed (archive directory of failed callhome files)
ConnectEMC (daemon log)
ConnectEMC_email.log (last email attempt)
ConnectEMC_ftp.log (last FTP attempt)
ConnectEMC_dial.log (last modem attempt)
output
CONTROL STATION PROCESSES FOR CONNECTHOME:
# ps -eafl |grep connect
140 S root 1463 1 0 69 0 - 1284 do_sel Aug27 ? 00:00:00 sendmail:
accepting connections
000 S root 3531 1689 0 69 0 - 373 nanosl Aug27 ? 00:00:00
/nas/sbin/log_trimmer -n /nas/log/connecthome_log 2000 l 6 h t 10 n
000 S root 4757 1689 0 69 0 - 566 wait4 Aug27 ? 00:00:14
/bin/bash /nas/sbin/connectemc_starter
000 S root 5243 4757 0 69 0 - 1838 nanosl Aug27 ? 00:00:00
/nas/opt/connectemc/connectemc
Note: The connectemc process replaces the old ch_monitor, while the Kermit process replaces the
ch_app process.
Note: /nas/log/cel_api.log records fact that a modification was done, and what the host IP address was,
but does not record the actual modification.
Celerras>Support>ConnectHome tab
Miscellaneous Items:
Celerra Manager can modify the Site ID, Celerra Serial Number, and Enable or Disable the Dial-in phone
number; Enter or Modify the Dial-in modem number, Enable or Disable Encyrption, and can test any of
the ‘configured’ transport methods present on the list. Celerra Manager cannot stop, clear, or restart the
transport service; only CLI can perform these functions.
Defaults:
The Dial-in Enable and Encryption enable are set by default. All other values blank until set.
EMAIL ITEMS:
You can modify the Priority transport, Disabled, Primary, Secondary, or Tertiary method of transport,
specify Primary and Secondary SMTP server, Subject line of email, specify multiple Recipient
Address(es) with comma separation. You cannot change Sender Address from GUI.
EMAIL DEFAULTS:
Default Sender is connectemc@emc.com <mailto:connectemc@emc.com
Default Recipient is emailalert@emc.com <mailto:emailalert@emc.com
Default Subject Line is “CallHome Alert”-all other values blank until set
FTP ITEMS:
You can modify the Priority of the Primary and Secondary FTP Servers, the Port to use for FTP, the
Username, Password, default Remote Location path, and the Active or Passive Transfer Mode.
FTP DEFAULTS:
The Default FTP user account is “onalert”,
The Default FTP password is “EMCCONNECT”.
The Default FTP destination path is “incoming”.
The Default transfer mode is Active-all other values blank until set.
MODEM ITEMS:
You can modify the Priority of the Primary and Secondary Modem Number, Enable or Disable BT
Tymnet.
MODEM DEFAULTS:
The default setting for BT Tymnet is no,-all other values are blank until set
CONFIGURING CONNECTHOME FROM CLI:
Setting Dial-In Modem Number, Site ID, Serial Number, or Encryption:
# /nas/sbin/nas_connecthome -modify -dial_in_number 15082498600 | -serial_number |
-site_id | -encryption_enabled yes | no
Ok
# /nas/sbin/nas_connecthome -info |head
ConnectHome Configuration:
Encryption Enabled = no
Dial In :
Enabled = yes
Modem phone number = 15082498600
Site ID = s323
Serial number = APM00064001123
Note: Multiple email recipients allowed using comma separation between addresses, no spaces, via CLI
only-EMC recommendation to keep emailalert@emc.com <mailto:emailalert@emc.com> as the default
destination address. The Callhome Email message body is Base64 encoded and is not readable text.
The Default Email Subject line is ‘Callhome Alert’. The Default Email Sender is ‘connectemc@emc.com’.
Note: The default ftp user is “onalert” and default ftp password is “EMCCONNECT”.
Note: Be aware of syntax difference between the Primary and Secondary Modem numbers.
Note: Use double quotations in place of the FTP IP address, Email address, or Modem number that is to
be removed from the configuration
Note: If the system ships with an MT5634ZBA modem, it may require the use of a utility or CLI procedure
to set the country and regional codes.
3. [ ] Using Windows Explorer on the service laptop, double-click the ZBAWizard.exe file. When you
do, a password prompt display appears.
4. [ ] Enter EMC (case-sensitive) and click OK when prompted for the decryption password.
5. [ ] The Global Wizard application display appears.
Note: The country/region listed in this application does not indicate that the modem you are using is
approved for use in that country/region. For more information, refer to the list of approved countries and
regions, which may be included with your modem. If no such list exists or you wish to check on the most
up-to-date country/region approved information, see the Multi-Tech web site at http://www.multitech.com.
9. [ ] Select or verify the correct country/region is selected as shown in the display that follows. Then
click Next.
1. [ ] Connect the serial cable from the modem to the service laptop.
4. [ ] The decimal value for the country/region code is output to the HyperTerminal session. Refer to
the tables that follow for a list of the countries, their decimal values, and hex commands.
5. [ ] If you need to change the country/region code, enter the following command:
Note: You can use the Windows calculator to convert decimal to hex. Just enter the value into the
calculator as decimal and select hex.
AT%T19,0,<modem_hex_value>
Where <modem_hex_value> is the hex value for the country/region code shown in the tables that
follows.
For example Australia for modem MT5634ZBA.
AT%T19,0,1
OK
6. [ ] Enter the following command to confirm that the current country/regional setting was changed
correctly:
ATI9
The country/region-code decimal value is output to the HyperTerminal session. Refer to the tables
that follow for a list of the countries and their decimal values.
Note: The applicable country and region code can be found in the appropriate Celerra Setup Guide for
MT5634ZMA