Download as pdf or txt
Download as pdf or txt
You are on page 1of 16

EMC² CORPORATION

HOPKINTON, MA NAS Tech Support

Appendix I: Celerra ConnectHome

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.

Note: ConnectEMC 2.0.27-b118 is the Linux version on the Control Station.


Multiple CallHome transports can be configured with Primary, Secondary, and Tertiary priority.

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.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-113-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

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.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-114-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

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.

Celerra Manager>Celerras>Support>Connect Home>


Select the primary delivery mechanism
Email; FTP; or Modem:
Select a Secondary or Tertiary delivery method as required
Celerra Manager can modify and test the ConnectHome function and disable or enable the Transport mechanism.

Note: You must be Root user to edit the “Connect Home” page

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-115-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

ConnectHome Configuration Rules


All transport mechanisms can be enabled at the same time.
None of the transport mechanisms are required to be enabled.
Only the root user can make transport mechanism modifications with Celerra Manager or CLI.
A valid email address, FTP IP address or Modem phone number is required to enable or change a
transport method priority.
At least one of the mechanisms must have a priority of 1 making it the Primary transport method.
To enable or disable the transport mechanisms, assign a priority using “-modify email_priority 1, 2, or 3”,
or by removing the priority setting altogether using the “-modify email_priority Disabled” syntax
Command Line Examples
2. Task: Set ConnectHome priority:
Required Parameters: First Set: Primary Email Address, IP Address, or Modem Phone Number
Error: Modem Phone Number not configured.
# /nas/sbin/nas_connecthome -modify -modem_priority 2
Error 14504231241: The Modem transport cannot be enabled because the Primary Modem
Number is not configured.
# /nas/sbin/nas_connecthome -info|tail
Modem :
Priority = Disabled
Primary :
Phone Number =

3. Task: Setting Modem Phone Number:


# /nas/sbin/nas_connecthome -modify -modem_number 918005270941

4. Task: Enabling the Transport Mechanism, Setting Transport Mechanism Priority


# /nas/sbin/nas_connecthome -modify -modem_priority 2
Ok
# /nas/sbin/nas_connecthome -info|tail
Modem :
Priority = 2

Primary ConnectHome Applications and Files


The main ConnectHome application that monitors and delivers event files via a transport method is
/nas/sbin/connectemc.
The general ConnectHome configuration file is /nas/opt/connectemc/ConnectEMC.ini.
The transport configuration file is /nas/opt/connectemc/ConnectEMC_config.xml.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-116-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

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 } ]

Note: ConnectHome consolidates legacy CallHome scripts into one-ch_dd, ch_cfg,


ch_dialin_enable that monitors and delivers event files via a transport method, ch_dialin_disable,
ch_test.

# /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

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-117-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

CallHome File Locations


/nas/log/ConnectHome
RSC_APM00064001123_102107_034449696.xml
/nas/opt/connectemc; ls -la poll
lrwxrwxrwx 1 root root 20 Oct 16 15:51 poll ->
/nas/log/ConnectHome
# /nas/sbin/nas_connecthome -service stop | start (-clear) | clear
# /nas/sbin/nas_connecthome -service stop Pauses the delivery service for any
pending events
Delivery of pending events has been paused.

Note: Process takes about 1 minute to stop, and XML CallHome files in /nas/log/ConnectHome are
removed.

# ps -eafl |grep connect (processes that run during -service stop)


/nas/sbin/nas_connecthome -service stop
000 S root 32690 32689 0 68 0 - 1128 nanosl 13:19 pts/0 00:00:00
/usr/bin/perl/nas/opt/connectemc/.connectemc_suspend -q -m stop -c suspend
# /nas/sbin/nas_connecthome -service start
Prompts to clear any pending events and resumes the delivery service
Do you want to clear all the pending event files?(yes/no) :yes
Any pending events have been cleared and delivery has been resumed.

Note: If no events are pending, the delivery service is resumed.

# /nas/sbin/nas_connecthome -service start –clear


