AT-VIEW PLUS AMIGO USER’S GUIDE PN 613-50662-00 Rev A Page 1 of 43
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.2 Edit ........................................................................................................................... 37 4.2.1 Cut ..................................................................................................................... 37 4.2.2 Copy................................................................................................................... 37 4.2.3 Paste.....................................................................
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 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 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. This is required when using SNMPv3.
Allied Telesyn AT-VIEW PLUS AMIGO Examples: Amigo -TargetHost 172.16.99.123 -SnmpVersion 1 Amigo -TargetHost 172.16.99.123 -SnmpVersion 2 2.1.4 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.34 -GetCommunity dvcmgrget 2.1.
Allied Telesyn AT-VIEW PLUS AMIGO 2.1.7 Security Level If you specified 3 (SNMPv3) for the SNMP Version, you must also specify a Security Level that is configured for the User Account Name on the target host. The available Security Levels are noAuthNoPriv, authNoPriv, and authPriv. 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 2.1.10 Privacy Protocol If you specified 3 (SNMPv3) for the SNMP Version, and your Security Level is authPriv, then you must specify a Privacy Protocol that is configured for the User Account Name on the target host. The available Privacy Protocol is DES. Examples: Amigo -TargetHost 172.16.99.123 -SnmpVersion 3 -UserName -SecLevel authPriv -AuthProtocol MD5 -AuthPassword -PrivProtocol DES -PrivPassword PASS5678 Amigo -TargetHost 172.16.99.
Allied Telesyn AT-VIEW PLUS AMIGO 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. Topics: • • • MIB Tree Panel Detailed Information Panel MIB Operation Panel Main Window 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 When you first run AMIGO, the Personal MIB tree is empty (root node only). To create your own tree, follow the steps below. 1. On the General MIB tree tab, copy MIB objects to the clipboard by selecting Edit > Copy. Select multiple objects by using the Shift or Ctrl keys. 2. On the Personal MIB tree tab, click the place where you want to insert the copied objects. 3. Paste previously copied objects by selecting Edit > Paste.
Allied Telesyn AT-VIEW PLUS AMIGO 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 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. Note - SNMPv3: When a Set operation is performed using a user account that has No Read access but has Write access to the target MIB variable, the error message, "No access error.
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.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. Auto Add Using the "Auto Add" button, you can automatically add the MIB files which are required to manage the target device.
Allied Telesyn AT-VIEW PLUS AMIGO To change the properties of a specific target device, select the target device from the list, then click the Property button. The "Target host property" dialog box opens. Change the properties, then click OK. To remove a target device from the list, select a device in the list then click Delete. Setting target devices tab 4.1.6.
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 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.4 Setting WWW Browser Tab In the "Setting WWW browser" tab, you can specify the path of the web browser to use for viewing the online user's guide.
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 A Page 38 of 43
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. 4.4.
Allied Telesyn AT-VIEW PLUS AMIGO 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.
