Chapter 2. Tutorial

Table of Contents
Quick EnFuzion Setup Instructions for Windows NT/2000/XP
Quick EnFuzion Setup Instructions for Linux/Unix
Creating The Sample Parametric Study
Creating Your Own Parametric Study

This chapter is an introduction to using EnFuzion. It includes a step by step guide on how to use most common EnFuzion features and allows you to quickly become productive by applying EnFuzion to your needs.

The first two sections show how to install EnFuzion and how to execute the sample parametric study in Windows NT/2000/XP and Linux/Unix environments, respectively. The next section describes the sample parametric study in more detail, showing how it can be constructed with EnFuzion tools. The last section provides guidelines for creating your own parametric studies.

The EnFuzion distribution package includes a sample parametric study. This sample parametric study is used throughout this chapter to illustrate key concepts.

Quick EnFuzion Setup Instructions for Windows NT/2000/XP

This section describes how to set up EnFuzion for Windows NT/2000/XP and how to execute the sample parametric study. If you do not plan to use EnFuzion on Windows NT/2000/XP, you can skip this section.

EnFuzion setup involves the following steps:

These steps are described in the sections below.

Installation of the EnFuzion Root

The EnFuzion root system is the main computer that controls EnFuzion nodes and job execution. Select your EnFuzion root system and install EnFuzion software as follows:

  • Copy a Windows EnFuzion distribution package to the system.

  • Unzip the package.

  • Obtain Administrative user rights.

  • Execute the SETUP.EXE program in the package.

Installation of an EnFuzion Node

EnFuzion node systems are computers that execute jobs. Install EnFuzion on a node as follows:

  • Copy a Windows EnFuzion distribution package to the system.

  • Unzip the package.

  • Obtain Administrative user rights.

  • Execute the SETUP.EXE program in the package.

  • Create or choose the user account that will be used by EnFuzion for executing jobs on this node. The account will be used in the EnFuzion configuration step.

EnFuzion software must be installed on all systems that will be used as EnFuzion nodes.

License Installation

EnFuzion will not work without a valid license. EnFuzion licenses can be obtained from Axceleon at www.axceleon.com or at sales@axceleon.com. Install an EnFuzion license as follows:

  • Save the license to file enflicense.txt.

  • Copy enflicense.txt to C:\enfuzion\config, which is the default EnFuzion directory, or to the config subdirectory of the user specified EnFuzion directory, if the default is not used.

The license must be installed on the EnFuzion root system.

EnFuzion Configuration

Default EnFuzion configuration is suitable for most environments, and no special configuration steps are required. The only configuration requirement is to specify the systems that are used as EnFuzion nodes. Specify EnFuzion nodes on the root system as follows:

  • Create the file enfuzion.nodes.txt.

  • For each EnFuzion node, add the following line to the file:

    
    <node_host>  <user_account>  <user_password>
    
    Replace <node_host> with the name of the system, <user_account> with a user account to be used by EnFuzion on that system, and <user_password> with a password for that user.

  • On the root system, copy enfuzion.nodes.txt to C:\enfuzion\config, which is the default EnFuzion directory, or to the config subdirectory of the user specified EnFuzion directory, if the default is not used.

Execution of a Sample Parametric Study

The EnFuzion package provides a sample application template, which demonstrates EnFuzion use. The template can also be used to test EnFuzion installation. The sample template is located in C:\enfuzion\test by default or in the test subdirectory of the user specified EnFuzion directory, if the default is not used. Test EnFuzion installation as follows:

  • On the root system, click on the sample.run file in the EnFuzion test subdirectory.

Clicking this file starts the execution of the template, using EnFuzion nodes. It opens a window that provides a log with execution details. The window disappears when the execution has completed. The log is preserved in the enfuzion.log file in the test directory.

Using the Web Based GUI

Template execution can be monitored from any standard Internet browser. Monitor the execution as follows:

  • Start a standard web browser on any system.

  • Connect to the following URL:

    
    http://<root_host>:10101
    
    Replace <root_host> with the host name of the EnFuzion root system.

The web based GUI is provided only while the template is executing. It is not available after the execution has completed.