Skip to main content

Mudfish OVA Management Tool

While installing and using Mudfish OVA on a Virtual Machine (VirtualBox, VMWare), the most inconvenient part is changing and restoring the default gateway of the local machine.

This document explains how to use the mudrun_ova.exe (Mudfish OVA Management Tool) file. With this tool, you can conveniently do the following:

  • Basic test for Mudfish OVA's operation status.
  • Change and restore the default gateway to the Mudfish OVA.

How to install​

The Mudfish OVA Management Tool (hereinafter mudrun_ova.exe) currently supports only the Windows environment and can be downloaded from the following link:

At this link, you can download the mudrun_ova-<version>.zip file.

After downloading this file and decompressing it, you can find the mudrun_ova.exe file. This file can be run from anywhere.

How to use​

warning

mudrun_ova.exe has a feature (changing the default gateway) that requires administrator privileges on the system.

Therefore, you must run this file with administrator privileges. If you do not run it with administrator privileges, a "Warning" message will appear on the program's first screen.

When you run the mudrun_ova.exe file, you will see the following screen:

picture 0

As you can see on the screen, it has a total of 4 menus.

  • Basic Connection Test

    Performs a basic test to check if Mudfish OVA is working. The following tests are performed:

    1. Ping test to 192.168.56.2
    2. TCP connection test to 192.168.56.2 on TCP port 80
    3. HTTP connection test to 192.168.56.2 on TCP port 8282

  • Change Default Gateway to Mudfish OVA

    Changes the system's default gateway to that of the Mudfish OVA. After the change, this menu will change to the "Restore" menu.

  • View Logs

    You can view logs related to the operation of the mudrun_ova.exe program.

  • Exit

    Exits the program.

Usage Example (Applying)​

Usually, you can use the mudrun_ova.exe program as follows.

  1. After importing the Mudfish OVA in VirtualBox, run the VM.

    picture 1

    If it runs correctly, you will see the Mudfish OVA screen as follows.

    picture 2

  2. Now, run the mudrun_ova.exe program with administrator privileges.

    picture 3

  3. Select the "Basic Connection Test" menu to verify that the OVA is working correctly.

    picture 4

    Confirm that the result is successful.

  4. Select the "Change Default Gateway to Mudfish OVA" menu to change the default gateway to the Mudfish OVA.

    picture 5

    If the change is successful, a completion message will appear. If an error occurs during the process, checking the logs in the "View Logs" menu will help you solve the problem.

  5. Now that everything(?) is set up correctly, please go to http://192.168.56.2:8282, log in to Mudfish, and configure it for use.

    If you want to configure OpenWRT settings, you can connect to http://192.168.56.2.

Usage Example (Restoring)​

When you have finished using the Mudfish OVA, you can restore your original settings.

  1. To restore the original system default gateway, select the "Restore" menu.

    picture 6

FAQ (Frequently Asked Questions)​

Restoration does not work properly.​

In this case, simply reboot your computer. It will automatically revert to the original settings.

The internet is down after configuration. How do I restore it?​

In this case, simply reboot your computer. It will automatically revert to the original settings.

Can I continue to use the Mudfish OVA as the default gateway?​

The Mudfish OVA is basically an OpenWRT-based router, so you can continue to use it even if you disconnect Mudfish. In this case, the Mudfish OVA will simply act as a router.