Oldinstall

From . .. poMMo .. .

Jump to: navigation, search

NOTE: This is poMMo's legacy install guide, applicable to versions Aardvark PR10.2 and BELOW. For Aardvark PR11 or above, see the regular Install Guide.

Contents

[edit]

bMail Installation Instructions

22:23, 30 January 2006 (EST)

This document is currently being written. Installation procedure may change up until the release of Aardvark 1.0 final. Please verify that the content of this documentation matches that of the INSTALL file located within your downloaded bMail distribution.
WARNING: Do not install bMail Aardvark 8.3 and below in a database with existing tables used by other programs. They will be lost. Upgrading from earlier versions of bMail will not effect your other tables. If you'd like to install bMail, create a dedicated database for it as per the instructions. CVS versions have been updated to allow for peaceful coexistance in a shared database environment.
[edit]

Aardvark INSTALL GUIDE 


Requirements:
--------------------------------------------------------------------------------

PHP >= 4.1.0 (http://www.php.net/)
        * MySQL support must be active in PHP (check with <? phpinfo(); ?>)

MySQL >= 3.23 (http://www.mysql.com/)
        * You must have permissions to create and edit a MySQL Database.

Quick Install Instructions:

  1. Download and unpack bMail
    • This should create a directory named 'bmail' wherever you unpacked it
  2. Create a database MySQL on your webserver for bMail to use, and a MySQL user to access it.
    • Your webhost should provide a MySQL server and access information
  3. Copy the contents of config.sample.php to config.php (located in the root directory in PR11, or the "setup" directory in PR10.2 and below)
  4. Configure the database, language, and work directory by editing your renamed config.php
    • Open 'config.php' in a text editor and follow the instructions
  5. Move bMail to your webserver
    • Use FTP or another means to transfer the bMail files to your website


[edit]

Using bMail

Once you have copied bMail to your webserver, visit its location on the web. A script will help you through the rest of the way. Once finished, login and visit the settings page to further configure bMail. When configured, you'll want to setup subscriber demographics and generate a subscription form for your website.
[edit]

Upgrading bMail

If you are upgrading bMail simply copy the new files over the old ones. A clean way to do this is to backup your config.php file (in the "setup" directory), then remove the entire bmail directory from your webserver. After this is done, copy the new bmail diretory in the old one's place and replace your config.php file. When finished, visit bMail on your webserver and an upgrade script will automatically be called.
[edit]

Upgrading to PR11

FOR THOSE UPGRADING TO PR11 - The config.php has been relocated to the main (root) directory of your install, and its syntax has changed. The program will complain about not being set up if you do not update your configuration. Please use the config.sample.php as a skeleton, and set your database, work directory, and language values.


[edit]

OLD (Aardvark <= PR6) INSTALL GUIDE 


bMail Aardvark PR Quick Install Guide

Requirements:
--------------------------------------------------------------------------------

PHP >= 4.1.0 (http://www.php.net/)
        * MySQL support must be active in PHP (check with <? phpinfo(); ?>)

MySQL >= 4.0.18 (http://www.mysql.com/)
        * You must have permissions to create and edit a MySQL Database.


Installation:
--------------------------------------------------------------------------------

1) Untar bMail-*.tar.gz (tar xvfz bMail-*.tar.gz)
        * This will create a directory "bmail" containing the program

2) Copy the "bmail" directory underneath your website directory
          ie. (cp bmail /c/apache/your_website/)

3) Create the bmail database
        * Use a frontend to your MySQL database such as PHPMyAdmin to create
          a new database to populate with the bMail structure, or you can use
          the commandline such as:
            mysql -u root -p
            create database mybMail
            GRANT ALL PRIVILEGES ON mybMail.* TO user@localhost IDENTIFIED BY 'password';

        *  The database can be named anything you'd like. You can create a user
           to access the database (such as 'user' in the above example) or just
           access it with the normal/root user you used to create the database.

4) Populate the bmail database with bMail data structure
        * Use a frontend toy your MySQL database such as PHPMyAdmin to import
          "bmail.sql" into your database, or you can use the commandline such as:

          mysql -u user -p mybMail < /path/to/bmail.sql

          where '-u user' should be the user used to connect to the database
                'mybMail' should be the database name
                '/path/to/bmail.sql' should be the location of bmail.sql that
                  was unpacked when you extracted bMail-*.tar.gz

          bmail.sql is included in the distribution and located in the "bmail" directory.

5) Configure bMail
        * edit setup/config.php to setup database access and list parameters.
          Instructions are provided within the file.

        * config.php is in the "setup" directory of your bMail distribution.
          ie. /c/apache/your_website/bmail/setup/config.php

6) Logon to bMail to configure your mailing list and get going...
        * In a web browser, visit-> http://www.yoursite.com/bmail/

        * Configure subscriber demographics, generate the subscription form,
          save it, customize the HTML (optional), link to it on your site.

7) Let me know you're using bMail by emailing me from the bMail website @
    http://bmail.sourceforge.net/
Retrieved from "http://pommo.org/Oldinstall"
Personal tools