3Setup

Please read the section System Requirements for prerequisites needed to install and run MIB Explorer. Then follow the below steps to install and setup MIB Explorer below.

3.1Installation

MIB Explorer can be installed as native application or standard Java application.

The latter requires a Java Runtime already installed on the target operating system whereas the native application installs a stripped OpenJDK Java Runtime bundled with MIB Explorer.

The native installation provides operating system integration, such as icons on the desktop and start menu integration.

To install MIB Explorer for an already installed Java Runtime (JRE), first make sure you have installed a JRE version 9 or later (see System Requirements). Then follow the steps set forth in section Any Platforms - Plain Java Installation.

3.1.1Native Application Installation

1.Log on to your system as the user who is supposed to use MIB Explorer.

2.Download one of the native application packages of MIB Explorer compatible with your operating system from https://agentpp.com/down­load.html.

3.Run the installer and start the application.

4.Follow the instructions to setup MIB Explorer in section Setup.

3.1.2Any Platforms - Plain Java Installation

Download the mxp-<version>.jar file in a folder of your choice. Start the MIB Explorer application by

double clicking it from your system’s file explorer, or

running the following command from the command line:

java -jar mxp-<version>.jar

Java Runtime Environment (JRE) Installation

1.Download the latest JRE from https://java.com.

2.Install the Java Runtime Environment (JRE) 9 or later on your system and add the bin directory of the JRE (or SDK) installation to your PATH environment variable (this is often already done by the installa­tion process).

3.2Starting MIB Explorer

If you have used a native installer to install MIB Explorer, then you can start it from your systems application start menu or by clicking its icon on your desktop.

Otherwise double click the downloaded mxp-<version>.jar file or run

java -jar mxp-<version>.jar

from the command line (see previous section). When MIB Explorer is started for the first time, you will be prompted for your license information.

Please enter your license key including blanks! The license key is case sensitive.

If you are using a restricted or evaluation license you can upgrade it later without reinstalling MIB Explorer by choosing Help>License… from the main menu.

3.3Setup

Once you have started MIB Explorer and entered your license information, choose File>Install... to install MIB Explorer MIB files and repository as well as other accompanied files on your system.

At first application start, you will be automatically asked to specify an empty installation directory for MIB Explorer accompanied files.

Note: When updating accompanied files, modifications on that files may get lost. Thus, it is recommended to use a new installation directory and delete the old manually if you have changed any of those files. You can then delete the old directory, if it is not needed any more.

Every time MIB Explorer is updated and the structure or version of the accompanied file set has changed, you will be asked to install/update those files again. You have then the choice to install the files to a new location or update the files in the existing location.

3.3.1Install Templates, Examples, and MIBs

Once you have started MIB Explorer and entered your license information, choose File>Install... to install MIB Explorer MIB files, repository of precompiled MIB files, example scripts and monitors as well as other accompanied files on your system.

3.4Updates and Upgrade

MIB Explorer checks on startup if there is a new version available if it can reach the update server through the Internet.

By default MIB Explorer uses the system proxy (or no proxy if there is not any system proxy defined). You can specify your proxy as described in section  Preferences.

You can run that check manually from the Help>Check for Updates menu.

If a newer version is available, MIB Explorer prompts you to start the Update process.

As there are two different installation types (native and plain java), there are two different upgrade/update methods:

1.In-place JAR update

2.Native OS Installer

3.4.1In-place JAR Update

For plain Java installations, you can update your MIB Explorer application by replacing the mxp-<version>.jar at the location it is installed. This in-place update will

1.download the new version,

2.extract a small Java application within the same directory that is going to do the actual update,

3.start the Java update application and exits MIB Explorer

4.move the existing JAR to a backup file and then move the downloaded new version to the existing JAR filename.

5.then restart MIB Explorer using the new JAR.

6.verify the MIB Explorer setup and will remove any backup files during restart - if still present.

3.4.2Native OS Installer Update

If the MIB Explorer update function detects, that it is currently running from a native OS installer built setup, then it will offer to use that update method. It will run the update as follows:

1.Download the new OS installer for the existing application.

2.Run the OS installer.

3.Exit MIB Explorer.

Please follow the steps of the installer to either install updated MIB Explorer in a new location or overwrite the existing installation. It depends on your operating system which options you actually have.

3.4.3Manual Update

In any case, you can switch between the installation and update methods by doing a manual update. Simply follow the steps in Setup. MIB Explorer will find the configuration file in your home directory and reuse existing settings and accompanied files.

3.4.4Updating Accompanied Files

MIB Explorer will contact a service on https://updates.snmp.app to check if new updates are available for the installed version and license. When you confirm the update, the new version will be downloaded from https:// agentpp.com from the same location you would use for a manual download.

If a newer version of the accompanied file set is available with the new version, MIB Explorer will ask you to install them in the current installation location. If you confirm the installation, MIB Explorer will overwrite existing files with the newer version.

If the newer version has a higher major release number, then it is recommended - but not required - to install the files into a new directory.

3.4.5Upgrade License

To upgrade to a new major release version, purchasing an upgrade license is an alternative to purchasing a regular new license. To upgrade your existing software you can download the new software and start it.

It will then prompt for a license key (because the stored license key is not valid for the new version). Now enter your upgrade or regular license key.

If the configuration file of the old version cannot be found then you will be prompted for entering the license key of the previous version too in order to validate the upgrade license. For a regular license this step is not necessary.

3.5Uninstall

For an installation with one of the native installer packages, please use the platform specific uninstall mechanisms to remove the software itself. Otherwise it is sufficient to remove the mxp-<version>.jar file.

In any of both cases, you may manually remove the accompanied files installed by MIB Explorer during initial startup at the location you had then chosen.

MIB Explorer holds its configuration data in the mxp4.cf file in your home directory. To completely uninstall MIB Explorer, this file has to be removed manually. By removing it, you will have to reenter your license information - as well as other configurations - when you reinstall MIB Explorer.