The EnFuzion distribution package provides the program Enfinstall, which is able to install EnFuzion on remote Linux/Unix hosts from a central location.
The Enfinstall program can be used to install EnFuzion on remote systems, without any need to access the system's keyboard or monitor. The program can also be used to verify an EnFuzion configuration and copy the options file to the nodes.
The Enfinstall program is called with a command option:
enfinstall <command>
enfuzion
Installs EnFuzion node software on node systems. /usr/local/enfuzion.
verify
Accesses nodes and verifies their installation.
options
Copies the enfuzion.options file to node systems.
collect
Collects the information about EnFuzion nodes.
Enfinstall installs EnFuzion nodes in a heterogeneous network. The program executes on your local root host and installs EnFuzion nodes over the network. The program Enfinstall automatically detects the type of each remote host and installs the corresponding executables.
The program Enfinstall works only on supported Linux/Unix platforms. See the Section called Installation in a Mixed Linux/Unix and Windows NT/2000/XP Environment below to install EnFuzion in mixed environments.
Follow these steps to perform the installation:
Obtain the EnFuzion distribution packages for all Linux/Unix systems in your EnFuzion configuration. Packages are available from the Axceleon Web site.
Copy all the packages to the same directory on the root system. Unpack the packages in that same directory, using the tar and gunzip utilities on your system. The distribution packages and the extraction directories are not required for EnFuzion operation, and you can delete them after the installation.
Go to the extraction directory that contains executables of your root system.
Install EnFuzion root software on the local system by executing the install-root script in the current directory.
Add the path for EnFuzion executables to the PATH environment variable. This step allows you to execute Enfinstall without specifying the entire path. The default path for EnFuzion executables is $HOME/enfuzion/bin, if EnFuzion was installed by a non-root user and /usr/local/enfuzion/bin otherwise.
Prepare the configuration file install.nodes, which contains a list of node hosts.
The configuration file install.nodes contains a description of your EnFuzion network configuration. Each line describes one node. It contains a remote host, a user account on that host, a password and an optional remote access protocol. For example, to install EnFuzion on three hosts called "host1", "host2", and "host3" under user account "user1", the install.nodes file looks as follows:
host1 user1 password [ remote_access ]
host2 user1 password [ remote_access ]
host3 user1 password [ remote_access ]
Optional remote access protocol can be one of "Unix", "UnixRsh", or "ssh". The install.nodes file has the same syntax as the enfuzion.nodes file, which is used after the installation to connect the EnFuzion root system with EnFuzion nodes. More details about the enfuzion.nodes file can be found in the Section called Specifying EnFuzion Nodes in Chapter 6.
Install EnFuzion node executables on remote hosts with the command:
enfinstall enfuzion
EnFuzion is installed in the directory ~/enfuzion on the node for all accounts, except the root account. If the the root user is specified in the install.nodes file, EnFuzion is installed in the directory /usr/local/enfuzion on the node host.
The Enfinstall program must be run from the distribution directory with executables for your local host. Package directories for all nodes in your EnFuzion configuration must be in the same parent directory.
By default, the Enfinstall program uses the standard ftp protocol to copy files. Some ftp servers (e.g., Sun Solaris) do not support the command to set execution permissions. In such cases, Enfinstall issues a warning. If you get such a warning, make sure that the execution permissions for EnFuzion node executables are set on the node hosts. The files that require attention will be reported by Enfinstall on the screen.
Verify the installation of EnFuzion nodes with the command:
enfinstall verify
This command verifies that EnFuzion is correctly installed. For all EnFuzion nodes in your configuration, it starts the node, establishes a connection and reports whether the node is operational. Alternatively, it reports any errors encountered.
If you decide to use the load monitoring features of EnFuzion, install the enfuzion.options file with the command:
enfinstall options
This command will copy the options file to remote hosts. It will ask you for the installation directory. The use of the default install directory is recommended. The file enfuzion.options must be in the current directory. Details on the contents of the enfuzion.options file can be found in the Section called The enfuzion.options File in Chapter 7.