background image

Chapter 2  Setup
 >

2.3  Setting Items

ETERNUS Disk storage systems ETERNUSmgr User Guide -Introduction-

22

Copyright 2009 FUJITSU LIMITED   

P2X0-0202-04ENZ0

[Example]

BUSY_TIME=1800

2.3.2

E-mail Notification Settings

This section explains how to setup the E-mail notification function. See 

"6.3 E-mail Messages"             

(page 54)

 for the content of E-mail messages provided by this function.

Admin Mail Address

This parameter is used to specify an address to which to send the E-mail generated in the event              
of change in the target device status. Usually this is the address of the target device administra-              
tor.
The E-mail notification function is disabled if this parameter is omitted.

[Parameter]

ADMIN_MAIL (up to 64 characters)

[Example]

ADMIN_MAIL=admin@domain-name.com

To set multiple E-mail addresses, use a comma with no spaces between each address.

ADMIN_MAIL=admin1@domain-name.com,admin2@domain-name.com

Alarm Mailing Interval

This parameter is used to specify the interval for sending generated E-mail in the event of a fail-              
ure or abnormality in the machine. Units are seconds.
Set the interval in units of seconds within the range of 1 ~ 65535. Set this parameter only if you              
wish to send E-mail with timing different from the specified Polling Interval. For example, by set-              
ting this parameter, you can set a short Polling Interval and long Alarm Mailing Interval. This will              
allow any device errors that may have occurred over this interval to be collected and sent              
together with other E-mail messages.
This parameter is not a required setting. If omitted, the default value will be the same as the              
Polling Interval.

[Parameter]

MAIL_SEND_TIME (1-65535)

[Example]

MAIL_SEND_TIME=300

This specifies the Alarm Mailing Interval (time between the sending of one notification E-mail             
message to the next) for sending E-mail.
Due to network or device load the time to send the E-mail may exceed the expected time. In such                
cases, the E-mail sending times are recalculated the same way as for the polling time.

This setting is not described in the initial setup file. Add if necessary.
This setting needs not be changed.

Summary of Contents for ETERNUS

Page 1: ......

Page 2: ......

Page 3: ...tration and Web server administration are required by this document Fourth Edition October 2009 Structure of this Manual This guide consists of the following 6 chapters Chapter 1 About ETERNUSmgr This chapter explains the functions of ETERNUSmgr its structure and what other software is required to operate it Chapter 2 Setup This chapter explains how to configure ETERNUSmgr and additionally explain...

Page 4: ...tems ETERNUSmgr Install Guide for Windows ETERNUS Disk storage systems ETERNUSmgr Install Guide for Linux ETERNUS Disk storage systems ETERNUSmgr Install Guide for HP UX ETERNUS Disk storage systems ETERNUSmgr Install Guide for AIX ETERNUS DX410 DX440 Disk storage system User Guide ETERNUS DX8100 DX8400 DX8700 Disk storage system User Guide ETERNUS2000 Disk storage system User Guide for models 100...

Page 5: ...at Inc in the USA and other countries Netscape and Netscape Communicator are registered trademarks of Netscape Communications Corporation in the USA and other countries Mozilla and Firefox are registered trademarks of Mozilla Foundation Adobe Acrobat is a trademark of Adobe Systems Incorporated The company names product names and service names mentioned in this document are registered trademarks o...

Page 6: ... 3 4 Alarm Text File Settings 26 2 3 5 Log File Settings 28 2 4 Modifying the ETERNUSmgr Top Menu System 30 2 4 1 Copying Modifying the Top Menu Files 30 2 4 2 Editing Top Menu file menu htm 32 2 5 Monitoring Multiple Target Devices 34 2 5 1 Setup File Cautions 34 2 5 2 Creating a Setup File for Each Target Device 34 2 5 3 Adding the Extra Target Devices to the Top Menu File 36 Chapter 3 Startup a...

Page 7: ...ide Introduction 7 Copyright 2009 FUJITSU LIMITED P2X0 0202 04ENZ0 Chapter 4 Control Interfaces Top Menu 46 Chapter 5 Cautions 48 Chapter 6 Messages 52 6 1 Alarm History Messages 52 6 2 Alarm Text Files 53 6 3 E mail Messages 54 6 4 Log Messages 56 Index 61 ...

