Manual Install instructions for Mambo
Created: February 15th, 2003

Getting started

First you must have the base environment for Mambo.  We have tested Mambo on Linux and FreeBSD, Mac OS X, Windows NT/2000.  Linux or one of the BSD's are recommended, but anything else that can run the 3 pieces of software listed below should do it.

Getting Mambo

You will find the latest version at http://sourceforge.org/projects/mambo

Installing Mambo

First up, download the Mambo tar package. You can run Mambo as a full site (http://www.mysite.com/) or you can run it in a subdirectory of another site e.g. http://www.mysite.com/mambo/. You just have to edit the configuration.php file to tell Mambo where it is.  In this example it will run in a directory of a web site:

  1. Make a directory for the web site files:
    mkdir /usr/local/www/mywebspace/mambo

  2. Mambo is packaged in gzip and tar format. Untar the file into the directory:
    tar -xvfz latest_mambo_version.tar.gz -C /usr/local/www/mywebspace/mambo/
    (Make sure you have a trailing slash and replace latest_mambo_version with the version you have downloaded)

  3. Now you have to create a database for Mambo in MySQL, you can choose any name you want, just remember to edit the configuration.php file with the name you choose. Use the mysqladmin command:
    mysqladmin -uroot -ppassword create mambo_database_name

  4. Import the SQL database tables into your newly created database from the "sql/mambo4.sql" text file:
    mysql -uroot -ppassword mambo_database_name < sql/mambov4.sql

  5. Make a copy of the "configuration.php" file in your web directory and edit this file with the correct database name, password, host and directory info.

    Example:

    <?php
    $version = '4.0.12';
    //**********************************
    //* Database configuration section *
    //**********************************
    $host = 'localhost';
    $user = 'mysqluser';
    $password = 'mysqlpassword';
    $db = 'Mambo';
    $dbprefix = 'mos_'; // Do not change unless you know what you are doing!
    //*******************************
    //* Site specific configuration *
    //*******************************
    setlocale (LC_TIME, "en_GB"); // Country locale
    $lang = 'eng';
    $absolute_path = '/usr/local/www/data/Mambo'; // Make sure there is no trailing slash
    $live_site = 'http://www.yoursite.com/Mambo';// Make sure there is no trailing slash
    $sitename = 'Mambo 4.0.12';
    $phpmyadmin = ''; // Path to phpMyAdmin
    $popup = 0; // 0 = no pop-up windows 1 = allow pop-up windows
    $shownoauth = true; // Display links&cats user doesnt have access to - will see Unauth msg
    $local_backup_path = $absolute_path.'/administrator/backups';
    //**********************************************
    //* Do not change ANYTHING below this line !!! *
    //**********************************************
    $pdf_path = $absolute_path.'/pdf/';
    $image_path = $absolute_path.'/images/stories';
    $col = 3;
    $row = 3;
    if ($directory !='uploadfiles'){
    $title[0]='Story Images';
    $dir[0]=$absolute_path.'/images/stories';
    $picurl[0]=$live_site.'/images/stories/';
    $tndir[0]=$live_site.'/images/stories/';
    } else {
    $title[0]='Uploaded File Images';
    $dir[0]=$absolute_path.'/uploadfiles/$Itemid';
    $picurl[0]=$live_site.'/uploadfiles/$Itemid';
    $tndir[0]=$live_site.'/uploadfiles/$Itemid';
    }
    ?>


  6. You will need to change the permissions of the images/, /pdf and uploadfiles/ directories to 777, this should be done recursively:
    chmod -R 777 images
    chmod -R 777 uploadfiles
    chmod -R 777 newsfeeds
    chmod -R 777 pdf

Logging into the administration site

Go to
http://www.yoursite.com/administrator/

username: admin
password: admin

Admin email Address

When you login to the administration section of Mambo for the first time,remember to change the email address of the administrator to your own. This way you will receive all emails automatically sent by the system.

Sections and sub-sections (Administration)

Sub-Sections can only be added to a Section that is not a mambo component or a web-link. If you wish to create a Sub-Section, you must first create the main menu Section. This will populate the Section drop down box on the create new Sub-Section form, and allow the Sub-Section to be created.

** FINISHED! *