Installing Rush on NT


TO INSTALL RUSH
---------------

    1) Unzip the distribution to C:\RUSH
    2) Edit the C:\RUSH\ETC\HOSTS file, and configure hosts to be used by rush
    3) Run the C:\RUSH\ETC\BIN\INSTALL.BAT script to install the daemon,
       and follow any further directions.

    See "NT Install" in the HTML documentation for more info.
    (Thanks to Greg Turian at Black Logic for tips on setting up NT services.)

TO INSTALL WWW-RUSH
-------------------
    www-rush is the cool optional GUI interface to rush; a great way for users 
    to monitor and control render queue jobs. For pictures and docs see:

	http://www.3dsite.com/people/erco/rush/www-rush
    
    'www-rush' is a single perl script found in /rush/cgi-bin/www-rush.pl,
    and should be installed on your internal network's web server.

    It has been tested to work with either Apache/unix, or IIS/NT.
    (IIS is Microsoft's web server that comes with NT Server)

    www-rush will work with IIS, provided:

	o You have properly installed IIS, and enabled 'cgi-bin' scripts.

	o You have installed ActiveState perl (www.activestate.com).
	  On install, be sure to enable the check flags for IIS.

	o You have installed rush on the server, and have included 
	  the server's hostname in the /rush/etc/hosts file.

	o You view www-rush with Netscape. (Explorer has problems)

    Then it's just a matter of putting the www-rush.pl script in IIS's 
    /inetpub/scripts/ directory, tweaking variables at the top if need be.

    To install www-rush on an Apache web server, just put www-rush.pl
    in the cgi-bin directory, like any other cgi-bin script.

REMOTE INSTALL RUSH
-------------------
    It is best to be running a 'remote shell' service on the remote
    machines, so that step #2 can be done with the WinNT 'rsh' command.
    Remote shell services are available from the net.

    1) Copy the entire C:\RUSH directory to the remote machines.
       An example could be:

    	for %i in ( nt1 nt2 nt3 ) do xcopy /e /i C:\RUSH \\%i\C$\RUSH

    2) Invoke \RUSH\ETC\BIN\INSTALL.BAT to install the daemon

    3) Configure the administrator and password for the Rushd service.

       a) Click on Control Panel -> Services -> Rushd
       b) Double click on Rushd, and change the settings to:
       
              This Account: Administrator
	          Password: <ADMIN PASSWORD>
	           Confirm: <ADMIN PASSWORD>

    4) Start the service by clicking 'Start'.
    
       NOTE: You can also start/stop the rushd service from the DOS
             command line via:
       
           net start rushd
	   net stop rushd

TO UNINSTALL RUSH
-----------------

    1) Run the C:\RUSH\ETC\BIN\UNINSTALL.BAT script
    2) Remove the C:\RUSH directory


NT/UNIX CAVEATS
---------------
    If you have a mixture of unix and NT machines, be sure:

	o Your unix machines have a valid user called 'ntuser'

	o The uid/gid for this user is configured in the C:\RUSH\ETC\RUSH.CONF
	  file for ntrushuid and ntrushgid

        o Both Unix and NT machines have the same 'rush hosts' files, 
	  eg. C:\RUSH\ETC\HOSTS is the same as /usr/local/rush/etc/hosts

	o Both Unix and NT machines can resolve each other's hostnames, 
	  eg. you can 'ping' nt machines from unix, and vice versa.

LEGACY DOCS
-----------
    Some old legacy docs are here which show how to manually configure 
    the service. These docs are no longer recommended.