Page 8: ...ware on each ETERNUS Disk storage system can provide SNMP Traps A central monitoring system is required However if the customer has a central monitoring system which fields SNMP Traps For example ETER NUS SF Storage Cruiser and does not need to directly receive e mail notification of events then the ETERNUSmgr frontend and the Management Server are not necessary When service actions are necessary ...

Page 9: ...400 series ETERNUS DX8000 series ETERNUS4000 models 300 400 500 and 600 and ETERNUS8000 Managing Server Mail Server Windows version excluded Web Server program Frontend Status monitoring and mail notification LAN ETERNUS Disk storage system Work Server Fibre Channel Web Browser Client WAN Mail Server Windows version Only Windows Solaris OS HP UX AIX Linux Backend Status display Configuration displ...

Page 10: ...eriod of time the administrator can browse the failure history later as time permits The error monitoring function records the enclosure number where the error occurred The error monitoring function can detect only the error location in terms of drive enclosures controller enclosures and battery enclosures not detailed error location such as hard disk CPU etc To obtain detailed location once an er...

Page 11: ... No No FC cable No Yes Yes RCI cable No Yes Yes DEI cable No No No PANEL No No No Battery unit No No No Battery charger unit No No No Compone nt Device model ETERNUS3000 ETERNUS 2000 ETERNUS 4000 models 80 and 100 ETERNUS DX400 series ETERNUS DX8000 series ETERNUS 8000 ETERNUS 4000 ETERNUS 6000 model 50 models 80 and100 models 200 300 400 500 600 and 700 Controller enclosure Yes Yes Yes Yes Yes Ye...

Page 12: ... also needed on the ETERNUSmgr server Use the mail server program included with ETERNUSmgr if the OS is Solaris OS HP UX AIX or Linux Web server program By installing or enabling a Web server program on the ETERNUSmgr Server user can browse alarm history and ETERNUSmgr portal page linking multiple ETERNUS systems Chapter 4 Control Interfaces Top Menu page 46 Web server program is not required if n...

Page 13: ... client providing it has a Web browser installed Java Runtime Environment JRE may be necessary for some devices Web browser The alarm history files from ETERNUSmgr are generated in HTML format Also device settings and maintenance are performed using CGI scripts or Java applets which also require a Web browser Operation windows used by ETERNUSmgr are supported by the following browsers For ETERNUS ...

Page 14: ...ater Windows environment Java Runtime Environment Java Runtime Environment must be installed to perform settings and maintenance of the following device For ETERNUS2000 Required Software Java Runtime Environment 5 0 Update 11 or later Java Runtime Environment 6 0 Update 3 or later Web browsers older than or other than those shown above may not display the window correctly The current status of Web...

Page 15: ...p files before making any changes Keep this backup until you have verified that the new setup files operate normally Setup file names must be in the following format If the file name is other than as specified above ETERNUSmgr will not be able to detect the file The only place setup files should be saved is the installation directory If a setup file is saved in another directory ETERNUSmgr will no...

Page 16: ...arm Text Files are Kept is only enabled when the Alarm Text Files Directory has been specified 4 Alarm Text Files Directory TEXT_ALARMFILE_NAME Number of Days Alarm Text Files are Kept TEXT_ALARMFILE_DAY the Busy Target Detection Time BUSY_TIME and Sender Mail Address MAIL_FROM are not described in the initial setup file Add if necessary Setting item Parameter Solaris OS HP UX AIX and Linux Window...

Page 17: ...uring installation This explanation uses ETERNUSmgr s default installation directory opt FJSVgrmgr as an example Procedure 1 Confirm the contents of the installation directory Make sure that the necessary files and directories stxchk _STXPOLL INI STXPOLL_1 INI stxpoll stxpolld www have all been installed ls opt FVSVgrmgr stxchk _STXPOLL INI STXPOLL_1 INI stxpoll stxpolld www Setting item Parameter...

Page 18: ...ion directory using Explorer etc Make sure the following files and folder have been installed in the installation directory _stxpoll ini STXPOLL exe STXPOLL_1 INI stxpolld exe stxsmail exe and www www is a folder 2 Edit the STXPOLL_1 INI file Edit the STXPOLL_1 INI file using a text editor Notepad etc End of procedure 2 3 Setting Items This section explains the setting items parameters in the setu...

