| 1 |
trevor |
1.10 |
/** |
| 2 |
trevor |
1.10 |
* CPG Dragonfly CMS |
| 3 |
trevor |
1.10 |
* Copyright (c) 2004-2005 by CPG-Nuke Dev Team, www.dragonflycms.com |
| 4 |
trevor |
1.10 |
* Released under the GNU GPL version 2 or any later version |
| 5 |
trevor |
1.11 |
* $Id: INSTALL.txt,v 1.10 2005/02/02 23:48:05 trevor Exp $ |
| 6 |
trevor |
1.10 |
*/ |
| 7 |
djmaze |
1.1 |
  |
| 8 |
djmaze |
1.1 |
  |
| 9 |
djmaze |
1.1 |
Base Requirements |
| 10 |
djmaze |
1.1 |
----------------- |
| 11 |
djmaze |
1.1 |
  |
| 12 |
trevor |
1.10 |
In order to setup CPG Dragonfly CMS, the following prerequisites are necessary: |
| 13 |
djmaze |
1.1 |
  |
| 14 |
trevor |
1.7 |
- a web server (Apache prefered) |
| 15 |
trevor |
1.7 |
- PHP 4.1 or higher (4.3.x prefered) |
| 16 |
trevor |
1.8 |
- an SQL server (MySQL 4.x and PostgreSQL 7.3.x or later are supported) |
| 17 |
djmaze |
1.1 |
  |
| 18 |
djmaze |
1.6 |
Setup of these required packages is beyond the scope of this document and if |
| 19 |
djmaze |
1.6 |
you are unsure you should check with each of the appropriate web sites for |
| 20 |
djmaze |
1.6 |
further details. |
| 21 |
djmaze |
1.6 |
  |
| 22 |
djmaze |
1.1 |
  |
| 23 |
trevor |
1.2 |
Installing the Package |
| 24 |
trevor |
1.2 |
---------------------- |
| 25 |
djmaze |
1.1 |
  |
| 26 |
djmaze |
1.6 |
If you are going to upgrade your website start at step two... |
| 27 |
djmaze |
1.6 |
If you want to run a CVSWeb read the CVS.txt documentation carefully before you |
| 28 |
djmaze |
1.6 |
install our CVS bundle onto your website |
| 29 |
djmaze |
1.6 |
  |
| 30 |
trevor |
1.10 |
1) Create a new database, for example, 'dragonfly': mysqladmin create cpgnuke |
| 31 |
djmaze |
1.6 |
OR add a database through your web control panel. |
| 32 |
djmaze |
1.6 |
  |
| 33 |
djmaze |
1.6 |
2) Edit the file "config.php". Change all the fields until you are happy with |
| 34 |
djmaze |
1.6 |
the changes and they fit the need of your web site. Give special attention |
| 35 |
djmaze |
1.6 |
to the database configuration section. When you have finished editing |
| 36 |
djmaze |
1.6 |
config.php, save it. |
| 37 |
djmaze |
1.1 |
  |
| 38 |
djmaze |
1.6 |
3) Now upload all content from the /html directory to your webspace. |
| 39 |
djmaze |
1.1 |
  |
| 40 |
trevor |
1.8 |
4) CHMOD the following file to 600 (622 if 600 fails): |
| 41 |
djmaze |
1.6 |
- cpg_error.log |
| 42 |
trevor |
1.2 |
  |
| 43 |
trevor |
1.8 |
5) CHMOD the following directories to 755 (777 if 755 fails): |
| 44 |
djmaze |
1.6 |
- cache |
| 45 |
djmaze |
1.6 |
- modules/coppermine/albums |
| 46 |
djmaze |
1.6 |
- modules/coppermine/albums/userpics |
| 47 |
djmaze |
1.6 |
- uploads/avatars |
| 48 |
djmaze |
1.6 |
- uploads/forums |
| 49 |
djmaze |
1.1 |
  |
| 50 |
djmaze |
1.6 |
6) In your web browser go to http://mydomain.tld/install.php |
| 51 |
djmaze |
1.6 |
The setup will install/update your database. |
| 52 |
djmaze |
1.1 |
  |
| 53 |
djmaze |
1.6 |
After the database is created you will be prompted to insert additional |
| 54 |
djmaze |
1.6 |
information and, if it's a new install, to create the super user account. |
| 55 |
djmaze |
1.6 |
Create your super user following the on-screen instructions. |
| 56 |
djmaze |
1.1 |
  |
