AT-VIEW PLUS AMIGO USER’S GUIDE PN 613-50662-00 Rev B Page 1 of 48
Allied Telesyn AT-VIEW PLUS AMIGO Copyright (c) 1998-2005 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.......................................................................7 2.1.2 Target Host .........................................
Allied Telesyn AT-VIEW PLUS AMIGO 4.1.5 Target Device...........................................................................27 4.1.6 Property....................................................................................28 4.1.7 Exit ...........................................................................................40 4.2 Edit .................................................................................................41 4.2.1 Cut ......................................................
Allied Telesyn AT-VIEW PLUS AMIGO 1 Overview AMIGO (Advanced MIb Group Operator) is a MIB browser that comes with ATView 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 SNMP Version Get Community Set Community User Account Name Security Level Authentication Protocol Authentication Password Privacy Protocol Privacy Password Configuration File Parameter File 2.1.1 Command Syntax To start AMIGO from the command line, use the following syntax.
Allied Telesyn AT-VIEW PLUS AMIGO SetCommunity SNMP Set community string. This is used to modify MIB values. UserName User account name to be used for accessing the MIB. This is required when using SNMPv3. SecLevel Security level that is configured for the User Name. This is required when using SNMPv3. AuthProtocol Authentication protocol that is configured for the User Name. This is required when using SNMPv3. AuthPassword Authentication password that is configured for the User Name.
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 SNMP Version The Device Manager can use SNMPv1, SNMPv2c and SNMPv3. You may specify a value of 1, 2 or 3. If the SNMP Version is not specified, the default value of 1 (SNMPv1) will be used. Examples: Amigo -TargetHost 172.16.99.123 -SnmpVersion 1 Amigo -TargetHost 172.16.99.123 -SnmpVersion 2 2.1.
Allied Telesyn AT-VIEW PLUS AMIGO Example: Amigo -TargetHost 172.16.18.34 -SetCommunity dvcmgrset 2.1.6 User Account Name If you specified 3 (SNMPv3) for the SNMP Version, you must also specify a User Account Name that is already configured on the target host. Examples: Amigo -TargetHost 172.16.99.123 -SnmpVersion 3 -UserName ATVP -SecLevel noAuthNoPriv Amigo -TargetHost 172.16.99.123 -SnmpVersion 3 -UserName ATVP1 -SecLevel authNoPriv -AuthProtocol SHA -AuthPassword PASS1233 2.1.
Allied Telesyn AT-VIEW PLUS AMIGO Examples: Amigo -TargetHost 172.16.99.123 -SnmpVersion 3 -UserName ATVP -SecLevel authNoPriv -AuthProtocol MD5 -AuthPassword PASS1234 Amigo -TargetHost 172.16.99.123 -SnmpVersion 3 -UserName ATVP1 -SecLevel authNoPriv -AuthProtocol SHA -AuthPassword PASS1233 2.1.
Allied Telesyn AT-VIEW PLUS AMIGO 2.1.11 Privacy Password If you specified 3 (SNMPv3) for the SNMP Version, and your Security Level is authPriv, then you must specify a Privacy Password that is configured for the User Account Name on the target host. Examples: Amigo -TargetHost 172.16.99.123 -SnmpVersion 3 -UserName ATVP -SecLevel authPriv -AuthProtocol MD5 -AuthPassword PASS1234 -PrivProtocol DES -PrivPassword PASS5678 Amigo -TargetHost 172.16.99.
Allied Telesyn AT-VIEW PLUS AMIGO -SetCommunity set -GetCommunity get 2 Starting AMIGO PN 613-50662-00 Rev B Page 13 of 48
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 When you start AMIGO from AT-View Plus Device Manager, AMIGO automatically configures this information according to the target device.
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. ATView 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 3.3.8 Set MIB Value Button : sets values in the MIB Value column for the variables checked in the checkbox column. Note - SNMPv3: Depending on the WRITE VIEW access settings of the User Account Name used, there is a possibility that Amigo may not be able to set some MIB values. When this happens, a "No access error." value will be displayed on the affected MIB Value cells.
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 Select MIB-Files tab 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.
Allied Telesyn AT-VIEW PLUS AMIGO Setting target devices tab 4.1.6.3 Target Host Property In the "Target Host Property" dialog box, you can change various properties for a specific target device by selecting a host, then clicking on the Property button. 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.
Allied Telesyn AT-VIEW PLUS AMIGO SNMP version The version of SNMP that the device will use to send and receive device information. After choosing the version of SNMP to use, click on the Settings button to specify the SNMP parameters that correspond with the chosen version. If the SNMP version is set to "v1" or "v2c", then the SNMP v1/v2c Settings dialog box will be displayed. Otherwise, if the SNMP version is set to "v3", then the SNMP v3 Settings dialog box will be displayed.
Allied Telesyn AT-VIEW PLUS AMIGO 4.1.6.3.2 SNMP v3 Settings User Account Name This is the SNMPv3 User Account to be used for accessing the MIB of the target device. Make sure to specify a User Account that has already been configured on the target device. Security Level This is the Security Level for the User Account Name that you have specified. Make sure to set the Security Level to be the same as what is configured on the target device.
Allied Telesyn AT-VIEW PLUS AMIGO Privacy Protocol If the Security Level is "Auth / Priv", you need to specify a Privacy Protocol. This is the available Privacy Protocol: DES Use Data Encryption Standard Privacy Password If the Security Level is "Auth / Priv", you need to specify a Privacy Password. Make sure to set the Privacy Password to be the same as what is configured on the target device. SNMP v3 Settings dialog box 4.1.6.
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-50662-00 Rev B Page 42 of 48
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.3.3 Jump to Mark To jump to a marked object on the tree, select Mark > Jump to mark > [marked object].
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 mib2 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.
