Re: [Phpwebsite-developers] phpWS 0.9x install HOWTO for SF (final draft)

[Mike N. <mh...@us...>]

Everyone,
This is a final draft. Feedback and comments are welcome.

** Begin Final Draft **

phpWebSite 0.9x install howto for SourceForge hosted projects

Things you'll need:

    Fallout Tarball (2002-09-17)
    http://phpwebsite.appstate.edu/downloads/fallout/fallout.tar.gz
     
    PEAR libs
    http://phpwebsite.appstate.edu/downloads/pear/pear-4.1.0.tar.gz

    A working MySQL database supplied and hosted by SourceForge.
    Guide to MySQL Database Services
    https://sourceforge.net/docman/display_doc.php?docid=3052&group_id=1


Installation Instructions:
 
Download the required files to your project directory. Untar them, and
move the contents to your htdocs directory. Create a tmp directory in
your project directory. Modify your .htaccess file in htdocs (see
example below).

$ ssh -l yourname shell.sf.net
$ cd /home/groups/y/yo/yourproject
$ wget http://phpwebsite.appstate.edu/downloads/fallout/fallout.tar.gz
$ wget http://phpwebsite.appstate.edu/downloads/pear/pear-4.1.0.tar.gz
$ tar xvzf fallout.tar.gz
$ tar xvzf pear-4.1.0.tar.gz
$ mv fallout/* htdocs
$ mv pear-4.1.0/* htdocs
$ mkdir tmp
$ cd htdocs
$ vi .htaccess
    php_value arg_separator.output "&"
    php_value include_path
    ".:/home/groups/y/yo/yourproject/htdocs:/usr/local/lib/php"
    php_value session.save_path "/home/groups/y/yo/yourproject/tmp"

Using your web browser, open the following url and follow the
instructions provided.
 
     http://yourproject.sf.net/setup/setup.php

When phpWS informs you that it doesn't have permission to write to your
htdocs directory, select save a local copy of config.php. Then, create a
config.php file in your project htdocs directory, and copy the contents
of the local config.php to the one on SourceForge.

$ touch config.php
$ chmod 600 config.php
$ vi config.php
    <paste in local config.php contents>
$ logout

Now you need to open a support request with the SourceForge staff. You
need them to change group ownership on: .htaccess, config.php, and the
tmp directory.

Submit New SF SR
https://sourceforge.net/tracker/?func=add&group_id=1&atid=200001

Sample SF SR:
    Category: Project web services
    Summary: Project web content file permissions issue
    Detailed Description:
        Project: yourprojectname
        
        Please perform the following administrative actions. Thanks.
        
        # cd /home/groups/y/yo/yourproject
        # chgrp nfsnobody htdocs/.htaccess
        # chgrp nfsnobody htdocs/config.php
        # chgrp nfsnobody tmp
        
        ref. "Guide to Project Web Hosting Services" section Security
        paragraph two
        https://sourceforge.net/docman/display_doc.php?docid=4297&group_id=1

After you receive notification this task is complete, log into
SourceForge. You need to change the permissions on:  .htaccess,
config.php, images directory, and tmp directory.

$ ssh -l yourname shell.sf.net
$ cd /home/groups/y/yo/yourproject
$ chmod 0770 tmp
$ cd htdocs
$ chmod 660 .htaccess
$ chmod 640 config.php
$ find ./images -type d -exec chmod 2777 {} \;
$ find ./images -type f -exec chmod 0666 {} \;
$ logout

Now open the phpWS setup page in your browser, and finish the
installation.

    http://yourproject.sf.net/setup/setup.php


Backup your site:

$ ssh you...@sh... mysqldump -h mysql.sourceforge.net -u
yourproject -p --quick --add-drop-table --add-locks --lock-tables
yourproject > yourproject.sql

$ rsync -e "ssh -l yourname" -av --partial --delete
shell.sf.net:/home/groups/y/yo/yourproject localdirectory


Acknowledgments: I thank Adam Morton, Jeremy Agee, and David Burley for
their assistance in creating this document.

-- 
Mike Noyes <mh...@us...>
http://sourceforge.net/users/mhnoyes/
http://leaf-project.org/