Titlepage. Agent Simulator. Document Device Management

Transcription

1 Titlepage Agent Simulator Document Device Management

2 Copyright Notice Document Copyright August 2002 by Aprisma Management Technologies, Inc. All rights reserved worldwide. Use, duplication, or disclosure by the United States government is subject to the restrictions set forth in DFARS (c)(1)(ii) and FAR Liability Disclaimer Aprisma Management Technologies, Inc. ( Aprisma ) reserves the right to make changes in specifications and other information contained in this document without prior notice. In all cases, the reader should contact Aprisma to inquire if any changes have been made. The hardware, firmware, or software described in this manual is subject to change without notice. IN NO EVENT SHALL APRISMA, ITS EMPLOYEES, OFFICERS, DIRECTORS, AGENTS, OR AFFILIATES BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATED TO THIS MANUAL OR THE INFORMATION CONTAINED IN IT, EVEN IF APRISMA HAS BEEN ADVISED OF, HAS KNOWN, OR SHOULD HAVE KNOWN, THE POSSIBILITY OF SUCH DAMAGES. Trademark, Service Mark, and Logo Information SPECTRUM, IMT, and the SPECTRUM IMT/VNM logo are registered trademarks of Aprisma Management Technologies, Inc., or its affiliates. APRISMA, APRISMA MANAGEMENT TECHNOLOGIES, the APRISMA MANAGEMENT TECHNOLOGIES logo, MANAGE WHAT MATTERS, DCM, VNM, SpectroGRAPH, SpectroSERVER, Inductive Modeling Technology, Device Communications Manager, SPECTRUM Security Manager, and Virtual Network Machine are unregistered trademarks of Aprisma Management Technologies, Inc., or its affiliates. For a complete list of Aprisma trademarks, service marks, and trade names, go to All referenced trademarks, service marks, and trade names identified in this document, whether registered or unregistered, are the intellectual property of their respective owners. No rights are granted by Aprisma Management Technologies, Inc., to use such marks, whether by implication, estoppel, or otherwise. If you have comments or concerns about trademark or copyright references, please send an to spectrum-docs@aprisma.com; we will do our best to help. Agent Simulator Page 2

3 Restricted Rights Notice (Applicable to licenses to the United States government only.) This software and/or user documentation is/are provided with RESTRICTED AND LIMITED RIGHTS. Use, duplication, or disclosure by the government is subject to restrictions as set forth in FAR (June 1987) Alternate III(g)(3) (June 1987), FAR (June 1987), or DFARS (c)(1)(ii) (June 1988), and/or in similar or successor clauses in the FAR or DFARS, or in the DOD or NASA FAR Supplement, as applicable. Contractor/manufacturer is Aprisma Management Technologies, Inc. In the event the government seeks to obtain the software pursuant to standard commercial practice, this software agreement, instead of the noted regulatory clauses, shall control the terms of the government's license. Virus Disclaimer Aprisma makes no representations or warranties to the effect that the licensed software is virusfree. Aprisma has tested its software with current virus-checking technologies. However, because no antivirus system is 100 percent effective, we strongly recommend that you write-protect the licensed software and verify (with an antivirus system in which you have confidence) that the licensed software, prior to installation, is virus-free. Contact Information Aprisma Management Technologies, Inc. 273 Corporate Drive Portsmouth, NH Phone: U.S. toll-free: Web site: Agent Simulator Page 3

4 Contents Overview 6 What is the Agent Simulator?...6 How does the Agent Simulator Work?...7 What Does the Agent Simulator Include?...8 What Else Does This Book Cover?...10 Installation 11 Setting Up Your Workstation...11 Installing the Agent Simulator...12 SPECTRUM Support Customers...12 Downloading from the Web...12 Installing from CD...13 Getting Started 15 Selecting DataSets and Run Modes...15 Obtaining Additional IP Addresses...17 From NT...17 From Windows Starting the Agent Simulator...19 From the Command Line...19 From the Directory...19 Creating Simulations 20 Clone Device Mode...21 Record Device Mode...23 Preparation...24 Procedure...24 Characterize Device Mode...28 Preparation...29 Procedure...29 Agent Administration 31 Agent Simulator Page 4

