Master Syndication Gateway V2

INSTALLATION MANUAL

Requirements

To install and use Master Syndication Gateway V2, these requirements must be met:

1. Your domain server must be Unix/Linux and have Perl version 5+ installed.
    
2. An FTP program is required for uploading files, creating directories, and changing 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 Syndication Gateway V2 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 CHMOD (change directory and file permissions). These are all available for download at http://tucows.com/

List of Files

{top}

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

LicenseAgreement.html
MSG.cgi
MSGalways.cgi
MSGcp.cgi
Master-Syndication-Gateway-V2-Installation.html
Master-Syndication-Gateway-V2-Users-Manual.pdf
README.txt

Here are the files by category:

If you did not receive all of the above files, see Technical Support.

Also available (see Technical Support section, below, for URL):

1. The User's Manual in PDF format for alternate paper sizes.

2. A few documents, slanted for you and slanted for web site owners who will be syndicating your content, all in PDF format available for several paper sizes.

Getting Started

{top}

Creating directories
Installing the program
Setting permissions

      Creating directories

Master Syndication Gateway V2 is a set of programs. You'll probably want to create a directory within your "cgi-bin" to install Master Syndication Gateway V2. This will allow you to keep the set of programs separate from other CGI programs you have installed or may install in the future. For example, you might name that directory: msg

The Program Directory (named msg in our example) has a subdirectory. It must be named MSGdata and have global write permission. (See Setting permissions.) Note: Directory and file names are case sensitive.

The MSGdata directory is where the various Master Syndication Gateway V2 databases are located.

The MSGdata directory has its own subdirectory. It must be named p and have global write permission. (See Setting permissions.)

The p directory is where the file containing your own Control Panel password is located. (The password will be scrambled and located in a file named "p.cgi" after your first use of the Control Panel.)

This is how the directory structure might look:

cgi-bin |
        | msg |
              | MSGdata |
                        | p

Once installed in the msg directory, Master Syndication Gateway V2 will maintain the files in the MSGdata and p directories.

{up}

{top}

      Installing the program

Upload the program files into the directory you decided upon above. Upload the files as ASCII/plain text and set file permissions (see Setting permissions) as indicated in the following table:

{up}

{top}

      Setting permissions

Permissions can be set via telnet or with some FTP programs.

Perl CGI scripts should be set with global read/execute permissions.

Directories for Perl CGI scripts should be set with global read/execute permissions. Some servers have different configurations, so if that doesn't work give the directory global read/write permissions. If it still doesn't work, try global read/write/execute permissions;

Here are the permission numbers translated into defining attributes:

Using Master Syndication Gateway V2

{top}

When you first type the URL of MSGcp.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 the password screen, the main page will have two or more buttons. When Master Syndication Gateway V2 is first installed, only the "Basic Configuration" and "Create a New Channel" buttons will be available.

Do "Basic Configuration" first. Then do "Create a New Channel." After you have created a channel, the rest of the buttons will show up.

Please see the user's manual for further software operation instructions.

Technical Support

{top}

See http://willmaster.com/contact.shtml or any of the "Contact" links of our various web sites for a form that can be used to initiate technical support. http://willmaster.com/master/gateway1/support/ also has a "Contact" link.

http://willmaster.com/master/gateway1/support/ contains links to user and information manuals to make your life easier. These are in PDF format and are available in several page sizes.

The FAQ at http://willmaster.com/support/faq/ can be consulted for answers to common questions. And the CGI Q&A Forum at http://willmaster.com/support/cgi-bin/forum/MBP.cgi can be used to ask questions whose answers may be of interest to others.

If you prefer to have us install Master Syndication Gateway V2 for you, professional installation information can be found at http://willmaster.com/master/installation.shtml

Thank you for your purchase of Master Syndication Gateway V2.

Copyright 2001,2004,2005 William Bontrager