Page 19: ...lt value 300 Parameter POLLING_TIME 1 65535 Example POLLING_TIME 300 This specifies the Polling Interval time between the start of one poll to the next Due to network or device load the actual polling time may exceed the set time In such cases the start of the next polling time is delayed until the previous polling finishes When the actual polling finishes within the scheduled polling time As the ...

Page 20: ...TERNUS GR740 GR820 GR840 4 ETERNUS DX400 series ETERNUS DX8000 series ETERNUS2000 ETERNUS4000 ETERNUS8000 Unless there is some special reason to change this parameter it is recommended to keep the default For this reason the parameter is initially commented out 400 sec 150 sec 150 sec 450 sec 300 sec 300 sec 300 sec 300 sec Schedule recalculated Scheduled polling interval Actual polling interval P...

Page 21: ...nabled in its setup file immediately after installation Set TRUE to detect the offline status Omit setting to disable this parameter Parameter DETECT_OFFLINE Example Detect the offline status set as below DETECT_OFFLINE TRUE Busy Target Detection Time This parameter is used to set the target device busy status detection time Units are seconds Depending on what the ETERNUS device is doing its devic...

Page 22: ...ecify the interval for sending generated E mail in the event of a fail ure or abnormality in the machine Units are seconds Set the interval in units of seconds within the range of 1 65535 Set this parameter only if you wish to send E mail with timing different from the specified Polling Interval For example by set ting this parameter you can set a short Polling Interval and long Alarm Mailing Inte...

Page 23: ...m ADMIN_MAILSV mailsv domain name com Mail Server SMTP Port ETERNUSmgr for Windows only This parameter is used to specify a SMTP port No for the mail server ADMINS_MAILSV when the ETERNUSmgr server is running on Windows Parameter SMTP_PORT 1 65535 Unless there is some special reason to change this parameter it is recommended to keep the default For this reason the parameter is initially commented ...

Page 24: ...TML file The directory in which these Alarm His tory Files are saved must be specified as an absolute path This is a required parameter ETERNUSmgr will not start if this parameter has not been set The default setting is the html_1 directory under the www Top Menu directory specified during installation specifically opt FJSVgrmgr www html_1 for the Solaris OS HP UX AIX and Linux versions and C Prog...

Page 25: ...file directory ensure that all the files index htm menu htm fujitsu gif eternus gif in the parent directory ETERNUSmgr Top Menu directory are also moved to the new parent directory If using multiple setup files ensure that any modifications are consistently applied to each setup file Setup the parent directory of the alarm history file directory i e the ETERNUSmgr Top Menu directory as a public di...

Page 26: ... date files use a stxgrYYYYMMDD log naming format e g stxgr20081201 log Alarm Text Fixed File A copy of the most recent alarm text date file may also be given an arbitrary name Alarm Text Files Directory Alarm text files are created when this parameter is set If only alarm text date files are required specify an absolute path to the directory in which the alarm text date files are to be created If...

Page 27: ...Example To save seven days worth of alarm text files TEXT_ALARMFILE_DAY 7 When monitoring and generating alarm text files for multiple target devices set different directories for each device s alarm text files See 2 5 Monitoring Multiple Target Devices page 34 for information on how to monitor multiple target devices If the specified Alarm History Files Directory does not exist it will automatica...

Page 28: ...n ETERNUSmgr Log files can be viewed with a text editor etc The log files are located in the directory specified by the LOGFILE_PATH parameter in the setup file The log file names are represented by the character string consisting of stxpe Date log e g stxpe20081201 log making it easy to find the log file for a specific date Log Files Directory This parameter specifies as an absolute path the dire...

Page 29: ...ess log files Output startup and error information LOGFILE_MODE 1 This outputs logs only when ETERNUSmgr starts up and in the event of an error Use this mode when space in the log area is restricted Output all log information LOGFILE_MODE 2 This mode outputs all possible log information from the startup of ETERNUSmgr Regardless of its eventual success or failure at least one log is generated by ea...

Page 30: ...enu Settings directory However in such case be sure to make a backup copy of the top menu file menu htm before editing the original 2 4 1 Copying Modifying the Top Menu Files This section explains how to copy and edit the top menu files 2 4 1 1 ETERNUSmgr for Solaris OS HP UX AIX and Linux Procedure This section explains what to do for the Solaris OS HP UX AIX and Linux versions of ETERNUSmgr This...