5 Contents Contents Clones...31 Preparation...31 Procedure...31 Freeze Frame Playback...33 Preparation...33 Procedure...33 Single Pass Playback...36 Preparation...36 Procedure...36 Continuous Loop Playback...37 Preparation...37 Procedure...37 Animate Mode...39 Preparation...39 Procedure...39 Managing DataSets 41 Index 45 Agent Simulator Page 5

6 Overview This section describes the purpose and features of SPECTRUM s Agent Simulator. This section answers the following questions: What is the Agent Simulator? How does the Agent Simulator Work? (Page 7) What Does the Agent Simulator Include? (Page 8) What Else Does This Book Cover? (Page 10) What is the Agent Simulator? The Agent Simulator is a Microsoft Windows based application that lets you implement software simulations of network devices without having the physical devices or infrastructure in place. The simulations can be used in support of all elements in the network service life cycle (i.e., network planning, hardware design, network management design, testing, sales, installation, training, and product support). For example, network engineers can use device simulations to investigate configuration alternatives before committing to solutions. Developers of SNMP applications can use simulations to test their products against network devices they do not have in house or can not afford to obtain. Sales people can give demonstrations of their product on a laptop. Trainers can provide scenarios for classroom demonstration and permit students to gain experience without having to constantly reconfigure equipment. Support personnel can troubleshoot problems with their customer s equipment without having the equipment on hand. Agent Simulator Page 6

7 Overview How does the Agent Simulator Work? How does the Agent Simulator Work? The Agent Simulator captures device functionality through the following process: Contacts the IP address of the device. Accesses the SNMP agent via a community name match. Queries the supported MIBs to collect attribute state data. This collection of data is referred to as a frame. Creates a DataSet, which can include one frame or multiple frames. Uses a DataSet and an IP address to run any one of a variety of different device simulations. A simulation that is based on a single frame (i.e., a DataSet created by querying the MIBs only once) is considered a static simulation. The Agent Simulator uses the Clone Device Mode to create a static simulation. Because this simulation uses only one snapshot of data, the responses for a given attribute are always the same. This type of simulation may be all that you need for a particular purpose. To make a more active or perhaps more meaningful simulation, it is possible to create a multi-framed DataSet, which results in a simulation that more closely represents changing operational conditions. Two additional modes, Record Device Mode and Characterize Device Mode, produce simulations using multi-framed DataSets. Record Device Mode uses as-recorded frames in its DataSet to create a simulation. There are three possible Playback Modes as follows: Freeze Frame continually plays back a single selected frame from the DataSet. This is similar to the static simulation created in the Clone Device Mode. Single Pass runs through all of the frames in the DataSet and then plays back the last frame repeatedly. Continuous Loop plays back all of the frames of a DataSet in sequence and then repeats the entire sequence over and over. Agent Simulator Page 7

8 Overview What Does the Agent Simulator Include? Characterize Device Mode uses the as-recorded frames of a Dataset to generate a statistical DataSet module whose content represents the anticipated behavior of the device. In operation, the Characterize Device Mode uses statistics exclusively to predict attribute data, thus producing a more animated simulation. As you can see from the above descriptions, you can achieve different levels of simulation to suit different needs. Moreover, through the use of the Agent Simulator s DataSet Editor tool, you can manipulate a DataSet (i.e., simulation) to achieve more explicit results. What Does the Agent Simulator Include? There are multiple Agent Simulator packages available and each package comes with a license that is good for one year. The license controls the number of simulations you can run simultaneously on one host (10, 100, 250, 500, 1000, and Unlimited) but does not limit the number of simulations that you can create. Note: If, for example, you are going to create 1000 simulations but only run 175 at one time, the 250 license would suffice. Depending on which package you choose, the Agent Simulator can incorporate the following software functions: Clone Device is the heart of the product and it lets you create DataSets (i.e., clone devices). Agent Administration lets you run simulations. Record Device lets you collect and store MIB values for a cloned device over a specified number of time intervals. Characterize Device lets you collect data by use of statistical algorithms to manipulate the MIB data and cause the cloned device to simulate predicted data. Agent Simulator Page 8

