Mambo > Projects > Mambo CMS > SVN

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

Revision 1 - (view) (download)
Original Path: mambo/trunk/INSTALL.php

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