Common Rush Administration Tasks

Preparation

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 activestate.com) 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:

      Unix/Mac
      vi /usr/local/rush/etc/hosts
      rush -checkhosts /usr/local/rush/etc/hosts
      rush -push hosts +any

      Windows
      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:

       Unix
       rsh newhost /usr/local/rush/etc/bin/install.sh
       rsh newhost /usr/local/rush/etc/S99rush start
       
       Windows

           Login as administrator on the new machine, open a DOS window and:

	       a) Run the install script:
		       
		       c:\rush\etc\bin\install
		       
	       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.