Master Members Only V3

INSTALLATION

TABLE
OF
CONTENTS

Requirements

List of Files

Installing
Master Members Only V3

The Control Panel

Technical Support

Requirements

To install and use Master Members Only V3, these requirements must be met:

Your domain server is Unix or Linux, has sendmail or qmail available, and has Perl version 5+ installed.
The Perl modules LWP::Simple and Time::Local are available on your server. If they aren't, your hosting company will need to install those modules before Master Members Only V3 can be used.

To find out whether or not those Perl modules are on your server, you can ask your hosting company or use Master Pre-Installation Tester.
When installing Master Members Only V3, use an FTP program for uploading files, creating directories, and changing file and directory permissions.

(Note: If your hosting company provides a Control Panel for this purpose, the maximum file size that can be uploaded might be about 32k. Some Master Members Only V3 files are larger than 32k.)

CuteFTP and WS_FTP for Windows, and Transmit for Macintosh, are among the many FTP programs that allow you to change file and directory permissions.

List of Files

{top}

Here is a list of the files you should have received when you generated Master Members Only V3. Depending on how you generated your copy of Master Members Only V3, the files with .cgi extensions may have .pl extensions instead.

admin.cgi
always.cgi
autoadd.cgi
autoaddremote.cgi
bulkadd.cgi
download.cgi
example_autoadd_call.cgi
extend.cgi
extend.html
failedlogin.html
first.htm
forgotpw.html
help.cgi
IndependentVerification.cgi
LicenseAgreement.html
login.html
main.cgi
mainupdate.cgi
MMO_Installation.html
MMO_UserManual.html
nextpage.htm
okay.cgi
outside.html
pwsent.html
README.txt
signup.cgi
signup.html

Here are the files by category:

Installations	Program Files
LicenseAgreement.html MMO_Installation.html MMO_UserManual.html README.txt	admin.cgi always.cgi autoadd.cgi autoaddremote.cgi bulkadd.cgi download.cgi example_autoadd_call.cgi extend.cgi help.cgi IndependentVerification.cgi main.cgi mainupdate.cgi okay.cgi signup.cgi
Example Files
Public Forms and Pages	Members Only Pages
extend.html failedlogin.html forgotpw.html login.html outside.html pwsent.html signup.html	first.htm nextpage.htm

If you did not receive all of the above files, please contact as provided at the Technical Support section of this document.

Installing Master Members Only V3

{top}

Install Master Members Only V3 in a directory that can run Perl CGI programs.

The installation directory will need a subdirectory named data and the data directory will need a subdirectory named p

The data directory will contain the database and configuration files. The p directory will contain the file with your Control Panel password. (The password will be scrambled and located in a file named p.cgi after your first use of the Control Panel.)

If your installation directory is /cgi-bin/mmo/ then the directory structure would look like this:

cgi-bin |
        | mmo |
              | data |
                     | p

Once installed in the mmo directory, Master Members Only V3 will maintain the files in the data and p directories.

Upload the programs into your installation directory. Upload and set file permissions (see Setting permissions) as indicated in the following table:

File Name
File Permission	Required/ Optional	Description
always.cgi
—	Required	always.cgi is used by all of the other Master Members Only V3 programs (except the example file example_autoadd_call.cgi). It contains database formats, subroutines, and other information common to all programs.
admin.cgi
0755/execute	Required	This is the Master Members Only V3 Control Panel. To access the Control Panel, type the URL of this program into your browser.
download.cgi
0755/execute	Optional	This is the program that makes member downloads possible.
help.cgi
0755/execute	Required	This is the popup window help system used by the Control Panel.
mainupdate.cgi
0755/execute	Optional	This program is required only if you let members update their own main member record, their name and email address and so forth.
main.cgi
0755/execute	Required	This is the program that monitors access. The URL to this program is the URL to your members only area.
signup.cgi
0755/execute	Optional	This program adds people to the Master Members Only V3 database when a sign-up form is used. Because other programs (such as e-commerce programs) can add members and members can be added manually, the sign-up form and this signup.cgi program are optional.
extend.cgi
0755/execute	Optional	This program is similar to signup.cgi except it is used to extend memberships when Master Members Only V3 already has the usernames in the database. Like signup.cgi, extend.cgi is optional.
autoadd.cgi
0755/execute	Optional	This program can add members to your Master Members Only V3 database when accessed by other programs (such as e-commerce programs) on your server. The other program will need to pass a secret code in order to get autoadd.cgi to add members. The secret code is specified in the admin.cgi Control Panel.
autoaddremote.cgi
0755/execute	Optional	This program can add members to your Master Members Only V3 database when accessed by other programs (such as e-commerce programs) on a remote server. The remote program will need to pass a secret code in order to get autoaddremote.cgi to add members. The secret code is specified in the admin.cgi Control Panel.
example_autoadd_call.cgi
—	Optional	This program is actually not a working program. Instead, it contains example code that programmers can use to enable external e-commerce programs to pass membership information to autoadd.cgi
IndependentVerification.cgi
—	Optional	This is not a working program. Instead, it contains code programmers can use to make their programs accessible only to members in your Master Members Only V3 database.

{top}

Directory permissions

When the data and p directories are created, they most likely will be created with permissions 755.

If, after initializing the The Control Panel, you can't log back in, verify the data and p directories have 755 permissions.

If the two directories have 755 permissions and you still can't log in after setting the password, give the data and p directories 766 permissions and try again.

If still no joy, give the data and p directories the broadest permissions possible: 777

If things don't work and you can't find the reason, please contact as provided at the Technical Support section of this document.

The Control Panel

{top}

Before installation is complete, initialize the control panel with a password. To do that, type the URL of admin.cgi into your browser.

When you first type the URL of admin.cgi into your browser, you will be asked to provide a password. What you type here will be your password for future access to the Control Panel.

After successfully providing a password and the control panel Main Page is in the browser, you are logged in and the installation is complete. Otherwise, see the "Directory permissions" subsection (above) and adjust the directory permissions.

Technical Support

{top}

Technical support is available via the help desk or the contact page on willmaster.com. The help desk is here and the contact page here.

Thank you for your purchase of Master Members Only V3.