Clears pending events from /nas/log/ConnectHome without prompting, and resumes the
delivery service, there maybe be a delay, running this command does not immediately
remove the callhome file.
Any pending events have been cleared and delivery has been resumed.
# /nas/sbin/nas_connecthome -service clear
Pauses, clears pending events, and resumes Callhome delivery service
None exist. No pending events have been cleared.
# /nas/sbin/nas_connecthome -service clear
Delivery of pending events has been paused.
Any pending events have been cleared and delivery has been resumed.
# /nas/sbin/nas_connecthome
CLI tool for the ConnectEMC feature
connectemc daemon executable that monitors and delivers event files using the
configured transport mechanism(s)

Note: Primary file is /nas/sbin/connectemc. /opt/connectemc/connectemc is a link to


/nas/sbin/connectemc.

kermit A modem control executable


connectemc_starter The process that runs everytime the connecthome service is
started
connecthome_upgrade Script that performs ConnectHome upgrade during NAS Upgrades
/nas/sys connecthome.config The transport configuration and system information
file. A backup copy kept in /nasmcd/CHomeFiles/connecthome.config

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-118-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

# 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:

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-119-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

# 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.

CONFIGURING CONNECTHOME FROM CELERRA MANAGER:

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.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-120-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

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

Enabling or Disabling Dial-In Modem Number:


# /nas/sbin/nas_connecthome -modify -dial_in_enabled yes | no
Ok

Setting E Mail Transport Primary and Secondary Destinations:


# /nas/sbin/nas_connecthome -modify -email_to
emailalert@emc.com,BAR101@spaek1.hosts.svt.dns,BAR101@spark2.hosts.svt.dns -
email_from admin@emc.com -email_subject 'Email Callhome Alert' -email_server
spark1.hosts.svt.dns -email_server_2 spark2.hosts.svt.dns
Ok
# /nas/sbin/nas_connecthome -info |grep -C3 Email
Email :
Priority = 1
Sender Address = admin@emc.com <mailto:admin@emc.com> Set using CLI
only
Recipient Address(es) =
emailalert@emc.com,BAR101@spark1.hosts.svt.dns,BAR101@spark2.hosts.svt.dns
Subject = Email Callhome Alert
Primary :
Email Server = spark1.hosts.svt.dns
Secondary :
Email Server = spark2.hosts.svt.dns

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’.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-121-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

FTP by ESRS Gateway DESTINATIONS--Primary & Secondary Server:


Sets Primary FTP server and port, if specified and sets Secondary FTP server and port
# /nas/sbin/nas_connecthome -modify -ftp_ipport 168.151.215.45 -ftp_ipport_2
192.1.6.248
Ok
# /nas/sbin/nas_connecthome -info |grep -i ftp
FTP :
FTP Server = 168.151.215.45
FTP Port = 21
FTP User Name = onalert
FTP Password = **********
FTP Remote Folder = incoming
FTP Transfer Mode = active
FTP Server = 192.1.6.248
FTP Port = 21
FTP User Name = onalert
FTP Password = **********
FTP Remote Folder = incoming
FTP Transfer Mode = active

MODIFYING FTP USER & PASSWORD:


# /nas/sbin/nas_connecthome -modify -ftp_user anonymous -ftp_passwd onalert@emc.com
Ok

Note: The default ftp user is “onalert” and default ftp password is “EMCCONNECT”.

MODEM DESTINATIONS--Primary & Secondary:


# /nas/sbin/nas_connecthome -modify modem_number 9,18885552222 -modem_number_2
9,18885553333
Ok
SETTING TRANSPORT METHOD PRIORITY:
# /nas/sbin/nas_connecthome -modify -email_priority 1 -ftp_priority 2 -
modem_priority 3
# /nas/sbin/nas_connecthome -modify -ftp_priority 2
Ok
# /nas/sbin/nas_connecthome -info |grep -C1 FTP
FTP :
Priority = 2
# /nas/sbin/nas_connecthome -modify -modem_priority 2
Ok
DISABLING TRANSPORT METHOD PRIORITY:
# /nas/sbin/nas_connecthome -modify -ftp_priority Disabled
Ok
# /nas/sbin/nas_connecthome -info |grep -C1 FTP
FTP :
Priority = Disabled
# /nas/sbin/nas_connecthome -modify -modem_priority Disabled
REMOVING A TRANSPORT METHOD FROM THE CONFIGURATION FILE:
# /nas/sbin/nas_connecthome -modify -ftp_ipport "" -ftp_ipport_2 ""
Ok
# /nas/sbin/nas_connecthome -modify -ftp_ipport ""
Error 14504231237: The Primary FTP Server cannot be unconfigured because the FTP
transport is enabled.
Note: Must disable the transport method using -modify -ftp_priority Disabled
before the transport can be removed
# /nas/sbin/nas_connecthome -modify -email_server_2 ""
# /nas/sbin/nas_connecthome -modify -modem_number ""
Ok

Note: Be aware of syntax difference between the Primary and Secondary Modem numbers.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-122-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

# /nas/sbin/nas_connecthome -modify -modem_number_2 ""

Note: Use double quotations in place of the FTP IP address, Email address, or Modem number that is to
be removed from the configuration

TESTING A TRANSPORT METHOD (Testing Celerra ConnectHome):


# /nas/sbin/nas_connecthome -test -email_1 [or -ftp_1, -modem_1, etc.]
---------------------------------------------------------
ConnectEMC 2.0.27-bl18 Wed Aug 22 10:24:32 EDT 2007
RSC API Version: 2.0.27-bl18
Copyright (C) EMC Corporation 2003-2007, all rights reserved.
---------------------------------------------------------
Reading configuration file: ConnectEMC.ini.
Run Service begin...
Test succeeded for Primary Email.

EXAMPLE OF SUCCESSFUL CONNECTHOME EMAIL TRANSFER:


# tail /nas/opt/connectemc/logs/ConnectEMC_email.log
[2007-11-04 03:45:47] ******* New SMTP Session started *******
[2007-11-04 03:45:47] Sender Name: connectemc@emc.com, Recipient Name:
BAR101@spark1.hosts.svt.dns.
[2007-11-04 03:45:47] Email Server: spark1.hosts.svt.dns, File count: 2.
[2007-11-04 03:45:47] Subject: CallHome Alert.
[2007-11-04 03:45:47] Sending
/opt/connectemc/poll/RSC_APM00064001123_110407_034444400.xml
[2007-11-04 03:45:47] Attaching
/opt/connectemc/poll/RSC_APM00064001123_110407_034444400_checkup.gz
[2007-11-04 03:45:47] Email sent to mail server successfully

EXAMPLE OF SUCCESSFUL CONNECTHOME FTP TRANSFER:


# /nas/sbin/nas_connecthome -test -ftp_1
---------------------------------------------------------
ConnectEMC 2.0.27-bl18 Wed Aug 22 10:24:32 EDT 2007
RSC API Version: 2.0.27-bl18
Copyright (C) EMC Corporation 2003-2007, all rights reserved.
---------------------------------------------------------
Reading configuration file: ConnectEMC.ini.
Run Service begin...
* About to connect() to 168.151.215.45 port 21
* Trying 168.151.215.45... * connected
* Connected to 168.151.215.45 (168.151.215.45) port 21 --output abridged--
USER anonymous
< 331 Enter your email address as your password
> PASS onalert@emc.com
< 230 Password accepted
> PWD
< 257 "/" is your current location
* Entry path is '/'
> CWD incoming
< 250 OK. Current directory is /incoming --------output abridged---
> STOR RSC_APM00064001123_111207_161635666.xml
< 150 Accepted data connection
* Remembering we are in dir incoming/
< 226-61952.1 Mbytes free disk space
< 226-File successfully transferred
< 226 0.002 seconds (measured here), 0.99 Mbytes per second
* Connection #0 to host 168.151.215.45 left intact
> QUIT

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-123-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

TESTING MODEM DIALOUT:


19. [ ] First make sure the TTY port is functioning correctly:
# /nas/sbin/modemtst
modemtst: Modem /dev/ttyS0 OK

20. [ ] Then test ConnectHome modem configuration:


# /nas/sbin/nas_connecthome -test -modem_1
---------------------------------------------------------
ConnectEMC 2.0.27-bl18 Wed Aug 22 10:24:32 EDT 2007 (Output abridged…..)

SETTING COUNTRY CODE ON MT5634ZBA MODEMS:

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.

Setting the Country Code on the MT5634ZBA Modem


If the customer has a MT5634ZBA modem (check the label on the bottom of the modem or on the box
that the modem shipped in) you might need to run a special utility to set the correct country/regional code.
The modem ships with a default value for the country/regional code. The default value might not be
appropriate for the location of the system.
Use ZBAWizard.exe to set the country/regional code on a Microsoft Windows-based PC.
ZBAWizard.exe is available on the Global Services website in the Application Download Area. Manual
instructions for setting the country code are also provided for a non Windows-based PC or when the
ZBAWizard.exe is not available. Only the manual instructions let you verify the country/regional code
configured on the modem.
Windows-based PC Instructions
Set the regional code by using a utility named ZBAWizard.exe. This is an EMC version of the vendor
supplied utility. To use the ZBAWizard.exe utility do the following:

1. [ ] Download the latest version of the ZBAWizard.exe utility as follows

a. Go to the following Global Services website:


http://www.cs.isus.emc.com/
b. Click on Site Index
c. Click the Application Download Area hyperlink.
d. Click the ZBA Global Modem Wizard hyperlink.
e. Click the ZBAWizard.exe hyperlink to download the executable.
f. Click Save and select a location on your service laptop to save the file. You run this application at
a later step in the procedure. So make sure you know where the file is on the service laptop.
2. [ ] Connect the serial cable from the modem to the service laptop.

Note: Make sure the modem is powered on.

3. [ ] Using Windows Explorer on the service laptop, double-click the ZBAWizard.exe file. When you
do, a password prompt display appears.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-124-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

4. [ ] Enter EMC (case-sensitive) and click OK when prompted for the decryption password.
5. [ ] The Global Wizard application display appears.

6. [ ] Click Next to start the wizard.


The wizard attempts to contact the modem. Wait for modem detection. If this does not occur, verify
tht the modem is powered on and the serial cable is securely connected at both ends.
7. [ ] Click Next once the modem is found.
8. [ ] If a warning message about the modem not being compatible with this region or country is
displayed, click OK to acknowledge the message.

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.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-125-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

10. [ ] A confirmation screen appears with your selection.


11. [ ] Click Next on the confirmation screen.
12. [ ] Click Finish to exit the wizard. This completes this procedure.
Manual Instructions for Setting the Country Code
To manually set the country/region code without using the ZBAWizard.exe utility, do the following:

1. [ ] Connect the serial cable from the modem to the service laptop.

Note: Make sure that the modem is powered on.

2. [ ] Open a HyperTerminal session using the following settings:


Bits per second: 19200 Flow Control: None
Data bits: 8 Emulation: Auto Detect
Parity: None Telenet terminal ID: ANSI
Stop bits: 1
Typically this is done using COM 1.
3. [ ] Enter the following command to check the current country/regional setting which is decimal 52 in
the example that follows:
ATI9
For example:
+++
ATI9
52
(?$MTS00C1\\MODEM\TIA0602,TIA0578\MultiTech Systems
MT5634ZBA-V92A9)
OK

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.

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-126-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

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.

MT5634ZBA Modem Country/Region Codes


Region config ATI9 Result code
Country
command (Hex) (Decimal)
Australia AT%T19,0,1 1
Hong Kong, Hungary, India, Indonesia, Israel, Korea, AT%T19,0,30 48
Malaysia, Republic of (South Korea), Philippines, Poland,
Singapore, Slovenia, Vietnam
Japan AT%T19,0,10 16

MT5634ZBA Modem Country/Region Codes


