background image

94

C

HAPTER

 4: S

ERVER

 F

AILOVER

 C

ONFIGURATION

EMS_FILEHOME

EMS_FILEHOME

 should be treated as a server-specific setting only. Given 

the different ways that two computers can attach to a shared disk (using 
different UNIX mount points or mapping different drive letters in 
Windows), it is not desirable to share this setting.

Troubleshooting

What if the remote_server property is set wrongly?

If the 

remote_server

 property is not set correctly, the EMS Server will not 

complete its startup

What if I don't set EMS_FILEHOME correctly?

If 

EMS_FILEHOME

 is set differently on both EMS servers, the servers will use 

different directories if the settings point to valid directories. This can also 
happen if 

EMS_FILEHOME

 is not set on one or both of your EMS servers. It 

is essential that 

EMS_FILEHOME

 is set correctly, otherwise the Server 

Failover system will not work properly when trying to run operations that 
rely on the EMS filesystem, such as telnet scripts or restore operations. 
The 

EMS_FILEHOME

 setting is mandatory, if the user specifies a 

remote_server.

What if the shared file location is unavailable?

On UNIX, if the shared file location is unavailable, EMS will create its files 
under the empty mount point, and in turn both EMS servers will not be 
sharing the same set of files.

Running in Server 
Failover Mode

Once you have configured both servers as described in the previous 
section you can run the servers. This section details how the Server 
Failover system operates once it begins running.

Server Startup

Messages

Start the EMS server you marked as your preferred server first. This 
server starts up in Active mode and displays the following message on 
the server command line once server startup is complete:

************* ACTIVE SERVER MODE *************

*** EMS Clients will connect to this server ***

***********************************************

Summary of Contents for 3CR15600 - Enterprise Management Suite

Page 1: ...http www 3com com Part Number 10015165 Rev 2 Published September 2007 ENTERPRISE MANAGEMENT SUITE GETTING STARTED GUIDE Enterprise Management Suite Release 2 41 ...

Page 2: ...ile named LICENSE TXT or LICENSE TXT If you are unable to locate a copy please contact 3Com and a copy will be provided to you UNITED STATES GOVERNMENT LEGENDS If you are a United States government agency then this documentation and the software described herein are provided to you subject to the following United States Government Legend All technical data and computer software is commercial in na...

Page 3: ...ge 19 Configuration Templates 19 Scheduled Operations 19 EMS Device Classes 20 All Configuration Template Classes 20 All Events 20 All Operation Steps 20 All Stated Managed Objects 20 All Stateless Folders 20 All Static Classes 20 Serial and Parallel Processing 20 Features 21 Benefits 22 EMS Software Components 23 Supported Devices 24 Supported 3Com Data Products 24 Supported 3Com Router Products ...

Page 4: ...indow 36 Online Help 36 Printing Options 36 EMS Event Processing 37 Event Flow 37 2 PRE INSTALLATION EMS Software Licenses 41 Network Management Platform Software Optional 42 System Requirements 42 Hardware Requirements 42 IBM Compatible Hardware Requirements 42 Sun Workstation Hardware Requirements 42 IBM i5 OS Hardware Requirements 43 Network Interface Card Requirements 43 Platform and Operating...

Page 5: ...guring the 3Com TFTP Server for Windows Software 50 Initially Configuring EMS for the 3Com TFTP Server Software for Windows 51 TFTP for UNIX and Linux 51 TFTP for IBM i5 OS 52 Server Failover Requirements 52 Hardware Requirements 52 Supported Platforms 53 3 INSTALLATION AND INITIAL SETUP Installing EMS Software Components 56 Installing the EMS Server using the Silent Option 59 Installing the EMS S...

Page 6: ...75 EMS Licensing System 75 Evaluation Mode 75 Extended Evaluation Mode 75 Activating EMS 76 Obtaining an Activation Key 76 Activate Server Command 76 Activation Key Verification 77 EMS Client Evaluation Mode Visual Indicator 77 Initially Starting the EMS Server 79 Using Windows Shortcut Options 79 Using a Command Prompt 80 Initially Starting the EMS GUI Client 81 Using Windows Shortcut Options 81 ...

Page 7: ...r 97 Dormant Server Behaviors 97 Connecting to the Dormant server when the Active server is still running 97 Preventing Clients from Attaching to the Dormant Server 97 How the Failover System Works 98 Server Failover Mechanism 98 Passing Control Back to the Peferred Server 99 5 SNMP DEVICE CONFIGURATION Creating Device Folders 101 Creating Equipment Bays and Racks 102 Discovering Multiple SNMP Dev...

Page 8: ...ased Device Discovery 120 Transferring Values to from the Discovery Tab 120 Copy Values from the Discovery Tab 120 Save Values to the Discovery Tab 121 6 GUI CLIENT CONFIGURATION Configuring Environment Settings 125 Configuring the Printer Page Setup 129 Configuring the Display of Non supported MIB Objects in the EMS GUI 131 7 USER CONFIGURATION Creating User Folders 133 Creating New Users 134 Del...

Page 9: ...GICAL VIEW CONFIGURATION Creating a Logical View 147 Deleting a Logical View 148 9 NETWORK MANAGEMENT PLATFORM INTEGRATION CONFIGURATION About 3Com Integration Kit 149 Installation 150 Launching EMS from a Network Management Platform 152 Setting Up the EMS Launcher 152 Launching EMS from a Network Management Platform 153 Icons 154 Traps 154 MIBs 155 Network Node Manager Integration Architecture 15...

Page 10: ...king 175 Executing Commands for Multiple Elements 176 Organizing Elements 176 Monitoring the Status of GUI Elements 177 Viewing the Status 177 Using the State Tab 177 Using the State Icon 178 Using the Monitor State Utility 179 Refreshing the Status 180 Using the MIB Browser 181 Starting the MIB Browser 181 Getting and Setting MIB Values 181 Viewing Numeric Values in Alternative Formats 182 Monito...

Page 11: ...I Client 198 Stopping the EMS GUI Client 198 Starting the EMS CLI Client 199 Stopping the EMS CLI Client 199 Using the Server Monitor to Monitor EMS Server Performance 199 Monitoring EMS Server Memory 201 Monitoring EMS GUI Memory 202 Displaying Server Console Commands 203 Displaying EMS CLI Client Console Commands 204 Configuring Table Data Loading 204 A COMMAND LINE INTERFACE REFERENCE EMS Serve...

Page 12: ...12 ...

Page 13: ...g 3Com equipment The README file is bundled with the EMS software and provides release notes and basic installation instructions If the information in the README file differs from the information in this guide follow the instructions in the README file Conventions Table 1 and Table 2 list conventions that are used throughout this guide Table 1 Notice Icons Icon Notice Type Description Information ...

Page 14: ...CONTrol Listen In this example you must supply a port number for port Commands The word command means that you must enter the command exactly as shown and then press Return or Enter Commands appear in bold Example To remove the IP address enter the following command SETDefault 0 IP NETaddr 0 0 0 0 The words enter and type When you see the word enter in this guide you must type something and then p...

Page 15: ...tion and Help systems to voice_techcomm_comments 3com com Please include the following information with your comments Document title Document part number found on the front page Page number Your name and organization optional Example Enterprise Management Suite Getting Started Guide Part Number 900 0282 01 Rev AA Page 25 Please address all questions regarding the 3Com software to your authorized 3...

Page 16: ...16 ABOUT THIS GUIDE ...

Page 17: ... complexity of network management by presenting a truly object oriented view of all aspects of its system In EMS everything is considered an object which includes devices folders logical views users scheduled operations and configuration templates This object based approach is fundamental to giving you the flexibility to customize EMS to your specific needs Object Containers Objects are stored in ...

Page 18: ...cover or add a new device to an equipment folder EMS creates a corresponding system defined logical view that groups the new devices according to device type The devices inside the device type folders are actually links to the original object in the equipment folder If you reserve the object in the equipment folder the link is reserved at the same time Logical views can be used in conjunction with...

Page 19: ...t setting Once created a configuration template is itself an object and while you cannot change any attributes for a configuration template you can use the template like any object For example you can move it to a more appropriate container or add a link using a Logical View to it instead if other users need to access the same template Scheduled Operations The operations of an object are specifica...

Page 20: ...e The state is represented by a colored square in the tree The following colors represent the possible states Green enabled Yellow degraded Red disabled and Magenta if EMS cannot accurately determine the state Stated Managed Objects includes Equipment SNMP Managed devices and users All Stateless Folders Stateless folders are Managed Objects that act as containers for other Managed Objects Stateles...

Page 21: ...ace GUI and command line interface CLI clients with remote browser access to key functions Java based platform independent architecture Consistent common interfaces across 3Com applications and components Open solutions environment Hierarchical organization of discovered devices into several different views For more information see Right hand Pane Views on page 32 Comprehensive management of devic...

