1. The MIMIC Wizards are easy-to-use GUI front-ends to the most common or most difficult tasks in MIMIC.

    Whenever you see the Youtube logo YouTube you'll be able to view a video for that section.

  2. The MIB Wizard is designed to easily import and compile new MIBs for use with MIMIC. It is a user-friendly, graphical or command-line front-end to the MIB compilation process and MIMIC Compiler.

    The MIB Wizard lets you select a set of MIBs to import, which together with a set of existing MIBs will be compiled. The Wizard resolves all dependencies among the MIBs and compiles them in the correct order.

    In this dialog, select the MIBs you want to import into MIMIC.

    MIB Wizard: Select MIBs

    Figure 1: MIB Wizard: Select MIBs

    The file selection dialog displayed by the MIB File Browse... button lets you select one or more MIB files to import.

    Pick an enterprise name in the Enterprise field. This should be a short name for the enterprise of your enterprise-specific MIBs. For example, you can browse the existing enterprise names with the Browse... button.

    By default, the MIB Wizard will automatically skip over MIBs that are already compiled into MIMIC. The Overwrite existing MIBs field can be left unchecked, unless you indeed want to overwrite MIBs that were already compiled into MIMIC.

    You need to click <<Add to add the MIBs to the list.

    You can edit the list of MIBs further with the Delete button, and even edit MIB files with the Edit button.

    In this dialog, select the existing (imported into MIMIC) MIBs you want to recompile. You need to do this if a previous compile failed. This allows for an iterative process until the MIB compiles correctly.

    MIB Wizard: Existing MIBs

    Figure 2: MIB Wizard: Existing MIBs

    If you cannot use the MIMICview GUI to import and compile your MIBs, you can use the command-line as follows:

    % ./mibwiz.sh --nogui --help
    Usage:
    --nogui                 No GUI
    [--help]                Show this usage help
    [--import file|dir]     Import file or all files in directory
    [--overwrite]           Overwrite files if they already exist
    [--ent enterprise]      Import into specified enterprise
    [--existing file]       Compile existing MIB file
    ERROR - user specified --help, printed usage
    
    % ./mibwiz.sh --nogui --import /tmp/mib-force/mibs/force10 --ent force10
    INFO  Parsing input files for MIB dependencies. Please wait...
    WARN  skipping MIB IEEE8021-PAE-MIBrce10/IEEE8021-PAE-MIB.txtVATE-MIB.txt
     imported file /tmp/mib-force/mibs/force10/IEEE8021-PAE-MIB.txt
     was already compiled before in the standard area
          Reading /tmp/mib-force/mibs/force10/F10OS-OUTBOUNDTELNET-PRIVATE-MIB.
          Reading /tmp/mib-force/mibs/force10/SFTOS-PORTSECURITY-PRIVATE-MIB.tx
    WARN  skipping MIB MGMD-STD-MIBs/force10/MGMD-STD-MIB.txtB.txtMIB.txt.txt
     imported file /tmp/mib-force/mibs/force10/MGMD-STD-MIB.txt
     was already compiled before in the standard area
          Reading /tmp/mib-force/mibs/force10/SFTOS-QOS-DIFFSERV-PRIVATE-MIB.tx
    WARN  skipping MIB LLDP-MIB/mibs/force10/LLDP-MIB.txtG-MIB.txt
     imported file /tmp/mib-force/mibs/force10/LLDP-MIB.txt
     was already compiled before in the standard area
          Reading /tmp/mib-force/mibs/force10/SFTOS-QOS-DIFFSERV-EXTENSIONS-MIB
          Reading /tmp/mib-force/mibs/force10/F10OS-DENIALOFSERVICE-PRIVATE-MIB
    INFO  Importing /tmp/mib-force/mibs/force10/f10-products.mib
    ...
      98% Compiling MIB force10/SFTOS-QOS-ACL-MIB.txt (58 out of 59)
    INFO  10/07.10:04:20 - MIMIC Compiler v20.00
     built Sep 24 2020 11:52:41
    INFO  10/07.10:04:20 - Evaluation license, expires 11/4/2020
    INFO  10/07.10:04:20 - Compiling input file : mibs/force10/SFTOS-QOS-ACL-MIB.txt
    INFO  10/07.10:04:20 - loading mib : force10/SFTOS-QOS-ACL-MIB
    INFO  10/07.10:04:20 - done
    
     100% Compiling MIB force10/f10-ss-chassis.mib (59 out of 59)
    INFO  10/07.10:04:20 - MIMIC Compiler v20.00
     built Sep 24 2020 11:52:41
    INFO  10/07.10:04:20 - Evaluation license, expires 11/4/2020
    INFO  10/07.10:04:20 - Compiling input file : mibs/force10/f10-ss-chassis.mib
    INFO  10/07.10:04:20 - loading mib : force10/F10-S-SERIES-CHASSIS-MIB
    INFO  10/07.10:04:20 - done
    
  3. The Discovery Wizard allows you to create a network simulation by discovering SNMP Agents on a network and record them as simulations which can be played back later. It is a front-end to the MIMIC Recorder, designed to record large networks.

    In addition to recording from a live network, it can create network simulations from a group of previously recorded walkfiles.

    Check out this 2-minute YouTube video for a quick intro.

    In this dialog, you can create a new session or select an existing session that you wish to use. The Discovery Wizard allows you to interrupt and continue discovery sessions. A new session will be useful to run the discovery at a remote site without creating the simulation, then continue and create the simulation at your local site by selecting that existing session.

    Create New Session: perform a fresh discovery and record the simulation

    Select Existing Session: resume the discovery or recreate the simulation

    You can annotate your discovery in the Comments field.

    Discovery Wizard: Select Session

    Figure 3: Discovery Wizard: Select Session

    In this dialog, select the discovery method. The Discovery Wizard supports three methods to generate the network simulation.

    Discovery Wizard: Discovery Methods

    Figure 4: Discovery Wizard: Discovery Methods

    Choose method 1 Traverse IP address ranges on live network, if you wish to discover SNMP Agents on the live network within specified ranges of IP addresses. This is useful to limit the discovery to a very specific set of addresses.

    Choose method 2 Use seed address ranges on live network, if you wish to discover SNMP Agents on the live network from the tables maintained by special "seed" agents (routers, hubs, etc) within the specified ranges of IP addresses. You may select any combinaton of the ARP, ROUTE, IP Address, TCP Connections, CDP Cache, LLDP Remote and OSPF tables. Discovery will traverse those MIB tables, and try to probe addresses pointed to by these tables. This method is useful if you have a large network, and only know addresses of the main routers.

    NOTE: the TCP Connections table could be very large, and point to many systems to continue discovery.

    NOTE: by default, the wizard will detect IP aliases of devices (multiple network interfaces), and will record only one instance of the agent through one of the interfaces. This will generate a correct simulation, assuming that the data presented through each of the interfaces is the same. Some devices present different MIBs through different interfaces, if so, you can select the option Record IP Aliases to record agents on all interfaces.

    Choose method 3 Import existing walkfiles, if you wish to create the network simulation from previously recorded walkfiles. This allows you to import walkfiles into MIMIC and generates a network simulation from them.

    In this dialog, enter the IP address ranges. If the Discovery method of "IP Address ranges" was chosen, these ranges will be used to discover the actual SNMP Agents. If the Discovery method of "Seed address ranges" was chosen, these ranges will be used to discover the seed agents. The chosen tables from these discovered seed targets will then be used for discovering the actual SNMP Agents.

    Discovery Wizard: Seed Addresses

    Figure 5: Discovery Wizard: Seed Addresses

    Rather than inputting the addresses by hand, you can feed a file containing the addresses in the From File... dialog. The file needs to have one address or one address range per line.

    In this dialog, you may also choose the number of simultaneous Pings to use for the discovery process.

    In this step you may optionally specify Include and Exclude patterns. These patterns will be used to determine if an IP address from the specified ranges will be included or excluded.

    Discovery Wizard: Filters

    Figure 6: Discovery Wizard: Filters

    The patterns can use the special characters "*" and "?". The "*" would match 1, 2 or 3 digits. The "?" would match a single digit.

    The filter script lets you define a TCL script, which will dynamically be loaded into the Wizard to do advanced filtering of discovered devices. This lets you do incremental discovery, for example. MIMIC ships with sample filter scripts (scripts/discwiz_filter*.mtcl).

    In this dialog, you may enter the SNMP parameters to use.

    Discovery Wizard: SNMP Parameters

    Figure 7: Discovery Wizard: SNMP Parameters

    In the General tab you may change the Timeout (in msecs) and Retries. You may specify any number of ports, which will be probed in turn for each target, until one of them returns a valid response. You can select any of the supported SNMP versions, which will be used in turn for each of the selected ports for each target.

    In the SNMPv1/v2c tab you specify the read community names to try. The default community is "public".

    In the SNMPv3 tab you specify the user names and contexts to try.

    In this dialog, you may specify the options to be used with the MIMIC Recorder.

    Discovery Wizard: Recorder Options

    Figure 7: Discovery Wizard: Recorder Options

    Optionally, specify a Start Oid. By default, the Recorder walks the entire MIB exported by the target agent. This options lets you specify the starting OID to start recording. This is useful if you want to restart a recording that previously failed for any reason.

    Optionally, specify the Root Oids. By default, the Recorder walks the entire MIB exported by the target agent. This options lets you specify MIB subtrees to record. This option is useful if you are interested in only a small part of the MIB.

    Optionally, specify the Exclude Oids. By default, the Recorder walks the entire MIB exported by the target agent. This option is useful if you want to exclude parts of the MIB from being simulated. For example, some MIB tables (such as RMON history tables) can be extremely dynamic (and large). Other tables implement proprietary retrieval schemes (e.g., getTable). Some agents even crash when you access certain parts of the MIB. This option allows to skip these MIB subtrees.

    Optionally, specify the Max Table size. Selecting this option limits the size of large tables to the specified number of table entries. It applies both at discovery time, where only the selected number of entries are traversed, and at simulation time, where only the selected number of entries are simulated. This is useful for agents with large tables, such as RMON tables, etc.

    Choose the Simulation Method. This option allows two choices: random or constant, to specify which of two simulation methods to use for counter simulations.

    Optionally, choose to Create Source. Selecting this option generates the simulation source file so that you can change the simulation later on.

    Selecting the No Simulation option skips the simulation phase and only generates a walk file. This is useful for example if you are at a remote site, and want to generate the simulation later.

    Selecting the Edit target list before recording allows you edit the list of targets before actually performing the recording.

    When you press Next> the discovery starts. A Log Windows displays results of the discovery and the progress bar shows the progress.

    Discovery Wizard: Progress

    Figure 8: Discovery Wizard: Progress

    Discovery Wizard: Log

    Figure 9: Discovery Wizard: Log

    This dialog allows you to specify a group of previously recorded walkfiles to import into the Discovery Wizard in lieu of live recording of devices.

    In this dialog, the discovered SNMP Agents are displayed in a listbox. You may, optionally, delete some of them.

    Discovery Wizard: Discovered Targets

    Figure 10: Discovery Wizard: Discovered Targets

    To record the discovered SNMP Agents, press Next>. The Log Window displays the results of each recording.

    In real-time, the Status column shows the current status of each target, one of to be recorded, recording or recorded.

    The Discovery Wizard allows to record agents at one site, then resume the simulation creation at another. This is accomplished by selecting No Simulation in the original session, then resuming it. In this dialog, the recorded SNMP Agents in a resumed session are displayed in a listbox. You may, optionally, exclude some of them by deleting them from the list. Simulations will not be regenerated for excluded targets.

    To specify recorder options for regenerating simulations, press Next>.

    Once the targets are recorded, they are categorized into the device catalog in a new category under Devices -> Discovered with the same name as the discovery session named above.

    Then you can save the recorded lab configuration so that you can later load it into the Simulator.

    In this dialog, the summary of user inputs for the last interrupted session as well as state of the engine at which the engine was interrupted is shown.

    Discovery Wizard: Interrupted Session

    Figure 11: Discovery Wizard: Interrupted Session

    The wizard continuously checkpoints its state, so that on any interruption it can continue where it left off, as if it had never been interrupted.

  4. The Snapshot Wizard makes it easy to take multiple snapshots of a device over time and automatically change the simulation to account for changes. This is specially useful if you take an initial snapshot, make some changes on your device (reconfigure it, such as take cards in/out of service, make operational changes such as higher loads, etc), then take another snapshot after the change. The Wizard will automatically detect the changes (different MIB object values, new/deleted table entries, different counter rates, etc), and create timer scripts to change the simulation. In addition to manual snapshots (like a camera click), you can also take periodic snapshots, such as every hour, to capture long-term trends.

    You can create a new snapshot series, or add new snapshots to an existing series. To create a new snapshot, you need to give it a new name that you can remember, preferably a short word or phrase, like test1, or cisco5k-under-stress.

    Snapshot Wizard: Option

    Figure 12: Snapshot Wizard: Option

    You can create a new simulation, apply the snapshots to an existing simulation, or copy an existing simulation and apply the snapshots to it. To create a new simulation, you need to give it a new name that you can remember, preferably a short word or phrase, like test1, or cisco5k.

    Snapshot Wizard: Simulation

    Figure 13: Snapshot Wizard: Simulation

    Specify the mandatory target parameters to be recorded. See the MIMIC Recorder Guide for more details.

    Snapshot Wizard: Target

    Figure 14: Snapshot Wizard: Target

    These optional parameters modify the default recording. See the MIMIC Recorder Guide for more details.

    Snapshot Wizard: Recorder

    Figure 15: Snapshot Wizard: Recorder

    Once you click Next, the MIMIC Recorder will record the target. To continue, dismiss the log viewer window that pops up.

    Snapshot Wizard: Log

    Figure 16: Snapshot Wizard: Log

    From here on you will take snapshots of the device at different times. But, your snapshots may not need to record the entire device, if you know that the changes will be confined to a particular area. In this dialog you can impose constraints on the snapshots.

    Snapshot Wizard: Constraints

    Figure 17: Snapshot Wizard: Constraints

    These optional constraints further restrict all subsequent snapshots. If the snapshot is of the entire MIB, that is very expensive both in terms of the amount of data, and the computing to detect differences. It is usually better to concentrate on MIB subtrees (Root), and/or exclude large MIB subtrees.

    You can take an immediate snapshot or schedule periodic snapshots.

    Snapshot Wizard: Take Snapshots

    Figure 18: Snapshot Wizard: Take Snapshots

    If you select Immediate Snapshot, when you press the Record... button the snapshot will happen immediately. This is equivalent to pressing the snapshot button on a camera. Optionally, you can input an informative Comment for your snapshot.

    When you choose Scheduled Snapshots, you can use the Start Time frame and Take Snapshots frame to schedule your periodic snapshots.

    This dialog allows you to edit the sequence of snapshots you took. Once you click Finish, a script will be created in the simulation directory to transition the simulation through the desired changes.

    You need to select at least 2 walkfiles to create change script(s).

    Snapshot Wizard: Create Script

    Figure 19: Snapshot Wizard: Create Script

    By default, after you apply a snapshot series to a simulation device, all changes occur automatically in the background at the same pace as the recorded device. The change script(s) are change.{0,1,2...}.mtcl file(s) in the same device simulation directory, like these,

    $ ls data/sim/procurve530/
    BRIDGE-MIB                       IPV6-MIB
    change.0.mtcl                    microsoft-LanMgr-Mib-II-MIB
    change.1.mtcl                    OLD
    dev.cfg                          RFC1213-MIB
    HOST-RESOURCES-MIB               SFLOW-MIB
    hp-HP-PROCURVE-WLAN-AP-MIB       SNMP-FRAMEWORK-MIB
    hp-HP-PROCURVE-WLAN-AR-MIB       SNMP-MPD-MIB
    hp-HP-PROCURVE-WLAN-SYSTEM-MIB   SNMP-USER-BASED-SM-MIB
    hp-HP-WLAN-SFLOW-EXTENSIONS-MIB  SNMPv2-MIB
    IF-MIB                           SNMP-VIEW-BASED-ACM-MIB
    invoke.0.mtcl                    start+snapshot.mtcl
    invoke.1.mtcl                    stop+snapshot.mtcl
    invoke.2.mtcl                    TCP-MIB
    IP-FORWARD-MIB                   UDP-MIB
    $
    
    .

    To manually apply the changes at your own pace, you can use MIMICShell to invoke the change script(s), such as this,

    $ ./mimicsh --nogui --agent 4 --script ~/mimic/data/sim/procurve530/change.1.mtcl
    
    .

    You can also copy the change.*.mtcl script(s) to the private area's scripts directory and use the Agent->Script window to invoke the change script(s).

  5. The Trap Wizard allows you to capture a series of traps from a target device and creates scripts that will play them back in the Simulator. This consist of 2 distinct recording processes: first to record the MIB of the live target device to create the base simulation, then to capture the generated traps from the device.

    While the initial MIB recording is a one-time process, the capture of traps can be done multiple times. You could for example cause your device to generate a sequence of traps for a certain reason (eg. some abnormal condition), verify this is what you captured, then generate another sequence for the restoration to normal operations.

    You can further use the MIMICView Agent->Generate Traps... dialog to manually generate any trap for a group of agents.

    Check out this 3-minute YouTube video for a quick intro.

    The end-result of the Trap Wizard is a Trap Series that will be played back in a simulation. This playback is implemented as a group of Timer Scripts that will be invoked upon starting an agent that runs the simulation.

    Trap Wizard: Options

    Figure 20: Trap Wizard: Options

    This dialog lets you start a fresh series or modify an existing one. To create a new series, you need to give it a new name that you can remember, preferably a short word or phrase, like test1, or cisco5k-booting.

    The trap series will be applied to a simulation. This dialog lets you specify a fresh simulation, an existing one, or a copy of an existing one. If you create a new simulation, the MIMIC Recorder will be invoked to create it. If you copy an existing simulation, the original is not touched.

    Trap Wizard: Simulation

    Figure 21: Trap Wizard: Simulation

    If you selected to create a new simulation, then this dialog lets you specify the mandatory target parameters, such as its address, version of SNMP, etc. These parameters will be used by the MIMIC Recorder to record the target.

    Trap Wizard: Target

    Figure 22: Trap Wizard: Target

    These optional parameters modify the recording of the MIB. See the MIMIC Recorder Guide for more details.

    Trap Wizard: Recorder

    Figure 23: Trap Wizard: Recorder

    Once you click Next, the MIMIC Recorder will record the target. Dismiss the Log Windows to continue.

    Trap Wizard: Log

    Figure 24: Trap Wizard: Log

    You can select to capture traps live, by invoking the Trap Recorder with these optional parameters to control the capture of traps. See Record Traps for more details.

    Trap Wizard: Capture

    Figure 25: Trap Wizard: Capture

    Instead of a live capture you can record from a PCAP file that contains captured TRAP messages. Through this wizard, all TRAP messages in this PCAP are recorded, but the trapper tool has filtering options. If you want to filter certain traps only, then you need to either use the trapper from the command line, or filter your PCAP in a utility like wireshark.

    Otherwise, if you previously recorded traps with the Trap Recorder, then the wizard can read the Trap Recorder output. This way, you can deploy the Trap Recorder remotely, capture traps, and import them back into the MIMIC installation.

    This dialog is the heart of the wizard, and lets you capture multiple sequences of traps for this series. The capture can be delayed, and its duration controlled. When you press the Capture... button, then the capture starts and captured traps are displayed in real-time. The capture stops when you press the Interrupt button or when the Duration expires.

    Trap Wizard: Series

    Figure 26: Trap Wizard: Series

    The traps displayed in this dialog are all the captured traps, whether deleted or not. You can delete entire sequences / individual traps in the next dialog, and select / deselect them to be generated.

    Once you are done with the capture, you can edit the trap series that you want to simulate with this dialog.

    Trap Wizard: Edit Series

    Figure 27: Trap Wizard: Edit Series

    You can select the sequences and individual traps that you want the wizard to generate scripts for. Click on a node with a checkbox to select/deselect the item (and it's children). For example, selecting a sequence selects all the traps in the sequence.

    You can delete sequences that you don't want to consider in the future, eg. if the sequence is empty. Click on a sequence, and press the >>Delete button.

    You can edit parameters of sequences (Time, Comment) and traps (Time, Version). Click on the node, then press the Edit button to change the value. Changed items are shown in red.

    The Up and Down buttons move the selected trap up or down in the series, thus changing the order of the generated traps.

    When the scripts are created, you can play back the traps on your simulated device.

    Trap Wizard: Play Back

    Figure 28: Trap Wizard: Play Back

    When you start an agent with that simulation, you can control the generation of the traps with the Agent->Trap Series... dialog.

    Trap Wizard: Run

    Figure 29: Trap Wizard: Run

  6. The Simulation Wizard is designed to easily create a basic simulation from a set of walkfiles and MIBs. It is a user-friendly, graphical front-end to the mib2walk utility, and the Record from File functionality.

    Through a graphical interface, you define instances and values for each of the MIB objects and save them in a walkfile, which is fed to the MIMIC Recorder to create the simulation.

    By loading an optional walkfile, you seed the simulation with instances and values of your MIB objects. This walkfile can be from a previous live recording with the MIMIC Recorder, or saved by the Simulation Wizard.

    Simulation Wizard: Walkfile

    Figure 30: Simulation Wizard: Walkfile

    If you load more than one walkfile, they will be merged. This is useful if you have walkfile fragments for distinct (disjoint) parts of your MIB.

    Press Add... to add walkfiles from a file browser dialog. Select a walkfile and press Delete to delete it from the list.

    If you don't have a walkfile, you will have to specify instances and values for MIB objects you want to simulate.

    In this dialog, select the MIBs you want in your simulation. If you loaded a walkfile in the previous dialog, the set of MIBs is detected from that walkfile.

    Simulation Wizard: MIBs

    Figure 31: Simulation Wizard: MIBs

    You can incrementally add more MIBs to your simulation. Start with a small set, e.g., just RFC1213-MIB. Then add more MIBs as you complete the simulation.

    Press Add... to add MIBs from a MIB selection dialog. Selecting an enterprise and clicking Ok in the Browse MIB Directory adds all the MIBs in that enterprise to the list. Select one or more MIBs and press Delete to delete them from the list.

    The Simulation Wizard can seed all objects for which you don't specify values with default values. To accomplish this, check off the Use Default Values button. Then enter the default values you want for each of the types of MIB objects. These values will be used only if the object does not already have a DEFVAL clause defined in the MIB.

    For tables, a single instance will be created with an index whose value is determined by the default value of its type.

    Simulation Wizard: Defaults

    Figure 32: Simulation Wizard: Defaults

    In this step you instantiate MIB objects and successively assign them values.

    Simulation Wizard: Edit

    Figure 33: Simulation Wizard: Edit

    For all tables, you need to instantiate rows in the table. For all MIB objects that are not Counters, MIMIC creates a simulation that returns the value that you set here. For Counter objects, MIMIC generates a rate-based simulation, based on the value you give to the object, and the current value of sysUpTime.0:

    rate = value(object) / value(sysUpTime.0)

    We recommend that you save the walkfile, since you can later load it again into the Wizard. This walkfile is saved in the walks/ directory in your private area.

    Simulation Wizard: Save

    Figure 34: Simulation Wizard: Save

    In this final step, you specify the new device simulation to create.

    Simulation Wizard: Simulation

    Figure 34: Simulation Wizard: Simulation

    Fill in any Simulation name, such as test, or a short name for the target you are recording, or your first name. Use any Scenario name, such as a small number, e.g., 1.

    These names will be significant once you start doing advanced tasks. Pick easy names to remember.

    Choose a constant simulation method for regression tests: Counter objects will increment at a constant rate, causing predictable values. Use a random simulation method for realistic simulations: Counter objects will increment at the specified rate, but with a minor random fudge factor. Values in this type of simulation are not predictable.

  7. The CLI Wizard helps you to create a command line interface (CLI) Simulation from a real device with a command line interface, such as Cisco IOS, Juniper JUNOS, etc. It combines and integrates the functionality of the IOS Explorer and the IOS Recorder. The wizard creates a CLI simulation to be loaded into the MIMIC Telnet Protocol Module. Instead of requiring a third party NMS application to issue commands, it discovers the commands on the device dynamically, which are then recorded.

    The results of the wizard will be a rule file that maps CLI commands to responses. Each command detected will result in a rule entry and its corresponding response .mtcl file. It will also dump a transcript of the commands and responses for future processing.

    Choose to record from a live device, a previously captured PCAP file, or from a transcript of a telnet session.

    CLI Wizard: Method

    Figure 44: CLI Wizard: Method

    This dialog specifies the parameters for live recording or from PCAP. For the latter, you need to specify the PCAP In File below.

    CLI Wizard: Parameters

    Figure 45: CLI Wizard: Parameters

    The following General parameters have to be specified:

    • Address

      The IP Address of the device to be recorded. This is mandatory.

    • Interactive Login

      This indicates you want to discover in interactive mode. A simple terminal dialog is presented. You will need to interactively enter login information. This is useful if you need to go through terminal servers, or other frontends before reaching your target device. You are done when you are logged into the device and you see its command prompt and can press Next.

    • Username

      The username to use to login to the device.

    • Password

      The password to login to the device.

    • In File

      This is only used in Method 2 Record From PCAP.

    • Out File

      The Rule file to be created. It is recommended that this be in its own folder, ie. a name of the form YOUR-FOLDER/YOUR-RULE where YOUR-FOLDER is your folder name, and YOUR-RULE is your rule name. The Wizard will put all related files for your CLI simulation in that folder.

    • Append

      To append to the existing rule file.

    • Norepeat

      To add rule without repeat

    Optionally, you can also specify these Mode parameters:

    • Modes

      Select to discover different modes.

    • Enable Password

      Enable password to enter enable mode.

    • Interface Command

      Interface command to enter config-if mode.

    • Router Command

      Router command to enter config-router mode.

    • Line Command

      Line command to enter config-line mode

    • Command1 ... Command5

      Commands to discover other modes.

    • Prompt1 ... Prompt5

      Corresponding prompts to expect in other modes.

    Optionally, you can also specify these Advanced parameters:

    • Template Rules

      TBD

    Optionally, you can also specify these Telnet server parameters:

    • Port

      The telnet port to use (default 23).

    • Login Prompt

      The login prompt to be detected, if it is non-standard. The IOS Recorder uses patterns like the login prompt ("Username: "), password prompt ("Password: ") and login failure message ("Login incorrect") to construct the connection welcome message. These default values can be overriden by setting the Login Prompt, Password Prompt and Login Failure Message configurables in this tab.

    • Password Prompt

    • Login Failure Message

    In the Others tab you can specify these parameters:

    CLI Discovery Options

    • Discovery Depth

      How many subcommand levels to traverse.

    • Timeout

      Timeout to wait for response.

    • Ignore Output Redirect Commands

      This options lets you ignore output redirections. The Output Redirect Symbol field specifies a space-separated list of redirect symbols.

    • Include Permutational Commands

    If you are recording a live device, pressing Next goes to the next step.

    If you are recording from a PCAP file, pressing Finish will process any Telnet requests and responses in that PCAP for the specified server address and create the rule file in the Out File you specified above.

    This dialog allows you supply the recording parameters from a transcript.

    CLI Wizard: Record Transcript

    Figure 45b: CLI Wizard: Record Transcript

    The following General parameters have to be specified:

    • Out File

      The Rule file to be created. It is recommended that this be in its own folder, ie. a name of the form YOUR-FOLDER/YOUR-RULE where YOUR-FOLDER is your folder name, and YOUR-RULE is your rule name. The Wizard will put all related files for your CLI simulation in that folder.

    The Transcript tab allows you to interactively enter (eg. copy / paste) snippets of Telnet interaction (command / response) to Add to the Command List.

    The Files tab lets you do the same by reading transcript files.

    In the Interactive tab you can manually add commands and responses.

    When you click Finish, the rule file will be generated for the commands in the cumulative Command List.

    The user has the ability to either completely discover the device by specifying no commands to be included and no commands to be excluded. In the first dialog you can restrict the discovery by specifying the commands to be included and commands to be excluded. Approriately only included commands will be discovered and excluded commands will be ignored.

    CLI Wizard: Discover

    Figure 46: CLI Wizard: Discover

    Once the commands are discovered, this dialog allows the commands to be issued after editing them by providing required arguments. The checklist shows all the commands with a checkbox indicating the command to be issued. Commands in red indicate they were excluded from the discovery process. The argument of the command appear as a leaf in the tree. When selected it allows the user to add the arguments through the graphical interface, which becomes the issued command.

    CLI Wizard: Issue

    Figure 47: CLI Wizard: Issue

    All the checked commands will be issued to the device when you click on the Finish button.

  8. The NetFlow Wizard allows you to easily create a NetFlow Simulation from a real Cisco device by capturing a packet capture of the generated flows. Additionally, once you have created a simulation, the wizard allows you to modify it to suit your needs.

    Check out this 2-minute YouTube video for a quick intro.

    In this initial dialog you can choose to create a fresh simulation from a live NetFlow Exporter or modify an existing simulation.

    NetFlow Wizard: Method

    Figure 48: NetFlow Wizard: Method

    In this dialog you can enter the parameters to the netflowrec utility to create a fresh simulation from a packet capture (PCAP) of a real NetFlow Exporter. Check the netflowrec documentation for details.

    NetFlow Wizard: PCAP

    Figure 49: NetFlow Wizard: PCAP

    This dialog lets you modify the previously selected configuration file. The left pane shows the sections of the NetFlow configuration.

    The right pane shows the flows and their values.

    NetFlow Wizard: Modify

    Figure 50: NetFlow Wizard: Modify

  9. The sFlow Wizard allows you to easily create a sFlow Simulation from a Cisco device by capturing a packet capture of the generated flows. Additionally, once you have created a simulation, the wizard allows you to modify it to suit your needs.

    In this initial dialog you can choose to create a fresh simulation from a live sFlow Exporter or modify an existing simulation.

    sFlow Wizard: Method

    Figure 51: sFlow Wizard: Method

    sFlow Wizard: Create from PCAP

    Figure 52: sFlow Wizard: Create from PCAP

    This dialog lets you modify the previously selected configuration file. The left pane shows the sections of the sFlow configuration.

    The right pane shows the samples and their values.

    sFlow Wizard: Modify

    Figure 53: sFlow Wizard: Modify

  10. The IPMI Wizard allows you to easily create a IPMI Simulation by capturing a session between a IPMI device and a management app. Additionally, once you have created a simulation, the wizard allows you to modify it to suit your needs.

    Check out this 3-minute YouTube video changing an IPMI simulation in real-time.

    In this initial dialog you can choose to create an IPMI simulation from a live IPMI session, record from an existing walkfile, or modify an existing simulation at runtime.

    IPMI Wizard: Method

    Figure 56: IPMI Wizard: Method

    To record the live session, the ipmirec tool implements a proxy server between the IPMI management app and the IPMI device, storing the requests and responses in an IPMI walkfile.

    IPMI Wizard: Live

    Figure 57: IPMI Wizard: Live

    The mandatory options are the target host IP address and the authentication code.

    You can apply the IPMI simulation to a new SNMP simulation that will be recorded from the live device, to an existing simulation that you created previously, or copy an existing simulation so that you don't modify it.

    IPMI Wizard: Simulation Options

    Figure 58: IPMI Wizard: Simulation Options

    Pressing Next will present the Create IPMI Simulation dialog to summarize the selections. Pressing Next again will actually create the simulation.

    After you select a running agent with an IPMI simulation, this dialog allows you to change the simulation at runtime. You can modify any of the field values in responses for any of the supported requests, and add or delete instances to requests. YouTube

    IPMI Wizard: Modify

    Figure 59: IPMI Wizard: Modify

  11. The Web Wizard allows you to easily create a Web Services Simulation by capturing a session / conversation between a Web Server and client. Additionally, once you have created a simulation, the wizard allows you to modify it at run-time to suit your needs.

    Unless you already have recorded before, you start by recording a new conversation between a web client and a server.

    Web Wizard: Create

    Figure 60: Web Wizard: Create

    If you have never recorded before, then you have 2 choices to record a web service session.

    First, select Record new conversation to record a live conversation between your application and your web service. The Recording Parameters dialog will be displayed when pressing Next allowing you to specify the parameters of the live session to record.

    Second, if you have a packet capture (PCAP) that you recorded, you can use Record PCAP to record it. The Record PCAP dialog will allow you to record from the packet capture. This allows you to record sessions with a packet capture tool like Wireshark where you cannot record live.

    Alternatively, use Record with existing config if you have recorded before and saved the recording configuration. The Recording Parameters dialog will be displayed when pressing Next of the previously recorded session, allowing you to record again.

    Select Convert an existing conversation to convert an existing session that was recorded to a Web Services simulation.

    Finally, if you want to change a WEB simulation while it is running, select Change WEB configurable values of the selected agent. The Change WEB Values dialog will be displayed when pressing Next.

    To record a conversation, specify the conversation file name, and the web server you want to record. The HTTP port is usually port 80, and the SSL port is usually 443, although you should verify these before you record.

    Web Wizard: Record

    Figure 61: Web Wizard: Record

    When you press Next, the Recorder Settings dialog appears, allowing you to start a recording.

    Specify the PCAP file to record, and if there are multiple WEB conversations in it, you can pick the one between a specific server and a client, or between specific packet numbers.

    Web Wizard: Record PCAP

    Figure 62: Web Wizard: Record PCAP

    WEB module simulations can implement configurable values, which can be changed at run-time in real-time on a running agent.

    Web Wizard: Configurable Values

    Figure 63: Web Wizard: Configurable Values

  12. The MIMIC Tutorial Wizard guides you through the MIMIC software. The process to run SNMP simulations is described in the QuickStart manual. This wizard will follow that process.

    As a short-cut, you may want to watch the videos YouTube in the QuickStart Tutorial.

    The process we follow here is the most efficient to get you going. The Tutorial Wizard will invoke the existing tools to accomplish each task. You can at any point invoke the tools manually.

    The 4 main steps covered here are:

    1. setup MIBs needed by the simulations

    2. create simulations

    3. run simulations

    4. customize simulations

    You can skip any of the steps, for example if you just want to run the simulation that ships with MIMIC, go to step 3 . MIMIC is designed so you can easily come back to an earlier step later. The wizard lets you do this, in effect exploring the steps and the tools necessary to complete them.

    The first step in the process is to make sure you have all the MIBs you need for your simulations. Ultimately, you will need a MIB only if your management application accesses the objects in that MIB.

    Tutorial Wizard: MIBs

    Figure 70: Tutorial Wizard: MIBs

    MIMIC already ships with 2100+ precompiled MIB files , but there are many more. You can extend MIMIC by importing any needed MIBs. If you are missing MIBs, the simulations will be incomplete. MIMIC can guess at simulating these "unknown" MIB objects, but the simulation is not guaranteed to work.

    Remember that you can get more help at any time by clicking the Help... button.

    If you are not sure whether MIMIC knows about your required MIB, you can lookup objects, to see whether they are known. When you click the MIB->Lookup... button, the corresponding Lookup... menu item in the MIB menu will be invoked.

    You can inspect all the MIBs known to MIMIC by clicking the MIB->Directory... button. The MIBs that come pre-compiled with MIMIC are shown in blue, while the MIBs that you compiled are shown in red. This is due to the difference between the shared and private data areas.

    If the MIBs you require are not already known, you can extend MIMIC in various ways. First, you want to see if Gambit supplies them in the optional updates that you can download from the Web. To do this, use the Update Wizard. Initially, install only patches necessary from the Patches section, then look at the MIB Library section to install required MIBs. You can install MIBs even if they are not required. The overhead on MIMIC is minimal, because the software is designed to efficiently handle a large amount of MIBs. If you will be looking at the details of MIBs, it may be useful to download the optional "MIB source files" update.

    If the MIBs you require are not in any of the updates in the Update Wizard, then you can import and compile them yourself. To do this, you need the MIB source files (in standard SMI format). You first import the MIB source files into MIMIC with MIB->Import..., then compile them with MIB->Compile..., You can look at a flash demo of this task at the MIMIC demo page.

    If you have a number of MIBs to add to MIMIC, the MIB Wizard will make this job much easier, resolving any dependencies among them automatically. You can look at a flash demo of this task at the MIMIC demo page.

    The second step is to create a simulation of a device (which as a short-cut we call "device"). This step assigns MIBs to the device, and specifies values to be returned for each MIB object instance. For example, we need to specify what string to return for the sysDescr object.

    Tutorial Wizard: Simulations

    Figure 71: Tutorial Wizard: Simulations

    MIMIC ships with a sample set of devices. If you want to use them, you can skip to the next step. To inspect the currently known set of devices, use the Simulation->Devices... button.

    Else, you can download more devices from our device and network libraries on the web with the Update Wizard. Look at the Device Library and Network Library sections. You can browse for the available devices from several manufacturers, and complete networks. Expand a node, and double-click to get extra info. To install them, most of them require you to have installed the permanent license keys, but the Cisco VLAN network is available for evaluators.

    The third choice is to create new simulations from existing devices, networks, or from scratch. To record a small group of existing devices, use the Simulation->Record Live... button. You can look at a flash demo of this task at the MIMIC demo page.

    To discover a larger network of interconnected devices, use the Discovery Wizard. You can look at a flash demo of this task at the MIMIC demo page.

    The Snapshot Wizard. allows to take snapshots from an existing device, so that the simulation changes just like the device does.

    If you don't have a device to record, you can use the Simulation Wizard. to create the simulation. This involves specifying values for all relevant MIB objects.

    The Trap Wizard. lets you capture traps from a real device, which can then be replayed from one of the simulations.

    This step configures MIMIC to run simulations.

    Tutorial Wizard: Run Simulations

    Figure 72: Tutorial Wizard: Run Simulations

    Out of all the simulations that MIMIC knows about, you may want to run only a subset. The subset you want to run first needs to be configured into the current configuration on the main panel. The configured simulations can be thought of as the current lab setup. Running the lab is equivalent to turning power on.

    If you want to start fresh, the first task would be to clear the currently configured simulations from the main panel.

    You can add one or more agents with specific simulations to the simulation, either manually or by loading a previously saved configuration. You can then run it and/or save it.

    The diagnostic log lets you troubleshoot the MIMIC simulations.

    MIMIC allows you to change simulations at run-time, dynamically. You can control these changes interactively through MIMICView, or via scripts in the supported APIs (Tcl, Perl, Java, C++).

    Tutorial Wizard: Customize Simulations

    Figure 73: Tutorial Wizard: Customize Simulations

    Assuming you have at least one agent running and have selected it, you can interactively change its simulation at run-time with the Value Space Browser, generate traps, or run scripts.

  13. The Configuration Wizard lets you tailor the MIMIC environment.

    Each of the tabs lets you configure parameters in MIMICView:

    • Update Notification

      Turn Automatic Update Notification on or off.

      We recommend to enable notification, unless you are not connected to the Internet.

      Proxy configuration is only needed if you require a proxy to access the Internet. MIMIC Update Wizard works through SOCKS proxy servers with the help of the socat relay utility which is an optional installable on newer versions of Fedora Linux. For details see this FAQ entry.

    • Colors

      You can choose colors for various aspects of the GUI. You can re-configure other aspects of the user interface with the MIMICView resource file (see also the FAQ section).

    • Help

      Pick your favorite help viewer for viewing the context-sensitive online documentation. By default, on Windows the Microsoft HTML Help Control (HH.exe) is used, on Unix the first popular HTML browser it can find.

      You can also turn off the yellow balloon tooltips. YouTube

    • Agent

      You can toggle the address label of the agent icon to show its IP address or resolved fully qualified domain name (FQDN).

      NOTE: currently the FQDN will only show after starting the agent.

      You can toggle the description label of the agent icon to show its name (as shown in Simulation -> Devices ) or simulation,MIB,scenario triplets.

      You can configure the status message hint of the agent icon to show any information that the display subsystem knows about. By default it shows

      Agent $id, address $_host_name
      

    • Maps

      The Max agents in root map configurable limits the number of agents in the root map. Once the limit is surpassed, agents are automatically placed in submaps in batches of this configurable. Eg. if this number is 100, if the number of agents added is more than that, then submaps will be created with 100 agents each. Any leftover agents will be placed in the root map.

      This results in better GUI performance for large lab configurations.

    • Log

      Lets you turn on/off the automatic switching of the Simulator Log. If enabled, then the Log is switched to a new file every midnight. This is useful for management of large logs.

    • Graph

      These configurables are for graphing agent statistics in the Agent -> Statistics dialog. You can change from Built-in to Graphite to integrate with Graphite or Grafana . The following fields can be set:

      • CARBON_ADDR specifies the IP address of the Graphite server. This is required.
      • CARBON_PORT specifies the TCP port of the Graphite server. This is required.
      • CARBON_PREFIX set the prefix for the statistics. This is useful if you have multiple MIMIC instances that are exporting agent statistics.

      For example, this shows agent PDU statistics for agents 6 and 7 for an MIMIC instance named MIMIC-1.

      Configuration Wizard: Graph

    You can limit the number of lines to be shown in the log windows, by selecting the Limited button. Enter the number of lines to be displayed in the Lines to log text field.

    You can store new log files in a different Log Directory.

    MIMIC needs to know about the Java Runtime Environment (JRE) installed on your machine. It attempts to detect it in the default paths, but you may have to point it to the correct location (bin/ subdirectory of the JRE install area).

    Certain MIMIC components ( Diagnostic Wizard, profile reporting) need to know how to send information back to Gambit. Here you configure your mail gateway.

    You can enable/disable profile reporting, and how often you want it to happen.

  14. The Update Wizard makes it easier to install optional software packages, or to update to newer versions of MIMIC over the Internet (if available). It automatically notifies you of new software updates, and presents a friendly front-end to install them.

    NOTE: in order to work, MIMIC requires access to the internet, in particular to HTTP port 80 for the Gambit update servers update.gambitcom.com, www.gambitcomm.com and mirror2.gambitcommunications.com. If you do not have direct access, then it can also work with a proxy.

    The Update Wizard can be invoked in 3 different ways as detailed in the rest of this section:

    1. in the desktop MIMICview GUI via the Wizard -> Update... menu item;

    2. on the command line, via the updwiz.sh tool detailed below;

    3. in web-browser based WEBUI via the Wizard -> Update... menu item detailed below;

    If you have it enabled , MIMICView will notify you of the availability of new updates of MIMIC. This occurs whenever you start MIMICView, but at most once a day. MIMICView will download the MIMIC update database, and check for applicable updates to your software.

    Update Wizard: Notify

    Figure 80: Update Wizard: Notify

    If there are new updates, you will be notified with a dialog. This lets you either:

    • update immediately, by invoking the Update Wizard.

    • update later. You have to manually invoke the Update Wizard from the Wizards menu.

    • don't notify. This turns off the automatic update notification feature just as in the Configuration Wizard.

    In order to use the Update Wizard, you will need write permissions to the MIMIC shared area (the directory where you installed MIMIC).

    First you need to select the source of your update, either over the Internet from the Gambit Web site, or from CD-ROM. Since the CD-ROM can be at a different directory path on each system, you will need to supply it's location in the Path field.

    If you have installed MIMIC previously, you can select the same packages that you had already installed then, to be installed for this release with Select packages from previous release of MIMIC. This selection is done automatically and a Previous installation dialog pops up, then can be reviewed and modified in the next Select Package dialog.

    Update Wizard: Introduction

    Figure 81: Update Wizard: Introduction

    A Log Window is displayed which logs all steps taken in the update.

    Update Wizard: Log

    Figure 82: Update Wizard: Log

    In this dialog, select one or more updates you want to install for your version of MIMIC. If there are no applicable updates, you are done.

    Update Wizard: Select

    Figure 83: Update Wizard: Select

    Pressing Next displays the Selection Summary dialog allowing you to verify your selected update package(s).

    Pressing Next downloads the selected update package(s).

    Each update is downloaded from the Gambit Communications Web site. The download progress is displayed on the Status and Progress bars at the bottom.

    If the update has already been downloaded, you are asked whether to download again.

    If the extraction tools (gzip, tar) are not executable, they are also downloaded.

    Pressing Next prepares for installation. The wizard automatically continues after some number of seconds, as displayed in the status bar.

    Certain updates need extra preparation to complete the update. This is done here. You will be prompted for any extra steps.

    Pressing Next extracts the files. The wizard automatically continues after some number of seconds, as displayed in the status bar.

    Files are extracted from the update. The list of files is displayed for your information.

    Pressing Next extracts the contents of the update, and moves files to the shared area. Any existing files are backed up. The wizard automatically continues after some number of seconds, as displayed in the status bar.

    First, the contents of the update are extracted into a temporary directory. Then files are moved from the temporary directory to the shared area.

    While files are being moved, the progress is displayed on the Status and Progress bars.

    If you cannot use the MIMICview GUI to update your optional packages, you can use the command-line as follows:

    % ./updwiz.sh --nogui --help
    Usage:
    --nogui                 No GUI
    [--help]                Show this usage help
    [--offline path]        Install from offline path instead of Internet (default)
    [--noprevious]          Don't select previously installed packages
    [--norecommended]       Don't select recommended packages
    [--list]                List eligible packages
    [--continue]            Automatically continue and accept the defaults
    [--select package]      Select a package to install
    [--select section]      Select entire section of packages to install
    [--select everything]   Select every package to install
    [--exclude package]     Exclude a package from install
    [--noinstall]           Just list the selected packages, don't install
    ERROR - user specified --help, printed usage
    
    % ./updwiz.sh --nogui --list
    INFO - You have necessary permissions to update MIMIC.
    INFO - Getting update database
    INFO - Updates for MIMIC 20.00 on Linux-x86_64 3.14.27-100.fc19.x86_64
     Package    Size(kB)   Description
     -------------------------------------
     Patches (INSTALL FIRST)
        BUGS-2       114 Fix miscellaneous bugs
        BUGS-3        77 Fix miscellaneous bugs
        INTERF         1 Check Linux interface names for length 16 limit
    ...
       COLLWEB         0 WEB packages
     COLLWEBUI         0 Web-based MIMIC GUI packages
          NOTE         0 Pick applicable packages under "Collections" to get started
    INFO - recommended package "Fix miscellaneous bugs" selected
    INFO - recommended package "Fix miscellaneous bugs" selected
    INFO - recommended package "Check Linux interface names for length 16 limit" selected
     -------------------------------------
     Already Installed
    INFO - Total packages selected: 3
    INFO - Total size: 192 kB
    INFO - Estimated download time: < 1 second
    INFO - BUGS-2         114 kB Fix miscellaneous bugs        
    INFO - BUGS-3          77 kB Fix miscellaneous bugs        
    INFO - INTERF           1 kB Check Linux interface names for length 16 limit
    INFO - Total download size: 192 kB
    INFO - Continue? y or n and ENTER (C = continue automatically with --continue)
    
    ERROR - user does not want to continue
    
    % ./updwiz.sh --nogui --noprevious --norecommended --select QUICKPDF --select MIMICPDF
    INFO - You have necessary permissions to update MIMIC.
    INFO - Getting update database
    INFO - Selecting package QUICKPDF from --select
    INFO - Selecting package MIMICPDF from --select
    INFO - Total packages selected: 2
    INFO - Total size: 8444 kB
    INFO - Estimated download time: 22 seconds
    INFO - QUICKPDF      2193 kB QuickStart Guide in PDF format
    INFO - MIMICPDF      6251 kB MIMIC 20.00 documentation in PDF format
    INFO - Total download size: 8444 kB
    INFO - Continue? y or n and ENTER (C = continue automatically with --continue)
    C
    INFO - no license key and no dependencies, package "QuickStart Guide in PDF format" can be installed.
    INFO - no license key and no dependencies, package "MIMIC 20.00 documentation in PDF format" can be installed.
    INFO - Downloading Package "QuickStart Guide in PDF format"(1 out of 2).
    INFO - Checking http://www.mirror4.gambitcommunications.com/update/images/PDPCMOHLEBEEJKBGHLBAJFJMACAA/quick2000pdf.tar.gz
    INFO - Downloading http://www.mirror4.gambitcommunications.com/update/images/PDPCMOHLEBEEJKBGHLBAJFJMACAA/quick2000pdf.tar.gz
    INFO - GET url: http://www.mirror4.gambitcommunications.com/update/images/PDPCMOHLEBEEJKBGHLBAJFJMACAA/quick2000pdf.tar.gz
    done
    INFO - No preparations needed, continuing...
    INFO - Preparing to extract quick2000pdf.tar.gz [size 2193 KB], please wait...
    INFO - contents
    pdf/
    pdf/quickstart2000.pdf
    
    INFO - Total 2 files to be extracted
    INFO - created temporary directory /tmp/mimic.updwiz.200924144038
    INFO - Please wait, extracting 2 files, this can take a while...
    INFO - Extracting Package "QuickStart Guide in PDF format"(1 out of 2).
    INFO - extracted into temporary directory /tmp/mimic.updwiz.200924144038
    INFO - Extracted 2 files
    INFO - Moving 2 files, this can take a while, please wait...
    INFO - installed pdf/
    doneINFO - Downloading Package "MIMIC 20.00 documentation in PDF format"(1 out of 2).
    INFO - Checking http://www.mirror4.gambitcommunications.com/update/images/PDPCMOHLEBEEJKBGHLBAJFJMACAA/mimic2000pdf.tar.gz
    INFO - Downloading http://www.mirror4.gambitcommunications.com/update/images/PDPCMOHLEBEEJKBGHLBAJFJMACAA/mimic2000pdf.tar.gz
    INFO - GET url: http://www.mirror4.gambitcommunications.com/update/images/PDPCMOHLEBEEJKBGHLBAJFJMACAA/mimic2000pdf.tar.gz
    done
    INFO - No preparations needed, continuing...
    INFO - Preparing to extract mimic2000pdf.tar.gz [size 6252 KB], please wait...
    INFO - contents
    pdf/
    pdf/mimic2000.pdf
    
    INFO - Total 2 files to be extracted
    INFO - created temporary directory /tmp/mimic.updwiz.200924144051
    INFO - Please wait, extracting 2 files, this can take a while...
    INFO - Extracting Package "MIMIC 20.00 documentation in PDF format"(1 out of 2).
    INFO - extracted into temporary directory /tmp/mimic.updwiz.200924144051
    INFO - Extracted 2 files
    INFO - Moving 2 files, this can take a while, please wait...
    done
    

    If you cannot use the MIMICview GUI to update your optional packages, you can use the Wizard -> Update menu from WEBUI as follows:

    • List...

      List the available and installed packages in a new web browser tab.

    • Install...

      Install one or more packages separated by a space. The Select previously installed packages option only applies to fresh installations of MIMIC, without any updates installed, and is meant to be used on MIMIC version updates. The Select recommended packages allows you to automatically installed packages marked as recommended, eg. bug fixes.

      The log will be displayed in a new web browser tab.

    • Help...

      Display this page.

  15. The Diagnostic Wizard makes it easier to diagnose and report problems with MIMIC. In case of technical problems, you can use this wizard to collect information from your installation to be sent to Gambit Technical Support. You traverse a set of dialogs, each collecting different information, and the last dialog sends it after your explicit confirmation.

    This dialog lets you select the various MIMIC configuration files. You can click on the + box on a node to expand it, on the - to collapse it. You can click on a checkbox to include a file in the report. You can click on a checkbox of a category to include all files in the category. You can double-click on a file to examine its contents.

    By default, relevant system and thread information is included. You can review the information with the Details... button.

    The next 9 dialogs let you add more MIMIC files to send in your report. As a shortcut, if you want to skip the rest of the dialogs, you can select Skip adding files and send report and press Next.

    This dialog lets you select your compiled MIB files. This will not send the source code of your MIBs, to prevent divulging proprietary MIB files. If you need to transfer the source code of your MIBs, Gambit support will give you instructions to transfer them manually.

    You can select simulations to be collected. Since these are quite large, select only the simulations necessary to diagnose your problem.

    This dialog lets you select your Walkfiles. You can additionally select walkfiles from other areas by pressing the "Browse..." button. Since these are quite large, select only the walkfiles necessary to diagnose your problem. You can inspect the walkfiles by double-clicking on them.

    You can select snapshots to be collected. Since these are quite large, select only the snapshots necessary to diagnose your problem.

    You can select discovery sessions to be collected. Since these are quite large, select only the discoveries necessary to diagnose your problem.

    You can select trap series to be collected. Since these are quite large, select only the trap series necessary to diagnose your problem.

    Any necessary log files to diagnose your problem can be selected here. The logfiles are sorted in reverse temporal order (most recent first), and show the highest severity in the file. Since these are quite large, select only the log files necessary to diagnose your problem. You can inspect the log files by double-clicking on them.

    The complete list of selected items is shown, and you can review it and remove items.

    Currently, only manual and e-mail transfer mode are supported. Manual transfer just creates the compressed tar-ball with your selected files. You can transfer it to Gambit manually, eg. as an attachment in an e-mail message.

    If your mail configuration is defined in the Configuration Wizard then E-mail mode can send the e-mail for you. You just have to fill in your e-mail address in the From field. All other fields are optional.

  16. The Sanity Wizard lets you check the integrity of your MIMIC data (ie. the files in your private area). You can use this wizard upon request from the Gambit Technical Support team.

    In the first dialog you select the items to be checked. By default, all checks will be performed, as indicated with the checkmarks on the items. The set of checks is broken down by

    • Lab Configurations
    • Device Configurations
    • MIB Directory
    Each check indicates the number of files and checks involved. You can select/deselect any subset of the checks. Only if there is something to check will you be able to continue to the next step.

    This dialog shows a summary of the check results. It will indicate how many checks have been performed, and how many have passed/failed. The Log Window will show details of the checks.

  17. The Performance Wizard lets you check the SNMP performance of your system running MIMIC. It runs a standard test which simultaneously walks a varying number of agents with the MIMIC Recorder. This attempts to capture the performance characteristics of a typical scenario involving a network of agents being accessed by a small set of management applications.

    This process is useful if you want to gauge the performance of your system in a standard way. You can also incrementally tune the system and measure whether the performance is actually improved.

    The wizard will first collect system information and will allow you to identify the system.

    Then it will run a series of performance tests using the MIMIC Recorder. This test lasts a couple of minutes.

    Finally you can choose to report this data. By doing so, you will be able to contribute to a database of systems.

    In the first dialog the wizard collects information about your system. The Details... button displays the collected information.

    Optionally you can identify the brand, model and description of your system. For example, if you have multiple MIMIC systems of the same type, you can put the system name in the Description field. If you decide to share your results with Gambit, the more identifying information you provide about your system, the better our database will be.

    The performance test consists of configuring 10 agents, and simultaneously walking subsets of them using the MIMIC Recorder.

    If you want to preserve your lab configuration, save it now with the File -> Save As... menu command.

    By default the agent addresses are 10.0.0.1 to 10.0.0.10. Optionally specify alternative addresses of the agents in this dialog, then press Next to start the test.

    The test will run for a couple of minutes, and display its progress in a Log Window.

    This dialog shows a summary of the performance results.

    This dialog sends the files for inclusion in Gambit's database.

    Currently, only manual and e-mail transfer mode are supported. Manual transfer just creates the compressed tar-ball with your selected files. You can transfer it to Gambit manually, eg. as an attachment in an e-mail message.

    If your mail configuration is defined in the Configuration Wizard then E-mail mode can send the e-mail for you. You just have to fill in your e-mail address in the From field. All other fields are optional.

  18. The Protocol Wizard lets you install and uninstall optional protocol modules into MIMIC.

    First, you can select the protocol modules to be installed or uninstalled. The currently installed modules are already selected in the list.

    Next, you need to supply the license keys for each protocol module to be installed. Once you proceed, the modules are installed.

    Protocol Wizard: Introduction

    Figure 90: Protocol Wizard: Introduction

    In the first dialog the wizard collects information about protocol modules to be installed or uninstalled.

    Protocol Wizard: Protocols

    Figure 91: Protocol Wizard: Protocols

    For each selected protocol which needs a license key, enter the key string you received from Gambit Communications.

    Protocol Wizard: Keys

    Figure 92: Protocol Wizard: Keys

    This dialog displays the results of the install/uninstall.

    Protocol Wizard: Results

    Figure 93: Protocol Wizard: Results

    If you cannot use the MIMICview GUI to configure your protocols, you can use the command-line as follows:

    % ./protowiz.sh --nogui --help
    Usage:
    --nogui                 No GUI
    [--help]                Show this usage help
    [--available]           List available products
    [--enable product]      Enable a product / module
    [--key key]             key for previous --enable
    [--disable product]     Disable a product / module
    ERROR - user specified --help, printed usage
    
    % ./protowiz.sh --nogui 
    % ./protowiz.sh --nogui
    INFO - You have necessary permissions to Install Protocol Modules.
    INFO - installed protocols TELNET SSH SYSLOG TFTP
    INFO - installed products: {IOS Simulator} {TFTP } {SYSLOG }
    INFO - to install 
    INFO - to uninstall 
    INFO - Nothing to install / uninstall, done...
    
    % ./protowiz.sh --nogui --enable netflow --key YOURKEY
    INFO - You have necessary permissions to Install Protocol Modules.
    INFO - installed protocols TELNET SSH SYSLOG TFTP
    INFO - installed products: {IOS Simulator} {TFTP } {SYSLOG }
    INFO - to install netflow
    INFO - to uninstall 
    INFO - installed netflow
     with key YOURKEY
    
    % ./protowiz.sh --nogui --disable netflow
    % ./protowiz.sh --nogui --disable netflow 
    INFO - You have necessary permissions to Install Protocol Modules.
    INFO - installed protocols TELNET SSH SYSLOG TFTP NETFLOW
    INFO - installed products: {IOS Simulator} {NETFLOW Simulator} {TFTP } {SYSLOG }
    INFO - to install 
    INFO - to uninstall NETFLOW
    INFO - uninstalled NETFLOW