Mambo > Projects > Mambo CMS > SVN

Annotation of /mambo/branches/4.5.3h/INSTALL.php

Revision 1414 - (view) (download)

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

	ViewVC Help
Powered by ViewVC 1.0.0

Web Hosting provided by Network Redux.

MyGforge Home

Mambo CMS

Annotation of /mambo/branches/4.5.3h/INSTALL.php