Page 22: ...tures an easy to use GUI that enables network operators to view system status and device availability at a glance Supports Multiple Platforms Based on Java architecture EMS enables allowed network operators to use the operating system of choice giving them power to leverage their existing equipment investment Highly Customizable EMS includes an XML interface and scripting APIs which provides a wid...

Page 23: ...re applications for you to use Server Runs as a Java application No GUI components Runs from a DOS Shell prompt Has a console command line interface GUI client Manages network devices and organizes them in an explorer tree Maps MIB objects to their associated device Provides event logs for all GUI activity CLI client Contains no GUI component Provides a remote command line interface to the EMS ser...

Page 24: ...ported by EMS Table 3 Supported 3Com Data Products Device Family Individual Device Switch 4007 Switch 4007 Switch 4007R Intellijack Switches Intellijack Switch NJ225 3Com Switch 7700 Switch 7700 4 Slot Switch 7700 7 Slot Switch 7700 8 Slot 3Com Switch 7750 Switch 7758 Switch 7757 Switch 7754 3Com Switch 8800 Switch 8814 14 slot Switch 8810 10 slot Switch 8807 7 slot SuperStack 3 Switch 3300 SuperS...

Page 25: ...ch 4200G 48 Port SuperStack 3 Switch 4400 SuperStack 3 4400 24 Port SuperStack 3 4400 48 Port SuperStack 3 4400 FX SuperStack 3 4400 SE SuperStack 3 4400 PWR SuperStack 3 Switch 4900 SuperStack 3 Switch 4900 SuperStack 3 Switch 4900 SX SuperStack 3 Switch 4924 SuperStack 3 Switch 4950 Switch 4500 Switch 4500 26 Port Switch 4500 50 Port Switch 4500 PWR 26 Port Switch 4500 PWR 50 Port Switch 4500G P...

Page 26: ...2 Port Switch 5500 EI PWR 28 Port Switch 5500 EI PWR 52 Port Switch 5500 EI 28 Port FX Switch 5500G EI 48 Port Switch 5500G EI SFP SuperStack 3 Switch 1100 SuperStack 3 Switch 1100 Managed Switch 9 Managed Switch 9 Managed Switch 9 FX Switch 2xxx Switch 2226 Plus Switch 2250 Plus Switch 2426 PWR Plus 3Com OfficeConnect Managed Gigabit PoE Switch Table 3 Supported 3Com Data Products continued Devic...

Page 27: ...ble 4 Supported 3Com Router Products Device Family Individual Device Router 3000 Router 3012 Router 3013 Router 3014 Router 3015 Router 3016 Router 3018 Router 3030 Router 3031 Router 3032 Router 3033 Router 3034 Router 3035 Router 3036 Router 3040 Router 3041 Router 5000 Router 5009 Router 5231 Router 5232 Router 5640 Router 5232 Router 5640 Router 5642 Router 5680 Router 5682 Router 6000 Router ...

Page 28: ...LAN Access Point 8750 Wireless LAN Access Point 8850 Wireless LAN Access Point 8760 Table 6 Supported 3Com Bridge Products Device Family Individual Device N A Wireless LAN Building to Building Bridge 11 a b g Wireless LAN Bridge Outdoor Building to Building Bridge Table 7 Supported 3Com Wireless Switch Products Device Family Individual Device N A Wireless Switch WX1200 Wireless Switch WX2200 Wirel...

Page 29: ...tory Server SIP Phone Downloader Call Processor 5 2 Accounting Server Authentication Server Directory Server SIP Phone Downloader Call Processor 6 0 Accounting Server VCX Data Server Call Processor SIP Phone Downloader IP Messaging Server 7 0 Accounting Server VCX Data Server Call Processor SIP Phone Downloader IP Messaging Server 7 1 Accounting Server VCX Data Server Call Processor SIP Phone Down...

Page 30: ...r the right hand pane of the EMS GUI For more information on element views see Right hand Pane Views on page 32 and Left hand Pane Views on page 31 See Figure 1 The Job Progress window is used to monitor the status of each task being performed on a device through EMS Figure 1 Left and Right Panes of the EMS GUI Main Window Actual screen captures in this guide may differ from those in the EMS GUI f...

Page 31: ...xplorer View default view The Explorer view lets you view all of the elements in an explorer tree a hierarchical organization containing multiple levels of tree nodes The Explorer view is the default view in the EMS GUI client and all of the procedures in this document begin from this view Many folders and devices have sub elements You can expand and collapse elements nodes in the tree that have s...

Page 32: ...l View on page 147 EMS provides system defined logical views which are created at the discovery time You can group devices through the use of equipment folders and then by device type Right hand Pane Views The right hand pane of the EMS GUI main window has two views to choose between Properties and Related For more information see Toggling between the Properties and Related View on page 173 Proper...

Page 33: ...g a Logical View on page 147 SNMP Agents This root folder contains a list of all SNMP agents discovered by EMS To view these agents and their associated relationships use the Related view For more information see Right hand Pane Views on page 32 Logs This root folder contains logical logs which are collections of related event records For more information see Log File and Network Traffic Monitorin...

Page 34: ...NMP Devices In this guide SNMP device refers to any SNMP agent that can be managed through EMS You must discover SNMP devices and configure them before using them in your network For more information see SNMP Device Configuration on page 101 EMS labels each SNMP device in the left hand pane of the EMS GUI main window with the IP address of the device If the discovered device is a 3Com product a 3C...

Page 35: ...pyright Information on page 168 Contents The EMS Online help system For more information see Online Help on page 36 Show Advisor For more information see Advisor Window on page 36 Copyright Copyright information For more information see Viewing Software Version and Copyright Information on page 168 Tool Tips Tool tips are available for most commands and functions To display a tool tip place the cu...

Page 36: ...or Window on startup Online Help The EMS Online help comprises the contents of the EMS User Guide in HTML format It describes how to install configure operate and maintain each EMS software component To open the Online help use one of the following methods Click the Help contents icon Click the Help menu and select Contents Printing Options The EMS GUI client allows you to print various types of i...

Page 37: ...gly Events come from a variety of sources Sources include the following internal processes User Manager processes all user login and logout activity SNMP Trap Receiver processes and translates all SNMP traps that the EMS server receives Syslog daemon processes all of the syslog messages the EMS server receives EMS server process monitors each time a user runs an operation or changes an attribute M...

Page 38: ...NMP device can send syslog messages D to EMS EMS translates the message into an EMS event and passes the event to the Event Manager C Any EMS server process E can generate EMS events and SNMP traps EMS passes the event to the Event Manager C while sending the SNMP trap to the Forwarding Filter B SNMP device syslog device EMS Server Process Translate to Event Forwarding filter Daily Audit Log DB Ev...

Page 39: ...termine if the specific event should be written to the daily audit log G and stored in the Event Table H for the database The Event Manager C independently launches the Event Action Script I if one has been supplied The Forwarding Filter B is not supported for this release ...

Page 40: ...40 CHAPTER 1 PRODUCT OVERVIEW ...

Page 41: ...m Requirements Platform Related Installation Information Ports Used by EMS TFTP Server Installation and Initial Configuration Server Failover Requirements EMS Software Licenses 3Com provides four types of EMS licenses to meet your network s needs The following EMS Software CDs are available from 3Com Table 10 EMS License Types 3C Number 3Com EMS Version Maximum No Devices Managed 3CR15640 2 4 up t...

Page 42: ...S server installed on a UNIX server Hardware Requirements This section lists the hardware requirements for both an IBM compatible and Sun Workstation environment IBM Compatible Hardware Requirements Table 11 lists hardware specifications for IBM compatible server and client environments If you are using external databases for your EMS server the minimum hardware requirements may change For more in...

Page 43: ...rements For detailed installation information see the software installation documentation and release notes for these external products Table 12 Sun Workstation Hardware Requirements for EMS Component Minimum Requirement Recommended CPU Ultra 10 with CD ROM Ultra 60 or better with CD ROM RAM 1024MB 1GB or more Free Disk Space 300MB 3Com recommends 500MB of space to store back up images agent image...

Page 44: ...eir recommended patch guidelines for the Solaris and JRE version you are using There are no EMS specific patches Intel x86 Windows Pentium III 450 MHz EMS supports the following Windows operating systems for the EMS server Windows 2000 Server Windows 2003 Server Windows 2000 Professional SP4 Windows XP Professional SP1a and SP2 3Com supports the following Windows operating systems for the EMS clie...

Page 45: ...t 8 0 EMS requires the following Linux kernel and components Kernel 2 2 X11R6 3 3x from XFree86 glibc 2 1 Kernel updates http www kernel org X11 updates http www xfree86 org glibc sources http sources redhat com glibc Sun Java 2 Runtime Environment 1 4 2 or Platform Standard Edition 5 0 Distribution updates are distribution specific Contact your Linux distribution vendor for distribution update in...

Page 46: ... This section provides additional information and issues related to UNIX environments you will need to review before installing and using the EMS server and clients in your network File Permissions and EMS If you install EMS as a particular user depending on the group permissions for that user no other user may use the same installation DB2 Database DB2 for i5 OS V5R3 or V5R4 Table 15 Supported Da...