| 57 |
djmaze |
1.6 |
7) Login following the admin link (http://mydomain.tld/admin.php) |
| 58 |
djmaze |
1.1 |
  |
| 59 |
djmaze |
1.6 |
Now click on "Main Settings" and change whatever you want to fit your site |
| 60 |
djmaze |
1.6 |
info. All the options you need to change are in the Settings menu. |
| 61 |
djmaze |
1.1 |
  |
| 62 |
djmaze |
1.6 |
8) After installing, delete install.php and the /install directory! |
| 63 |
djmaze |
1.1 |
  |
| 64 |
djmaze |
1.1 |
  |
| 65 |
djmaze |
1.1 |
Testing the Installation |
| 66 |
djmaze |
1.1 |
------------------------ |
| 67 |
djmaze |
1.1 |
  |
| 68 |
djmaze |
1.1 |
Go to your homepage, for example: |
| 69 |
djmaze |
1.1 |
  |
| 70 |
trevor |
1.8 |
http://mydomain.tld/index.php |
| 71 |
djmaze |
1.1 |
  |
| 72 |
trevor |
1.2 |
To login as administrator: |
| 73 |
djmaze |
1.1 |
  |
| 74 |
trevor |
1.8 |
http://mydomain.tld/admin.php |
| 75 |
djmaze |
1.1 |
  |
| 76 |
djmaze |
1.6 |
This will give you full administrator privileges to your installation of |
| 77 |
trevor |
1.10 |
CPG Dragonfly CMS. |
| 78 |
djmaze |
1.1 |
  |
| 79 |
djmaze |
1.6 |
Remember to logout from admin after you use it. From this area you can |
| 80 |
djmaze |
1.6 |
delete or add content on your site, so never leave your computer without |
| 81 |
djmaze |
1.6 |
logging out from the admin account. |
| 82 |
djmaze |
1.1 |
  |
| 83 |
djmaze |
1.1 |
We recommend the use of MySQL-Front or phpMyAdmin. Those are good |
| 84 |
djmaze |
1.1 |
administration systems for MySQL databases. |
| 85 |
trevor |
1.10 |
www.dragonflycms.com/downloads/mysqlfront25.exe (free version) |
| 86 |
djmaze |
1.1 |
www.mysqlfront.de (30 days free) |
| 87 |
djmaze |
1.1 |
www.phpmyadmin.net/home_page |
| 88 |
djmaze |
1.1 |
  |
| 89 |
djmaze |
1.1 |
We also recommend setting a password for your MySQL access. This is |
| 90 |
djmaze |
1.1 |
important as some data in the nuke database is not encrypted, so for |
| 91 |
trevor |
1.5 |
security reasons you need to set a password. Not only that, it's a |
| 92 |
trevor |
1.5 |
good practice! |
| 93 |
djmaze |
1.1 |
  |
| 94 |
djmaze |
1.1 |
  |
| 95 |
djmaze |
1.1 |
Final Notes |
| 96 |
djmaze |
1.1 |
----------- |
| 97 |
djmaze |
1.1 |
  |
| 98 |
trevor |
1.10 |
That's it! You're done with CPG Dragonfly CMS. Just navigate around, play with it, |
| 99 |
trevor |
1.10 |
abuse it and if you like CPG Dragonfly CMS, use it. Spend some time getting used to the |
| 100 |
djmaze |
1.6 |
administration interface. |
| 101 |
djmaze |
1.6 |
  |
| 102 |
djmaze |
1.6 |
To change your site's logo, go to the /themes directory and make a custom |
| 103 |
djmaze |
1.6 |
logo for each individual theme. Just navigate around all themes and change |
| 104 |
djmaze |
1.6 |
the graphics you want. |
| 105 |
djmaze |
1.6 |
  |
| 106 |
djmaze |
1.6 |
PS: When you e-mail us asking something, just remember that we receive A LOT |
| 107 |
djmaze |
1.6 |
of e-mails a day! We don't answer, but for sure we'll read it. |
| 108 |
trevor |
1.10 |
Your best bet is to visit the forums at www.dragonflycms.com/Forums.html and post |
| 109 |
djmaze |
1.6 |
your questions there. |
| 110 |
djmaze |
1.1 |
  |
| 111 |
djmaze |
1.6 |
** A special thank you to all the people who have helped is in CREDITS.txt ** |
| 112 |
djmaze |
1.1 |
  |
| 113 |
trevor |
1.10 |
Enjoy! |