| 1 |
REQUIREMENTS |
|---|
| 2 |
|
|---|
| 3 |
|
|---|
| 4 |
Gregarius requires a relatively up-to-date PHP installation (>= 4.3.0) |
|---|
| 5 |
with xml (expat) support. It works fairly well with PHP5. |
|---|
| 6 |
|
|---|
| 7 |
Your PHP installation must support socket operations. See: |
|---|
| 8 |
http://ch2.php.net/manual/en/function.fsockopen.php |
|---|
| 9 |
|
|---|
| 10 |
Additionally you will need access to a MySQL or a SQLite database. |
|---|
| 11 |
|
|---|
| 12 |
QUICK START |
|---|
| 13 |
|
|---|
| 14 |
|
|---|
| 15 |
1. If you are upgrading from an earlier version make sure you have a |
|---|
| 16 |
backup copy of all the files you have modified |
|---|
| 17 |
|
|---|
| 18 |
2. If you haven't already done so, download the latest release from |
|---|
| 19 |
the sourceforge.net project site. |
|---|
| 20 |
http://sourceforge.net/project/showfiles.php?group_id=98845 |
|---|
| 21 |
|
|---|
| 22 |
3. Unpack the Gregarius package inside your web directory: |
|---|
| 23 |
|
|---|
| 24 |
1. If you are installing from a tar.gz archive: |
|---|
| 25 |
|
|---|
| 26 |
tar xvfz rss-x.y.z.tar.gz |
|---|
| 27 |
|
|---|
| 28 |
2. If you are installing from a zipped archive: |
|---|
| 29 |
|
|---|
| 30 |
unzip rss-x.y.z.zip |
|---|
| 31 |
|
|---|
| 32 |
4. cd to the created directory: |
|---|
| 33 |
|
|---|
| 34 |
cd rss |
|---|
| 35 |
|
|---|
| 36 |
5. Choose your installation type: |
|---|
| 37 |
|
|---|
| 38 |
1. For a graphical installation, point your browser at the root |
|---|
| 39 |
directory of your installation. Enter the necessary information |
|---|
| 40 |
about your database structure and continue. |
|---|
| 41 |
|
|---|
| 42 |
2. For a manual installation, create a configuration file, based on the |
|---|
| 43 |
sample: |
|---|
| 44 |
|
|---|
| 45 |
Copy the sample database configuration file: |
|---|
| 46 |
|
|---|
| 47 |
cp dbinit.php.sample dbinit.php |
|---|
| 48 |
|
|---|
| 49 |
Edit the dbinit.php file to match your database configuration. |
|---|
| 50 |
Make sure that the database exists and has the right permissions |
|---|
| 51 |
and the database user you define owns privileges to create/modify |
|---|
| 52 |
tables. Point your browser at the root directory of your |
|---|
| 53 |
installation. You should read a message informing you that the |
|---|
| 54 |
database schema has been generated. |
|---|
| 55 |
|
|---|
| 56 |
6. If at this point, the browser returns a 500 internal server |
|---|
| 57 |
error, then remove (or disable) the .htaccess file in this |
|---|
| 58 |
directory and try again. |
|---|
| 59 |
|
|---|
| 60 |
mv .htaccess .htaccess.tmp |
|---|
| 61 |
|
|---|
| 62 |
See the FAQ http://wiki.gregarius.net/index.php/FAQ for more |
|---|
| 63 |
information. |
|---|
| 64 |
|
|---|
| 65 |
If the database user you defined lacks privileges to create |
|---|
| 66 |
database tables you should import your schema manually: from the |
|---|
| 67 |
command-line type (replacing database_user, database_host and |
|---|
| 68 |
database_name) |
|---|
| 69 |
|
|---|
| 70 |
php schema.php --dump > dbstruct.sql |
|---|
| 71 |
mysql -u database_user -h database_host -p database_name < dbstruct.sql |
|---|
| 72 |
|
|---|
| 73 |
|
|---|
| 74 |
7. Point your browser to the URL corresponding the install |
|---|
| 75 |
location and click "Admin". After selecting a new password, |
|---|
| 76 |
you can start adding feeds by pasting URLs of RSS or RDF feeds |
|---|
| 77 |
into the "Add a feed" field. Alternatively you can import a |
|---|
| 78 |
list of feeds using the OPML import feature. |
|---|
| 79 |
|
|---|
| 80 |
8. This version of Gregarius comes with default password |
|---|
| 81 |
protection, however you may wish to to strengthen it by using |
|---|
| 82 |
a .htaccess file. |
|---|
| 83 |
|
|---|
| 84 |
See http://wiki.gregarius.net/index.php/Password_Protection |
|---|
| 85 |
for this purpose. |
|---|