Page 31: ...ctory 3 Confirm the copy results ls new Top Menu directory fujitsu gif index htm menu htm eternus gif 4 Edit the copied Top Menu file vi new Top Menu directory menu htm End of procedure 2 4 1 2 ETERNUSmgr for Windows Procedure This section explains what to do for the Windows versions of ETERNUSmgr This procedure shows how to change the top menu directory and then edit menu htm If you are not going...

Page 32: ...o the target device login ETERNUS2000 LI a href http 000 000 000 000 80 target _blank ETERNUS2000 1 a The above line is for HTTP communication between the client and the target device Change http to https and 80 to 443 to use HTTPS ETERNUS Disk storage systems other than ETERNUS2000 Example ETERNUS3000 LI a href http 000 000 000 000 80 login htm target _blank ETERNUS3000 1 a The link to login htm ...

Page 33: ... detect log list H2 TABLE TR TD OL LI a href http domain name eternus mgr html_1 target _blank ETERNUS3000 1 a Status of 000 000 000 000 font color red Offline font OL TD TR TABLE omission HTML HTML omission H2 Select RAID Device H2 TABLE TR TD OL LI a href http 000 000 000 000 80 login htm target _blank ETERNUS3000 1 a OL TD TR TABLE HR H2 Show hardware error detect log list H2 TABLE TR TD OL LI ...

Page 34: ...start To begin monitoring immediately manually reboot ETERNUSmgr 2 5 2 Creating a Setup File for Each Target Device For each additional device that is to be monitored save a renamed copy of the sample setup file created by the installation procedure in the Installation Directory and edit the parameters as necessary for the given target The following example procedures assume that the setup file fo...

Page 35: ...firm the copy results ls opt FJSVgrmgr stxchk _STXPOLL INI STXPOLL_1 INI STXPOLL_2 INI stxpoll stxpolld www 4 Edit the copied file The STXPOLL_2 INI file is used here Vi editor is used here Refer to 2 3 Setting Items page 18 for details of how and which parameters should be changed in the new setup file vi opt FJSVgrmgr STXPOLL_2 INI End of procedure 2 5 2 2 ETERNUSmgr for Windows When adding extr...

Page 36: ...ws Note that if the target device is other than ETERNUS2000 each target address must have either login htm or login_jp htm added to the end The following example uses a configuration with two ETERNUS3000s and one ETERNUS2000 to show how the top menu file should be edited to allow all three devices to be monitored The top menu file should be edited in the same way when monitoring other devices Exam...

Page 37: ...Select RAID Device H2 TABLE TR TD OL LI a href http 000 000 000 001 80 login htm target _blank ETERNUS3000 1 a LI a href http 000 000 000 002 80 login htm target _blank ETERNUS2000 1 a LI a href http 000 000 000 003 80 login htm target _blank ETERNUS3000 2 a OL TD TR TABLE HR H2 Show hardware error detect log list H2 TABLE TR TD OL LI a href http domain name eternusmgr ETERNUS3000_1 target _blank ...

Page 38: ... is able to indicate the current status of each target device in the top menu This is done using the lines after link to the Alarm History Files Directory These lines should not be edited but may be deleted if target status display is not required Status of 000 000 000 000 font color red Offline font The font color red Offline font portion is dynamically changed to one of the following by ETERNUSm...

Page 39: ...he daemon is running ps e grep stxpolld 999 0 00 stxpolld End of procedure After ETERNUSmgr has started up you need to view the log file to confirm whether or not ETERNUSmgr is in communication with the target device If using the E mail notification function also check that E mail notification of ETERNUSmgr startup and changes in the target device states is received ETERNUSmgr startup can be confi...

Page 40: ...ter is not specified or if it is incorrect the following message is displayed and startup is terminated If ETERNUSmgr detects the TARGET_ADDR parameter to be missing incorrect or duplicated in multiple setup files the following message is displayed and startup is terminated If any such messages are displayed on the screen when ETERNUSmgr is starting up check that a setup file exists and all parame...