9 Overview What Does the Agent Simulator Include? Dataset Administrator lets you obtain the DataSet properties. The Dataset Administrator is useful to copy DataSets from one machine to another to register the DataSets. It can be used to delete registered entries and DataSet files from your PC. Note: The following tools are not discussed in this document in detail. For more information, please refer to the help as specified in each individual section. DataSet Editor lets you manipulate the MIB attributes of a cloned SNMP device in order to change the behavior of the simulation. Also, you can add and delete DataSets. For more information on the DataSet Editor, refer to the on-line help by pressing SHIFT + F1, or use the context sensitive help. MIB Tools utilizes the SNMPv1 protocol to let you view MIBs for an SNMP device. With this tool it is also possible to eliminate selected MIB attributes from the DataSet. For more information on the MIB Tools, refer to the on-line help by pressing SHIFT + F1. COM Based Scripting lets you invoke and control nearly all of the operations and functionality of the Agent Simulator through the use of scripts prepared in VBScript, Visual Basic, Java, and Perl. For more information on COM Based Scripting, refer to the Scripting documentation. Agent Simulator Page 9

10 Overview What Else Does This Book Cover? The remainder of this book covers the following topics: What Else Does This Book Cover? Installation (Page 11) describes the minimum requirements for your PC, and how to download and set up the Agent Simulator. Getting Started (Page 15) provides some pointers on how to plan your simulation program. Creating Simulations (Page 20) provides step-by-step procedures for creating static, playback, and animated simulations. Agent Administration (Page 31) provides step-by-step procedures for running simulations. Managing DataSets (Page 41) describes how to use the DataSet Administrator. Agent Simulator Page 10

11 Installation This section explains how to get the Agent Simulator up and running. Getting the Agent Simulator running involves the following: Setting Up Your Workstation Installing the Agent Simulator (Page 12) Obtaining Additional IP Addresses (Page 17) Setting Up Your Workstation Listed below are the minimum hardware and software configuration requirements for the PC that you use to run the Agent Simulator. Hardware IBM compatible computer with Pentium II processor 128 MB RAM SVGA Appropriate Network Card 15 MB available space on the hard drive Software Windows Microsoft TCP/IP must be installed Windows NT SP3 or greater installed - MDAC 2.1 SP2 - Microsoft TCP/IP must be installed Agent Simulator Page 11

12 Installation Installing the Agent Simulator Installing the Agent Simulator The Agent Simulator can be installed one of the following three ways: ftp d for SPECTRUM Support Customer downloaded from the web, or installed from CD SPECTRUM Support Customers 1 Go to ftp://nms@ftp.aprisma.com/nms_data/simulator 2 Enter the password: AprismA. 3 Click on the file name sim4_0.exe. 4 Save the file to your local disk. 5 Go to the directory where the executable is stored and follow the directions for Installing from CD. Downloading from the Web 1 Go to the Simulator Group Web site. 2 Click the SPECTRUM Agent Simulator 4.0 hot link. The Save As dialog box displays. 3 Enter the name of the directory in which to install the sim4_0.exe executable. 4 Click Save. The Saving Location screen displays as the files begin copying. 5 Go to the directory where you saved the sim4_0.exe executable and follow the instructions on Installing from CD. Agent Simulator Page 12

13 Installation Installing from CD Installing the Agent Simulator 1 Double click on the setup.exe executable from the folder containing the Simulator s distribution. The Win Zip Self Extractor Screen displays. 2 Click Setup. The files begin copying, after which the SPECTRUM Agent Simulator Screen displays. 3 Click Next. The Software License Agreement Screen displays. 4 Click Yes to accept the terms of the license. The Please Select An Install Path Screen displays. 5 Enter the directory where you want the Agent Simulator installed. You may do so by clicking on Browse, and selecting your path. When you are done, click Next. The Folder Selection Screen displays. 6 Enter the Program Folder to add program icons. A name will be defaulted for you. If you do not wish to change it, simply click Next. The Enter Information Window displays. 7 Enter one of the following: a Internal Aprisma Users: Either use the license key DEMO for a 4- week trial period or generate a key using the tools at the Simulator Group s web site. b c SPECTRUM Support Customers: Enter the license key CLONE to obtain the ability to Clone device information. Contact SPECTRUM Support if you have problems with this key. SPECTRUM Level ll Toolkit Users: Enter the key contained in the file simkey. This file is found in the same folder as the Simulator Agent Simulator Page 13

