[ deltree 2.2.3 install instructions ]



--- This script should be installed/upgrade has "root" user !!

--- For Upgrade Instructions jump to the bottom of the file


Unpack the file ( you done this probably, right ;) )
tar -xvf deltree_2_2_3.tar              for .tar

tar -xvfz deltree_2_2_3.tar.gz          for .tar.gz

bzip2 -d deltree_2_2_3.tar.bz2          for .tar.bz2
tar -xvf deltree_2_2_3.tar              for .tar.bz2

unzip deltree_2_2_3.zip                 for .zip

rar x deltree_2_2_3.rar                 for .rar


################################################################
To install this script simply copy the 3 main files into any
directory in the PATH variable. To check the PATH type [ set ]
or [ echo $PATH ].

3 Files are :
          deltree            -> The Script
          deltree.conf       -> Main Configuration File
          deltree_users.conf -> Special Users Configuration File

Example ( in my case ): cp deltree* /usr/local/progs/scripts

"VERY IMPORTANT !!!!!!"
To prevent nasty security problems file permissions should be
	-rwxr-xr-x    root root      deltree
	-rw-r--r--    root root      deltree.conf
	-rw-r--r--    root root      deltree_users.conf
to do this type :
        chown root:root deltree*
        chmod 755 deltree
        chmod 744 deltree.conf
        chmod 744 deltree_users.conf


"Extra"
Verify if the PATH to the ksh that i put on the script is
correct on the first line of the script [ #!/usr/bin/ksh ], if
that is incorrect in your system fix it.
To determine were that ksh executable is type [ which ksh ].
If you don't have Korn Shell the script will most possibly work
under Bash Shell or the HP-UX posix shell ( sh ).
To edit the script use any ASCII Editor, [ vi ] if you must i
hate it :).


"Advanced Installation"
If you want the configuration files ( .conf ) on a different
directory, hack ( edit :) ) the script and replace the line
[ CONF_FILE_PATH="EMPTY" ] with your path, by example 
[ CONF_FILE_PATH="/etc/deltree.conf" ] and move the
[ deltree.conf ] file to there.
Do also the same for the [ deltree_users.conf ], here edit the
file and look for the line [ CONF_USERS_FILE_PATH="EMPTY" ] and
change it to by example
[ CONF_USERS_FILE_PATH="/etc/deltree_users.conf" ], finally
copy the .conf files into your path's.


"Configure Deltree"
   - Type [ deltree -ac ] to use the reconfiguration menu.

   - About the [ mv ] command configuration
       Starting from version 2.1.0 the deltree script supports
       systems were the [ mv ] command is unable to move
       files or directories across different file systems.
       If your [ mv ] command supports this or your systems has
       only one file system, "/" ( root ) configure option ( 8 )
       with [ Yes ] else configure has [ No ].

   - About [ rm ] syntax support
       Starting with version 2.2.0 you can now call deltree with
       rm syntax ( ex.: deltree -fR file = rm -fR file ), this
       means that you can use a alias to call deltree each time
       a user uses [ rm ].

   - For ALL details about the configuration read the Online
     Help.


"Special Users"
If you want to configure special users, meaning users that do
NOT follow the rules configured in the main configuration file,
type [ deltree -au ] and follow the instructions written there.
To check out the available parameters type [ deltree --help ] or
simply [ deltree ], to check some examples type [ deltree -x ].



################################################################
"Upgrading"

To upgrade you DO NOT need to lose the present configuration.

  - First fix the new deltree permissions if required type:
      chown root:root deltree
      chmod 755 deltree

  - If your deltree configuration files are on a different
    directory in relation to the old deltree, hack the new
    deltree just like in the old deltree, if you don't remember
    READ the "Advanced Installation" in order to see the
    procedures.

  - copy the new deltree over the old one.
    ex.: cp -f /tmp/deltree_2_2_3/deltree /usr/scripts/deltree

  - If you are updating from versions bellow 2.2.0 ( not
    including ), reconfigure deltree in order to configure the
    new option(s), [ deltree -ac ], for questions read the
    Online Help, else do nothing.

################################################################


Enjoy
Miguel Angelo - miguel_a_l@hotmail.com