Page 47: ...rite Permissions The user read write permissions must be set for EMS clients installed on a workstation using a UNIX platform To set the user read write permissions in a UNIX environment 1 Change to root 2 Change to the directory where the EMS client is installed 3 Enter the following command chmod R 777 file_or_directory Or you may substitute an explicit list of permissions Using Static IP Addres...

Page 48: ... Resolving Remote Client Login Problems If you experience problems with remote client login when the EMS server is running on Linux systems make sure the first line in your etc hosts file on the server contains the server name and IP address of the server You may experience problems if the first entry in the etc hosts file is localhost IBM iSeries This section provides additional information and i...

Page 49: ...d folders The Windows 3Com TFTP server is included on the EMS CD TFTP for Windows This section provides instructions on how to install and initially configure it No matter which TFTP Server software is used with EMS you will need to configure the TFTP Server and EMS settings similarly as described in sections Initially Configuring the 3Com TFTP Server for Windows Software on page 50 and Initially ...

Page 50: ...6 Click Finish when the installation completes Initially Configuring the 3Com TFTP Server for Windows Software To initially configure the TFTP Server software 1 Start the 3Com TFTP Server software The default location is Start All Programs 3Com TFTP Server 3Com TFTP Server The 3Com TFTP Server application appears 2 From the menu bar click the Options button The Options window appears See Figure 7 ...

Page 51: ...perties file for the EMS Server The default location is C Program Files 3Com EMS 2 Open the file using a text editor 3 Locate the tftp SERVER heading 4 From the tftpServer tftpbootDirectory entry type the same path that was entered in the Upload download directory field for the 3Com TFTP Server In Windows you must use double backslashes as shown below tftpServer tftpbootDirectory c Program Files 3...

Page 52: ...l destination path of the file You therefore need to download and install the IBM patch PTF SI27230 This PTF allows EMS to support all 3Com data products For more information about configuring a TFTP server for IBM i5 OS please refer to the URL below http publib boulder ibm com infocenter iseries v5r4 index jsp topic rza hg icmain htm Server Failover Requirements This section details the minimum p...

Page 53: ...version 2 3 and therefore those required by Server Failover Table 18 Supported Platforms Required by HA Mode Platform Version and Requirements Unix Supported on Solaris 8 Solaris 9 and Solaris 10 Redhat 8 0 is also supported Windows The EMS server runs on Windows 2000 Server Windows Server 2003 Windows 2000 Professional SP4 Windows XP Professional SP1a The EMS client runs on Windows 2000 Server Wi...

Page 54: ...54 CHAPTER 2 PRE INSTALLATION ...

Page 55: ...ial setup outlined in this chapter there are some differences between the set up for single server operation and HA Mode operation with two servers Where there are differences these are highlighted Before you begin please be sure to download and install the proper Java Runtime Environment JRE and patches For more information about installing EMS on a specific hardware and software platform see Pre...

Page 56: ...e CD See EMS Software Licenses on page 41 for the available EMS software The CD contains the following files 3ts01_04 exe is the 3Com TFTP Server for Windows installation file EMS_gs pdf is a PDF version of the EMS Getting Started Guide It provides a product overview installation and initial setup information EMS_ug pdf is a PDF version of the EMS User Guide It provides configuration operations ma...

Page 57: ...erprise Management Suite opens Figure 9 Installation Wizard for Enterprise Management Suite 5 Click Next 6 Read the License Agreement and Warranty information and select I agree 7 Click Next 8 In the Directory Name field type the desired directory and folder or use the Browse button to search for a specific directory If installing on a Windows platform and if no previous version has been installed...

Page 58: ...ion option of choice and click Next 11 Read the installation summary and click Next EMS installs all associated files into the desired directory and folder 12 Read the installation notes and click Finish Table 19 Enterprise Management Suite Installation Options Option Description All Use this option to install all EMS software components on the workstation EMS server and EMS GUI and CLI clients Se...

Page 59: ...ersion of the installation wizard Enter the command as follows java jar EMSSetup jar console The following screen displays 3Com Enterprise Management Suite v2 40 This will install 3Com Enterprise Management Suite v2 40 on your computer To continue choose Next 3Com Enterprise Management Suite v2 40 Copyright c 2002 2006 www 3com com Press 1 for Next 3 to Cancel or 4 to Redisplay 1 Navigate the text...

Page 60: ...iles are created goldenTemplate Where the Golden Configuration templates are stored log This directory contains all of the server and audit logs generated by the EMS server For more information about log files see Viewing Server Console Logs and Viewing the Daily Audit Log in the Enterprise Management Server Administration Guide mib This directory contains all of the MIB files for the core and pac...

Page 61: ...es an internal embedded database within EMS EMS uses this database by default Embedded databases are used primarily for smaller deployments External Database 3Com allows you to use an external database for larger deployments You can either install the external database on the EMS server itself or on a dedicated external database server Before installing the external database review the minimum har...

Page 62: ...The Java Database Connectivity JDBC database connection and interface drivers come bundled with EMS When the EMS server runs a database instance is run along with it therefore there is no need to start configure or maintain the database separately from EMS By default EMS is pre configured to use the embedded database upon initial system startup This features allows you to run EMS out of the box wi...

Page 63: ... enabling the compactOnStartup feature within the server properties file This compresses free space on the DB and reduces its size on the disk To configure DB Compression 1 Using a standard text editor open the server properties file 2 In the MySql DB section uncomment the compactOnStartup line to enable DB compaction See Figure 12 Figure 12 Uncommenting the compactOnStartup Line compactOnSTartup ...

Page 64: ...e Management Server Administration Guide Configuring Embedded Databases By default EMS is pre configured to use the embedded InstantDB database All options are already bundled with the EMS software package and no additional configuration is necessary If you would like to view default database connection options for the InstantDB database review the Instant DB section of the server properties file ...

Page 65: ...ive of the database setup Features and Benefits Using an external database provides the following features and benefits External databases are customized for a specific platform and optimized to run more efficiently on the platform of choice External databases are more scalable than the embedded database It is possible to procure support contracts for the Configuring and Maintenance of external da...

Page 66: ...le 11 CPU If the CPU speed requirements from the external database vendor conflict with the original EMS requirements use the faster of the two speeds RAM Use the summation of memory requirements required for both EMS and the external database which is provided by the database vendor Deploying on a Dedicated Server If you deploy an external database on a dedicated database server the minimum hardw...

Page 67: ...base download the JDBC drivers and place them in the following folder on your EMS server jre_home jre lib ext where jre_home is the installation location of the JRE Java Runtime Environment being used to run EMS For more information on the correct JRE version to use see Platform and Operating System Requirements on page 43 3 Using the standard Oracle administrative tools create a new blank databas...

Page 68: ... of the server properties file and gives descriptions and default values When you connect to an Oracle cluster you need to specify a different connection string telling the JDBC connector that it has a choice of two connections in this example serverName1 or serverName2 Note that you can specify different port numbers too DBURL jdbc oracle thin DESCRIPTION ADDRESS_LIST ADDRESS PROTOCOL TCP HOST se...

Page 69: ...standard Oracle administrative tools create a new blank database For example if you are using the MySQL console tool enter CREATE DATABASE database_name where database_name is the name of the MySQL database DBEmbeddedQuote The escape sequence for an embedded single quote character NOTE results in a single backslash character DBFile The specific location of the EMS database file directory that cont...

Page 70: ...ced by the EMS server IP address and netmask For more information on database users see Multiple User Access for External Databases on page 74 For example 192 168 1 1 255 255 255 0 is an acceptable entry 6 In the MySQL DB section of the server properties file uncomment each section and configure according to your customized needs MySQL DB DBDriver com mysql jdbc Driver DBURL jdbc mysql hostname da...

Page 71: ...d on the QSECOFR user Do not configure the external database tables and schemas When EMS detects a blank database EMS will automatically create all of the necessary tables and configure them according to your customized needs DBEmbeddedQuote The escape sequence for an embedded single quote character NOTE results in a single backslash character DBFile The specific location of the EMS database file ...

Page 72: ...onfigure according to your customized needs DBDriver com ibm db2 jdbc app DB2Driver DBURL jdbc db2 local DBLong BIGINT DBBLOB BLOB DBEmbeddedQuote DBEmbeddedBackslash DBFile DBUserName db_username DBPassword db_password Table 24 lists the fields in the IBM DB2 DB section of the server properties file and gives descriptions and default values Table 24 IBM DB2 DB Section of the server properties Fil...

Page 73: ... If you choose to do this follow these guidelines A single EMS server can only connect to a single database instance Active EMS servers cannot share database instances Each active EMS server must have exclusive read write access to a particular database If you choose to deploy multiple EMS databases on the same database server for example EMSDB1 and EMSDB2 only one instance of EMS should ever be c...

Page 74: ...he related documentation for your specific vendor Configuring for Multi homedServer Support If you are planning to run the EMS server on a workstation that has more than one NIC and is configured to be on more than one network multi homed use this procedure to guarantee that the server binds to an IP address on the desired management network To configure the EMS server for multi homed support 1 Us...