14 Installation Installing the Agent Simulator distribution. Contact SPECTRUM Support if you have any problems with this key. 8 Click Next. The simulator files are copied. 9 Click OK when copying completes. Agent Simulator Page 14

15 Getting Started This section discusses how to assess your simulation needs, select the types of simulations to use, and start the Agent Simulator. The section contains the following topics: Selecting DataSets and Run Modes Obtaining Additional IP Addresses (Page 17) Starting the Agent Simulator (Page 19) Selecting DataSets and Run Modes Before you begin creating simulations, you need to decide which types of DataSets and Run Modes to use. The following paragraphs provide some assistance in this regard. 1 Clone Device Mode (Static Simulation) This mode is the simplest to run and requires the least amount of CPU and memory resources. Because there is only a single frame of data available, the simulation returns the same operational values for a given attribute each time the simulation runs. This mode would be useful when simulating a simple condition that is not dynamic. 2 Record Device Mode (Multi-Framed DataSets In General) Because this mode uses several frames of data collected over a period of time, its use is desirable when your application requires time varying data. Some examples where this mode may be useful are when showing the graphing or reporting capabilities of a network management system or when you want to recreate a particular problem environment. For example, the event that occurs when an attribute exceeds a certain threshold can be captured and replayed. This mode does require more memory resources than the Clone Device Mode and the size of the DataSet file on disk is larger. Agent Simulator Page 15

16 Getting Started Selecting DataSets and Run Modes a Record Device Mode > Freeze Frame Playback This playback is somewhat like the Clone Device Mode in the sense that data from a single frame is played back. But with this playback, you can choose which frame in the DataSet to play back. This lets you simulate certain specific network conditions. b Record Device Mode > Single Pass Playback This playback is useful to simulate applications that require time varying data over a specific time interval. c Record Device Mode > Continuous Loop Playback This playback is useful to simulate applications that require several passes through the same time interval to vary data. An example would be a repetitive test or a demonstration that attempts to run continuously. 3 Characterize Device Mode (Statistically Predicted Data) This mode is also useful to simulate applications that require time varying data. The strength of this mode over the other multi-frame modes is that the values of the data are not limited by the range of values collected for the DataSet. This mode gathers statistics on the original data and then uses a data predictor module to predict time-varying data that extends beyond the values collected. Therefore, a simulation run in this mode represents the predicted behavior of the device. The CPU and disk resource usage are more significant than the Clone Device Mode because, the Agent Simulator continuously generates new data samples for all counter attributes. Agent Simulator Page 16

17 Getting Started Obtaining Additional IP Addresses Obtaining Additional IP Addresses Each simulation you run needs its own IP Address. You need additional IP Addresses configured on your PC to run more than one simulation at a time. However, you can simulate multiple devices using only one IP Address and run one at a time. Follow the instructions for your operating system: From NT 1 From the Start menu, select Settings > Control Panels > Network. 2 Click on the Protocols tab. 3 Double-click on TCP/IP Protocol. The Microsoft TCP/IP Protocols Screen displays. 4 Click Advanced. The Advanced IP Addressing Screen displays. This allows you to add IP Addresses. 5 Click Add. The TCP/IP Address Screen displays. 6 Enter the IP Address and Subnet Mask. 7 Click Add. 8 If you wish to add more IP Addresses, repeat steps 6 and 7. Note: See your Local Network Administrator to obtain additional IP Addresses. 9 Reboot your PC. Agent Simulator Page 17

18 Getting Started From Windows Right-click the My Network Places desktop icon. A pull-down menu displays. 2 Select Properties from the pull-down menu. Obtaining Additional IP Addresses The Network and Dial Up connections dialog displays. 3 Right-click Local Area Connection. A pull-down menu appears. 4 Select Properties from the pull-down menu. The Local Area Connection Properties dialog displays. 5 Highlight the Internet Protocol selection. 6 Click Properties. The Internet Protocol (TCP/IP) Properties dialog displays. 7 Click Advanced. The Advanced TCP/IP Settings dialog displays. 8 Click Add from the IP Addresses section. The TCP/IP Address dialog displays. 9 Enter the IP Address and subnet mask. 10 Click Add. This closes the TCP/IP Address dialog and brings you back to the Advanced TCP/IP Settings dialog. 11 Repeat steps 8 through 10 until all addresses have been entered. Agent Simulator Page 18