Region config ATI9 Result code
Country
command (Hex) (Decimal)
South Africa AT%T19,0,35 53
Afghanistan, Albania, Algeria, American Samoa, AT%T19.0.34 52
Andorra, Angola, Anguilla, Antigua and Barbuda,
Argentina, Armenia, Aruba, Austria, Azerbaijan,
Bahamas, Bahrain, Bangladesh, Barbados, Belarus,
Belgium, Belize, Benin, Bermuda, Bhutan, Bolivia,
Bosnia and Herzegovina, Botswana, Brazil, Brunei
Darussalam, Bulgaria, Burkina, Faso, Burundi,
Cambodia, Cameroon, Canada, Canary Islands, Cape,
Verde, Cayman Islands, Central African Republic, Chad,
Chile, China, Colombia, Congo, The Democratic
Republic of Congo, Cook Islands, Costa Rica, Côte
D'Ivoire, Croatia, Cyprus, Czech Republic, Denmark,
Djibouti, Dominica, Dominican Republic, East Timor,
Ecuador, Egypt, El Salvador, Equatorial Guinea, Estonia,
Ethiopia,
Faero Islands, Fiji, Finland, France, French Guiana,
French Polynesia, Gabon, Gambia, Georgia, Germany,
Ghana, Gibraltar, Greece, Greenland, Grenada,
Guadeloupe, Guam, Guatemala, Guernsey, C.I., Guinea,
Guinea-Bissau, Guyana, Haiti, Holy See (Vatican City
State), Honduras, Iceland, Iran, Iraq, Ireland, Isle of Man,
Italy, Jamaica, Jersey C.I., Jordan, Kazakhstan, Kenya,
Kiribati, Kuwait, Kyrgyzstan, Lao People's Democratic
Republic, Latvia, Lebanon, Liberia, Libya, Liechtenstein,

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-127-
EMC² CORPORATION
HOPKINTON, MA NAS Tech Support

Region config ATI9 Result code


Country
command (Hex) (Decimal)
Lithuania, Luxembourg,
Macau, Macedonia, The Former Yugoslav Republic of,
Madagascar, Malawi, Maldives, Mali, Malta, Martinique,
Mauritania, Mauritius, Mayotte, Mexico, Moldova,
Republic of Monaco, Mongolia,
Montserrat, Morocco, Mozambique, Namibia, Nauru,
Nepal, Netherlands, Netherlands Antilles, New
Caledonia, Nicaragua, Niger,
Nigeria, Norway, Oman, Pakistan, Palestine Territory,
Occupied, Panama, Papua New Guinea, Paraguay,
Peru, Portugal, Puerto Rico,
Qatar, Reunion, Romania, Russian Federation, Rwanda,
Saint Kitts and Nevis, Saint Lucia, Saint Vincent and the
Grenadines, Samoa, Saudi Arabia, Senegal, Seychelles,
Sierra Leone, Slovakia, Solomon Islands, Spain, Sri
Lanka, Sudan, Surinam, Swaziland, Sweden,
Switzerland, Syrian Arab Republic, Taiwan, Tajikistan,
Tanzania,
United Republic of, Thailand, Tahiti, Togo, Tonga,
Trinidad and Tobago, Tunisia, Turkey, Turkmenistan,
Turks and Caicos Islands, Uganda, Ukraine, United Arab
Emirates, United Kingdom, Uruguay, USA, Uzbekistan,
Vanuatu, Venezuela, Virgin Islands, British, Virgin
Islands, U.S., Yemen, Yugoslavia, Zambia, Zimbabwe

Manually Updating Country/Region settings:

1. [ ] Connect serial cable between modem and laptop


2. [ ] Open HyperTerminal session and configure 19200 bits per second, 8 data bits, set parity to
None, 1 for stop bit, flow control None, terminal emulation ANSI
3. [ ] Verify current country/regional setting:
ATI9 (returns country value in decimal)
4. [ ] Set desired country code and verify to make sure the setting was updated:
AT%T19,0,10 (last digit is modem value in hex, which in decimal is 16 for Japan)
5. [ ] ATI9

Note: The applicable country and region code can be found in the appropriate Celerra Setup Guide for
MT5634ZMA

EMC CONFIDENTIAL Celerra Procedure Generator V1.5.5


-128-

You might also like