Page 75: ...mized needs For example ManagementInterface 10 10 3 1 3 To enable the new configuration uncomment the ManagementInterface field 4 Save and close the server properties file EMS Licensing System EMS V2 40 defaults to a node limit of 20 devices EMS will run with this 20 node limit for a time limited period of 60 days Evaluation Mode The EMS server will function in evaluation mode for 60 days from the...

Page 76: ...e key from the CD to obtain the activation key The serial number is shown in the message above or it can be found by entering the info command on the live EMS server The activate command can be used to enter the activation key so that the EMS server starts working in a fully licensed mode Activate Server Command The license activation command allows you to enter the activation key while the EMS se...

Page 77: ...e activation key entered is invalid Please contact 3Com software vendor and obtain the correct activation key Following the failed activation key verification the EMS server will revert back to evaluation mode If the 60 day trial period has expired then the Evaluation expired message will be shown as above in Evaluation Expired Message on page 76 EMS Client Evaluation Mode Visual Indicator The EMS...

Page 78: ...tion period has expired the EMS client will be logged out and the following screen as shown in Figure 15 is displayed Figure 15 Evaluation Period Expired Visual Indicator Once you click OK the EMS Client GUI is dismissed You are not able to log back into the server until the activation key is installed ...

Page 79: ...S Server Shortcut Icon You can also start the EMS server by navigating from a command line to the location of the FDServer jar file and entering runServer A Java based EMS Server window opens showing the progress of the EMS server startup sequence If this is a new installation the EMS Server will start in Evaluation Mode and will support up to 20 devices without an activation key If the installati...

Page 80: ...om a previous version of EMS it does not need a new activation key 3 After the server has completed its startup sequence you can minimize the EMS Server window CAUTION Do not close the EMS Server GUI using the system close button The server must be properly shut down using the quit command to maintain database integrity Table 25 Server Login Optional Properties Property Description DB name Start w...

Page 81: ...es in this section assume that the EMS server is running You can start the EMS GUI client using shortcut options or commands from a command prompt described in this section Using Windows Shortcut Options To run the EMS GUI client using Windows shortcut options 1 Double click the EMS GUI icon Figure 17 EMS GUI Client Shortcut Icon You can also double click the GUIClient jar icon within Windows Expl...

Page 82: ... User ID Administrator Initial installation provides the Administrator user with no password The Server field should be the IP address of the EMS server or type localhost if you are running the EMS GUI client on the same workstation as the EMS server When you run the EMS GUI client the next time EMS will remember the previous login parameters At that time simply type your Password and click OK 4 C...

Page 83: ...and prompt 1 From a separate command prompt navigate to the folder where the runGUIClient executable file is located 2 From the folder containing the runGUIClient executable file enter the following command and optional parameters as shown in Table 26 runGUIClient parameters Table 26 GUI Login Optional Parameters Parameter Description Default H hostname where hostname is the name of an individual ...

Page 84: ... Device Configuration on page 101 for information on creating folders and discovering devices For additional information on users see User Configuration on page 133 Initially Starting the EMS CLI Client The EMS CLI client provides a Command Line Interface CLI as an alternative to the EMS GUI Use the same Server Name User ID and Password as the EMS GUI client for the EMS CLI client 1 Start the EMS ...

Page 85: ...tion Guide and Command Line Interface Reference on page 207 Table 27 CLI Client Startup Optional Parameters Parameter Usage Default scriptname py where scriptname py is the name of the python script to execute A python script is not executed H ipaddress where ipaddress is the IP address of the device to manage rather than entire Explorer tree Entire Explorer tree is shown in the EMS CLI list of ma...

Page 86: ...86 CHAPTER 3 INSTALLATION AND INITIAL SETUP For more information on using the CLI client to create customized scripts contact your 3Com customer service representative ...

Page 87: ...work management needs where a quick failover from an Active Server to a Dormant Server is required In the event of the Active Server failing the Dormant Server will take over the EMS operations and allow clients to connect and carry out EMS operations as usual How Server Failover Works The Active server operates as a traditional EMS server The Dormant server opens a connection to the Active server...

Page 88: ...is section summarizes the key concepts and terminology used in Server Failover Remote Server At startup neither EMS server knows whether it will run in Active or Dormant mode The run mode is determined by the server s ability to connect to its remote server If a connection can be made to the remote server the server puts itself into Dormant mode Active Dormant Clustered Mirrored Database EMS Files...

Page 89: ... server then becomes the Active server EMS_FILEHOME EMS_FILEHOME lets you specify a base directory for the EMS server to locate its files This is how two servers share a common set of files and directories and thus remove the need for file synchronization The local_server properties file installed as part of the EMS server installation contains this explanatory header EMS Files Location Specify a ...

Page 90: ...ver_Retries 4 Timeout Count for Server Failover This specifies the number of seconds between any two retry attempts when contacting the Remote_Server Remote_Server_Timeout 5 All Server Failover variables are commented out by default The local_server properties file overrides the settings in server properties and is only ever read from the directory in which the EMS server is running To locate the ...

Page 91: ...s and local_server properties files must be edited as detailed in Editing the Properties Files before the servers are run Editing the Properties Files After both servers have been installed and setup you need to configure the servers for Server Failover by editing the properties files local_server properties and server properties before you run the servers The local_server properties file can be f...

Page 92: ...rying to contact its remote server specified in the Remote_Server property in local_server properties If the Preferred_Server property is not set its value is assumed to be no 3 Setting the Retry and Timeout for EMS Startup When deciding the settings for retry and timeout it is important to be aware that the higher the setting you define for retry and timeout the more resilient the system is to tr...

Page 93: ...most common examples Note that many of the settings for the servers should be shared otherwise the Dormant server once it becomes Active will not be the equivalent of the Active server it has replaced All the typical server specific settings are provided in local_server properties but are commented out so that the shared server properties setting is used wherever possible SNMP Trap Forwarding In S...

Page 94: ...E is set correctly otherwise the Server Failover system will not work properly when trying to run operations that rely on the EMS filesystem such as telnet scripts or restore operations The EMS_FILEHOME setting is mandatory if the user specifies a remote_server What if the shared file location is unavailable On UNIX if the shared file location is unavailable EMS will create its files under the emp...

Page 95: ...ndicate Server Failover is running correctly When you login to EMS using the GUI Client you can verify the Server Failover setup by looking at the Server Failover tab This tab is populated with the EMS Server states and other Server Failover information Figure 21 shows the Server Failover tab and its contents Figure 21 Server Failover Tab The Server Failover table in the database is used by both E...

Page 96: ...dules all active data collections This is a similar process to a newly started server resuming all active data collections on start up Logged in Users At failover time the new Active server clears the login status of all users the server starts from a state of no logged in clients Shutting down the Active Server When the administrator tries to quit a server with clients and or a dormant server sti...

Page 97: ...k Yes to re start the client and present the login screen Dormant Server Behaviors Connecting to the Dormant server when the Active server is still running When you try to connect to an EMS Server in Dormant mode the client displays this message box Click Yes to retry the connection click No to exit the client Preventing Clients from Attaching to the Dormant Server The Dormant server does not allo...

Page 98: ... the Dormant server receives a client connection request while retrying its connection the Dormant server assumes that the Active server has definitely failed and failover occurs immediately See Server Failover Mechanism for details on the transition from Dormant to Active server Server Failover Mechanism Once the Dormant server realizes that the Active server is no longer available it logs this m...

Page 99: ...d the server displays this message and takes no further action Server cannot enter dormant mode unless there are no logged in users and no running jobs If there are no running jobs and no logged in users the server halts its client connection service and displays this prompt Server ready to enter Dormant Mode Ensure the remote server is in Active Mode then press any key to complete the Active to D...

Page 100: ...100 CHAPTER 4 SERVER FAILOVER CONFIGURATION ...

Page 101: ...to rediscover SNMP devices Creating Device Folders All managed devices are added initially to one or more folders you create in the Equipment root folder and they are also added to the System Defined Logical Views as links to the original devices in the Equipment folders The Equipment folder is the root of all SNMP devices for the EMS GUI Once you have added a folder under the Equipment main folde...

Page 102: ...vices on page 103 and Creating Equipment Bays and Racks on page 102 Creating Equipment Bays and Racks To organize SNMP devices you can create virtual equipment bays and racks Bays and racks are specialized containers you can create in individual sub folders under the Equipment root folder Bays contain racks but racks cannot contain bays To create an equipment bay or a rack 1 First create a device ...

Page 103: ...ange of IP addresses The discovery executes in the background and displays the progress of the discovery operation in the Job Progress pane of the main window The target device folder remains locked throughout the entire process At the end of discovery a dialog box summarizes how many devices were discovered in the requested range You can use the User Options dialog and the copy values dialogs whi...

Page 104: ...Ending IP Address is greater than or equal to the Starting IP Address IP Class Address Checking This parameter is used only during IP range discovery If you select this parameter recommended EMS will automatically skip over network and broadcast addresses based on the subnet mask NOTE 3Com recommends making sure this option is selected Subnet Mask The subnet mask for this SNMP device Timeout sec T...

Page 105: ...fields See Figure 24 Figure 24 Dialog Box for SNMPv3 with No Authentication Read Community The SNMP Read Community string for access to the devices This should match the Read Community string of the devices to be discovered Write Community The SNMP Write Community string This should match the Write Community string of the devices to be discovered Table 29 Discovery Parameters continued Parameter D...

Page 106: ...ox changes to reveal three new fields See Figure 25 Figure 25 Dialog Box for SNMPv3 with Authentication and No Encryption MD5 is the only authentication protocol supported for this release 7 In the Discovery dialog box enter the appropriate parameters Table 30 Additional Discovery Parameters for SNMPv3 with No Authentication Parameters Description Context Name For SNMPv3 leave this field blank Con...

Page 107: ... device for example cards with multiple spans and DS0s the sub element discovery may still be in progress even if the Device Discovery dialog box indicates that the discovery is complete Make sure an SNMP device and all its sub elements are completely discovered before attempting to configure the device The SNMP device discovery summary dialog box appears 9 When complete click Close Table 31 Addit...

Page 108: ... on page 103 To discover a single SNMP device 1 In the explorer tree right click an equipment sub folder bay or rack under the Equipment root folder If you want to create a new folder rack or bay see Creating Device Folders on page 101 and Creating Equipment Bays and Racks on page 102 2 From the pop up menu select Discovery and then select Single SNMP Device See Figure 26 Figure 26 New Device Dial...

Page 109: ...e 32 Discovery Parameters Parameter Description Hostname IP Address The IP address of the SNMP device to be discovered Timeout sec The SNMP time out in seconds The default is 1 Retrys The number of times EMS will retry connecting to an SNMP device The default is 0 SNMP Version The SNMP version number Read Community The SNMP Read Community string for access to the devices This should match the Read...

Page 110: ...anges to reveal three new fields See Figure 28 Figure 28 Dialog Box for SNMPv3 with Authentication and No Encryption MD5 is the only authentication protocol supported for this release 7 In the New Device dialog box enter the appropriate parameters See Table 34 Table 33 Additional Discovery Parameters for SNMPv3 with No Authentication Parameter Description Context Name For SNMPv3 leave this field b...

Page 111: ...resses instead of the hostnames This feature can only be used at discovery time To apply this to devices that have already been discovered change the server properties files and then use the Rediscover right click menu To discover devices and list them by IP address 1 Using a standard text editor open the server properties file 2 Below the Use IP as Label section find the useIPAsLabel variable 3 C...

Page 112: ... box opens and asks if you are sure you want to delete the SNMP device or folder 3 Click OK to delete the selected element The selected element and all of its sub elements if any are deleted For example if you delete an SNMP device folder all SNMP devices in that folder are deleted Rediscovering an SNMP Device When changing or replacing an SNMP device or when upgrading software it is necessary to ...

Page 113: ...S internal class names and do not have any relationship to MIB classes This is a read only field FQN Specifies the fully qualified name of this object This is the complete path from the root of all objects This is a read only field Hostname Specifies the DNS host name This is a read only field IP Address Specifies the IP address used for all SNMP operations xxx xxx xxx xxx Location Specifies the p...

Page 114: ...down list appears 4 From the drop down list select v1 for SNMPv1 only or Select v2c for SNMPv2c only or Select v3 for SNMPv3 only 5 Click Save all Configuring Read and Write Community Strings To change read and write community strings for the SNMP manager 1 From the explorer tree select the SNMP device Read and write community strings only affect SNMPv1 and SNMPv2c devices 2 In the right pane of t...

Page 115: ...ice folders bays and racks prior to upgrading the EMS server If you do not have EMS Administration privileges you can not use this feature For more information please refer to the Auto deployment chapter in the EMS User Guide Importing SNMP Devices from HP OpenView You can synchronise the SNMP devices and their community strings from HP OpenView Network Node Manager using EMS HP OpenView Network N...

Page 116: ...mport process This provides a convenient means of viewing all the devices that have been imported from HP OpenView Remove Old Devices This option will remove all devices from EMS that have been deleted from HP OpenView since the last import The devices are also removed from the Imported HPOV Devices logical view Reserving and Unreserving Elements You can reserve an element in the explorer tree so ...

Page 117: ...ments To change the name of a selected element use the Rename command This is particularly helpful when renaming a particular SNMP device or user Not all elements can be renamed The menu option may not be available For example root folder cannot be renamed For more information see Root Folders on page 33 To rename an element in the explorer tree 1 In the explorer tree select the element you want t...

Page 118: ... Interface This section provides an overview of the various tabs and menus used for the Discovery tab The Discovery tab is configurable from the equipment folder and is contains sixteen attributes See Figure 31 as described in Table 36 If you configure these parameters at the equipment folder level they are applied to every device within this folder Figure 31 Discovery Tab Table 36 Discovery Tab A...

Page 119: ...s 2 Discovery Timeout Seconds The SNMP time out in seconds The default is 2 continued SNMP Version The SNMP version number This is a drop down menu with these options v1 v2c v3 SNMPv3 Authentication This is a drop down menu that is only available if the SNMP Version chosen is v3 These options are available is v3 is chosen none MD5 SHA not supported in this release SNMPv3 Context Name For SNMPv3 on...

Page 120: ... you can fill in and schedule regular discoveries using the Discover Now action for that folder In addition if you use one of the Discovery dialogs to enter information instead you can transfer values to and from the Discovery tab to ensure that the Discover Now action and Schedulable Operations can be applied to all equipment folders Transferring Values to from the Discovery Tab This section desc...

Page 121: ...values as the last time Cancel Closes the message box with no further action being taken The intended Discovery dialog is not launched Do not ask me again Marking this checkbox will record the user answer to this dialog either Yes or No the Cancel response is not recorded The response is recorded in the user properties file against the property TransferDiscoveryParameters The valid settings for th...

Page 122: ...aunches the User Options dialog Here you can change the discovery preference inside the Session Preferences tab as shown in Figure 32 Do not ask me again Marking this checkbox will record the user answer to this dialog either Yes or No the Cancel response is not recorded The response is recorded in the user properties file against the property SaveDiscoveryParameters The valid settings for this pr...

Page 123: ...Schedulable GUI Based Device Discovery 123 Figure 32 Session Preferences Discovery Tab Boxes ...

Page 124: ...g launched No Launches the relevant Discovery dialog with the dialog fields containing the same values as the last time the user clicked OK in that dialog Ask Prompts the user every time to make a selection to copy not copy values from the Discovery tab Table 40 Session Preferences Discovery Tab Save Values Button Action Yes All applicable attributes are saved from the dialog being launched to the...

Page 125: ...h node in the explorer tree To customize the GUI client environment 1 From the main menu of the EMS main window select Tools 2 From the drop down menu select User Options The Options dialog box opens 3 From the Options dialog box select the Session Preferences tab You can also access the Options dialog box by clicking the User Options button on the toolbar For more information see Toolbar on page ...

Page 126: ...to appear each time you launch the GUI Client The Advisor window appears on GUI client startup by default You can easily hide and reopen the Advisor window once the GUI client opens b In the Look and Feel section select your choice of GUI motif This setting changes the appearance of the GUI itself The default setting is Metal 4 From the Options dialog box select the State ICONs tab See Figure 34 ...

Page 127: ...ure 34 State ICONs tab a Select the State ICON to show in tree view drop down list to view the available state type icons See Figure 35 Figure 35 State ICON to Show in Tree View b Select a state type according to the options shown in Table 41 ...

Page 128: ...roperty tabs are visible from the GUI client c For each state type you want to change click the state color See Figure 36 Figure 36 Changing a State Color The Choose a new color dialog box opens See Figure 37 Table 41 Monitor State Types State Type Description operationalState enabled disabled degraded usageState idle active busy administrativeState locked unlocked shutting down click the state co...

Page 129: ...specific color you want e Select a new color and click OK to save your changes Configuring the Printer Page Setup Before printing configure the printer page setup For more information about different printing options using EMS see Printing Options on page 36 For more information about printing the explorer tree see Printing the EMS GUI Explorer Tree on page 195 ...

Page 130: ...ct the Size and Source from the drop down lists The default for Size is Letter and the default for Source is Automatically Select 3 In the Orientation section select either Portrait or Landscape The default for Orientation is Portrait 4 In the Margins inches section type the desired margins for the printer page in the Left Right Top and Bottom fields The default for all margins is one inch 5 When ...

Page 131: ...re To configure the EMS GUI client to display non supported MIB objects 1 Using a standard text editor open the client properties file To locate the client properties file see Navigating the Enterprise Management Suite Directories on page 59 2 Uncomment the showNoSuchName yes line to enable the GUI client to view non supported MIB objects See Figure 39 Figure 39 Uncommenting the showNoSuchName Lin...