19 Getting Started Starting the Agent Simulator Starting the Agent Simulator There are two ways to start the Agent Simulator, from the Command Line, or from the directory where it was installed. From the Command Line Select Start > Program> SPECTRUM Agent Simulator > SPECTRUM Agent Simulator. The SPECTRUM Agent Simulator Screen displays. From the Directory 1 Go to the directory where the sim4_0.exe executable was installed, C:\Program Files\Aprisma\SPECTRUM Agent Simulator\bin. 2 Double-click on the simmgr.exe executable. The SPECTRUM Agent Simulator Screen displays. Agent Simulator Page 19

20 Creating Simulations This section provides procedures for creating various types of simulations. The procedures for creating simulations are provided as follows: Clone Device Mode (Page 21) provides step-by-step procedures for creating a static simulation, which is based on a snap shot of the values in the queried MIBs. Record Device Mode (Page 23) provides step-by-step procedures for creating simulations that are based on actual MIB attribute values recorded at different time intervals. Characterize Device Mode (Page 28) provides step-by-step procedures for creating animated simulations that are based on statistically predicted values of MIB attributes. Tip: If this is your first time using the Agent Simulator or if you are unfamiliar with its windows and included fields, refer to the online help or context sensitive help by pressing SHIFT + F1. Agent Simulator Page 20

21 Creating Simulations Clone Device Mode Clone Device Mode The SNMP Agent Cloning Window is shown in Figure 1. You can create a static simulation by cloning a device using a single snap shot of the MIB attributes. The following paragraphs describe this process. Figure 1: SNMP Agent Cloning Window Agent Simulator Page 21

22 Creating Simulations Clone Device Mode Access the Clone Device tab from the SNMP Agent Simulator Window, shown in Figure 1, and perform the following steps. 1 Enter the IP Address of the device to be cloned in the top-most Agent IP Address field. 2 Click Add. 3 If you wish to name your DataSet, highlight the IP address in the IP s to Clone Window. This will enable the DataSet Name field. 4 Click in the DataSet Name field and enter a unique name. If you do not wish to enter a name, one will be assigned based on the information from the device. 5 Click Start. Note: You can also clone a range of IP Addresses by clicking the Range button and entering the starting and ending IP Addresses in the upper and lower windows. Those devices that were successfully cloned will show up with a green icon next to them in the IP s to Clone Window. Agent Simulator Page 22

23 Creating Simulations Record Device Mode Record Device Mode Access the Record Data tab from the SNMP Agent Simulator Window as shown in Figure 2. Record Device mode lets you create three types of simulations, which are based on multi-frame DataSets; Freeze Frame, Single Pass, and Continuous Loop. The procedures for each are described later in the Agent Administrator section. Figure 2: SNMP Agent Recording Window Agent Simulator Page 23

24 Creating Simulations Preparation Record Device Mode Before recording a device, it must first be cloned using the procedure described in Clone Device Mode (Page 21). Procedure The following steps are used to record data: 1 Enter the Agent IP address into the Record Data tab. 2 Click the Telephone icon. The light turns green when the device has been contacted. 3 Click the Key icon. The Select Name of Dataset to Open (Figure 3) displays. 4 Highlight the appropriate DataSet name. 5 Click Select. The Select Name of Dataset to Open Window exits. The Record Data tab displays. Agent Simulator Page 24

25 Creating Simulations Figure 3: Select Name of Dataset to Open Record Device Mode Note: For information on the other buttons in Figure 3, refer to Managing DataSets on Page Select one of the Counter Search Variables. a b c MIB-2 only shows counters from the MIB-2 MIB Private shows all of the enterprise MIB counters All MIBS shows both MIB-2 and enterprise-specific MIBs 7 Change the Data Collection information as needed, or you can choose to select the default values. Agent Simulator Page 25

