This chapter explains how to install and operate EnFuzion software on Windows NT/2000/XP computers. The EnFuzion software consists of the EnFuzion root components, the EnFuzion node components and the EnFuzion submit components. These components must be installed on computers that will act as EnFuzion roots, EnFuzion nodes or EnFuzion submit hosts, respectively. This chapter covers EnFuzion software installation, EnFuzion license installation, installation of EnFuzion as a network service, network installation, installation in a mixed Windows NT/2000/XP and Linux/Unix environment, instructions on how to modify installation defaults, removal of EnFuzion software and Windows specific issues of EnFuzion operation.
EnFuzion software must be installed on each Windows NT/2000/XP computer to be used as an EnFuzion root, an EnFuzion node or an EnFuzion submit host. The simplest method to install EnFuzion on Windows NT/2000/XP is by executing the setup program, which is included in the distribution package. The setup program automatically installs all EnFuzion components, including the EnFuzion root, the EnFuzion node and the EnFuzion submit software.
To install EnFuzion software, perform the following steps:
Obtain the EnFuzion distribution package for Windows NT/2000/XP. Packages are available from the Axceleon web site.
Unpack the package. If the package is a self-extracting executable with the .exe suffix, then simply execute the package by clicking on the file. The package execution will extract EnFuzion distribution files to a folder with the same name as the original package, but without the .exe suffix. If the package is an archive with the .zip suffix, then unpack the package to a temporary directory. The distribution package and the extraction directories can be deleted after the installation, since they are not required for EnFuzion operation.
Check installation prerequisites on your Windows NT/2000/XP system:
If you use Windows NT, Service Pack 6 is recommended for use with EnFuzion.
On some older versions of Windows, TCP/IP protocol is not installed by default. TCP/IP is required by EnFuzion for communication between the root and the nodes. If TCP/IP is not installed on your computer, check Control Panel:Network:Protocols and install TCP/IP.
Obtain Administrative User Rights on the system by logging in under the administrator account or under another account with Administrative User Rights. These administrative rights are required only for the installation, they are not required for regular EnFuzion use.
Install EnFuzion by executing the setup program in the directory with extracted EnFuzion distribution files. The setup program asks for the EnFuzion installation directory and for the EnFuzion temporary directory. The use of default values is recommended. The default EnFuzion directory is C:\enfuzion. The default EnFuzion temporary directory is C:\enfuzion\temp.
(optional) Add the path to EnFuzion executables to the PATH environment variable. This step allows you to execute EnFuzion binaries from a command line without specifying the entire path. The default path for EnFuzion executables is C:\enfuzion\bin. If the default EnFuzion value for the EnFuzion installation directory is changed, executables are located in the bin subdirectory.
Note: The setup program installs a Windows system service, called Starter Service. The service enables a remote EnFuzion root to start jobs on the computer. If the service is not available on a Windows node, EnFuzion will be unable to use that node. The setup program automatically configures the service, so that it is always available. No special configuration steps are required.
If the setup program is executed on a system that already has EnFuzion installed, it will automatically use the existing EnFuzion installation directories without asking for new values. This features simplifies the EnFuzion upgrade process. If you wish to change EnFuzion installation directories, uninstall EnFuzion before executing the setup program.
When EnFuzion is being installed to multiple computers, the distribution package is copied to each system, unpacked, and then installed. This installation process can be accelerated by unpacking the distribution package on one system only, and then sharing the directory with the extracted EnFuzion distribution files. This makes the EnFuzion files accessible from other computers, so there is no need for any further file copying and unpacking. In this case, EnFuzion is installed simply by executing the setup program on each computer. For an automated installation of EnFuzion across multiple computers, refer to the Section called Network Installation on Windows NT/2000/XP below.
The distribution package provides the setuproot.exe program for installing only EnFuzion root software on a system. The program can be executed instead of the setup program to perform the root only installation.
Note: If setuproot.exe is used on a system that already has EnFuzion installed with setup.exe or setupnode.exe, the installation must be first removed with uninstall. uninstall is not required if setuproot.exe was used for the previous EnFuzion installation.
The distribution package provides the setupnode.exe program for installing only EnFuzion node software on a system. The program can be executed instead of the setup program to perform the node only installation.
The distribution package provides the setupsubmit.exe program for installing only EnFuzion submit software on a system. The program can be executed instead of the setup program to perform the submit only installation.
If you experienced any problems during the installation process, you can send e-mail to support@axceleon.com to report the problems. Include the following information:
output from the failed installation process
optionally, a description of your system generated with command WINMSD /a /f from computers with a failed installation. This command generates file <hostname>.txt with detailed information about the system.