MIB Smithy

Installation Instructions

About the License Key

A license key file is required to run this software after installation. This file contains information about your license that is required by the extension.

For evaluation versions of the software, this license key allows you to try most features of the product for a period of 15 days from the time of download. The evaluation license key can be downloaded from the same page where you downloaded the software.

For non-evaluation versions of the software, this includes a Host ID that ties the installation to the computer you are licensed for. Typically, this is the ethernet address of one of the NIC cards in your computer. When you first load the extension, without a license key file present, you will be informed of the Host IDs available for use. After obtaining available Host IDs, log in to the Muonics web site with the account used to purchase the software, and select the "Licenses" option in the User Menu or go to:

https://www.muonics.com/User/licenses.php

There you may select a licensed product serial number, enter your Host ID, and download a license key file. Licensed users may return to the Licenses Page to re-download their license key at any time should reinstallation be necessary. If you need to change Host IDs, for reasons such as equipment failure/replacement or license transfer, please contact support@muonics.com. Per your license agreement, you may change computers/Host IDs at most once every six months (twice total during the period of an annual support contract). If you change Host IDs more often than this period, you will need to purchase a support contract renewal for a nominal fee.

MIB Smithy allows some flexibility in where the license key is located and how it is named, as well as providing a GUI interface to install the license key. By default it will search the following locations, in order of precedence, where prefix is the same as the prefix of the product distribution file you downloaded (such as smithypro or smithydemo):

1. The full path and file name specified by the SMITHY_LICENSE_FILE environment variable.
2. The user's home directory (as specified by the HOME environment variable) with the name .prefix.key, .prefix.lic, prefix.key or prefix.lic.
3. A file named license.key within the installation directory or any parent directory thereof.
4. file named .prefix.key, .prefix.lic, prefix.key or prefix.lic in /usr/local/etc.
5. A file named .prefix.key, .prefix.lic, prefix.key or prefix.lic in /etc.

To install the license key, you can either copy it to one of the above locations (e.g. $(HOME)/.smithydemo.lic) or let the application install it for you. For the latter, start MIB Smithy as you normally would (e.g. by double-clicking the application icon). If no valid license key is found automatically, a dialog will be provided where you can paste or import the license from a specified file. The key will be installed in your home directory using the .prefix.lic naming convention to avoid conflicts with other MIB Smithy editions you may have installed. To install the key system-wide for all users you will need to manually copy it into one of the above locations.

Windows (NT, 2000, XP, or later)

The Windows Install uses Microsoft Installer (.msi) format. If you do not already have Microsoft Installer installed, you will need to download and install it before installing this application. You can download the installer from Microsoft at one of the following locations:

• Microsoft Installer for Windows 95, 98 and ME machines
• Microsoft Installer for Windows NT 4.0 and 2000 machines

Once you have Microsoft Installer support, download the MIB Smithy application installer and save it to your hard drive. Double click on it in your Windows Explorer to launch the setup. The setup wizard will guide you through the installation process from there.

After the application has been installed, click the application icon from the Start Menu folder to start MIB Smithy. You will be asked for a license key if none is found. Paste the license key into the space provided or click Import to load the key from a file and save it to an appropriate location.

Unix Installation (Linux, FreeBSD, Solaris)

The Unix version of this application is distributed as a gzipped tar file (.tgz or .tar.gz). You will need to have gzip/gunzip installed in order to install this application.

Download the MIB Smithy application install file to your hard drive and extract the files using the following command:

gunzip -c filename | tar xvf -

No install script is currently available for the Unix version(s) of this application. The applications and directory structures extracted from the tar file are designed to be able to run anywhere, provided the relational structure is kept intact, should you wish to install in another location (such as /usr/local/smithy).

After the application has been installed, you can launch it by invoking the "smithy" binary within the 'bin' directory. You will be asked fora license key if none is found. Paste the license key into thespace provided or click Import to load the key from a file and save it to an appropriate location.

MacOS X Installation

To install on MacOS X, double-click on the .dmg file to mount the disk image. MIB Smithy its self is fully self-contained in the MIB Smithy application icon. You may wish to copy it and other files such as MIB and PIB modules, RFC documentation and Developer's Guide to another folder.

Double-click the application icon to start MIB Smithy. You will be asked for a license key if none is found. Paste the license key intothe space provided or click Import to load the key from a file and saveit to an appropriate location.