26 Creating Simulations Record Device Mode a b c Number of Samples is the number of samples you wish to collect. The default value is 100. Interval is the amount of time, in seconds, between polling cycles. The default value is 5 seconds. Number Sampled is a read-only field which displays the number of samples currently recorded. 8 Click Find Counters. The Find Counters Variables Window (Figure 4) displays. 9 Select the counter attributes to monitor from the Counter Variables List. You can choose to select all by hitting Select All. If you have a large number of attributes and only wish to monitor a few of them, you can select just those you will need. To the right, you can see the number of Variables Accessed and the Counters Found. The Counters Selected field displays the number of counters that you choose to monitor. 10 Click Apply. The Find Counters Screen closes. The Record Data tab displays. 11 Click Collect Data. When this finishes, the DataSet is complete. Agent Simulator Page 26

27 Creating Simulations Record Device Mode Figure 4: Find Counters Agent Simulator Page 27

28 Creating Simulations Characterize Device Mode Characterize Device Mode Access the Characterize Device tab from the SNMP Agent Simulator Window as shown is shown in Figure 5. You create an animated simulation by a process known as characterizing a device. This section describes this process. Figure 5: SNMP Agent Characterization Window Agent Simulator Page 28

29 Creating Simulations Preparation Characterize Device Mode Before recording a device it must first be cloned using the procedure described in Clone Device Mode (Page 21). Procedure The following steps are used to characterize data: 1 In the Characterize Device tab, enter the IP address. 2 Click the Telephone icon. The light turns green when the device has been contacted. 3 Select one of the Counter Search Variables. a b c MIB-2 only shows counters from the MIB-2 MIB Private shows all of the enterprise MIB counters All MIBS shows both MIB-2 and enterprise-specific MIBs 4 Change the data collection information as needed. a b c Number of Samples is the number of samples you wish to collect. The default value is 100. Interval is the amount of time, in seconds, between polling cycles. The default value is 5 seconds. Number Sampled is a read-only field which displays the number of samples currently recorded. 5 Click Find Counters. The Save As dialog box appears. 6 Enter or select the file name. 7 Click Save. If a file with that name already exists, you will be asked if you want to over write it. Select either Yes or No. Agent Simulator Page 29

30 Creating Simulations Characterize Device Mode The Find Counters Variables Window (Figure 4) displays. 8 Select the counter attributes to monitor from the Counter Variables List. You can choose to select all by hitting Select All. If you have a large number of attributes and only wish to monitor a few of them, you can select just those you will need. To the right, you can see the number of Variables Accessed and the Counters Found. The Counters Selected field displays the number of counters that you choose to monitor. 9 Click Apply. The Find Counters Screen closes. The Characterize Data tab displays. 10 Click Collect Data. When this finishes, the DataSet is complete. Agent Simulator Page 30

31 Agent Administration This section allows you to run the simulation. Clones You can run a clone simulation once the device has been cloned. A clone will show a snapshot of how the device looked at the moment the device was cloned. Preparation Before you can simulate a device, it must first be cloned, recorded or characterized following the procedures from Creating Simulations (Page 20). Procedure Access the Agent Administration tab (Figure 6 (Page 32)) from the SNMP Agent Simulator Window, and perform the following steps. 1 Click Start. The Select Simulator Parameters window (Figure 7 (Page 34)) displays. This view provides a list of DataSets, by name, that you have simulated. 2 Highlight the DataSet you wish to run. 3 Select a Run Mode of Static. 4 Click OK. The Select Simulator Parameters Window closes. The Agent Administration tab displays. Agent Simulator Page 31

32 Agent Administration Clones Figure 6: Agent Administration Window Agent Simulator Page 32

33 Agent Administration Freeze Frame Playback Freeze Frame Playback Freeze frame playback is very similar to that of a clone in that it plays one frame continuously. The difference is you get to choose the frame to play. Preparation Prior to using the freeze frame playback mode, the DataSet must be captured using the Record Device Mode (Page 23). Procedure Access the Agent Administration tab (Figure 6 (Page 32)) and perform the following steps. 1 Click Start. The Select Simulator Parameters window (Figure 7 (Page 34)) displays. This view provides a list of DataSets, by name, that you have simulated. 2 Select the DataSet from the list of available datasets. 3 Select a Run Mode of PlayBack. 4 Highlight the IP Address from the list of available IP Addresses. 5 Click OK. The Select Simulator Parameters Window closes. The Agent Administration tab displays, Agent Simulator Page 33

