1950885 visitors

 16 visitors online

I. First install (demo)

This first install paragraph explains you how to set up a GuppY web site with some demo content, so that you can play with it.

1. Download the guppy.zip file (http://www.freeguppy.org) on your PC.

2. Unzip this guppy.zip file in a directory of your PC with your favorite unzipping tool (WinZip, UltimateZip...).

3. EXCELLENT, GuppY is ready to run !

4. If you wish to play with GuppY on your PC before putting it on the Internet, install a webserver and PHP (you may also rather install a package like EasyPHP - http://www.easyphp.org)on your PC and copy the content of the directory where you unzipped guppy.zip in the www sub directory of EasyPHP, then launch EasyPHP... and your site will be running locally on your PC. It's just as easy as that !

4 bis. If you wish to install your web site directly on the Internet, then copy all unzipped files via FTP to your site with a simple FTP client software (IE, Netscape, CuteFTP, etc...). And that's all, you now just need to input the URL of your site in your browser to find yourself on your web site.

5. Wonderful, you just installed GuppY successefully!

IMPORTANT NOTICE

- If you do not plan to prepare a new clean database, delete the install/ directory now. Otherwise anybody could run it on your web site and delete all the content on your web site!

ALTERNATIVE

You can also download EasyGuppY on the GuppY site. EasyGuppY is a package made of a web server, PHP and GuppY, all packaged with an automated install program for a PC with Windows. You just cannot do easier than that !

"CHMOD" note

Here is how to set up files rights for web servers that require it (not all of them require it).
1. Directory admin
- File mdp.php : CHMOD 666
2. Directory data : CHMOD 777
- Files data/* : CHMOD 666
3. Directory data/archive : CHMOD 777
- Files data/archive/* : CHMOD 666
4. Directory data/cache : CHMOD 777
- Files data/cache/* : CHMOD 666
5. Directory data/countmsg : CHMOD 777
- Files data/countmsg/* : CHMOD 666
6. Directory data/usermsg : CHMOD 777
- Files data/usermsg/* : CHMOD 666

How can you detect that you should execute these "CHMOD" ? Well, it is pretty easy to know, it is in the case you get many error messages of this kind :

Warning: fopen("data/logh.dtb","w") - Permission denied in http://www.mysite.com/inc/functions.php on line 198
Warning: Supplied argument is not a valid File-Handle resource in http://www.mysite.com/inc/ functions.php on line 206
Warning: fopen("../data/logh.dtb", "w") - Read-only file system in functions.php on line 198
Warning: fputs(): supplied argument is not a valid File-Handle resource in functions.php on line 206

.htaccess notice

GuppY is shipped with a .htaccess file in the root directory. This file is only useful if your web site runs with an Apache server (this is the case most of the time). Here is its structure:
--------------------------------------
[Files ~ ".inc"]
Order allow,deny
Deny from all
Satisfy All
[/Files]
[Files ~ ".dtb"]
Order allow,deny
Deny from all
Satisfy All
[/Files]
ErrorDocument 400 /error.php?err=400
ErrorDocument 401 /error.php?err=401
ErrorDocument 403 /error.php?err=403
ErrorDocument 404 /error.php?err=404
ErrorDocument 500 /error.php?err=500
--------------------------------------
The first 5 lines are used to protect the content of your database from hackers and other bad people (and there are some !). Otherwise, files like the data/frth.dtb file for example which holds all e-mail addresses of the people who posted a message in the forum can be read and even help to enrich a Spam file (ugly !). These 5 lines are not to be modified.

The 5 following lines are used to direct users to the error page when ask for a non existing page or other possible errors. These lines might require to be adapted (with a simple text editor like Notepad or Wordpad for example) according to where you have put your GuppY.

If you installed GuppY at the rool of your site (URL = http://www.yoursite.com/) then you have nothing to do. But if you installed it in a directory of your site (URL = http://www.yoursite.com/here/ for example) then you will have to modify these 5 lines :
-------------------------------------------
ErrorDocument 400 /here/error.php?err=400
ErrorDocument 401 /here/error.php?err=401
ErrorDocument 403 /here/error.php?err=403
ErrorDocument 404 /here/error.php?err=404
ErrorDocument 500 /here/error.php?err=500
-------------------------------------------

In some cases, you might need to modify these 5 lines as follows (for a website having an URL like http://www.yoursite.com/) :
-------------------------------------------------------------
ErrorDocument 400 http://www.yoursite.com/error.php?err=400
ErrorDocument 401 http://www.yoursite.com/error.php?err=401
ErrorDocument 403 http://www.yoursite.com/error.php?err=403
ErrorDocument 404 http://www.yoursite.com/error.php?err=404
ErrorDocument 500 http://www.yoursite.com/error.php?err=500
-------------------------------------------------------------

Or, if installed in the here/ subdir :
------------------------------------------------------------------
ErrorDocument 400 http://www.yoursite.com/here/error.php?err=400
ErrorDocument 401 http://www.yoursite.com/here/error.php?err=401
ErrorDocument 403 http://www.yoursite.com/here/error.php?err=403
ErrorDocument 404 http://www.yoursite.com/here/error.php?err=404
ErrorDocument 500 http://www.yoursite.com/here/error.php?err=500
------------------------------------------------------------------

It would also be wise to protect your directory by a user name and password within the .htaccess file. As the way of doing it is usually specific to your web host, please refer to its documentation on this topic.
For further information on how to protect your web site with a .htaccess file, please refer to the official Apache documentation.

II. Clean install

The clean install is meant for when you want to erase the demo content and start with a brand new empty GuppY site.

The starting point is for this clean install is anywhere between the first install and anything you did with the demo content. It will erase all of the content but keep the current parameters made in the different "Config something" admin areas.

1. If your web site URL is http://www.mysite.com/ input the following URL in your browser : http://www.mysite.com/install/

2. Follow instructions for a "Clean install".

3. Wonderful, your web site is ready to run with your content !

IMPORTANT NOTICE

- Make sure that all the files in the install/ directory were deleted. Otherwise anybody could run it on your web site and delete all the content on your web site !
- If you cannot see the install/ directory anymore, then it means that everything is fine. The same conclusion applies if the install/ directory still exists but is empty (you should the delete it by FTP, as your web host does not allow its deletion with PHP).

III. Migrating from previous versions

IMPORTANT : the migration script is for web sites running with miniPortail version 1.8 or later / GuppY version 2.4 or later.If you are running with an earlier version of miniPortail / GuppY, you should apply the following instructions, being :

- Follow steps 1 to 6 of the migration procedure here under.
- Then execute install/migrate17.php and then install/migrate18.php if you are running a version < 1.7 of miniPortail.
- Or execute install/migrate18.php if you are running a version 1.7 of miniPortail.
- Then jump to step 7 of the migration procedure here under.Notice : these old and "dirty" scripts are no more maintained by the GuppY development team. The new script instead will be maintained for future releases.


Now, if you are running a miniPortail version 1.8 or later / GuppY version 2.4 or later, follow these instructions :

1. Back up all of your web site before going ahead.

2. Run a "DB integrity check". Make sure it finds no error or run it again.

3. Your data is put in the 4 directories data/, file/, img/, pages and photo/. Therefore, you should not delete them from your web site.

4. Delete the files that are at the root of your site (/) and the directories , inc/, mobile/ (mobile/ appeared with version 2.3), and plugins/ (plugins/ appeared with version 3.0) their content, as well as all their subdirectories and their content.

5. Disactivate the skin and the plugins you are using:

5.1 Go to Config site to activate the skin "no_skin".
5.2 Go to the management pages of your plugins to take off their icons from the heigher menu bar.
5.3 Go to Config boxes to take off lateral boxes.

6. Copy the new directories and files from the latest version of GuppY (that is /, , inc/, mobile/, pages/ and plugins/) as well as install/ and it's content.

7. Check if the "CHMOD" notice (from paragraph #2) is required for your installation. This will be the case if you had to apply it for your previous miniPortail / GuppY installs/migrations.

8. If your web site URL is http://www.mysite.com/ input the following URL in your browser : http://www.mysite.com/install/

9. Follow instructions for a "Migration".

10. Wonderful, you have just migrated to the latest version of GuppY.

11. Some modifications in the GuppY parameters require you to check for "General Config", "Site Config", "Home Config", "Sections Config", "Services Config" and "Boxes Config". You will also have to run a "DB integrity check" for updating the GuppY database indexes.

IMPORTANT NOTICES

- Once you have finished migrating, make sure that all the files in the install/ directory were deleted. Otherwise anybody could run it on your web site and delete all the content on your web site !
- If you cannot see the install/ directory anymore, then it means that everything is fine. The same conclusion applies if the install/ directory still exists but is empty (you should the delete it by FTP, as your webhoster does not allow its deletion with PHP).
- After the migration, the admin password is reset to "pass".

Creation date : 06/12/2004 @ 04:00
Last update : 09/06/2005 @ 00:01
Category : GuppY
Page read 1373 times

 Print preview      Print the page

  0 member

Users online