The EnFuzion distribution package provides the program netsetup, which is able to install EnFuzion on remote Windows NT/2000/XP hosts from a central location.
The Netsetup 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 control the EnFuzion Starter Service on remote computers. Netsetup is implemented only on the Windows NT/2000/XP platform. On Linux/Unix, the enfinstall program provides similar functionality, as described in Chapter 4.
The netsetup program is called with a set of options, followed by a command and possible command options:
netsetup [ <option> ] <command>
-v
Prints the netsetup program version and options.
-d
Reads EnFuzion nodes from standard input instead of from the file install.nodes.
-p
Prints command progress.
-t <number>
Executes the command concurrently on at most <number> hosts. The default value is 1, so the command is executed sequentially for each host.
install \\<host>\<share>\<source> <destination>
Installs EnFuzion executables from a source directory to the destination directory on hosts specified in the file install.nodes. Options are as follows:
<host> is the name of the host where the EnFuzion package has been unpacked and has been made available for access over the network.
<share> is the name of the share on the <host>, which contains the <source> directory.
<source> is the directory containing the setup program and other EnFuzion distribution files.
<destination> is required for the initial EnFuzion installation. It specifies the EnFuzion installation directory. Its recommended value is C:\enfuzion. <destination> is not required, if EnFuzion is already installed on systems.
uninstall
uninstalls EnFuzion from all hosts.
start
starts the EnFuzion Starter Service.
stop
stops the EnFuzion Starter Service.
delete
deletes the EnFuzion Starter Service from the service control manager database.
verify
prints EnFuzion Starter Service status information.
The following steps are required to perform a remote installation:
Unpack the EnFuzion distribution package into the source directory.
Make the source directory a shared directory so that it is visible to other system where EnFuzion is to be installed. On a Windows XP source computer, simple file sharing must be disabled (see the Section called Windows XP Remote Installation).
Manually install EnFuzion on the local system from the source directory to the local destination directory.
Create the file install.nodes containing all the nodes where EnFuzion is to be installed. Place the install.nodes file in the Config subdirectory of the main EnFuzion directory. The default path is C:\enfuzion\config.
For the initial EnFuzion installation, the EnFuzionStarter Service is installed on all EnFuzion node computers. Users can specify domain and user name which are used to make initial installation of the EnFuzion Starter Service. User and domain name can be specified in the install.nodes file by writing the user name as domain_name\user_name or as user_name@domain_name. In case the user name is written without a domain, the user name on the local host is used for the initial Starter Service installation, which is equivalent to .\user_name. The node user must have the rights to connect to the node from the network, to install a service on the node system and to connect back from the node system to the system with the installation directory share.
To make an initial installation of EnFuzion, all the users on nodes in file install.nodes must have administrative rights.
Grant required user rights, if the installation is performed for the first time. They are necessary to install and start the Starter Service the first time. The additional user rights must be granted to the user, usually administrator, that is used to run the netsetup command. These rights must be granted on the root system and on all node systems. In addition to default user rights set when Windows NT/2000/XP are installed, the following additional user rights must be set for a user which will be used for initial EnFuzion installation:
Act as part of the operating system
Log on as a service
Replace a process level token
If EnFuzion has already been installed on a node and the current installation is performed by a user without administrative rights, all EnFuzion programs except the Starter Service will be upgraded.
Run the Netsetup program.
Netsetup executes the setup.exe program on all nodes where EnFuzion is installed. For example, to install EnFuzion from host gemini containing EnFuzion files on drive D:\enFuzion\install with drive D: shared as "d", execute the command:
netsetup install \\gemini\d\enfuzion\install C:\enfuzion
In case EnFuzion security features are enabled on nodes, the host from which netsetup is executed and the setup.exe must be defined as trusted in file enfuzion.security. A full path name of setup.exe must be specified in the security file:
\\nthost\share\source_dir\setup.exe
To be able to perform an installation in the example above, the following lines must be added to the enfuzion.security file on nodes:
allow host gemini
allow executable \\gemini\d\enfuzion\install\setup.exe
In order to remotely install and start the Starter Service on a Windows XP computer, simple file sharing must be disabled on the root system.
Follow the following steps to disable Simple File Sharing on XP Professional:
Click Start > My Computer > Tools > Folder Options
Select the View tab
Go to Advanced Settings,
Clear the Use Simple File Sharing box
Click Apply