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

When Master Syndication Gateway V2 control panel is first accessed (see Using the Software), it should automatically create subdirectories. This works on most servers.

If automatically creating subdirectories does not work on your server (you can tell if the password doesn't get remembered), then the directories will need to be created manually with your FTP program.

The Program Directory (named msg in our example) has a subdirectory. It must be named MSGdata (The MSGdata directory is where the various Master Syndication Gateway V2 databases will be located.)

The MSGdata directory has its own subdirectory. It must be named p (This directory is where the file containing your own Control Panel password, scrambled, will be located.)

This is how the directory structure might look:

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

Directory permissions should be okay as created with an FTP program. But sometimes they need to be changed.

If, after you install the Master Syndication Gateway V2 software, the control panel won't store the password, then the directories will need different permissions. For directory permissions, try 0755 first. After that, 0766 and, if still no joy, 0777. (See Setting permissions)

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 with an FTP program as ASCII/plain text and set file permissions to 755 (see Setting permissions).

{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}

To contact us, use the form at http://www.willmaster.com/contact.php.

http://www.willmaster.com/software/gateway1/support/ contains links to user and information manuals.

The FAQ at http://www.willmaster.com/support/faq.php can be consulted for answers to common questions. And the Support Forum at http://willmaster.com/support/forum/viewforum.php?f=2 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://www.willmaster.com/software/information/professional-installation-for-your-software.php

Thank you for your purchase of Master Syndication Gateway V2.

Copyright 2001,2004,2005 William Bontrager