Quick EnFuzion Setup Instructions for Linux/Unix

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:

• Create or choose the user account that will be used to execute EnFuzion on the root system. There is no need to install and use EnFuzion under the root account.

• Login to the chosen user account.

• Copy an EnFuzion distribution package for your platform to the system.

• Unpack the tar package.

• Execute the install-root script in the package.

• Add the EnFuzion directory $HOME/enfuzion/bin to your PATH environment variable.

Installation of an EnFuzion Node

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

• Create or choose the user account that will be used by EnFuzion to execute jobs on this node. There is no need to install and use EnFuzion under the root account.

• Login to the chosen user account.

• Copy an EnFuzion distribution package for your platform to the system.

• Unpack the tar package.

• Execute the install-node script in the package.

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 directory $HOME/EnFuzion/config.

The license must be installed on the EnFuzion root system and on all EnFuzion nodes.

Node Configuration For Remote Access

The EnFuzion root system must have a method for establishing communication with EnFuzion nodes. It is recommended that the standard ssh protocol be used.

The EnFuzion root must have an ssh client installed, and ssh access must be allowed from the EnFuzion root system to EnFuzion nodes. On EnFuzion nodes, ssh must be configured to authenticate the EnFuzion root for remote access, so that no password is required. EnFuzion nodes are configured to authenticate the EnFuzion root as follows:

• On the root system, create a public/private key pair.

• On the node system, install the root public key as an authorized key.

Details are provided in the Section called Configuring EnFuzion Nodes for Remote ssh Access in Chapter 4.

If ssh is not available, the standard telnet protocol can be used instead. In this case, the EnFuzion root user must be able to login to an EnFuzion node with telnet.

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 file enfuzion.nodes.txt.

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

      <node_host>  <user_account>  dummy  ssh
  

  Replace <node_host> with the name of the system and <user_account> with a user account to be used by EnFuzion on that system. If telnet is used instead of ssh, 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 directory $HOME/enfuzion/config.

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 $HOME/enfuzion/test. Test EnFuzion installation as follows:

• On the root system, change your working directory to $HOME/enfuzion/test.

• Execute the sample with the command:

      enfdispatcher sample.run
  

The command starts executing the template, using EnFuzion nodes. It prints out a log with execution details. The log is preserved in the enfuzion.log file after the execution has completed.

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 as long as the template is executing. It is not available after the execution has completed.