Change Program Root Password

- NAME
- VERSION
- USAGE
- DESCRIPTION
- CONFIGURATION AND ENVIRONMENT

- Please Read Before Installing
- Upload change_root_password.cgi into the plugins directory
- Configure the Config.pm file

- DEPENDENCIES
- INCOMPATIBILITIES
- BUGS AND LIMITATIONS
- AUTHOR
- LICENCE AND COPYRIGHT

# NAME

change_root_password.cgi - EXPERIMENTAL Dada Mail plugin to allow you to easily change the Dada Mail Root Password.

# VERSION

Refer to the version of Dada Mail you're using - NEVER use a version of this proggy with an earlier or later version of Dada Mail.

# USAGE

This script is a Dada Mail plugin. Once configured, you should be able to log into your list and access this plugin under the, Plugins menu.

Note, that by default, this plugin can only be accessed if you log into a list using the Dada Mail Root Password.

# DESCRIPTION

....

# CONFIGURATION AND ENVIRONMENT

## Please Read Before Installing

Before getting into configuration of the plugin, do note that this is an experimental plugin, so it is slightly awkward in a few places. Make sure you have the correct environment set up to use it.

Here's what you'll need to have:

- Outside Config File (.dada_config)

  Currently, this plugin only works with the outside configuration file called, .dada_config. For information on how to set up the outside config file do see:

  http://dadamailproject.com/purchase/sample_chapter-dada_mail_setup.html

- Specific Markers in the Outside Config File

  This plugin very simply looks for a, Start Marker and an, End Marker and between these two markers should be the following variables:

  - $ROOT_PASS_IS_ENCRYPTED

    (can either be set to 1 or 0)

  - $PROGRAM_ROOT_PASSWORD

  By default, the two markers are set in this very plugin under the variables, $Start_Marker and $End_Marker. So, in your .dada_config file, you should have something that looks similar to this:

       # Start Root Password

       $ROOT_PASS_IS_ENCRYPTED = 1;

       $PROGRAM_ROOT_PASSWORD  = 'S5R8IqNB7C3cQ';

       # End Root Password

  So, following the advanced installation instructions, this is what your outside config file would look like:

       my $DIR = '/home/account/.dada_files';
       #---------------------------------------------------------------------#
       $PROGRAM_URL              = 'http://www.yoursite.com/cgi-bin/dada/mail.cgi';

       # Start Root Password

       $ROOT_PASS_IS_ENCRYPTED = 0;

       $PROGRAM_ROOT_PASSWORD  = 'root_password';

       # End Root Password

       $MAILPROG                 = "/usr/sbin/sendmail";
       #---------------------------------------------------------------------#
       $FILES                    = $DIR . '/.lists';
       $TEMPLATES                = $DIR . '/.templates';
       $TMP                      = $DIR . '/.tmp';
       $BACKUPS                  = $DIR . '/.backups';
       $ARCHIVES                 = $DIR . '/.archives';
       $LOGS                     = $DIR . '/.logs';
       #---------------------------------------------------------------------#

  One of the more interesting features of this plugin is that no matter if you had your current Dada Mail Root Password encrypted before, changing it via this plugin will encrypt to the Dada Mail Root Password.

  Once your `.dada_config` file is configured like this, you are ready to use this plugin.

## Upload change_root_password.cgi into the plugins directory

We're assuming your cgi-bin looks like this:

     /home/account/cgi-bin/dada

and inside the dada directory is the mail.cgi file and the DADA (uppercase) directory. Good! Make a new directory in the dada directory called, plugins.

Upload your tweaked copy of change_root_password.cgi into that plugins directory. chmod 755 change_root_password.cgi

## Configure the Config.pm file

This plugin will give you a new menu item in your list control panel. Tell Dada Mail to make this menu item by tweaking the Config.pm file. Find this line (or the `line(s)` similar) in Config.pm file:

     #                                      {-Title      => 'Change the Program Root Password',
     #                                       -Title_URL  => $PLUGIN_URL."/change_root_password.cgi",
     #                                       -Function   => 'change_root_password',
     #                                       -Activated  => 0,
     #                                      },

Uncomment it (take off the ``#'''s)

Save the Config.pm file.

# DEPENDENCIES

You'll most likely want to use the version of this plugin with the version of Dada Mail is comes with.

# INCOMPATIBILITIES

# BUGS AND LIMITATIONS

Please, let me know if you find any bugs.

# AUTHOR

Justin Simoni

See: http://dadamailproject.com/contact

# LICENCE AND COPYRIGHT

Copyright (c) 2006-2008 Justin Simoni All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.