How to install MLM on your server
MLM stands for Mailing List Manager. To make things simple let’s say it is the online part of MaxBulk Mailer. Indeed it does all what MaxBulk Mailer can’t do by itself. MaxBulk Mailer is a desktop application you run when you need it and quit once you are finished. MLM however is a script running on your web site 24 hours a day, 7 days a week and 365 days a year. MaxBulk Mailer takes advantage of MLM to perform tasks and to offer services that require full time availability. Imagine you were to maintain your computer with MaxBulk Mailer running indefinitely at home or at the office. This is simply inconceivable, hopefully you don’t have to do that since MLM run on a web server and web servers are always running!
MLM installation is optional, yet it adds two important services to MaxBulk Mailer. On one hand it offers the possibility to maintain lists on your web site allowing your visitors to subscribe or unsubscribe from any of them. On the other hand it adds the possibility to find out what happens to a message once it leaves your computer, if it has been opened by a recipient or if a recipient has clicked on a link.
MLM fully integrates with MaxBulk Mailer. Once you have installed MLM on your server and set your subscribe page, everything else is handled transparently. Actually if you did not have to install MLM to your server you would never have heard about it.
MLM installation is supposed to be easy but sometimes it can give problems. It all depends on your server settings. MLM represents a great improvement for MaxBulk Mailer so it is well worth the effort.
There are two ways to install MLM on your server, using the MaxBulk Mailer > Install MLM menu or manually by using you favorite FTP software. This tutorial explains how to install MLM on your server using the MaxBulk Mailer built-in installer. It is made of 5 steps:
Step #1 – MLM Settings
This step is all about MLM settings itself. There are 4 groups of settings numbered 1 to 4. Note that the data used in the screenshot above is just an example. You have to use your own.
1.- Your MLM User ID and Password: Choose whatever you prefer here! This data is to protect the MLM access. MaxBulk Mailer will need this data to access MLM. You will need this data if you decide to access MLM directly with your Web Browser.
2.- Default Language: This is the language that will be used by default by MLM to display responses, errors and so on. It will be the language used for sending emails to the recipient as well.
3.- Your data: It will be displayed on all MLM pages and added to all MLM email messages. In addition administration messages and errors will be sent to ‘E-mail Address’.
4.- Data storage: First select how you want data to be stored, mySQL or Plain Text. If you select ‘Plain Text’ then you are finished with this step, just click on the ‘Next’ button. If you select ‘mySQL’ you will have to type all your mySQL server data below, that is, the server host address, your account ID, your password and the Database you want to use to store your data. Note that you have to use a full access mySQL account, the one that allows you to create tables! If you don’t have any database created just select a name, MLM will create it for you.
Once you are finished click on the Next button.
Step #2 – FTP Server Settings
MLM has to be installed on your web server. The common way to transfer files to a web server is using the FTP protocol, the same protocol used by your favorite FTP client software such as Transmit, Fetch or Core FTP.
1.- Server address, User ID and Password: You have to provide your FTP server address, your user ID and your password. Most of the time your FTP server will be in the form ‘ftp.mywebsite.xxx’. This is the same address, the same user ID and the same password you are using with the FTP software you are using to upload your HTML pages to your site!
2.- FTP path and Web URL: On many servers your public HTML files must be placed into a special folder. It can be labeled ‘public’, ‘html’, ‘public_html’, ‘web’, ‘www’, ‘httpdocs’ or whatever. Perhaps there is no such folder and your public files are located at your account root level. You should know that actually since you already uploaded files to your server, right? Just check and type the public folder here if any. The Web URL is the web address of the site corresponding to your FTP account. Both the Path and the Web URL are used to generate and add the MLM URL to the MaxBulk Mailer preferences. Nothing else actually! If you make an error, that URL will be wrong. You can edit it anytime from the MaxBulk Mailer preferences, second panel. More information on this in step #5.
3.- FTP connection settings: Those settings are here just in case you need to use a different port, a secure protocol or active mode instead of passive. Default settings should be fine though.
Once you are finished click on the Next button. If all the data is correct you will get connected to your FTP server.
Step #3 – Destination folder
As soon as you are connected select the folder where you want MLM to get installed.
1.- Destination folder: You can see where MLM is about to be installed. By default it will be in a folder labeled ‘lm’, inside the folder you select if any. In this example we have created a folder named ’scripts’.
2.- Folder contents: As with any FTP tool, you will see the list of files on the selected folder. In this case it is empty since we just created the script folder and moved to it.
3.- Browsing buttons: You can use those buttons to go back and forward through your server folders.
You can also use the Open button to open a folder (same as double-clicking) and the New Folder to create a new folder in the current directory.
Once you are finished click on the Select button to select the destination folder and to start the installation.
Step #4 – MLM Installation
During the installation you will see the detailed progress and the FTP log below. All the MLM files will be uploaded to your server, then the ‘lm’ folder permissions will be set to 777. If everything goes well you will end with a blue ‘Installation complete’ message and a grey checkmark on each line. If something goes wrong you will get a red error message and a red cross on the line that has produced the error. You can try to install again clicking on the Back button. If the error persists you will have to install MLM manually as explained at the end of this tutorial.
Once you are finished click on the Close button.
Step #5 – Checking the MLM URL in MaxBulk Mailer preferences
Now go to the MaxBulk Mailer preferences, second panel ‘General’. Make sure the URL is correct, you can for example copy and paste it to your browser. You should get a ‘Error – You forgot to provide the command parameter: &cmd=command’ error. That means the link is OK. Also check the ‘Click-Through tracking’ option if you plan to do tracking.
Installation Errors
When you get errors during the installation the best will be to install the software manually. You can do that with a FTP software like Transmit, Fetch, CoreFTP… This how you have to proceed:
1.- Open the lm/lm_settings.php file with a text editor.
2.- Edit the script settings and save (each setting is explained in the file). [1]
3.- Upload the ‘lm’ folder to your FTP server (in your public folder). [2]
4.- Use your FTP software to CHMOD the ‘lm’ folder to 777 (or 775 or 755). [3]
5.- Enter the ‘lm.php’ full URL and your user ID and password to MaxBulk preferences.
6.- If you have selected to use mySQL run the script with the ‘Init’ command:
http://<script_path_here>/lm.php?cmd=init&pwd=password
[1] The lm/lm_settings.php contains all the parameters you can change to customize the script to match your needs. When doing a manual installation it is important to open that file with a plain text editor like Notepad on Windows or TextEdit on the Macintosh.
[2] Never upload MLM to your home root folder if you have a specific folder for public html documents like ‘public’, ‘html’, ‘public_html’, ‘web’, ‘www’, ‘httpdocs’. Just open the folder or any subfolder first!
[3] If you don’t know how to CHMOD a folder with your FTP software please read your FTP software manual. It is possible your server doesn’t like you to CHMOD the ‘lm’ folder to 777 (showing an ‘Internal Server Error’ when you try to run the script with your browser) so just try 775 or 755.
The lm/html folder includes a few sample pages for subscribing customers to your lists (to a fixed single list, a single list from a selection or multiple lists at once) and a sample page for uploading lists to MLM (despite you can do that from MaxBulk Mailer as well).
















