Source for file INSTALL.php

Documentation is available at INSTALL.php

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

Documentation generated on Mon, 05 May 2008 16:20:32 +0400 by phpDocumentor 1.4.0