AT-VIEW PLUS AMIGO USER’S GUIDE PN 613-50506-00 Rev B Page 1 of 38
Allied Telesyn AT-VIEW PLUS AMIGO Copyright (c) 2003-2004 Allied Telesis K. K. All rights reserved. No part of this publication may be reproduced without prior written permission from Allied Telesis, K. K. Microsoft is a registered trademark of Microsoft Corporation. Netscape Navigator is a registered trademark of Netscape Communications Corporation. All other product names, company names, logos or other designations mentioned herein are trademarks or registered trademarks of their respective owners.
Allied Telesyn AT-VIEW PLUS AMIGO TABLE OF CONTENTS 1 Overview ........................................................................................................................... 5 2 Starting AMIGO ................................................................................................................. 6 2.1 Starting From the Command Line............................................................................... 7 2.1.1 Command Syntax...................................................
Allied Telesyn AT-VIEW PLUS AMIGO 4.3.1 Mark ................................................................................................................... 34 4.3.2 Delete Mark........................................................................................................ 34 4.3.3 Jump to Mark ..................................................................................................... 34 4.4 SNMP ........................................................................................
Allied Telesyn AT-VIEW PLUS AMIGO 1 Overview AMIGO (Advanced MIb Group Operator) is a MIB browser that comes with AT-View Plus. It is a tool for viewing or editing MIB variables on an SNMP agent.
Allied Telesyn AT-VIEW PLUS AMIGO 2 Starting AMIGO AMIGO can be started from AT-View Plus Device Manager or from the command line. In a Windows environment, AMIGO can be started from the Start menu or from the Run command in the File menu.
Allied Telesyn AT-VIEW PLUS AMIGO 2.1 Starting From the Command Line The command line interface is the most basic way to start AMIGO. Topics: • • • • • • Command Syntax Target Host Get Community Set Community Configuration File Parameter File 2.1.1 Command Syntax To start AMIGO from the command line, use the following syntax. Amigo [options] You can specify the following options. TargetHost The IP address or hostname of the target host. GetCommunity SNMP Get community string.
Allied Telesyn AT-VIEW PLUS AMIGO 2.1.2 Target Host The target host can be specified as a dotted IP address or as a host name. Example: Amigo -TargetHost 172.16.18.34 Amigo -TargetHost dvcmgrhub 2.1.3 Get Community Get Community is an SNMP community string used to get MIB values from the agent. You must specify the same community string as the one configured on the target host. If the string is not specified, the default community string "public" is used. Example: Amigo -TargetHost 172.16.18.
Allied Telesyn AT-VIEW PLUS AMIGO 2.1.6 Parameter File Parameters can be written in a file. You can specify the file from which AMIGO is to read the parameters. The parameter file is a plain text file which contains a name-value pair in each line. Example: Amigo -TargetHost TEST @para1.txt where para1.
Allied Telesyn AT-VIEW PLUS AMIGO 2.2 Configuring AMIGO AMIGO's general configuration can be changed from the File > Property menu. This includes MIB files, target IP addresses or host names, web browser settings, and window layout settings. When you first run AMIGO, a dialog box opens in which you can enter these settings. By default, you can browse the MIB-II tree only. If this is all you require, click Cancel to close the dialog box. This configuration can be changed later.
Allied Telesyn AT-VIEW PLUS AMIGO 2.3 Starting From AT-View Plus Device Manager You can start AMIGO from AT-View Plus Device Manager by clicking on Tool > MIB Browser or by clicking on the MIB Browser button on the toolbar. AT-View Plus Device Manager automatically passes the MIB file information of the target host to AMIGO so that a user can browse the MIB tree on the target host without manual configuration.
Allied Telesyn AT-VIEW PLUS AMIGO 3 Main Window The three panels in AMIGO's main window display related information about the SNMP agents and MIB objects on target hosts. This section describes these three panels.
Allied Telesyn AT-VIEW PLUS AMIGO The panels can be resized by dragging the borders.
Allied Telesyn AT-VIEW PLUS AMIGO 3.1 MIB Tree Panel The left half of AMIGO's main window is the "MIB Tree Panel", which shows the MIB object structure for the target device. This panel has two tabs, "General MIB tree" and "Personal MIB tree". Topics: • • • General MIB Tree Personal MIB Tree Target Device MIB Tree Panel 3.1.1 General MIB Tree The General MIB tree shows the tree structure based on MIB files that are read by AMIGO. The general MIB tree cannot be edited.
Allied Telesyn AT-VIEW PLUS AMIGO 3.1.2 Personal MIB Tree The Personal MIB tree is a customizable tree of your own. This tree can be constructed from any subtree of an existing MIB or any leaf objects copied from the General MIB tree. Using the Personal MIB tree, you can create a tree containing only objects that you want to monitor. When you first run AMIGO, the Personal MIB tree is empty (root node only). To create your own tree, follow the steps below. 1.
Allied Telesyn AT-VIEW PLUS AMIGO Set target device Operations on the MIB tree are applied to the currently selected target device. To change the current target, click the target device on the General MIB tree once. After that, all operations on the tree are applied to the new device until another device is selected. The currently selected device is displayed in the field under the MIB tree.
Allied Telesyn AT-VIEW PLUS AMIGO 3.2 Detailed Information Panel The Detailed Information Panel is the area at the top right corner of AMIGO's main window. It shows detailed information about the MIB object (variable) selected in the MIB tree. The information includes the variable name, object identifier, syntax and description.
Allied Telesyn AT-VIEW PLUS AMIGO 3.3 MIB Operation Panel The MIB Operation Panel is the area at the bottom right corner of AMIGO's main window. It shows the value of the variables selected in the MIB tree. To display the values of the MIB objects, first select the object(s) on the MIB tree panel, then select an appropriate SNMP command from the menu bar or toolbar. In this panel, you can also change (set) the value of the variables. Note - The threshold button cannot be used in AMIGO.
Allied Telesyn AT-VIEW PLUS AMIGO To change the value, check the variables to be changed before clicking the Set MIB Value button. AMIGO will send the checked values in a batch. 3.3.2 MIB Variable Column The second column shows the name of the variable. 3.3.3 MIB Value Column The third column shows the value of the variable. If the variable has write-access, you can input the value to be set in this column. If the variable takes a value from a fixed set of values, this column is a drop-down listbox.
Allied Telesyn AT-VIEW PLUS AMIGO 4 Menus This section describes AMIGO's menu bar items. These menu commands can also be accessed from the toolbar.
Allied Telesyn AT-VIEW PLUS AMIGO 4.1 File From the File menu, you can open, change, or save AMIGO's configuration. Topics: • • • • • • • New File Open Save Save As Target Device Property Exit 4.1.1 New File Creates a new configuration file. Selecting File > New File opens the "Setting environment for AMIGO" window. Specify appropriate parameters in this dialog box then click OK.
Allied Telesyn AT-VIEW PLUS AMIGO 4.1.6 Property Changes the AMIGO configuration. The "Setting environment for AMIGO" dialog box opens. The dialog box has the following tabs. 4.1.6.1 Setting MIB-Files Tab In the Setting MIB-Files tab, you can specify which MIB files AMIGO uses to draw the MIB tree. To add a MIB file, enter a file name in the MIB-File name textbox then click Add or select a MIB file using the Browse button. To remove a MIB file, select a file from the list then click Delete.
Allied Telesyn AT-VIEW PLUS AMIGO 4.1.6.2 Setting Target Devices Tab In the "Setting target devices" tab, you can add or remove a target device to/from which MIB values are set or retrieved. You can also configure the SNMP connection properties of a target device. To add a target device, input a dotted IP address or a host name in the Host name textbox, then click Add. To change the properties of a specific target device, select the target device from the list, then click the Property button.
Allied Telesyn AT-VIEW PLUS AMIGO Community for read/Community for write The community strings used to perform SNMP operations on the device. Timeout The time in seconds before AMIGO determines that the target device is not responding. Retry count The number of SNMP messages to send before giving up. Port number The UDP port number on which the target device is listening for SNMP messages. If the target device is using a non-standard port for SNMP operations, you must change this value.
Allied Telesyn AT-VIEW PLUS AMIGO Setting WWW browser tab 4.1.6.5 Window Layout Setting Tab In the "Window layout setting" tab, you can customize the appearance of AMIGO windows and the way information is displayed in the windows. To access each of the following submenus, select a node in the "How to show Amigo" tree. The submenu options appear on the right side of the dialog box. 4.1.6.5.1 How to Show AMIGO You can specify the "look and feel" of the AMIGO windows and dialog boxes.
Allied Telesyn AT-VIEW PLUS AMIGO Window display options for AMIGO 4.1.6.5.2 Toolbar Area You can select the appearance of the toolbar buttons.
Allied Telesyn AT-VIEW PLUS AMIGO Toolbar area submenu 4.1.6.5.3 MIB Tree Panel You can change the placement for the MIB Tree Panel, Detailed Information Panel, and MIB Operation Panel.
Allied Telesyn AT-VIEW PLUS AMIGO MIB tree panel submenu 4.1.6.5.4 Personal MIB Tree Area / General MIB Tree Area You can change the background colors for each of the MIB tree panels.
Allied Telesyn AT-VIEW PLUS AMIGO Background colour setting 4.1.6.5.5 MIB Node Description Area You can choose how to display the text in the Detailed Information Panel in the main window of AMIGO. You also have the option to change the background color of the panel.
Allied Telesyn AT-VIEW PLUS AMIGO Detailed information panel settings 4.1.6.5.6 MIB Operation Panel Submenu You can select the format of the MIB variable name in the MIB Operation Panel. This is the same as the Option > Option > Other tab of AT-View Plus Device Manager. You also have the option to show or hide the MIB Operation Panel in/from the main window of AMIGO. 4.1.6.5.7 Omit Display Check this box if you want to shorten the MIB variable name.
Allied Telesyn AT-VIEW PLUS AMIGO MIB variable name display type 4.1.7 Exit Quit AMIGO.
Allied Telesyn AT-VIEW PLUS AMIGO 4.2 Edit From the Edit menu, you can perform copy and paste operations on the MIB tree panel. These operations can also be performed by clicking toolbar buttons. Topics: • • • • • Cut Copy Paste Delete Find 4.2.1 Cut Cuts the selected objects from the Personal MIB tree tab. 4.2.2 Copy Copies the selected objects from the General or Personal MIB tree tab to the clipboard. Copied objects can be pasted to the Personal MIB tree. 4.2.
Allied Telesyn AT-VIEW PLUS AMIGO Search dialog box 4 Menus PN 613-50506-00 Rev B Page 33 of 38
Allied Telesyn AT-VIEW PLUS AMIGO 4.3 Mark From the Mark menu, you can mark particular MIB objects for later reference. After marking, you can access the object by selecting it from the "Jump to mark" menu. Topics: • • • Mark Delete Mark Jump to Mark 4.3.1 Mark Adds a mark to the selected MIB object on the MIB tree. To add a mark, select the object on the tree, then select Mark > Mark. Marked objects are listed in the Mark > Jump to mark menu. 4.3.
Allied Telesyn AT-VIEW PLUS AMIGO 4.4 SNMP From the SNMP menu, you can perform the following SNMP operations. Topics: • • • • • Get Values Get Values and Next To Set Values Save Values Load Values From a File 4.4.1 Get Values Gets MIB values for variables selected on the MIB tree. These MIB values are retrieved from the SNMP agent on the currently selected device. The currently selected device is displayed in the area under the MIB tree. Retrieved values are displayed in the MIB Operation Panel.
Allied Telesyn AT-VIEW PLUS AMIGO Get SNMP values of selected device Note - If you select a node containing many variables, for instance the whole mib-2 subtree, it might take a while to get all the values of these variables values. 4.4.2 Get Values and Next To Gets MIB values for the variable or node selected in the MIB tree, then select the next variable or node. This is useful when you want to get MIB values continuously.
Allied Telesyn AT-VIEW PLUS AMIGO 4.4.3 Set Values Sets values to the variables. 4.4.4 Save Values Saves MIB values to a file. 4.4.5 Load Values From a File Loads MIB values from a file to which AMIGO has saved them, then repeats the Get operation previously done.
Allied Telesyn AT-VIEW PLUS AMIGO 4.5 Help From the Help menu, you can view the online user's guide and version information for AMIGO. Topics: • • Display Help About 4.5.1 Display Help Opens the AMIGO online user's guide in your chosen web browser. You must first specify the web browser in the "Setting WWW browser" tab of the File > Property menu. 4.5.2 About Shows version and copyright information for AMIGO.
