Location: PHPKode > projects > News Manager - RSS aggregator > newsmanager/docs/INSTALL.txt
------------------------------------------------------------------------
Table of Contents
1.0 Introduction
  1.0.1 Licence
	
2.0 Installation
  2.0.1 Requirements
  2.0.2 Pre-Installation Setup
  2.0.3 Running the Installer
  2.0.4 Post-Installation

3.0 Upgrading

4.0 ADMIN 
     usermail
     password

5.0 Conclusion

Appendix A: Notes for installing Newsmanager on Windows.

-------------------------------------------------------------------------

-------------------------------------------------------------------------
1.0 Introduction

Thank you for choosing Newsmanager, a web-based application which syndicates or distributes a collection of news items, thereby acting as a single source of information. 
We have spent many months on this product and hope that 
you find it useful. 

1.0.1 Licence

This product is protected under the GNU General Public Licence (GPL).
For full details on this licence and the rights it grants to you, 
the user of this software, and to us, the developers, please see the
file COPYING that is distributed with this software. Also, for more 
information on the GPL and the Free Software Foundation visit 
http://www.fsf.org/ or http://www.gnu.org/
-------------------------------------------------------------------------

-------------------------------------------------------------------------
2.0 Installation

2.0.1 Requirements

Newsmanager  requires very little to run, and most well configured web servers 
should be able to run Newsmanager. You need at least the following:

1 Web server w/PHP 3.0.15 or greater  (Apache is know to work very well with Newsmanager)
1 MySQL server (Newsmanager has been tested on 3.22 and 3.23)
1 Admin crazy enough to run a forum (That would be you :) )

2.0.2 Pre-Installation Setup

Before beginning the install you should do 3 things:

1. Make sure PHP is installed and configured on your server, you can do
this by creating a file called phpinfo.php (or .php3) on your web server.
This file should contain the following code:

<?php
phpinfo();
?>

This should, if PHP is installed correctly, produce a nicely formatted
diagnostic page that gives you ALOT of information about the current status
of PHP on your system. Make sure this page contains a section entitled
'MySQL', if it does, you're ready to continue. If this section does not
exist then you will have to contact your system administrator and have
him/her reconfigure PHP with MySQL support. If you are the system
administrator and don't know how to do this please see the PHP manual
section on installation:
http://www.php.net/manual/en/installation.php

2. You must edit the file config.php. In this file you will have to set
the path to Newsmanager, and some cookie variables. This file contains
instructions on what settings need to be set and what they should be set
to. Also, this file MUST be writeable by the web server! To set this file
writeable you can issue the following command at a Unix command prompt:

chmod a+w config.php

If you do not have command line access to your web server then your FTP
client should be able to change file permissions.

3. You must check the status of MySQL. Make sure that MySQL is running on
the system and that you have a valid username/password to use with Newsmanager. If
your MySQL user has access to create databases on the server this is all you
have to do. If you do not have access to create databases please contact
your system administrator and have them create a database for your Newsmanager
install. Once you have a database to install Newsmanager into you are ready to
continue.

2.0.3 Running the Installer

We have tried to make the installer as user-friendly as we possible. Open your
web browser and type in the address of your Newsmanager install file.
For example:

mysql:http://www.yoursite.com/newsmanager/install_mysql.php

pgsql:http://www.yoursite.com/newsmanager/install_pgsql.php

If you do not have the correct file permissions on config.php you will see an error message telling you how to
correct this. If all goes well you should see the first screen of the
installer, the database information screen. You will see that values have
been set for you, these may not work for you! They are simply there to give
you an idea of what needs to be entered. Set them to the correct values before
proceeding. Next you will see a screen that tells you the status of the
database creation, if all goes well your database has now been set-up for
Newsmanager. After that you will be presented with the user registration screen for
the admin user. You must fill out at least the username, password, and email
fields in this form, all the rest are optional. Next you will see the forum
wide options configuration screen. This form allows you to set-up the basic
options to be used on the forum, default values have been entered for you to
give you an idea of what data you should enter.

