| 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. |
|---|