34 Agent Administration Figure 7: Select Simulator Parameters Freeze Frame Playback Click the Video Recording icon. The Playback Console Screen (Figure 8) displays. Agent Simulator Page 34

35 Agent Administration Freeze Frame Playback Figure 8: PlayBack Console Select a Run Mode of Freeze Frame. 8 Click Apply. 9 From here, you can run the simulation, fast forward, rewind, pause and stop by using the Execution Controls. Agent Simulator Page 35

36 Agent Administration Single Pass Playback Single Pass Playback Single pass playback will play back the simulation and then stay on the last frame. Preparation Prior to using the single pass playback mode, the DataSet must be captured using the Record Device Mode (Page 23). Procedure Access the Agent Administration tab (Figure 6 (Page 32)) and perform the following steps. 1 Click Start. The Select Simulator Parameters window (Figure 7 (Page 34)) displays. This view provides a list of DataSets, by name, that you have simulated. 2 Select the data set from the list of available data sets. 3 Select a Run Mode of PlayBack. 4 Highlight the IP Address from the list of available IP Addresses. 5 Click OK. The Select Simulator Parameters Window exits. The Agent Administration tab displays. 6 Click the Video Recording icon. The Playback Console Screen (Figure 8) displays. 7 Select a Run Mode of Single Pass. 8 Click Apply. 9 From here, you can run the simulation, fast forward, rewind, pause and stop by using the Execution Controls. Agent Simulator Page 36

37 Agent Administration Continuous Loop Playback Continuous Loop Playback Continuous loop playback will go through all the frames of data and then play it back from the beginning again until you hit stop. Preparation Prior to using the continuous loop playback mode, the DataSet must be captured using the Record Device Mode (Page 23). Procedure Access the Agent Administration tab (Figure 6 (Page 32)) and perform the following steps. 1 Click Start. The Select Simulator Parameters window (Figure 7 (Page 34)) displays. This view provides a list of DataSets, by name, that you have simulated. 2 Select the DataSet from the list of available data sets. 3 Select a Run Mode of PlayBack. 4 Highlight the IP Address from the list of available IP Addresses. 5 Click OK. The Select Simulator Parameters Window exits. The Agent Administration tab displays. 6 Click the Video Recording icon. The Playback Console Screen (Figure 8) displays. 7 Select a Run Mode of Continuous Loop. 8 Click Apply. 9 From here, you can run the simulation, fast forward, rewind, pause and stop by using the Execution Controls. Agent Simulator Page 37

38 Agent Administration Continuous Loop Playback Figure 9: SNMP Statistics If you select a running agent, the SNMP Statistics Window will appear. This window displays the SNMP communication statistics. It counts the number of gets, sets, and getnexts of the running agents. This can be used with any type of DataSet (clone, record, or characterization). The purpose of this screen is to show the clients of the running agents. This is useful to notify the clients in case the simulation is being shutdown. Agent Simulator Page 38

39 Agent Administration Animate Mode Animate Mode This mode allows you to play back a characterized device. It differs from a recorded device in that the simulation will predict future data based on statistics gathered during the characterization process. Preparation The device must be characterized (see Characterize Device Mode on Page 28) before you can animate it. Procedure Access the Agent Administration tab (Figure 6 (Page 32)) and perform the following steps. 1 Click Start. The Select Simulator Parameters window (Figure 7 (Page 34)) displays. This view provides a list of DataSets, by name, that you have simulated. 2 Select the DataSet from the list of available data sets. 3 Select a Run Mode of Animate. This brings up Figure 10, Finding the.dat File, which displays a list of.dat files. 4 Select a.dat file and click Open. The Finding the.dat File window closes. The Select Simulator Parameters Window displays. Agent Simulator Page 39

