Rush Logo Rush Render Queue - Common Admin Tasks
(C) Copyright 1995,2007 Greg Ercolano. All rights reserved.
V 102.43 04/10/08

Common Rush Administration Tasks

   Adding Hosts to Rush  


    To add new machines to the rush network, *first* make sure the new machines are configured correctly on the network as per these prerequisites. Some specifics:

    • Make sure they have their own static IP addresses
    • Make sure the hostnames are registered in your name lookup system (DNS, LDAP, NIS, /etc/hosts, etc)
    • Software firewalls: either turn them off, or allow Rush TCP and UDP port 696
    • Macs: make sure you have a HOSTNAME=xxx entry in /etc/hostconfig (and reboot)
      This prevents problems with hostname resolution and Rendezvous/Bonjours

    Double check that hostname lookups are working correctly:

    • Verify the new machines are 'ping'able by their hostname:

      ping newhost

    • If using DNS, verify forward and reverse lookups using 'nslookup' from a DOS or Unix shell:

      echo newhost | nslookup
      echo newhost_ip_address | nslookup

    Also: If your new hosts are Windows machines, be sure to install Perl (from on each.

Installing Rush

    Start on the license server logged in as 'root' (UNIX) or administrator (WINDOWS):

    1) Add the new hostnames to the license server's rush/etc/hosts file, then push your changes to the network.

      You can either use rushadmin:

        a) Click on 'hosts'
        b) Duplicate one of the existing entries, and modify
        c) Hit 'Save'
        d) Hit 'Send'

      ..or use the command line and a text editor to do the same thing, eg:

            vi /usr/local/rush/etc/hosts
            rush -checkhosts /usr/local/rush/etc/hosts
            rush -push hosts +any
            edit \rush\etc\hosts               -- the DOS 'edit' program
            rush -checkhosts \rush\etc\hosts
            rush -push hosts +any
    2) Copy the entire rush directory from a similar platform to the new machines:
           Unix/Mac: rcp -rp /usr/local/rush newhost:/usr/local/rush
            Windows: xcopy /i /e c:\rush \\newhost\c$\rush
    3) Run the install script and start the daemon on each new machine:
           rsh newhost /usr/local/rush/etc/bin/
           rsh newhost /usr/local/rush/etc/S99rush start
               Login as administrator on the new machine, open a DOS window and:
    	       a) Run the install script:
    	       b) Go into Start | Control Panel | Admin Tools | Services | Rushd,
    		  and set the account name and password for the service.
    	       c) Start the service:
    		       net start rushd
    4) Verify the daemon has started:
    	rush -ping newhost1 newhost2 newhost3
      If some don't respond, take a look in both the newhost's rushd.log and the license server's rushd.log to see what the error is.

      The most common problems are hostnames not being in ALL the rush/etc/hosts files, or misconfigured IP addresses in either the name lookup system, or the actual static IP config on the machines themselves.

    5) Done.

   Removing Hosts from Rush  

    1) Offline Rush for the machine being removed.

             rush -getoff oldhost

      This will requeue frames that were rendering to other machines, and prevent new frames from starting, so that you don't have jobs with 'stuck frames' when you disable Rush on the box.

    2) Stop the daemon and disable it from booting.

    Login to the old machine as root, and then:

      a) Stop the daemon:

             UNIX: /usr/local/rush/etc/S99rush stop
          WINDOWS: net stop rushd

      b) Disable the rushd service.

             Go into Start | Control Panel | Admin Tools | Services | Rushd
             and change the service from 'Automatic' to 'Disable'.
             Mac OSX
             Change the RUSHSERVER entry in /etc/hostconfig from "-YES-" to "-NO-".
             You can either do this manually with vi(1) or pico(1), or just run this
             single shell command:
             (echo g/RUSHSERVER=/s/-YES-/-NO-/g; echo wq) | ex /etc/hostconfig
             chkconfig rush off

    3) On the license server, remove the old machine from rush/etc/hosts and push the changes to the network.

      You can either use rushadmin(1):

        1) Click 'hosts' (to edit the hosts file)
        2) Remove (or comment out) the entry
        3) Hit 'Save'
        4) Hit 'Send' to update the network

      ..or just edit the file with a text editor and use rush -push:

            vi /usr/local/rush/etc/hosts
            rush -checkhosts /usr/local/rush/etc/hosts
            rush -push hosts +any
            edit \rush\etc\hosts               -- the DOS 'edit' program
            rush -checkhosts \rush\etc\hosts
            rush -push hosts +any

    4) Done.

      Optional: if you don't intend to use Rush again on this machine, you can remove it from the machine's disk drive:

        rm -rf /usr/local/rush

        rmdir /s c:\rush