If all goes well you should be presented with a link to the administration
panel. Congratulations, you have just installed Newsmanager.

If you have any problems with this install please contact us at
http://newsmanager.avalonnet.com/  and we'll try and help.

2.0.4 Post-Installation

Once you have finished the install you should make sure that you reset
config.php so that is NOT writeable by the web server. This is purely for
security reasons, you don't want just anyone writing values to that file.
You can do this by issuing the following Unix command:

chmod a-w config.php

Or, again if you don't have command line access to your server you can do
this via your FTP client.

4.0 ADMIN usermail,password
-----------------------------
   Once you enter the backend newsmanager (administration panel),you can use our default usermail 
   and  password to access the backend functionality and add yourself as a administrator.
   Default:
   usermail:hide@address.com
   password:admin
        
   
3.0 Upgrading
------------------------------------------------------------------------------

Upgrading from older versions of Newsmanager is very simple. We have provided full 
upgrade scripts along with this release. There are 5 steps to upgrading:

1. Backup your old Newsmanager files.

2. Unpack the new Newsmanager distribution.

3. Edit config.php and set the values as you need. There are some changes
from the old config file so make sure you read the new file carefully.
You will also have to copy your old database configuration values over to
the new file. The values you want to copy over are 
$dbuser
$dbpasswd
$dbhost
$dbname
Make sure config.php ends with ?> and there are no blank spaces after that.

4. Open your web browser and type in the address of your Newsmanager upgrade
script. For Example:
http://www.yoursite.com/newsmanager/upgrade_14.php
There are two different upgrade scripts. upgrade_14.php is for the conversion 
from 1.2.x to 1.4 and upgrade_12.php can be used if you are still using a
1.0.x database. In this case you'll fist have to run upgrade_12.php and after
that you can run the upgrade_14.php script to convert your DB from the 1.2 
format to the format required for 1.4.

5. Follow the instructions that the upgrade script gives you. (Basically you
just have to keep hitting next).

The upgrade script will make a backup of your old database but it is still
advisable that you also make a manual backup of the database in case
something goes very wrong.

If everything goes well, and you don't receive any errors you should now have
a working copy of Newsmanager v1.4.

Please don't forget to rename/move or delete the upgrade and installation
scripts because they are not needed anymore (install.php, upgrade_12.php and
upgrade_14.php).


4.0 Conclusion
----------------------------------------------------------------------------
Congratulations!
. We hope you have found this document
useful and you find out software equally useful. 

Any questions/comments can be posted at our official support forums at:
http://newsmanager.avalonnet.com/
Or by emailing hide@address.com

Thank you.
The Newsmanager Group

-----------------------------------------------------------------------------
Appendix A: Notes for Installing Newsmanager on windows systems.

First, thanks to our Windows using bug hunter David Tod Sigafoos for
coming up with this solution.

Newsmanager will only function correctly when PHP4 is installed as an ISAPI Apache
module, here are instructions for installing it as such:

1) Stop your apache server

2) Download php 4.0.3pl1 from php.net.  Download the isapi version
from here http://www.php.net/downloads.php

3) Unzip php into your directory (for me it was c:\php)

4) Copy the php4ts.dll into the windows\system directory.  (there
should only be one in system or system32)

In http.conf

5) In apache http.conf find the loadmodule section and add this line
LoadModule php4_module c:/php/sapi/php4apache.dll

6) Be sure you have the AddType for php

Also, some people have had success by adding the following line to config.php:

$PHP_SELF = $PATH_INFO;

This should only be used if you have PHP installed as a CGI module.
If you have any other problems installing on Windows please visit the
support forums at http://newsmanager.avalonnet.com/

--------------------------------------------------------------------------

Return current item: News Manager - RSS aggregator