Change Program Root Password

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

Installation

This plugin can be installed during a Dada Mail install/upgrade, using the included installer that comes with Dada Mail. The below installation instructions go through how to install the plugin manually.

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 when you do a contemporary installation of Dada Mail. Refer to the installation instructions that come with Dada Mail to understand the difference between a contemporary installation and a basic installation. If you use the installer that comes with Dada Mail, you will have a Contemporary Installation of Dada Mail.

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

    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

    If your .dada_config file does not have a part of its content that looks like this, this plugin will not work.

Change permissions of "change_root_password.cgi" to 755

The, change_root_password.cgi plugin will be located in your, dada/plugins diretory. Change the script to, 755

Configure your .dada_config file

Now, edit your .dada_config file, so that it shows the plugin in the left-hand menu, under the, Plugins heading:

First, see if the following lines are present in your .dada_config file:

 # start cut for list control panel menu
 =cut
 =cut
 # end cut for list control panel menu

If they are, remove them.

Then, find these lines:

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

Uncomment the lines, by taking off the, "#"'s:

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

Save your .dada_config 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) 1999 - 2012 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.

Loading