[Summary view] [Print] [Text view]

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