Page 41: ...ministrator 3 1 3 Setting the ETERNUSmgr Daemon for Automatic Startup The example below shows how to register the daemon for a Solaris OS installed server The daemon registration location and registration method may vary according to the settings of each server registration location will vary according to the run level in use Therefore refer to 1 7 Daemon Registration in the ETERNUSmgr Install Gui...

Page 42: ...service will start up automatically the next time the server is started After installation certain parameters must be set before you can use ETERNUSmgr See Chapter 2 Setup page 15 for details on how to perform these settings Once the necessary parameters have been set follow the instructions in 3 2 1 Starting Up ETERNUSmgr page 42 to startup ETERNUSmgr manually 3 2 1 Starting Up ETERNUSmgr Perform...

Page 43: ...etup file and loads it accordingly If ETERNUSmgr detects multiple setup files for multiple devices it will load all of them See 2 1 Setup files page 15 for information about setup files The setup files are read automatically when ETERNUSmgr is started but processing stops when the following messages appear When no setup files exist or none can be read When a TARGET_ADDR is not specified in a setup...

Page 44: ...below This is not a problem and will not affect future operation so feel free to click the OK button If such messages are displayed on the screen when ETERNUSmgr is starting up check that a setup file exists and all parameter settings are correct For Windows 2000 For Windows Server 2003 or Windows Server 2003 R2 If you do not click the OK button when the above dialogs are displayed Windows may dis...

Page 45: ...RNUSmgr Service for Automatic Startup After installation is completed ETERNUSmgr for Windows is already registered as an automatic startup service that will become active the next time the server is rebooted so there is no need to manually set ETERNUSmgr for automatic startup If for any reason the ETERNUSmgr automatic startup setting is disabled do the following to restore it This setting will be ...

Page 46: ...gs Maintenance Show hardware error detect log list menu Click the name of a target device listed in the Show hardware error detect log list menu to get a listing of the target device s error logs alarm history files This will require use of the Web server s list display function Refer to the User s Guide for the Web server being used for more details The status of the selected target device appear...

Page 47: ...ffline ATTENTION Red Indicates that one or more errors have been detected in the machine Login to the machine and check the location of the fault BUSY Red For ETERNUS4000 models 80 and 100 and ETERNUS3000 Indicates that one of the controllers in the controller enclosure cannot boot up and needs to be serviced For ETERNUS8000 ETERNUS4000 models 300 400 500 and 600 ETERNUS2000 and ETERNUS6000 Indica...

Page 48: ...r network overload caused by a device failure In such a case refer to Chapter 3 Startup and Shutdown page 39 and manually restart ETERNUSmgr Before restarting make sure that the network environment is free from any problem If the ETERNUSmgr server s network settings are not correct or there are hardware failures LAN omissions communications device failures etc on the LAN path it can take an overly...

Page 49: ...e conflicting log data in the same directory or file Refer to Chapter 2 Setup page 15 for information on how to modify the setup files and ETERNUSmgr User Guide Settings Maintenance for information on ETERNUSmgr error messages and the procedures to use when they appear Configuring multiple ETERNUSmgr instances to monitor the same target device may burden the device and overload the connection resu...

Page 50: ..._FLAG parameter is correct for the monitored device type ETERNUSmgr will be unable to monitor the target device if this setting is wrong Note that even if the TARGET_TYPE and the TARGET_FLAG settings are different ETERNUSmgr operations are not affected Any character string may be set in TARGET_TYPE however it is recommended that the correct device type ETERNUS DX400 series ETERNUS DX8000 series ET...

Page 51: ...ded or sleeping use of this mode should be avoided With a GRmgr V10L30 or V10L40 setup file the following parameter descriptions must be added before the E mail notification function available from GRmgr V10L50 can be used by ETERNUSmgr Admin Mail Address ADMIN_MAIL Admin Mail Address Mail Server Address ADMIN_MAILSV Mail Server Address Mail Server SMTP Port SMTP_PORT Mail Server SMTP Port These a...

Page 52: ...rm history file is saved using the following file naming convention in the directory specified in the setup file See Alarm History File Directory page 24 for more information about the setup files YYYY Year MM Month DD Day HH Hour mm Minute SS Second n Sequence number For example the alarm history file 200812011020300 htm was created on December 1st 2008 at 10 20 30 The sequence number is normally...

Page 53: ...s was changed See below is not an actual alarm history message 6 2 Alarm Text Files This section explains the alarm text files that are generated by ETERNUSmgr Alarm text files are a compilation of the alarm history messages for a single day in a text format See 6 1 Alarm History Messages page 52 for more information on the alarm history mes sages Alarm text files are categorized into the followin...

Page 54: ...using whatever name is specified in the setup file See 2 3 4 Alarm Text File Settings page 26 for more information about the setup files When an alarm history file is created a line formatted as Year Month Day Hour Minutes Sec onds Machine Address and Machine Status as Recorded in the Alarm History File is added to the alarm text file An example of an alarm text is shown below See 6 1 Alarm Histor...

Page 55: ...ation link between the device and SVP or device boot processing Check that the target device is operating normally and that there is no problem with the communication link between the device and SVP For ETERNUS DX400 series ETERNUS DX8000 series ETERNUS2000 ETERNUS4000 and ETERNUS8000 Indicates that the target device cannot respond due to device stop status or device boot processing Check that the...

Page 56: ...Unit Multiple statuses for a component are output joined by symbols Example The following message is output when all components of the target device are normal No hardware error detected Depending on the Target Type or version of firmware used actual format and contents of messages may differ slightly from the above 6 4 Log Messages This section describes the messages output by ETERNUSmgr to the l...

Page 57: ...re is no need to do anything Detection of the offline status is indicated when No hardware report detected Offline is displayed In this case check for problems with the target device failures in the communications route and errors in the setup file Work files create to temp directory CODE 014 Explanation ETERNUSmgr has created a work file in the directory indicated in this message Response None Wa...

Page 58: ... target device operating status LAN connection and LAN status Send Data Failed server port path CODE 307 Explanation Failed to communicate with the target device ETERNUSmgr target Response Check the target device operating status LAN connection and LAN status Receive Data Failed server port path CODE 308 Explanation Failed to communicate with the target device target ETERNUSmgr Response Check the ...

Page 59: ... Directory path CODE 908 Explanation Failed to create a directory Response Confirm your access permissions to the directory Confirm that the name of the specified directory is correct Not NULL Parameter parameter CODE 909 Explanation NULL is not allowed for this parameter setting Response Set the parameter Not Find Parameter parameter CODE 910 Explanation This parameter setting cannot be found Res...

Page 60: ...OLL_1 INI 20 45 41 Initialize HTML_ALARMFILE_URL http domain name ETERNUSmgr html_1 MESSAGE 006 STXPOLL_1 INI 20 45 41 Initialize HTML_ALARMFILE_PATH C inetpub wwwroot eternusmgr html_1 MESSAGE 006 STXPOLL_1 INI 20 45 41 Initialize HTML_ALARMFILE_DAY 7 MESSAGE 006 STXPOLL_1 INI 20 45 42 Initialize LOGFILE_PATH C Program Files FUJITSU ETERNUSmgr log_1 MESSAGE 006 STXPOLL_1 INI 20 45 42 Initialize L...

Page 61: ...ets 21 DETECT_OFFLINE 21 Device settings 18 Device Status Display window 10 E Editing Top Menu file menu htm 32 E mail Messages 54 E mail notification setting 22 Error information 28 ETERNUSmgr Functions 10 F Failure Notification 10 48 Fatal Error Messages 58 File name setup file 15 H Hardware 12 Hardware structure 10 HP UX 12 HTML_ALARMFILE_DAY 26 HTML_ALARMFILE_NAME 26 HTML_ALARMFILE_PATH 24 HTM...

Page 62: ...ndmail 12 Service 39 Setting item differences 17 Setting parameters 16 Setting the ETERNUSmgr Daemon for Automatic Startup 41 Setting up the Top Menu File when monitoring multiple target devices 36 Setup files 15 49 Show hardware error detect log list menu 46 Shutdown 39 SMTP protocol 13 SMTP service 13 SMTP_PORT 23 Software 12 Solaris OS 8 12 17 30 39 Startup 39 Status display 34 46 stxgrYYYYMMDD...

Page 63: ...of this manual are the product of all due care and diligence no responsibility can be accepted for operational problems arising from any errors or missing information or other use of the information contained in this manual Fujitsu assumes no liability for damages to third party copyrights or other rights arising from the use of any information in this manual Contents of this manual are not to be ...

Page 64: ......

Reviews: