MetaConsole for Unicenter NSM: Getting Started for Canon Guide version 2.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Copyright © 2000-2003 NETAPHOR SOFTWARE, INC. All rights reserved. No part of the contents of this document may be reproduced or transmitted in any form or by any means without the written permission of NETAPHOR SOFTWARE, INC. MetaConsole and NETAPHOR are trademarks of NETAPHOR SOFTWARE, INC. Computer Associates, Unicenter, and WorldView are registered trademarks of Computer Associates International Inc.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 4.2 LICENSEE MAY NOT REVERSE ASSEMBLE, REVERSE COMPILE, OR OTHERWISE TRANSLATE THE SOFTWARE OR USE ANY OTHER METHOD TO DISCOVER THE SOFTWARE'S SOURCE CODE. LICENSEE MAY NOT CREATE DERIVATIVE WORKS BASED UPON THE SOFTWARE OR ANY PART THEREOF EXCEPT AS SPECIFICALLY PROVIDED IN THIS LICENSE AGREEMENT. LICENSEE MAY NOT COPY THE SOFTWARE PRODUCT EXCEPT AS SPECIFICALLY PROVIDED IN THIS LICENSE AGREEMENT. 5. LICENSOR'S RIGHTS.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 10. GOVERNING LAW. This License Agreement shall be construed and governed in accordance with the laws of the State of California. Should any term of this License Agreement be declared void or unenforceable by any court of competent jurisdiction, such declaration shall have no effect on the remaining terms hereof. 11. COSTS OF LITIGATION.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Apache Software Foundation MetaConsole software contains the Xalan and Xerces components from the Apache Software Foundation. Xalan The Apache Software License, Version 1.1 Copyright (c) 1999 The Apache Software Foundation. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 4. The names "Xerces" and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact apache@apache.org. 5. Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without prior written permission of the Apache Software Foundation.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Table of Contents Overview 1 MetaConsole Documentation .................................................................................. 1 Chapter 1. MetaConsole Architecture .........................................................2 Client ....................................................................................................................... 4 Server ...........................................................................
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Specifying Alarm Notification Methods .................................................................. 17 Getting MetaConsole Component Version Information ......................................... 19 Enabling and Disabling Service Providers............................................................. 19 Viewing Alarms ...................................................................................................... 20 Chapter 5.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Overview A management console is a single tool used to manage entire networks. It is a framework within which device- or service-specific management modules can share a user interface, alarm monitoring, and other basic functions. Popular management consoles include CA Unicenter, Tivoli NetView, Microsoft Management Console (MMC), and HP OpenView.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Chapter 1. MetaConsole Architecture The MetaConsole application architecture is three-tiered. The major components are: • MetaConsole client —this is the front end that integrates with the console There is one client per console, managing all supported devices.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 3 Client Console Console-Specific Protocol MetaConsole Client Console Interface User Interface HTTP Client Layer HTTP Request/Response containing XML queries routed through the preferred server Server HTTP Server XML Query/Response Service Mapping File XML Translation Service Provider Device-Specific Protocol Device
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Client The client component includes three major sub-components: • The console interface cooperates with the host console so the client functions in a manner native to that console. For example, the console interface in the MetaConsole client for Unicenter uses the Unicenter WorldView API and ensures that the client performs all functions expected of WorldView applications.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Chapter 2. Planning Your MetaConsole Deployment MetaConsole was designed to be deployed in various and diverse environments. MetaConsole runs well for the small workgroup and can be scaled up, with several MetaConsole servers being deployed in a large enterprise to handle very large networks.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Are you managing devices of multiple service providers? To manage devices of multiple service providers, you might consider dividing the management load among multiple MetaConsole servers. This would also allow you to have multiple administrators with different job functions (such as managing servers and managing printers).
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Monitoring the Network and Using Alarms MetaConsole gives you flexibility in the monitoring of network activity. For each service provider, you select the types of events that should trigger alarms and the poll rate for alarms. (For details, see the client user’s guide for a particular service provider.) You can then view alarms in several ways.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide The HSQLDB database can be saved by copying and storing the database files: MetaConsoleDB.data, MetaConsoleDB.properties, and MetaConsoleDB.script. A new database can be created by deleting the old database files and running the runcreator.exe application in the MetaConsole directory. If you prefer a more familiar and robust database, you can download and install one.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Chapter 3. 9 Installation This chapter describes the installation of MetaConsole. Both the MetaConsole server and the client for Unicenter can be installed on a number of platforms. The devices that your client will manage need not be present on your network when you install MetaConsole. Prerequisites Server The following table describes the hardware and software requirements for the MetaConsole server. Platform Hardware Windows (NT 4.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Platform Hardware Software Solaris 8 Sun Ultra 5 CA Unicenter NSM 3.0 for Solaris 512 MB available RAM CDE, XWindows, or OSF Motif 45 MB free hard disk space Netscape Navigator 6.2 with Sun's Java Plug-in 1.4 (http://java.sun.com/products/plugin/) Database The following table describes the databases and corresponding drivers that are supported within MetaConsole.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide b. Click the Start Installer button. The platform is detected and the platform-specific installer is saved locally and executed. 3. Accept the license agreement. You cannot install and use MetaConsole if you do not accept the agreement. 4. Select the component or components to install: a. MetaConsole server b. Client for CA Unicenter 5. Specify an installation directory. The default directory is recommended.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Starting the MetaConsole Server After Installation Note: The MetaConsole installation procedure does not start the MetaConsole server. To use MetaConsole immediately after installation, you must manually start the MetaConsole server. To start the MetaConsole server on Windows: 1. Click the Start button, point to Programs, and then point to MetaConsole. 2.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 4. Modify the local.xml file so that the MetaConsole tables can be configured in the database. The example below shows the contents of the dataStore element in the local.xml file. Modify the data shown in italics to connect to your MSSQL server. DATABASE_NAME = “MSSQL” DATABASE_DRIVER=”com.microsoft.jdbc.sqlserver.SQLServerDriver” CONNECTION_URL=”jdbc:microsoft:sqlserver://10.0.0.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 4. Modify the local.xml file so that the MetaConsole tables can be configured in the database. The example below shows the contents of the dataStore element in the local.xml file. Modify the data shown in italics to connect to your MSSQL server. DATABASE_NAME = “MySQL” DATABASE_DRIVER=”org.gjt.mm.mysql.Driver” CONNECTION_URL=” jdbc:mysql://10.0.0.207/ks” USER_NAME=”root” PASSWORD=”password”> 5. Save and close the local.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Chapter 4. 15 Client for Unicenter WorldView MetaConsole adds a MetaConsole Devices folder to the Unicenter 2D Map. (This chapter assumes that MetaConsole discovery is used. See NetaphorDiscover on page 24.) Folders have nodes, some of which reveal sub-folders. There are four levels of MetaConsole-related nodes.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide All configuration settings for the server or a service provider are maintained by the MetaConsole server and are not client specific. All clients use the same values; if any client changes a particular setting, the change affects all clients that use that setting. To view information or change settings for a device, right-click a device node, and on the menu that appears, click Show device details.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide The new server appears in the Server List box and in the navigation tree. To remove a MetaConsole server from the list: 1. In the navigation pane, expand the top-level Configuration node and click Server Discovery. 2. In the Servers box, click the address of the MetaConsole server you are removing from the list. 3. Click Remove. The server is removed from the list and from the navigation tree.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 3. Specify primary recipients by doing one or both of the following: • To add a recipient to the To: List: In the To: Email Address box, type an email address; then click the adjacent Add button. • To remove an address from the To: List: Click the address; then click the adjacent Remove button. 4.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide c. Click the adjacent Add button. • To remove a recipient from the Pager List: Click the pager ID; then click the adjacent Remove button. 4. In the From box, type the email address to be displayed as the originator of alarm page messages. Typically, this is a network administrator’s email address. 5. In the Subject box, type text to be included in page messages as the subject.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide The MetaConsole client opens. To enable a service provider: 1. In the navigation pane, expand the MetaConsole server node and the Configuration node just below it, and click Service Providers. 2. In the Disabled list, click the name of the service provider you want to enable. 3. Click Enable. 4. To manually update discovered information in the map or the navigation pane, see Refreshing Displayed Information on page 16.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 3. In the Sort by list, click Most Recent Alarm or Device to sort the alarms. Most Recent Alarm shows the most recent alarms at the top of the page and older alarms at the bottom. Device shows alarms by device, with numbers in ascending order (for example, 10.0.0.1, 10.0.0.2) followed by letters in alphabetical order (for example, Alpha, Beta). 4. In the Filter by list, click an option to determine which alarms are shown.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Chapter 5. Configuration Text Files Configuration of MetaConsole server properties is governed by entries in a text file, configuration.txt. The MetaConsole client has a corresponding properties file, console.properties. Note: Changes in console.properties do not take effect until you stop and restart the Unicenter client. Configuration.txt The configuration.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide 23 Keywords Keyword Description Comments Port HTTP server port number. Original value is 80. Root HTTP server root directory name. Original value is root. Do not change this value. AllowWrites Indicates whether the server will allow sets. Original value is true. Do not change this value. ServiceProviderDirectory Name of the service provider directory. Original value is mcsps. Do not change this value.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide ServiceProviderConfigurationPage DeviceConfigurationPage 24 /start.html /start.html Keywords Keyword Description Comments Version The version of the client that this properties file is designed to run with. Do not change this value. LogToFile Indicates whether errors generated by the client for Unicenter are sent to the file named in LogFile (see below). True or False. LogToScreen N/A Do not change this value.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide Chapter 6. Troubleshooting MetaConsole for Unicenter SnapIn Not Installed The “Typical” installation does not include the MetaConsole for Unicenter SnapIn. You must choose the snapin explicitly, which changes the type of installation to “Custom.
MetaConsole for Unicenter NSM: Getting Started for Canon Guide If the 2D Map is run after you stop and restart the MetaConsole server and the MetaConsole Unicenter SnapIn, and the MetaConsole Devices icon still does not appear, contact Technical Support. To determine what is wrong, Technical Support will require a log from the MetaConsole Unicenter SnapIn service. To obtain this log, change the LogToFile option in console.
