ACP  is  basically  a  wrapper  for  ssh  and scp that allows a user to
select, or manually enter, a group of hosts to connect  to.   The  user
can  run  a command or copy some files/directories to multiple hosts by
issuing a single command on the "admin" host.  ACP (AdminCoPy) requires
the fping program as it checks the specified hosts for connectivity and
will only try to run the command/copy  files  to  the  hosts  that  are
reachable.


To copy a file or a directory to multiple machines:
     Usage: acp -c   
         
         ex:   acp -c buh.dat /home/html/
   
To remotely run  on multiple machines:
      Usage: acp -r 
           
         ex:   acp -r uptime

acp will prompt you for the hosts to use, there are
predefined groups, or you can enter your own.

To view the lists of predefined hosts:
	 Usage:  acp -l


INSTALLATION

For systemwide installation, as root run the install.sh script in the
distribution directory.  This will install acp into /usr/loca/bin (or
the directory you specifify) and install the man page as well.	

For local (non-root user) install, just copy the acp script to a 
directory you have access to and you're ready to go.

============================================================================

CONFIGURATION

Edit the acp script and take a look at the CONFIGURATION section.
You'll need to check/set the paths for fping and ssh/scp.

You also need to define the group list and create the matching
host arrays.  The @group_names array should contain a list of
host groups (dev, prod, corp, home, etc) and not specific hosts.

Create the mathcing @{host_list} arrays that contain the hostnames
in the specified group list.

	1) edit acp
	2) modify the "@group_names=();" array:
		@group_names=("list1","list2");
	   The Group names are what will be displayed when the script
	   is run and the user is presented with the names, so make them
	   short but descriptive.
	3) create matching host lists:
		@list1=("host1","host2",...,"hostX");
		@list2=("111","222");

===========================================================================

USE

To copy a file or a directory to multiple machines:
     Usage: acp -c  

         ex:   acp -c buh.dat /home/html/

To remotely run  on multiple machines:
      Usage: acp -r 

         ex:   acp -r uptime

acp will prompt you for the hosts to use, there are
predefined groups, or you can enter your own.

To view the lists of predefined hosts:
         Usage:  acp -l