40 Agent Administration Animate Mode Figure 10: Finding the.dat File 5 Since you have chosen animate, the Zero Counters option is now highlighted. This tells the algorithm to restart the count from zero. If not selected, the counters will start from the point at where you collected the data. 6 Click OK. The Agent Administration tab displays. 7 Enter the IP Address to use for the simulation. This is NOT the IP address of the device, but rather an IP from your machine. 8 This device can now be modeled in SPECTRUM using the IP address you assigned to the device. Agent Simulator Page 40

41 Managing DataSets This section describes how to manage DataSets using the DataSet Administrator. Figure 11 displays the DataSet Administrator Window. You can get to this window by selecting File > DataSets from the Agent Administration Window (Page 32). The DataSet Administrator is used to manage DataSets on a machine. With this tool it is possible to add, and delete DataSets as well as view and change properties. Figure 11: DataSet Administrator Agent Simulator Page 41

42 Managing DataSets Animate Mode SETUP is used to view or modify the registration of DataSets (see Figure 12 below). This might be invoked if you want to register a new name to an existing DataSet file (*.mdb). Figure 12: Simulator DataSet Setup SELECT selects the highlighted dataset. IMPORT displays the Select Log File to Import window. Datasets may be created from text files using this feature. There are two file formats currently supported: - Output of Java MibTools - Output of SNMP Walk Utility distributed through SPECTRUM Support Agent Simulator Page 42

43 Managing DataSets Animate Mode This is useful when it is not possible for a customer to obtain or install the SPECTRUM Agent Simulator but has access to one of the other tools mentioned above. COMPACT compacts the dataset. As datasets are used (opened, closed, modified, saved), they will grow in size. You may want to compact the datasets in order to save disk space. The space savings may be up to 25 %. ADD is used when copying a DataSet from one machine to another. Before the DataSet can be run in a simulation, it must be registered on the local machine using the add command. DELETE allows you to delete a DataSet that is no longer needed. This deletes the DataSet registration on the local machine and optionally deletes the.mdb file. PROPERTIES displays the information at the bottom of Figure 13. This feature is used to display all the properties of a DataSet. The detailed information in this section includes information on when and where the DataSet originated as well as device information like the system descriptor and community name. In addition, the number of frames contained in the DataSet is displayed. Agent Simulator Page 43

44 Managing DataSets Figure 13: Dataset Administrator - Properties Animate Mode Agent Simulator Page 44

45 Index A Agent Administration 8, 31 Agent Administration Window 32 Animate Mode 39 Preparation 39 Procedure 39 C Characterize Device 8 Characterize Device Mode 8, 16, 28 Preparation 29 Procedure 29 Statistically Predicted Data 16 Clone Device 8 Clone Device Mode 7, 15, 21 Static Simulation 15 Clones 31 Preparation 31 Procedure 31 COM Based Scripting 9 Continuous Loop 7 Continuous Loop Playback 37 Preparation 37 Procedure 37 D DataSet Administrator 41 Dataset Administrator 9 DataSet Editor 9 F Find Counters Window 27 Finding the.dat File Window 40 Freeze Frame 7 Freeze Frame Playback 33 Preparation 33 Procedure 33 H Hardware 11 I Installation 11 Downloading from the Web 12 Installing from CD 13 SPECTRUM Support Customers 12 Installing the Agent Simulator 12 L License 8 M Managing DataSets 41 MIB Tools 9 MIBs 7 Agent Simulator Page 45

46 Index O Obtaining Additional IP Addresses 17 From NT 17 From Windows P PlayBack Console 35 PlayBack Console Window 35 R Range Button 22 Record Device 8 Record Device Mode 7, 15, 16, 23 Continuous Loop Playback 16 Freeze Frame Playback 16 Multi-Framed DataSets 15 Preparation 24 Procedure 24 Single Pass Playback 16 Index SNMP Agent Cloning Window 21 SNMP Agent Recording Window 23 SNMP Statistics 38 SNMP Statistics Window 38 Software 11 Starting the Agent Simulator 19 From the Command Line 19 From the Directory 19 V Video Recording Icon 34 S Select Name of Dataset to Open Window 25 Select Simulator Parameters Window 34 sim4_0.exe executable 12 Simulator DataSet Setup 42 Single Pass 7 Single Pass Playback 36 Preparation 36 Procedure 36 SNMP Agent Characterization Window 28 Agent Simulator Page 46