Page 132: ...132 CHAPTER 6 GUI CLIENT CONFIGURATION ...

Page 133: ... The Administrator has full operator privileges and default login parameters For more information see Initially Starting the EMS GUI Client on page 81 Creating User Folders Before creating new users you can create folders to organize the users according to your needs To add a user folder 1 In the explorer tree right click the Users folder A pop up menu appears 2 From the pop up menu select New and...

Page 134: ...is user You may use any ASCII character and there are no practical limits on how many characters you may use The User ID is a case sensitive parameter Password Type the password for this user You may use any ASCII character and there are no practical limits on how many characters you may use The password is case sensitive This is an optional parameter Re enter Password Type the Password again for ...

Page 135: ... explorer tree hierarchy of their assigned root view A user sees the same view of managed devices with each login and these are the only devices the user is allowed to manage This includes viewing the status of the devices in the root view and viewing and modifying MIB values The Administrator can change a root view at any time The Administrator also can assign a root view when initially creating ...

Page 136: ... rights to use all of the EMS capabilities A browser has much more restricted rights and has essentially read only capability From within the EMS GUI a user with browser rights cannot change any property values invoke any pop up menus or run the EMS CLI client By default all existing users in the database are operators and all newly created users are granted operator rights To assign access right ...

Page 137: ... root folder 2 Right click the user select Root view and then select Remove The root view is no longer assigned to this user Exporting and Importing Users You can export user lists to a plain text file and then import them back into another EMS server instance This is not a database backup just a plain text file that can be read by the same EMS server or a different EMS server For example this fea...

Page 138: ... and then select Import The Users Import dialog box appears EMS imports the list of users into the EMS GUI client and creates a new user in the explorer tree for each user found in the user tsv file Also all user access rights and root views are mirrored from the user tsv file 4 When finished click Close User Passwords User passwords can be changed must know current password or reset in case the p...

Page 139: ...explorer tree select a user under the Users root folder 2 Right click the user and select Change Password from the pop up menu The Change password for User dialog box appears See Figure 43 Figure 43 Change password for User Dialog Box 3 From the Existing password field type in the current password 4 In the New password and Re enter password fields type the password you want to assign to this user ...

Page 140: ...ver after the expiration date and time the user receives an error message and is not allowed to access the EMS server Forcing a Logout An Administrator can force a user to logout You can force a logout from either the EMS GUI or from the EMS server command line This is particularly helpful to use before running maintenance procedures on your network Before forcing a logout it might be helpful to b...

Page 141: ...er 1 In the explorer tree select a user you want to send a message to 2 Right click the user and select Send Message To send a user a message the user must be logged into the EMS server If the user is not logged into the EMS server the Send Message options is unavailable grayed out Also you cannot send a message to yourself The EMS Chat window appears 3 In the Input Message field type the message ...

Page 142: ...RADIUS support to authenticate user connections through either Password Authentication Protocol PAP or Challenge Handshake Authentication Protocol CHAP To prevent all users from being locked out of the EMS server in the event of a complete RADIUS service failure the Administrator cannot be authenticated using RADIUS EMS also prevents other users from accessing the Administrator account and deletin...

Page 143: ...ables attributes and database attributes and gives them the ability to run operations such as performing a back up on a device Only the administrator has the ability to give users permission to configure the attributes contained within the Administration Configuration Fault Performance and Security folders of devices If a user views the Permissions folder all of the fields are uneditable Table 43 ...

Page 144: ...rights to the MIB tables attributes database attributes and gives them the ability to run operations such as performing a back up on a device Setting a device folder s permissions to No prevents a user from being able to perform any operations or have access to any of a device s attributes data attributes or MIB tables If a user does not have permission to configure device folders the attribute fi...

Page 145: ...that access level and all lower levels For example a user with access level 3 can also see telnet scripts with levels 1 and 2 Setting Telnet Scripting Access Levels The Permissions tab for an EMS user contains the Telnet Scripting Access Level attribute To set telnet scripting access levels 1 Log into the EMS client as administrator 2 In the explorer tree select a user under the Users root folder ...

Page 146: ...g Write Access attribute as shown in Figure 47 to control whether that user can edit telnet scripts or not Figure 47 Telnet Scripting Write Access Attribute When this attribute is set to No the user cannot launch the Telnet Scripts Manage Scripts right click menu which prevents access to the dialogs for adding editing and deleting Telnet Scripts ...

Page 147: ...eographical region and so forth Also you can create a logical view and assign it as the root view for a specific user This is a key security feature Logical views allow a user to see and manage only those objects such as devices or templates in their root view For more information see Assigning a Root View to a User on page 135 Creating a Logical View To create a logical view 1 In the explorer tre...

Page 148: ...k you want to use in your new logical view folder If you need to create an equipment folder bay or rack or discover SNMP devices see SNMP Device Configuration on page 101 7 Click OK Deleting a Logical View To delete a logical view from the explorer tree 1 In the explorer tree double click the Logical Views root folder 2 Right click the logical view you want to delete 3 From the pop up menu select ...

Page 149: ...sted in Supported Devices on page 24 About 3Com Integration Kit The 3Com Integration Kit customizes a Tivoli NetView or HP OpenView Network Node Manager installation to provide Iconic representation NNM only Device type recognition Trap translation for event log display MIB integration to allow SNMP management through the platform s tools In addition the 3Com Integration Kit CD contains applicatio...

Page 150: ...r from a Windows command line you can run the install by typing java jar setup jar The 3Com Integration Kit Welcome wizard appears See Figure 49 The examples shown in this section are for HP OpenView Network Node Manager installation The Tivoli NetView installation is very similar Figure 49 3Com Integration Kit Welcome Wizard 2 Once initialization completes click Next The license agreement section...

Page 151: ...tion begins A command window opens that shows you the output from the perl script used to copy the files from the integration kit location into your Network Node Manager or NetView installation See Figure 50 Figure 50 DOS Shell of Network Management Platform Integration The completion of the installation and integration process is summarized in the Summary section of the wizard This section summar...

Page 152: ...s follows Windows Use the ems_windows arf file and copy it to C Program Files HP OpenView NNM registration C Solaris Use the ems_solaris arf file and copy it to etc opt OV registration C These are the default installation locations for your network management platform your own installation directories may differ and they may also differ depending on the version of OpenView installed Make sure the ...

Page 153: ...tform 153 Launching EMS from a Network Management Platform To launch EMS from a network management platform 1 From the Tools menu click 3Com EMS Client See Figure 51 which shows an example using HP OpenView Figure 51 HP OpenView EMS Launch Point ...

Page 154: ...are Icons Traps MIBs OIDs see Configuration Files for SysObjectID Recognition oid_to_sym oid_to_type Symbol types see Symbol Integration File 3Com srf Icons In the Network Node Manager kit icons are provided for each device type See Figure 52 Figure 52 Network Node Manger Icon The NetView kit installs generic icons based on the function of the device Traps Trap translation text is provided for dis...

Page 155: ...ps for backup restore and agent update actions EMS SNMP library does not share the trap port Therefore EMS receives all traps and forwards them on to OpenView or NetView as appropriate OpenView can handle around 2 000 traps per second while EMS can only handle around 200 MIBs MIB files are loaded for use with the Network Node Manager or NetView built in MIB browser ...

Page 156: ...tion and Application Registration Files Application Registration files describe the database field rules that enable menu display and the action taken when the user clicks on the menu The 3Com Integration Kit CD contains three application registration files to provide the following menus for a selection of 3Com network management applications 3Com_dv arf 3Com_web arf 3Com_support arf To install th...

Page 157: ...se the OpenView or NetView Find facility to search for objects with these properties The 3Com fields are is3ComConnector identifies the device as a 3Com device is3ComDvManaged specifies that the device supports the 3Com Device View product is3ComNOTHTTPSupported identifies devices that have a Web interface but may not be supported by both Windows and UNIX browsers is3ComHTTPSupported8081 identifie...

Page 158: ...The following list the device types B bridge MB bridge with multiple IP The Switch 4900 with agent version 2 0 set up to function as a router requires the type MBR multi bridge router Version 1 0 of the Integration Kit shows type MB You can either change the entry manually or install version 1 1 of the Integration Kit G gateway H hub R router A typical entry is 1 3 6 1 4 1 43 10 27 4 1 2 4 Connect...

Page 159: ... is the group the symbol belongs to as shown in the Add Device menu 3Com SuperStack 3 Switch 3300 is the agent type Filebase is the bitmap name is3ComConnector identifies a 3Com device is3ComDvManaged identifies the device support for Device View Icon Files Bitmap bmp files are provided in four sizes 20 26 32 38 for the native Network Node Manager and are located here UNIX etc opt OV share bitmaps...

Page 160: ...ENT 3COM_90 1 3 6 1 4 1 43 0 90 Status Alarms Warning FORMAT IP Address 3 changed for 1 with serial number 2 SDESC This trap is sent whenever the IP address of the device changes EDESC MIB Files MIBs must be loaded in the order determined by the imports in the MIB files and are located here UNIX etc opt OV share conf C snmp_mibs Windows C Program Files HP Openview NNM snmp_mibs For example MIB 3fc...

Page 161: ...perties file needs to be configured 1 Stop the EMS Server 2 Locate the server properties file in the EMS Home directory 3 Open it in a text editor 4 Uncomment the SNMP forward line See Figure 54 Figure 54 Uncommenting the SNMP forward Line 5 Edit the line to represent the location of where your network management platform is installed where SNMP version is either v1 or v2 IP address is the IP addr...

Page 162: ...s The default is 1 12 Save the file 13 Restart the EMS Server Trap Forwarding Based on IP addr Range Setting The Trap Forwarding dialog found under the Tools menu lets you decide whether to forward traps based on trap type and source IP address 1 Select Tools Trap Forwarding to display the Trap Forwarding dialog as shown in Figure 56 The dialog has two tabs Event Type and IP Address Ranges Event T...

Page 163: ...those displayed 3 Click Save to save the changes or click Cancel to close the dialog without saving If you click Save the following message displays 4 Click OK IP Address Ranges Tab The IP Address Ranges Tab allows you to forward traps from all IP addresses or from a range of IP addresses The IP Address Ranges tab is shown in Figure 57 ...

Page 164: ...g without saving If you click Save the following message displays 3 Click OK or 1 Select the Only forward traps from these IP address ranges button if this is your preferred option 2 Click Add to add a new line to the range table 3 Enter the first IP address in the range you wish to specify in the Start Range column and the last IP address in the End Range column of the Trap Forward Range Table 4 ...

Page 165: ...address ranges When selected EMS will only forward a trap if that trap matches the event type filter and the trap s source address is within one of the IP address ranges specified Trap Forward Range table Start Range and End Range An editable table where rows for start range and End range can be added Add Adds a new row to the range table Delete Displays an Are you sure y n message box Clicking Ye...

Page 166: ...166 CHAPTER 9 NETWORK MANAGEMENT PLATFORM INTEGRATION CONFIGURATION ...

Page 167: ...List View Toggling between the Properties and Related View Expanding and Collapsing Elements Executing Commands for Multiple Elements Organizing Elements Monitoring the Status of GUI Elements Using the MIB Browser Viewing Numeric Values in Alternative Formats Monitoring Numeric Properties Using EMS to Edit Network Device Properties Copying and Pasting Values between Elements Locating Information U...

Page 168: ...oading Verifying the EMS Serial Number When EMS is run for the first time a serial number is generated to uniquely identify the installation To view the EMS serial number 1 From the EMS Server console window enter info The EMS serial number is displayed Viewing Software Version and Copyright Information You can view EMS core and package version numbers using the EMS GUI Graphical User Interface Cl...

Page 169: ...ect Help and then select About See Figure 58 Figure 58 Viewing the EMS Software Version The About window opens From the EMS Version heading the EMS version is listed and from the Installed Packages heading the package version is listed 2 When finished click Close 3 From the menu bar select Help and then select Copyright See Figure 59 ...

Page 170: ...efault view for the left hand pane of the EMS GUI main window which lists the system in an explorer tree hierarchy The List view is an optional view that allow you to manage properties and invoke operations in much the same manner as the Explorer view This includes managing properties and invoking operations using the EMS pop up menus Using the List View The List view allows you to sort elements b...

Page 171: ...ew and List View 171 To use the List view instead of the Explorer view 1 In the left hand pane of the EMS GUI main window select the List tab See Figure 60 Figure 60 List Tab 2 At the bottom of the List tab click Filter See Figure 61 ...

Page 172: ...ement 3 From the All Classes explorer tree select the element you want to use as your filter 4 To narrow your search select a Name and a Value from the Optional Attribute Filter section 5 Click OK The filter engine searches for elements based on your query The filter results appear in the left hand pane 6 In the left hand pane select the element you want to view In the right hand pane the properti...

Page 173: ...two views to choose between Properties and Related The Properties view is the default view for the right hand pane of the EMS GUI main window This view contains configuration tabs and MIB tables used for configuring all elements in the left hand pane of the EMS GUI main window The Related view is the optional view that allows you to see the different relationships between related elements in the e...

Page 174: ... the Related view to verify the relationship of related objects in the explorer tree In the example shown in Figure 63 the Related view shows the Initial Root View of user kirsten xp In the explorer tree the Initial Root View is the kirsten xp Equipment folder Use the Explorer view to locate the Equipment folder For more information see Toggling between the Explorer View and List View on page 170 ...

Page 175: ...on 1 In the explorer tree select the element you want to expand or collapse 2 From the main menu select Tree and then select either Expand or Collapse Using the Toolbar To expand and collapse elements using the toolbar 1 In the explorer tree select the element you want to expand or collapse 2 From the toolbar click either the Expand button or the Collapse button Using Standard Double clicking To e...

Page 176: ...and pop up commands can be executed while selecting multiple elements in the explorer tree This option may not be available for some options and commands Organizing Elements The EMS GUI lets you move device folders SNMP devices bays and racks in the explorer tree and organize them according to your customized needs Not all elements in the explorer tree can be moved The menu option may not be avail...

Page 177: ...n the explorer tree select an element 2 On the right hand pane of the EMS GUI main window select the State tab 3 View the Administrative State Operational State and Usage State fields Table 45 State Types for Elements State Type Description Administrative locked unlocked shutting down The administrative state is set by the network administrator who determines the states of locked unlocked or shutt...

Page 178: ...icon displayed in the explorer tree Table 46 lists the three status types and the default color for each type of icon Element status propagates to the top level of the element hierarchy in the explorer tree For example a yellow state icon means that an element in the present folder or the sub folder below it has at least one element or device in the red state The operational state is updated in an...

Page 179: ...Monitor State utility Figure 64 Accessing the Monitor State Utility To refresh the status click Refresh 3 From the State drop down list select a state type administrativeState operationalState and usageState based on your understanding of the state types For a detailed definition of each state type see Table 45 4 To select a class type click All Stated Managed Objects in the Class field The classe...

Page 180: ...b elements select the Detailed tab to reveal the status of all of the sub elements at the same time 7 When finished click Close Refreshing the Status To update EMS with the current administrative state operational state and usage status of the selected element and its sub elements use the State command This command forces EMS to poll the element and any sub elements to update its state For more in...

Page 181: ...1 In the explorer tree select an SNMP device 2 Right click the SNMP device and select Browse MIB from the pop up menu The MIB browser window opens Getting and Setting MIB Values To get or set a particular MIB value 1 In the MIB browser explorer tree navigate and select a MIB module for example SIP MIB 2 Navigate to the MIB object level leaf level 3 In the right pane edit the Name as desired You ca...

Page 182: ...e formats 1 In the explorer tree select an element that contains a numeric value 2 In the right hand pane right click a numeric property 3 Select any one of the individual data formats or select All Formats to see all the available formats at the same time The Multi Format Dialog dialog box opens See Figure 66 Figure 66 Displaying Data Formats for a Numeric Property 4 If the property you have sele...

Page 183: ...onitors as you want The display will update as often as set by the Poll Rate To change the poll rate see Setting the Poll Rate on page 183 4 Click Start to begin monitoring The graphing starts based on the poll rate value While the graphing proceeds the Start button is replaced by the Pause button Use the Pause button to interrupt the graphing process 5 To change the rate the default is five secon...

Page 184: ...hange its value and then click Save All to complete the change Some property changes require a save to NVRAM or EEPROM For more information about saving and restoring configurations on SNMP devices see the related documentation for that specific device type Figure 67 shows how to edit a property in the right hand pane of the EMS GUI main window Figure 67 Editing a Property EMS manipulates MIB obje...

Page 185: ...tree select an element that contains a simple property 2 In the right hand pane find an editable property on a tab and select the property name in the Attribute column a red border surrounds the selected property The EMS Advisor displays property information If the EMS Advisor is closed click the eye icon in the upper right hand corner of the EMS GUI to open it 3 In the field to the right of the p...

Page 186: ...ase integrity You can edit any tabular property that has a white background Properties with gray backgrounds are informational read only properties Properties with gray backgrounds and blue text are index values that cannot be changed once the row is created Each row in a MIB table is identified by one or more unique index values A MIB table may display no rows at all In that situation the table i...

Page 187: ...table A tab that contains a MIB table usually has the Add and Delete buttons at the bottom of the tab as shown in Figure 70 You may or may not have the ability to add or delete table rows for each individual table Some tables will simply not allow you to delete an existing row and add a new row providing new index values 3 At the bottom of the tab click Add The Add row to table dialog box opens ed...

Page 188: ...e same In the explorer tree not all elements can values be copied If this is the case you will receive a No Related Elements Found error message when attempting to copy and paste values To copy SNMP values from one element to another 1 In the explorer tree select an element to copy values from 2 On the main menu select the Configuration menu and then select Copy SNMP values Instead of using the Co...

