Change Program Root Password (Experimental)
- NAME
- DEPRECATED
- VERSION
- USAGE
- DESCRIPTION
- Installation
- CONFIGURATION AND ENVIRONMENT
- DEPENDENCIES
- INCOMPATIBILITIES
- BUGS AND LIMITATIONS
- AUTHOR
- LICENSE AND COPYRIGHT
NAME
change_root_password.cgi - EXPERIMENTAL Dada Mail plugin to allow you to easily change the Dada Mail Root Password.
DEPRECATED
The plugin, change_root_password.cgi has now landed itself on the DEPRECATED list of plugins that comes with Dada Mail. Since the new, Global Config plugin allows you to easily change the Dada Mail Root Password, amongst many other things, this plugin can now be retired.
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:
$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
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 => $S_PROGRAM_URL."/plugins/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 => $S_PROGRAM_URL."/plugins/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: https://dadamailproject.com/contact
LICENSE AND COPYRIGHT
Copyright (c) 1999 - 2023 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.