[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3  * @package Mambo Open Source
   4  * @copyright (C) 2005 - 2006 Mambo Foundation Inc.
   5  * @license http://www.gnu.org/copyleft/gpl.html GNU/GPL
   6  *
   7  * Mambo was originally developed by Miro (www.miro.com.au) in 2000. Miro assigned the copyright in Mambo to The Mambo Foundation in 2005 to ensure
   8  * that Mambo remained free Open Source software owned and managed by the community.
   9  * Mambo is Free Software
  10  */ 
  11  
  12  // no direct access
  13  defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );
  14  ?>
  15  
  16  REQUIREMENTS
  17  ------------
  18  
  19  First you must have the base environment for Mambo.
  20  We have thoroughly tested Mambo on: Linux, Free BSD, Mac OS X and Windows NT/2000.
  21  Linux or one of the BSD's are recommended, but anything else that can run the
  22  3 pieces of software listed below should do it.
  23  
  24  Apache    -> http://www.apache.org
  25  MySQL    -> http://www.mysql.com
  26  PHP    -> http://www.php.net
  27  
  28  
  29  SERVER CONFIGURATION
  30  --------------------
  31  
  32  You MUST ensure that PHP has been compiled with support for MySQL and Zlib
  33  in order to successfully run Mambo.
  34  
  35  While we have reports that Mambo works on IIS server we recommend Apache
  36  for running Mambo on Windows.
  37  
  38  
  39  OPTIONAL COMPONENTS
  40  -------------------
  41  
  42  If you want support for SEF (Search Engine Friendly) URLs, you'll need mod_rewrite and the ability to
  43  use local .htaccess files.
  44  
  45  
  46  INSTALLATION
  47  ------------
  48  
  49  1. DOWNLOAD Mambo
  50  
  51      You can obtain the latest Mambo release from:
  52          http://source.mambo-foundation.org/Remository/Download/Mambo_Core_Files/.
  53  
  54      Copy the tar.gz file into a working directory e.g.
  55  
  56      $ cp MamboVx.x.x-Stable.tar.gz /tmp/Mambo
  57  
  58      Change to the working directory e.g.
  59  
  60      $ cd /tmp/Mambo
  61  
  62      Extract the files e.g.
  63  
  64      $ tar -zxvf MamboVx.x.x-Stable.tar.gz
  65  
  66      This will extract all Mambo files and directories.  Move the contents
  67      of that directory into a directory within your web server's document
  68      root or your public HTML directory e.g.
  69  
  70      $ mv /tmp/Mambo/* /var/www/html
  71  
  72      Alternatively if you downloaded the file to your computer and unpacked
  73      it locally use a FTP program to upload all files to your server.
  74      Make sure all PHP, HTML, CSS and JS files are sent in ASCII mode and
  75      image files (GIF, JPG, PNG) in BINARY mode.
  76  
  77  
  78  2. CREATE THE Mambo DATABASE
  79  
  80      Mambo will currently only work with MySQL.  In the following examples,
  81      "db_user" is an example MySQL user which has the CREATE and GRANT
  82      privileges.  You will need to use the appropriate user name for your
  83      system.
  84  
  85      First, you must create a new database for your Mambo site e.g.
  86  
  87      $ mysqladmin -u db_user -p create Mambo
  88  
  89      MySQL will prompt for the 'db_user' database password and then create
  90      the initial database files.  Next you must login and set the access
  91      database rights e.g.
  92  
  93      $ mysql -u db_user -p
  94  
  95      Again, you will be asked for the 'db_user' database password.  At the
  96      MySQL prompt, enter following command:
  97  
  98      GRANT ALL PRIVILEGES ON Mambo.*
  99          TO nobody@localhost IDENTIFIED BY 'password';
 100  
 101      where:
 102  
 103      'Mambo' is the name of your database
 104      'nobody@localhost' is the userid of your webserver MySQL account
 105      'password' is the password required to log in as the MySQL user
 106  
 107      If successful, MySQL will reply with
 108  
 109      Query OK, 0 rows affected
 110  
 111      to activate the new permissions you must enter the command
 112  
 113      flush privileges;
 114  
 115      and then enter '\q' to exit MySQL.
 116  
 117      Alternatively you can use your web control panel or phpMyAdmin to
 118      create a database for Mambo.
 119  
 120  
 121  3. WEB INSTALLER
 122  
 123  Finally point your web browser to http://www.mysite.com where the Mambo web
 124  based installer will guide you through the rest of the installation.
 125  
 126  
 127  4. CONFIGURE Mambo
 128  
 129  You can now launch your browser and point it to your Mambo site e.g.
 130  
 131     http://www.mysite.com -> Main Site
 132     http://www.mysite.com/administrator -> Admin
 133  
 134  You can log into Admin using the username 'admin' along with the
 135  password that was generated or you chose during the web based install.
 136  
 137  
 138  MAMBO ADMINISTRATION
 139  ---------------------
 140  
 141  Upon a new installation, your Mambo website defaults to a very basic
 142  configuration with only a few active components, modules and templates
 143  (CMTs).
 144  
 145  Use Admin to install and configure additional CMTs, add users, select
 146  default language and much more.
 147  
 148  Note that additional community-contributed CMTs and languages are
 149  available at http://mamboxchange.com.