Page 189: ...change Figure 71 shows the SNMP Values to Change dialog box Figure 71 SNMP Values to Change Dialog Box 5 To remove a value from the list select the value and click Remove 6 When you are satisfied with the list of values you want to change click Set The copied SNMP values are pasted to the selected device 7 Click Close ...

Page 190: ...ching for 4 In the In section narrow your search by selecting one of the following Tree Label The label for a specific sub element or tree node for example DSP Property The name of a specific property or MIB object for example echo MIB OID The MIB OID for a specific MIB object for example 1 3 6 1 4 1 429 1 27 1 1 12 5 In the From field select the tree node you want to search If you want to change ...

Page 191: ...kbox 8 After entering your search criteria click Find now If any matches are found the results appear in the Find window See Figure 74 The results have three columns of information available to you Label The actual property or MIB object that contains the words entered in the search criteria Tab The tab on which this property or MIB object is found Tree Label The tree node where this property or M...

Page 192: ...ating Inventory Reports You can generate inventory reports for all the SNMP devices within a particular equipment folder To create an inventory report 1 In the explorer tree select an equipment folder bay or rack 2 Right click the selected element and select Inventory from the pop up menu The inventory report window and an EMS status dialog box open 3 When the Working icon changes to a Finished ic...

Page 193: ...table entry The Find button allows you to search on table entries based on the index values for that particular table EMS displays index values in blue text with gray backgrounds For more information see Editing Tabular Properties on page 186 To locate information in MIB tables using the Find button 1 In the right hand pane of the EMS GUI main window locate and select a tab containing a MIB table ...

Page 194: ... x to access the EMS the web browser interface you may experience security restrictions that prohibit you from accessing the HTTP port If this occurs see the related documentation for your web browser 2 Access the EMSServerAddress port file where EMSServerAddress port is the IP address of your EMS server and port designates the port number assigned to the internal HTTP web server The default value...

Page 195: ...nter page setup 2 From the main menu select the Tree menu and then select Print Tree A standard Print dialog box opens 3 Select the printer you want to print from 4 Configure the print job according to your customized needs also select the number of copies and click OK Starting and Stopping EMS Software Components Use the following procedures to start and stop EMS server GUI client and CLI client ...

Page 196: ...parameter in one of two ways Run the EMS server as a background process using the following command runServer daemon This will start the EMS server and force the EMS process into the background returning control of the terminal back to the user However shutting down the terminal window will stop the EMS server Run the EMS server in a mode where it is detached from the terminal that it was launched...

Page 197: ... the server to stop 3Com recommends that you create a Scheduled Task that will run the server in daemon mode when Windows boots The scheduled task should have the following properties Run The command line must include the full path to the runServer bat file including the daemon option For example C Program Files 3Com EMS runServer bat daemon Start in Reference the full path of the EMS installation...

Page 198: ...nism to prevent this from happening To access the server console commands available from a daemon see Displaying Server Console Commands on page 203 Stopping the EMS Server To shut down the EMS server enter one of the following commands from the EMS Server command prompt exit quit stop Starting the EMS GUI Client To start the EMS GUI client see Installation and Initial Setup on page 55 If you are ...

Page 199: ...Server Monitor to Monitor EMS Server Performance The EMS server monitor is a client side program that connects to a specific EMS server to monitor its key performance parameters It charts and optionally logs performance data such as transaction trap and notification activity for the EMS server To start the EMS server monitor 1 Open a command prompt window Make sure the EMS server is running before...

Page 200: ...onitor window Figure 77 EMS Server Monitor Window Table 47 Optional Parameters for the Server Monitor Parameter Usage Sservername Where servername is the hostname or IP address of the EMS server The default is localhost Llogfile Where logfile is the name of the log file to capture all data in Comma Separated Version CSV format ...

Page 201: ...ys the current performance data Click Pause to pause monitoring and click Continue to resume monitoring While the server monitor is running you can check how many Active users are using the EMS server See Figure 77 for more information 7 Click Close when you are finished Monitoring EMS Server Memory To monitor the amount of memory the EMS server is using 1 Start the Server Monitor For more informa...

Page 202: ... of memory currently being used 4 When finished click Close Monitoring EMS GUI Memory To monitor the amount of memory the EMS GUI client is using 1 Start the EMS GUI client For more information see Installation and Initial Setup on page 55 2 From the EMS GUI main menu select the Tools menu and then select Memory Monitor See Figure 79 for the GUIClient Memory Monitor window ...

Page 203: ...rver commands except the ones listed in Stopping the EMS Server on page 198 the server console commands provide a powerful alternative for many system commands To display the list of available EMS server console commands 1 Start the EMS server using one of the options listed in Starting and Stopping EMS Software Components on page 195 If you start the EMS server as a daemon or background process t...

Page 204: ...re Components on page 195 If you start the EMS server as a daemon or background process see Command Line Interface Reference on page 207 2 From the EMS server console enter or help For a comprehensive list of all EMS CLI client console commands and their functions see EMS CLI Client on page 209 Configuring Table Data Loading With the Table loading control on the EMS toolbar you can select how EMS ...

Page 205: ...able loading The Table loading indicator changes to red and EMS changes to loading the table data line by line as you scroll down in a full on screen table display 2 If the Table loading indicator is red EMS is set to load table data line by line as you scroll down in a full on screen table display Click Table loading The Table loading indicator changes to green and EMS changes to loading the tabl...

Page 206: ...206 CHAPTER 10 OPERATIONS ...

Page 207: ...me export the database with fileName docSchema document the schema exit f stops the server find mib objectName displays definition of objectName help shows help for the server console commands host hostName resolve hostName hpov_integration integrate with HP OpenView install directory package jar install an EMS package from the following path directory package jar For example c EMS V7230 jar inven...

Page 208: ...ole Commands in the Enterprise Management Server Administration Guide When the CLI client forces the EMS server to stop or restart the EMS CLI detects that the EMS server has stopped and consequently issues a message resdiscoverAll rediscovers all equipment restart f restarts the server rmov_integration remove HP OpenView integration set name value set server property value stats show instrumentat...

Page 209: ...automate server interaction for example collecting statistics and issuing commands or to issue stop commands in system scripts while a system is rebooting or going down EMS CLI Client If you are running the EMS server as a daemon this list changes Table 50 lists the EMS CLI client console commands Table 50 EMS CLI Client Commands Command Function shows help for the EMS CLI db export fileName expor...

Page 210: ...d Function Table 51 Dormant Server CLI Commands Command Behavior Help Displays a modified list of CLI commands listing only the commands that are available while the server is in Dormant Mode Stop quit exit Identical behavior to Running Server Restart Identical behavior to Running Server Host Not available rediscoverAll Not available Mail Not available Stats Not available Db export Not available P...

Page 211: ...on runMode Command The runMode command accepts one of two values active dormant If the server is already running in the requested mode the server displays the message Server already running in runMode mode where runMode is one of either Active or Dormant Next the runMode command confirms with the user that they want to perform the switch by asking Are you sure y n Entering anything other than y or...

Page 212: ...212 APPENDIX A COMMAND LINE INTERFACE REFERENCE ...

Page 213: ...mponents software 23 configuration files for SysObjectID recognition 158 configuring color palette 128 database compaction 63 databases 61 DB2 external databases 71 display of non supported MIB objects 131 embedded databases 64 EMS for multi homed server support 74 EMS servers with a static IP address 75 environment settings 125 equipment folder parameters 118 logical views 147 MySQL external data...

Page 214: ...ng 176 renaming 117 reserving 116 unreserving 116 embedded databases 62 EMS data formats presented 182 find function 190 EMS_FILEHOME 89 environment settings 125 equipment folder 101 event flow 37 event processing 37 executing commands for multiple elements 176 expanding and collapsing elements 175 explorer view 170 exporting users 137 exporting and importing SNMP devices 115 external databases 64...

Page 215: ...ric properties 183 status of GUI elements 177 N network management platform integration 130 149 launching from EMS 152 software 42 supported 46 network node manager fields file 157 general file location 156 icon files 159 icons 154 159 installation 150 integration architecture 156 menu integration and application registration files 156 MIB files 160 traps 154 new folder command 102 nodes deleting ...

Page 216: ...s 96 server run modes active dormant 89 server startup messages 94 timeout and retry 92 server monitor using 199 setting up the EMS launcher 152 setting login expiration 140 setting poll rate 183 shortcut options Windows 81 silently installing the EMS server 59 SNMP device ID 113 SNMP devices 34 103 SNMP values copying 188 SNMP version parameter 104 software components 23 software licenses 41 soft...

Page 217: ...anagement platform 161 tree menu option using 175 U understanding the discovery interface 118 unreserving elements 116 users adding 134 assigning root view 135 exporting and importing 137 folder 133 multiple user access for external DBs 74 V VCX supported products 29 verifying EMS serial number 168 viewing SNMP device identification 113 W web browser access 36 web browser Interface assessing 194 W...

Page 218: ...218 INDEX ...

Reviews: